在AI Agent系统中，将项目文件保存至专属Agent Space是确保会话状态、记忆与技能持久化的关键操作；需先确认Active workspace路径（如~/.openclaw/workspace），再通过拖放、cp命令或Agent指令等方式保存，并验证读取有效性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在AI Agent系统中将项目文件保存到专属Agent Space，是确保会话状态、记忆数据与技能文件持久化的核心操作。不按规范保存会导致后续会话无法加载历史上下文，或Agent读取不到关键配置文件。
确认当前Agent Space路径
打开终端，执行openclaw doctor命令，观察输出中Active workspace字段的值。该路径即为当前Agent正在使用的Space根目录。
若未显示有效路径，说明尚未初始化工作空间——此时需先运行openclaw setup完成基础结构创建，否则后续所有保存操作都将失败。
默认路径为~/.openclaw/workspace，但若设置了OPENCLAW_PROFILE环境变量（如dev），实际路径会变为~/.openclaw/workspace-dev。
手动保存项目文件到Agent Space
方法一：直接复制粘贴
将本地项目文件（如project_plan.xlsx、requirements.md）拖入已确认的Agent Space目录中。这一步操作起来很简单，直接把文件拖进去就行。
方法二：命令行保存（推荐用于脚本化场景）
① 进入项目文件所在目录：cd /path/to/your/project
② 将全部项目文件复制进Agent Space：cp *.* ~/.openclaw/workspace/
③ 验证是否写入成功：ls -la ~/.openclaw/workspace/，检查目标文件是否出现在列表中。
【注意：不要使用mv命令移动文件，而应使用cp。若误用mv，原文件将从本地永久消失，且Agent Space中不会自动同步删除记录】
通过Agent指令自动保存
在与Agent对话时，明确发出指令：“请将当前生成的会议纪要保存到我的工作空间，并命名为meeting_20260902.md”。
Agent会解析该请求，将内容写入~/.openclaw/workspace/meeting_20260902.md。
LightVela平台用户还可直接点击网页端“云存储管理”中的“上传”，选择文件后系统自动路由至对应Hermes实例的AgenticSpace内，无需关心路径细节。
验证文件是否可被Agent读取
在新会话中向Agent提问：“请读取requirements.md的内容并总结前三条需求。”
若Agent能准确返回摘要，说明文件已正确落盘且权限无误；若提示“文件不存在”或“拒绝访问”，大概率是文件未放在~/.openclaw/workspace下，或Agent启动时未加载该Space。
OpenClaw默认以Agent Space为当前工作目录（cwd），所有相对路径均以此为基准解析。
