OC
OpenClaw 中文解释版

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

简要总结

Default AGENTS.md

这页说明书是教你第一次使用 OpenClaw 智能助手时,需要做哪些准备。就像你要给一个新朋友准备一个属于他自己的小房间,还要告诉他一些重要的规矩。我们会先帮他建好小房间,放好一些重要的说明文件,这样他就能记住你是谁,并且安全地帮你做事了。

五岁小孩版解释

OpenClaw 是一个聪明的电脑助手,它需要一个自己的“小房间”来工作和记住事情。这个小房间默认在 ~/.openclaw/workspace 这个文件夹里。下面我们来一步步布置好它。

  1. 第一步:创建小房间。 这一步是给助手一个可以放东西的地方。你需要在电脑的“终端”里输入一个命令,就像对电脑说一句魔法咒语。 怎么做:打开终端,输入 mkdir -p ~/.openclaw/workspace 然后按回车。这个命令的意思是“请帮我创建(或确认存在)一个叫 .openclaw/workspace 的文件夹”。

  2. 第二步:放入重要的说明文件。 为了让助手知道怎么工作,我们需要放几份说明书到小房间里。这些说明书是提前准备好的模板。 怎么做:在终端里,连续输入下面三行命令,每输完一行就按一次回车: cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.md cp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.md cp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md 这些命令就像“把模板文件复制到小房间里”。

  3. 第三步(可选):换一份更厉害的助手名单。 如果你想让助手拥有更多本领,可以用一份更全的名单替换掉刚才的 AGENTS.md 文件。 怎么做:在终端里输入 cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md 然后按回车。

  4. 第四步(可选):给助手换个房间。 你也可以让助手使用别的文件夹作为小房间,只要告诉它新地址就行。 怎么做:你需要修改一个叫 agents.defaults.workspace 的设置,把它改成新文件夹的路径,比如 "~/我的助手房间"

助手的重要规矩(安全默认设置):

  • 不会在聊天里乱发文件夹列表或秘密。
  • 除非你明确要求,否则不会运行可能搞坏东西的命令。
  • 只把最终想好的完整回答发出去,不会发一半的话。

每次聊天开始,助手必须做的事: 每次你找助手聊天,它都会先认真阅读 SOUL.md(灵魂文件,告诉它你是谁、它该怎么说话)、USER.md(用户文件)、memory.md(长期记忆)以及昨天和今天的日记(在 memory/ 文件夹里)。做完这些,它才会回答你。

关于记忆系统: 助手会把每天重要的事情记在 memory/YYYY-MM-DD.md 这样的日记文件里。特别重要、需要长期记住的事情(比如你的喜好、做过的决定)会写在 memory.md 里。记得要帮它创建 memory/ 文件夹哦。注意,除非你特别允许,否则不要让它把密码之类的秘密记下来。

一个超有用的建议:备份! 你可以把助手的整个小房间变成一个“git 仓库”(想象成一个带版本记录的魔法背包)。这样,所有的说明书和记忆文件就都有备份,不怕丢啦。 怎么做:在终端里,先输入 cd ~/.openclaw/workspace 进入小房间,然后依次输入: git init (初始化魔法背包) git add AGENTS.md (把重要文件放进背包) git commit -m “Add Clawd workspace” (给这次打包做个记录) 你还可以把这个背包推送到一个私密的网上仓库,这样就更安全了。

助手有哪些厉害的本领? 在电脑上打开 OpenClaw 的设置,找到“技能”页面,你可以开启很多本领!比如:

  • Peekaboo:快速给电脑屏幕拍照,还能让 AI 看看照片里有什么。
  • camsnap:管理家里的摄像头。
  • imsgwacli:帮你收发 iMessage、短信和 WhatsApp 消息。
  • spotify-player:用终端控制 Spotify 播音乐。
  • 还有很多其他本领,比如控制智能灯泡(OpenHue CLI)、把说的话变成文字(OpenAI Whisper)等等。

使用时要记住的小提示:

  • 想让助手自动做事情,最好用 openclaw 这个命令来写脚本。
  • 安装新本领要在“技能”页面里点安装按钮,如果已经装好了,按钮会消失。
  • 记得保持“心跳”功能开着,这样助手才能帮你定提醒、查邮件、触发摄像头抓拍。
  • 如果网站需要你登录验证,可以用 openclaw browser 相关的命令,助手会用它自己管理的浏览器来帮你。