简要总结
CLI Onboarding Reference
这页说明书是专门讲 openclaw onboard 这个命令的。你可以把它想成一个“开箱即用”的魔法向导，它会牵着你的手，一步一步帮你把 OpenClaw 这个聪明的机器人助手设置好。它会问你一些问题，比如你想让机器人用哪个大脑（模型），你想在哪些地方和它聊天（比如 Telegram、WhatsApp），然后帮你把所有东西都安装和启动起来。如果你已经设置过，它也会很聪明地发现，并问你是想保留、修改还是重新开始。
五岁小孩版解释
这个向导有两种模式。一种是“本地模式”，这是最常用的，它会帮你把机器人助手安装和设置在你自己的电脑上。另一种是“远程模式”，它只帮你把电脑连接到另一个地方的机器人助手，不会去碰那台远程的电脑。
本地模式会带你做这些事：
- 检查已有的设置：向导会先看看你的电脑里有没有以前设置过的记录。如果有，它会问你是想“保留”、“修改”还是“全部重置，重新开始”。这里要小心哦，选择“重置”会丢掉一些东西，除非你确定要重来，否则别选它。
- 设置大脑和密码（模型与认证）：这一步是告诉机器人助手，它要用哪个“大脑”来思考。就像给手机连上网络一样，你需要提供一些密码（比如 API Key）或者登录账号。向导支持很多种大脑，比如 OpenAI、Anthropic 等等。
- 选择工作文件夹（Workspace）：机器人助手需要一个地方来存放它的工具和记忆。向导会帮你创建一个默认的文件夹，就像给它一个专属的小房间。
- 设置网关（Gateway）：网关就像机器人助手的“大门”和“电话总机”。你需要决定这扇门开在哪个“门牌号”（端口）上，以及要不要上锁（认证）。向导建议你最好一直把锁打开，这样更安全。
- 添加聊天通道（Channels）：告诉机器人助手，你希望它能在哪些 App 里和你聊天，比如 Telegram、WhatsApp、Discord 等等。每个通道都需要一些简单的设置，比如告诉它机器人的密码（Bot Token）。
- 安装后台服务（Daemon）：为了让机器人助手能一直工作，即使在你不开电脑窗口的时候也能运行，需要把它安装成一个后台服务。向导会根据你的电脑系统（比如 macOS 或 Linux）自动帮你做好。
- 健康检查（Health Check）：设置完成后，向导会启动大门（网关），并检查一下机器人助手是不是一切正常，能接电话了。
- 安装技能（Skills）：机器人助手有一些额外的本领，叫做“技能”。向导会列出可用的技能，并帮你安装它们可能需要的一些小工具。
- 完成：最后，向导会给你一个总结，并告诉你接下来可以做什么，比如在手机或平板上使用它。
一些重要的提醒和限制：
- 小心重置：如果你在命令行里用了
--reset选项，它会默认清除配置、密码和聊天记录。如果你想连工作文件夹也一起清除，需要用--reset-scope full。 - 认证很重要：设置网关大门时，强烈建议你启用密码或令牌认证，这样只有知道密码的程序才能和你的机器人助手说话，更安全。
- 系统要求：安装后台服务时，在 macOS 上需要你已经登录了用户账户。在 Linux 上，向导会尝试让服务在你退出登录后也能运行，这可能需要输入一次电脑的超级密码（sudo）。
- 通道是插件：有些聊天通道（如 Mattermost）是以“插件”形式提供的。当你选择它们时，向导会先提示你安装这个插件。
- 无界面模式：如果你的电脑没有图形界面（比如一些服务器），向导会打印出一些特别的指令，教你怎么通过 SSH 隧道来访问控制界面，而不是直接打开浏览器。
关于远程模式：
如果你选择“远程模式”，向导只会帮你设置当前电脑，让它去连接一个已经在别处运行好的机器人助手大门（网关）。你需要知道那个大门的地址（URL），如果它有密码，也需要提供。它不会去安装或修改远程那台电脑上的任何东西。
关于“大脑”和“密码”的更多选择：
向导支持非常多种“大脑”（模型提供商）。除了常见的 OpenAI 和 Anthropic，还有像 MiniMax、Moonshot、AI Gateway 等等。设置密码（API Key）时，你可以选择直接粘贴保存，或者告诉机器人助手“密码存在电脑的一个环境变量里，你去那里找”。后一种方式在某些情况下更灵活。