代理工作区

工作区是代理的主目录。它是用于文件工具与工作区上下文的唯一工作目录。请保持私有并视作记忆。这与存储配置、凭证和会话的 ~/.clawdbot/ 是分开的。重要： 工作区是默认 cwd，不是硬沙箱。工具相对于工作区解析相对路径，但绝对路径仍可访问主机上其他位置，除非启用沙箱。若需隔离，请使用 agents.defaults.sandbox（和/或每代理沙箱配置）。启用沙箱且 workspaceAccess 非 "rw" 时，工具在 ~/.clawdbot/sandboxes 下的沙箱工作区内运行，而非你的主机工作区。

默认位置

默认：~/clawd
若设置 CLAWDBOT_PROFILE 且非 "default"，默认变为 ~/clawd-<profile>。
在 ~/.clawdbot/moltbot.json 中覆盖：{ agent: { workspace: "~/clawd" } }。

moltbot onboard、moltbot configure 或 moltbot setup 会在缺失时创建工作区并填充引导文件。若你自行管理工作区文件，可禁用引导文件创建：{ agent: { skipBootstrap: true } }。

工作区文件说明

Moltbot 在工作区内期望的标准文件：AGENTS.md（操作说明与记忆）、SOUL.md（人设、语气、边界）、USER.md（用户与称呼）、IDENTITY.md（代理名称/风格/表情）、TOOLS.md（本地工具与约定）、HEARTBEAT.md（可选心跳清单）、BOOT.md（可选网关重启时执行）、BOOTSTRAP.md（一次性首次运行仪式）、memory/YYYY-MM-DD.md（每日记忆）、MEMORY.md（可选长期记忆）、skills/（工作区技能）、canvas/（可选画布 UI）。参见内存。

不在工作区中的内容

以下位于 ~/.clawdbot/，不应提交到工作区仓库：~/.clawdbot/moltbot.json、~/.clawdbot/credentials/、~/.clawdbot/agents/<agentId>/sessions/、~/.clawdbot/skills/。

Git 备份（推荐、私有）

将工作区视为私有记忆。放入私有 git 仓库以便备份与恢复。在运行网关的机器上执行：cd ~/clawd、git init、添加并提交文件、添加私有远程并推送。不要提交密钥；使用占位符并将真实密钥放在别处。建议 .gitignore：.DS_Store、.env、**/*.key、**/*.pem、**/secrets*。

迁移工作区到新机器

将仓库克隆到目标路径（默认 ~/clawd）。
在 ~/.clawdbot/moltbot.json 中将 agents.defaults.workspace 设为该路径。
运行 moltbot setup --workspace <path> 填充缺失文件。
若需会话，单独从旧机复制 ~/.clawdbot/agents/<agentId>/sessions/。

进阶

多代理路由可为每代理使用不同工作区。参见频道路由。若启用 agents.defaults.sandbox，非主会话可使用 agents.defaults.sandbox.workspaceRoot 下的每会话沙箱工作区。