第 1 步：运行 onboarding

如果安装脚本已经自动进入向导，你就继续往下走；如果没有自动进入，直接在终端里执行：

openclaw onboard --install-daemon

向导通常会让你在 QuickStart 和 Advanced / Manual 之间做选择：

• QuickStart：最适合新手，默认值更多，问题更少，也会自动生成 Gateway Token。
• Advanced：适合你已经知道自己要手动控制 bind、port、auth 或 remote URL 时再用。

如果你只是想先把系统跑起来，优先选 QuickStart。

第 2 步：先选一个最容易跑通的模型

第一次配置的思路应该是：先成功，再折腾更复杂的模型路线。对中国用户来说，可以按这个顺序理解：

最省心的内置路线：Z.AI（GLM）

openclaw onboard --auth-choice zai-api-key

官方示例默认模型是：

zai/glm-5

另一条内置路线：Volcengine（豆包）

openclaw onboard --auth-choice volcengine-api-key

官方示例模型是：

volcengine/doubao-seed-1-8-251228

Qwen 和 Kimi 更适合后面单独配置

Qwen 更接近插件 + OAuth 路线，Kimi 更接近 OpenAI-compatible custom provider。它们当然能用，但如果你现在的目标只是“先看到第一条回复”，不一定要把第一次成功压在它们身上。

第 3 步：确认 Gateway Token

Gateway Token 可以理解成你这套 OpenClaw 的第一道认证信息。官方向导默认会生成一个，就算你只是在本地用 localhost 跑也是一样。

如果你后面忘了 token，可以直接取回：

openclaw config get gateway.auth.token

如果当前还没有 token，也可以临时生成：

openclaw doctor --generate-gateway-token

第 4 步：理解 Workspace 只要记住一件事

对新手来说，不需要先把 Workspace 理解得很复杂。你只要先记住：

• 默认路径通常是 ~/.openclaw/workspace
• Onboarding 先确定它放在哪里
• 第一次 agent 真正运行时，才会把它进一步 bootstrapping 成一个可用工作区

也就是说，这一步你不用执着于“先在网页里建一个名字很复杂的工作区”，先让默认路径和第一次运行都正常就够了。

第 5 步：打开 Dashboard

完成 onboarding 以后，直接执行：

openclaw dashboard

本地默认地址是：

http://127.0.0.1:18789/

如果你是在远程服务器上，建议先执行：

openclaw dashboard --no-open
ssh -N -L 18789:127.0.0.1:18789 your_user@your_server_ip

然后在你自己的电脑浏览器里打开：

http://127.0.0.1:18789/

第 6 步：发第一条消息，确认系统真的能用

真正判断“首次配置是不是成功”，不是看欢迎页出来了没，而是看你能不能完成第一次正常对话。

1. 打开 Dashboard
2. 发送一条简单消息，比如：你好，我是 OpenClaw，新手测试
3. 如果模型正常回复，说明首次配置已经完成

如果没有回复，优先检查：

openclaw status
openclaw gateway status