OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书

简要总结

Sandbox CLI

这页说明书在教你玩一个叫“沙盒”的魔法盒子。这个盒子像一个小房间,能让你的“小助手”(Agent)在里面安全地工作,不会弄乱你的电脑。我们会学几个简单的魔法咒语(命令),用来看看盒子在干什么、有哪些盒子、还有怎么给盒子换新衣服(更新)。当你更新了盒子或者改了盒子的规则后,就要看这一页啦!

五岁小孩版解释

沙盒就像一个用积木(Docker)搭成的小房间,你的“小助手”可以在里面玩,这样它就不会跑到外面来弄乱你的玩具(电脑文件)了。这里有几个魔法咒语,能帮你管理这些小房间。

第一个咒语是 openclaw sandbox explain。它的意思是“解释一下”。就像你问妈妈“这个盒子现在是什么规则呀?”,这个命令会告诉你,小助手现在在哪个盒子里玩,它能用哪些工具,还有哪些特别的门(elevated gates)是锁着的。你可以用它问所有的小助手,也可以只问一个叫 main 的小助手。

第二个咒语是 openclaw sandbox list,意思是“列出清单”。它会像点名一样,把所有的小房间都叫出来,告诉你它们的名字、是不是正在玩(running/stopped)、它们是用哪张积木图纸(Docker image)搭的、搭了多久了(Age)、还有多久没玩了(Idle time)。你还可以加 --browser 只找那些用来上网的小房间。

第三个最重要的咒语是 openclaw sandbox recreate,意思是“重新做一个”。当你给积木图纸换了新颜色(更新了Docker镜像),或者改了房间的规则(改了配置),但旧房间还在用老样子,这时候就需要这个咒语了。它会拆掉旧房间,等小助手下次要玩的时候,就会自动用新规则搭一个新房间。 用的时候要小心告诉它拆哪个:

  1. --all 可以拆掉所有房间。
  2. --session main 可以只拆掉叫 main 的小助手的房间。
  3. --agent mybot 可以只拆掉名叫 mybot 的小助手的房间。
  4. --browser 就只拆那些上网用的房间。
  5. 如果你很确定,加 --force 它就不会再问你“你确定吗?”,直接动手。

要记住哦:通常在你换了新积木图纸或者改了房间规则后,才需要用 recreate 咒语。平时小助手自己会管理房间的。

这些房间的规则都写在一个叫 ~/.openclaw/openclaw.json 的魔法书里。书里会写房间的模式(mode)、范围(scope)、用哪张积木图纸(image)等等。比如 idleHours: 24 就是说,如果一个房间24小时没人玩,魔法就会自动把它清理掉。

最后提醒一下:最好用我们刚学的 openclaw sandbox recreate 咒语来拆房间,不要自己直接用 docker rm 命令去拆。因为我们的咒语更聪明,知道每个房间的秘密名字,不会拆错。