First configuration

首次配置只求一条稳链路,不求第一天全都配完。

这篇页面把首次配置收束成最短闭环:先确认 CLI 与运行时正常,再让 daemon、Dashboard、gateway status 和 doctor 顺序通过。先做低风险验证,再决定是否继续接模型与外部服务。

快速提示

首次配置的目标是稳定,不是一步到位。

先确认 daemon 与 Dashboard 正常,再谈 provider 和插件。

外部服务验证按需做,不要把第一天的链路拉得太长。

你将获得

内容风格

少废话,先给结果

先告诉你该做什么、会遇到什么,再给出最短可用路径。

阅读体验

能看懂,也能照着做

重点信息会被拆成清单、步骤和提示,减少第一次上手的理解成本。

页面重点

先把关键问题讲清楚

实用优先

Shortest path

首次配置的最小闭环检查单

按这个顺序做,能把“看起来装好了”和“真的可以继续配置”区分开。

先确认 `node -v`、`npm -v` 与 `openclaw --help` 都正常,再开始首次配置。
执行 `openclaw onboard --install-daemon`,先把 daemon 和 Dashboard 起步链路带起来。
打开 `openclaw dashboard`,优先完成 onboarding,不要一上来并行接太多 provider 或插件。
执行 `openclaw gateway status` 与 `openclaw doctor`,先确认环境健康,再进入外部服务验证。
只跑一个低风险验证任务:确认 Dashboard、gateway、doctor 都正常,而不是第一天就追求复杂自动化。

Stop scope creep

第一次配置先把边界收紧

越早把目标缩成一条可验证路径,后面排错越省时间。

今天先不做

不追求一次接完所有 provider、插件或消息渠道。

今天真正目标

确认 CLI、daemon、Dashboard 和 health check 形成一条可重复的最短链路。

继续前提

只有当状态命令和 doctor 都稳定通过,才值得进入更深的模型与工具配置。

Copy-ready command

首次配置建议按这组命令验证

建议按顺序执行;如果前一步没通过,不要继续往下堆命令。

openclaw --help
openclaw onboard --install-daemon
openclaw dashboard
openclaw gateway status
openclaw doctor
openclaw doctor --verify-external-services

Health signals

先看健康信号,再决定要不要继续扩功能

首次配置最容易犯的错,不是命令不会敲,而是 gateway 还没稳定、doctor 还有阻断项,就继续追求更复杂的功能链路。

Gateway 先在线

如果 `openclaw gateway status` 还没稳定返回运行中,就不要急着继续接模型、Skills 或浏览器自动化。

Doctor 没有阻断项

`openclaw doctor` 是首次配置前最便宜的验收动作。先把阻断项清掉,再决定要不要继续放宽权限。

外部服务按需验证

只有当你真的准备接模型或第三方服务时,再执行 `openclaw doctor --verify-external-services`,避免第一天把链路拉得过长。