Onboarding Wizard (CLI)

这个“设置向导”是一个特别棒的帮手，推荐你在电脑上第一次安装 OpenClaw 时使用它。它会问你一些问题，然后帮你把所有东西都设置好，比如连接网络的“网关”、聊天的“频道”，还有让软件更聪明的小“技能”。

怎么开始呢？ 很简单，你只需要在电脑的黑色命令窗口里输入 openclaw onboard 然后按回车，向导就会启动啦！

如果你想最快地聊上天，可以试试另一个方法：输入 openclaw dashboard，然后就能在浏览器里直接聊天了，连设置频道都不用。

以后想改设置怎么办？ 以后如果你想改设置，不用重新走一遍向导。你可以在命令窗口输入 openclaw configure 来调整。如果想添加一个新的“智能助手”，就输入 openclaw agents add <名字>，记得把 <名字> 换成你喜欢的名字哦。

要小心的地方： 向导里有一个步骤是设置“网络搜索”，就像给助手一个能上网查资料的本领。这里你需要选一个搜索提供商（比如 Perplexity、Brave 等），然后贴上你的“API 钥匙”。如果现在不想设置，以后也可以用 openclaw configure --section web 来补上。

向导有两种模式：快速和高级 向导一开始会让你选模式。

• 快速开始（默认）：就像选“简单模式”，它会用一些好用的默认设置帮你快速搞定。比如，把网关端口设为 18789，还会自动生成一个安全密码。
• 高级控制：就像选“专家模式”，它会让你看到并控制每一个设置步骤，适合想自己决定一切的小朋友。

向导会带你做哪些事？（以默认的本地模式为例） 它会像玩游戏闯关一样，带你完成下面这些步骤：

1. 选择大脑和密码：首先，你要为你的智能助手选一个“大脑”（也就是AI模型）和登录方式。这就像给手机选一个最聪明、最新的系统，并且设置一个安全的锁屏密码。这样助手才不容易被坏人骗。
2. 选择工作文件夹：接着，告诉助手把它自己的文件和工具放在电脑的哪个文件夹里。默认会放在 ~/.openclaw/workspace 这个地方。
3. 设置网络大门（网关）：然后，设置一个“网络大门”，包括大门开在哪个“门牌号”（端口，默认是18789），以及进出大门的检查方式（比如用密码令牌）。你还可以选择是否用一个叫“Tailscale”的工具让大门能被朋友从外面找到。
4. 添加聊天频道：现在，添加你想用来聊天的地方，比如 WhatsApp、Telegram、Discord 等等。就像决定在哪个游乐场和助手一起玩。
5. 安装后台小精灵（守护进程）：为了让助手能一直在后台工作，需要安装一个“小精灵”。在苹果电脑上叫 LaunchAgent，在 Linux 电脑上叫 systemd。安装时，它会检查你的密码设置是否正确。
6. 健康检查：最后，向导会启动“网络大门”并检查它是不是在好好工作，就像医生给病人做检查一样。
7. 安装小工具（技能）：向导还会帮你安装一些推荐的小工具，让你的助手本领更大。

重要提醒： 重新运行向导 (openclaw onboard) 不会删除你已经设置好的东西，除非你明确选择了“重置”或者加了 --reset 这个命令。如果向导发现你的设置文件有问题，它会先让你运行 openclaw doctor 命令来检查一下。

连接别人的网关（远程模式） 如果你只是想连接到一个已经运行在别处的“网络大门”，可以选择“远程模式”。这个模式只设置你电脑上的连接，不会去改动远处那台电脑上的任何东西。

添加另一个智能助手 如果你想要第二个智能助手，可以用 openclaw agents add <名字> 这个命令。它会创建一个全新的助手，拥有自己独立的工作文件夹和聊天记录。运行这个命令（不加 --workspace 参数）也会启动设置向导来帮你完成设置。