简要总结
CLI Automation
这页说明书是教你一个“秘密咒语”,让你不用一直回答电脑的问题,就能自动设置好 OpenClaw 工具。就像你有一个魔法按钮,按一下,所有准备工作就自己完成啦!当你需要用电脑程序来帮你做这件事,或者你不想一步一步点来点去的时候,就可以看看这页。
五岁小孩版解释
这个页面教你怎么用一个特别的“秘密咒语”,让电脑自己完成 OpenClaw 的第一次设置。这个咒语就是 --non-interactive,意思是“不要问我问题,自己干”。这样,你就可以写一个脚本(就像一张任务清单)让电脑自动运行了。
重要提醒:就算你用了 --json 这个咒语,电脑还是会问你问题哦。所以想让它完全自己干活,一定要用 --non-interactive 这个咒语。
基础自动设置咒语
下面是一个最基本的自动设置咒语例子。它告诉电脑:
- 我们要做什么:自动设置 (
onboard --non-interactive)。 - 在哪里工作:就在我们自己的电脑上 (
--mode local)。 - 用什么钥匙开门:用 Anthropic 的钥匙 (
--auth-choice apiKey)。 - 钥匙放在哪:直接告诉电脑钥匙是什么 (
--secret-input-mode plaintext),就像把密码写在纸上。 - 开一扇门:在电脑的 18789 号端口开一扇门 (
--gateway-port 18789),并且只让电脑自己访问 (--gateway-bind loopback)。 - 请一个帮手:安装一个一直在后台帮忙的小精灵 (
--install-daemon)。 - 帮手用什么语言:用 Node 语言 (
--daemon-runtime node)。 - 先不学技能:暂时跳过安装额外技能 (
--skip-skills)。
如果你想看电脑做完后给你一个机器能读的报告,可以在咒语最后加上 --json。
另一种藏钥匙的方法
你还可以换一种方法藏钥匙,不直接写在咒语里。用 --secret-input-mode ref,意思是告诉电脑:“钥匙放在一个叫‘环境变量’的秘密盒子里了,你自己去拿”。这样更安全。
要小心:如果你用了这个方法,就必须提前把钥匙放进那个叫“环境变量”的秘密盒子里。如果没放,电脑会立刻告诉你它找不到,然后就停下来了。
给不同“钥匙店”的咒语
OpenClaw 可以去很多不同的“钥匙店”拿钥匙,比如 Gemini、Z.AI、Vercel 等等。页面里给了很多例子,方法都差不多:
- 都是用
openclaw onboard --non-interactive --mode local开头。 - 然后告诉它去哪个店拿钥匙 (
--auth-choice xxx-api-key)。 - 把对应店的钥匙给它 (
--xxx-api-key "$钥匙变量名")。 - 最后都告诉它开哪扇门 (
--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
这个咒语会:
- 给帮手起名叫
work。 - 告诉它把小房间建在
~/.openclaw/workspace-work这个地方。 - 让它用
openai/gpt-5.2这个大脑模型。 - 让它绑定到 WhatsApp 的商业频道。
- 自动完成,不提问 (
--non-interactive)。 - 完成后输出一个报告 (
--json)。
要注意:如果不指定 --workspace,电脑就会启动向导问你问题。默认的小房间会建在 ~/.openclaw/workspace-<帮手名字> 这里。