Agent Workspace | OpenClaw 中文解释版

小助手的工作室，就是它自己的小房间。它在这里用工具处理文件，也会在这里记住事情。这个房间是它自己的，要保管好，别让别人随便进来。这和我们放钥匙和衣服的柜子（~/.openclaw/）是分开的。

要小心哦：这个房间是它平时待的地方，但不是个锁死的笼子。如果小助手用工具找房间里的东西，它会从房间开始找。但如果它用“绝对路径”（就是完整的地址），它还是能跑到房间外面去玩电脑里别的东西。如果你想让小助手只待在房间里，就需要打开一个叫“沙箱”的笼子功能（设置 agents.defaults.sandbox）。打开笼子后，如果还设置了不能随便进出房间（workspaceAccess 不是 "rw"），小助手就会在一个专门的沙箱房间里工作，而不是在你原来的房间里。

小助手的房间通常在哪里？ 它通常在你电脑上一个叫 ~/.openclaw/workspace 的文件夹里。你可以通过一个叫 OPENCLAW_PROFILE 的设置，或者修改 ~/.openclaw/openclaw.json 文件，来改变房间的位置。当你第一次运行 openclaw onboard、openclaw configure 或 openclaw setup 这些命令时，如果房间还没建好，电脑会自动帮你建好，并且放一些基础文件进去。

房间里有哪些重要的文件？ 房间里有很多文件，就像小助手的不同笔记本。每个都有特别的用处：

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/：这是可选的文件夹，放一些界面显示文件。

如果这些基础文件丢了，小助手会知道，然后继续工作。你可以用 openclaw setup 命令重新创建丢失的文件，但不会覆盖已有的。

什么东西不应该放在房间里？ 有些东西应该放在放钥匙的柜子（~/.openclaw/）里，不要放到房间文件夹里，也不要上传到代码仓库：

openclaw.json 文件（这是设置文件）
credentials/ 文件夹（这里放着密码和钥匙）
agents/<agentId>/sessions/ 文件夹（这里放着聊天记录）
skills/ 文件夹（这里是电脑管理的技能）

怎么给房间做个安全备份？（推荐） 你可以把房间变成一个 私人的 Git 仓库，这样就能备份，丢了也能找回来。就像给你的日记本拍照片存到保险箱里。

第一步：初始化仓库 如果 Git 工具已经装好了，全新的房间会自动初始化。如果还没有，你需要打开终端，输入：
```
cd ~/.openclaw/workspace
git init
git add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/
git commit -m "Add agent workspace"
```
第二步：连接到一个私人的远程仓库（选一种简单的方法）
- 方法A（用GitHub网站）：在GitHub上新建一个 私人的 仓库，不要初始化README。然后复制它的HTTPS地址，在终端里运行：
```
git branch -M main
git remote add origin <你复制的地址>
git push -u origin main
```
- 方法B（用GitHub命令行工具 gh）：先登录 (gh auth login)，然后运行：
```
gh repo create openclaw-workspace --private --source . --remote origin --push
```
- 方法C（用GitLab网站）：步骤和方法A很像，在GitLab上建私人仓库，然后添加远程地址并推送。
第三步：以后怎么更新备份？ 当你房间里的文件有变化后，可以运行：
```
git status
git add .
git commit -m "Update memory"
git push
```

千万记住！ 即使在私人仓库里，也不要在房间里存放秘密！比如：

API钥匙、密码、私人凭证。
任何放在 ~/.openclaw/ 柜子里的东西。
聊天记录的原始文件或敏感附件。如果真的需要记下敏感的东西，用占位符代替，把真的秘密放在别处（比如密码管理器里）。你可以在房间文件夹里放一个叫 .gitignore 的文件，写上 .env、**/*.key 这样的规则，告诉Git忽略这些秘密文件。

怎么把房间搬到新电脑上？

在新电脑上，把你的私人Git仓库克隆到想要的位置（比如默认的 ~/.openclaw/workspace）。
在新电脑的 ~/.openclaw/openclaw.json 文件里，设置 agents.defaults.workspace 为这个新位置。
运行 openclaw setup --workspace <新位置> 来补上任何丢失的基础文件。
如果你想把以前的聊天记录也搬过来，需要单独从旧电脑上复制 ~/.openclaw/agents/<agentId>/sessions/ 这个文件夹。