openclaw 默认工作区路径为 ~/.openclaw/workspace/(linux/macos)或 %userprofile%\.openclaw\workspace\(windows),可通过 openclaw configget agents.defaults.workspace 命令确认;工作区含 soul.md、user.md、identity.md、agents.md、memory.md、tools.md 等核心文件,定义ai行为与身份;其与系统级配置目录 ~/.openclaw/ 物理隔离但逻辑联动;建议定期压缩备份 workspace/ 目录,迁移时需确保 openclaw_workspace 环境变量正确指向。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw 的默认工作区路径是 ~/.openclaw/workspace/(Linux/macOS)或 %USERPROFILE%\.openclaw\workspace\(Windows)。
怎么确认当前实际路径
工作区路径可能被自定义,最可靠的方式是运行命令查实:
- 在终端或 PowerShell 中执行:openclaw configget agents.defaults.workspace
- 若返回为空,说明使用的是默认路径,即 ~/.openclaw/workspace/
- 若设置了环境变量 OPENCLAW_PROFILE(比如值为 coder),路径会自动变为 ~/.openclaw/workspace-coder/
工作区里有什么关键文件
进入该目录后,你会看到这些核心 Markdown 文件,它们共同定义了 AI 的行为与身份:
OpenClaw 原生 PDF/文档处理技能,适用于 Nutrient DWS,帮助用户完成 PDF 转换、OCR、文字/表格提取、PII 脱敏等功能。
- SOUL.md:人格设定,决定语气、价值观和表达风格
- USER.md:你的个人信息,用于上下文感知(如常用工具、偏好语言)
- IDENTITY.md:AI 的名字、头像 emoji、对外身份标识
- AGENTS.md:行为指令集,比如“每天早八自动汇总邮件”“遇到报错优先重试三次”
- MEMORY.md:长期记忆入口,日常记录会存入 memory/ 子目录下的日期文件中
- TOOLS.md:本地可调用的脚本或命令配置,比如 git、curl、自定义 Python 工具
工作区和配置目录的区别
别把工作区和主配置目录搞混:
- ~/.openclaw/(或 Windows 下的 %USERPROFILE%\.openclaw\)是系统级目录,存登录凭证、会话快照、API 密钥等——丢了会导致重新扫码登录、通道失效
- ~/.openclaw/workspace/ 是语义级目录,存角色、记忆、技能——即使前者损坏,只要这个还在,AI 就记得你是谁、该怎么帮你
- 两者物理隔离,但逻辑联动;修改工作区文件无需重启服务,保存即生效
备份和迁移建议
工作区是你 AI 的“记忆中枢”,建议定期归档:
- 直接压缩整个 workspace/ 目录即可完成备份
- 迁移时,把该目录完整复制到新机器的对应位置,再确保 OPENCLAW_WORKSPACE 环境变量指向它
- 不建议手动编辑 MEMORY.md 或 memory/ 下的日期文件,应通过交互指令触发写入,避免格式错乱









