OC
OpenClaw 中文解释版

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

简要总结

CLI Automation

这页说明书是教你一个“秘密咒语”,让你不用一直回答电脑的问题,就能自动设置好 OpenClaw 工具。就像你有一个魔法按钮,按一下,所有准备工作就自己完成啦!当你需要用电脑程序来帮你做这件事,或者你不想一步一步点来点去的时候,就可以看看这页。

五岁小孩版解释

这个页面教你怎么用一个特别的“秘密咒语”,让电脑自己完成 OpenClaw 的第一次设置。这个咒语就是 --non-interactive,意思是“不要问我问题,自己干”。这样,你就可以写一个脚本(就像一张任务清单)让电脑自动运行了。

重要提醒:就算你用了 --json 这个咒语,电脑还是会问你问题哦。所以想让它完全自己干活,一定要用 --non-interactive 这个咒语。

基础自动设置咒语

下面是一个最基本的自动设置咒语例子。它告诉电脑:

  1. 我们要做什么:自动设置 (onboard --non-interactive)。
  2. 在哪里工作:就在我们自己的电脑上 (--mode local)。
  3. 用什么钥匙开门:用 Anthropic 的钥匙 (--auth-choice apiKey)。
  4. 钥匙放在哪:直接告诉电脑钥匙是什么 (--secret-input-mode plaintext),就像把密码写在纸上。
  5. 开一扇门:在电脑的 18789 号端口开一扇门 (--gateway-port 18789),并且只让电脑自己访问 (--gateway-bind loopback)。
  6. 请一个帮手:安装一个一直在后台帮忙的小精灵 (--install-daemon)。
  7. 帮手用什么语言:用 Node 语言 (--daemon-runtime node)。
  8. 先不学技能:暂时跳过安装额外技能 (--skip-skills)。

如果你想看电脑做完后给你一个机器能读的报告,可以在咒语最后加上 --json

另一种藏钥匙的方法

你还可以换一种方法藏钥匙,不直接写在咒语里。用 --secret-input-mode ref,意思是告诉电脑:“钥匙放在一个叫‘环境变量’的秘密盒子里了,你自己去拿”。这样更安全。 要小心:如果你用了这个方法,就必须提前把钥匙放进那个叫“环境变量”的秘密盒子里。如果没放,电脑会立刻告诉你它找不到,然后就停下来了。

给不同“钥匙店”的咒语

OpenClaw 可以去很多不同的“钥匙店”拿钥匙,比如 Gemini、Z.AI、Vercel 等等。页面里给了很多例子,方法都差不多:

  1. 都是用 openclaw onboard --non-interactive --mode local 开头。
  2. 然后告诉它去哪个店拿钥匙 (--auth-choice xxx-api-key)。
  3. 把对应店的钥匙给它 (--xxx-api-key "$钥匙变量名")。
  4. 最后都告诉它开哪扇门 (--gateway-port 18789 --gateway-bind loopback)。

每个例子的写法都列出来了,你需要用哪个,就照着哪个写就行。比如用 Gemini 的店,就用 --auth-choice gemini-api-key--gemini-api-key "$GEMINI_API_KEY"

再请一个帮手(创建新代理)

你还可以用 openclaw agents add <名字> 这个咒语,再请一个专门的帮手。这个新帮手会有自己独立的小房间、聊天记录和钥匙串。 比如,你可以这样请一个叫“工作”的帮手: openclaw agents add work --workspace ~/.openclaw/workspace-work --model openai/gpt-5.2 --bind whatsapp:biz --non-interactive --json 这个咒语会:

  1. 给帮手起名叫 work
  2. 告诉它把小房间建在 ~/.openclaw/workspace-work 这个地方。
  3. 让它用 openai/gpt-5.2 这个大脑模型。
  4. 让它绑定到 WhatsApp 的商业频道。
  5. 自动完成,不提问 (--non-interactive)。
  6. 完成后输出一个报告 (--json)。

要注意:如果不指定 --workspace,电脑就会启动向导问你问题。默认的小房间会建在 ~/.openclaw/workspace-<帮手名字> 这里。