Onboarding Wizard Reference | OpenClaw 中文解释版

这个向导会像玩游戏闯关一样，带你走过好几个步骤。我们来看看每一步要做什么。

检查旧设置 这一步是看看你以前有没有设置过。它会检查一个叫 ~/.openclaw/openclaw.json 的文件。如果有，它会问你是想保留、修改还是重置（全部清空重新来）。别担心，重新运行向导不会弄丢你的东西，除非你明确选了重置。重置的时候，它会把东西放进“回收站”，不会直接删除。
选择大脑和钥匙 这一步最重要！你要给智能助手选一个“大脑”，也就是 AI 模型，比如 Claude 或 GPT。选大脑需要一把“钥匙”（API Key）。向导会帮你找钥匙：
- 如果电脑里已经有环境变量（比如 ANTHROPIC_API_KEY），它会直接用。
- 如果没有，它会让你输入钥匙，然后帮你保管好。
- 它支持很多种大脑，比如 Anthropic、OpenAI、xAI (Grok)、Moonshot (Kimi) 等等。你只需要选一个你有的。
- 选完后，向导会检查一下钥匙对不对，大脑能不能用。
- 这里要小心：为了安全，最好选你有的最厉害、最新的大脑模型。
准备工作室 智能助手需要一个地方“工作”和存放文件。向导会帮你建立一个“工作室”，默认位置在 ~/.openclaw/workspace。就像给你的助手一张桌子和一些文件夹。
设置安全大门 智能助手通过一个“网关”和外界联系。这一步就是设置这个大门。
- 你要决定大门开在哪个“端口”（比如 18789）。
- 最重要的是设置“锁”（认证方式）。向导建议用令牌模式，就像用一把密码锁，即使在自己电脑上也要用密码才能进，这样更安全。
- 你可以让向导生成一个令牌存起来，或者告诉它一个环境变量（比如 OPENCLAW_GATEWAY_TOKEN）的名字，从那里读令牌。
- 除非你完全信任电脑上所有程序，否则不要关掉认证。
连接聊天通道 这一步让智能助手能和你喜欢的聊天软件说话！比如 WhatsApp、Telegram、Discord、iMessage 等。
- 每个软件都需要一些设置，比如 Telegram 需要“机器人令牌”。
- 第一次用私信功能时，助手会发一个配对码给你，你需要用命令 openclaw pairing approve <channel> <code> 来批准，这样它才能和你聊天。
设置网络搜索 你可以选择让助手拥有上网搜索的能力，比如用 Perplexity 或 Brave 搜索。你需要提供对应服务的 API 钥匙。如果现在不想设置，可以跳过。
安装后台助手 为了让智能助手一直运行，需要安装一个“后台助手”。不同电脑方法不同：
- macOS：会安装一个 LaunchAgent。
- Linux/WSL2：会安装一个 systemd 用户服务，并尝试让它在你退出登录后也能运行。
- 这里要选运行环境，推荐用 Node。
- 如果上一步网关的“锁”（令牌）设置有问题，这里会安装失败并告诉你如何修复。
健康检查 设置快完成啦！向导会启动网关，并运行 openclaw health 命令检查一切是否正常。就像给刚搭好的积木城堡检查一下是否牢固。
安装小技能 向导会推荐一些额外的小技能给助手安装，比如更好的代码管理。它会让你选一个工具（npm 或 pnpm）来安装它们。
完成！ 恭喜！所有步骤都完成了。向导会给你一个总结，并告诉你接下来可以做什么，比如下载手机 App 获得更多功能。

不用回答问题的模式 如果你很熟悉，或者想用脚本自动设置，可以用 --non-interactive 模式。这样你需要在命令里一次性把所有选择告诉向导，比如用什么钥匙、开哪个端口。下面是一个例子： openclaw onboard --non-interactive --mode local --auth-choice apiKey --anthropic-api-key “你的钥匙” --gateway-port 18789

注意看这里

如果你的电脑没有屏幕（比如服务器），向导会打印出用 SSH 访问控制界面的方法。
设置过程中生成的各种信息，比如钥匙、配置，会保存在 ~/.openclaw/ 目录下的不同文件里。
有些聊天功能（通道）是以“插件”形式提供的，第一次选的时候，向导可能会提示你先安装它。