First configuration
首次配置只求一条稳链路,不求第一天全都配完。
这篇页面把首次配置收束成最短闭环:先确认 CLI 与运行时正常,再让 daemon、Dashboard、gateway status 和 doctor 顺序通过。先做低风险验证,再决定是否继续接模型与外部服务。
快速提示
首次配置的目标是稳定,不是一步到位。
先确认 daemon 与 Dashboard 正常,再谈 provider 和插件。
外部服务验证按需做,不要把第一天的链路拉得太长。
你将获得
内容风格
少废话,先给结果
先告诉你该做什么、会遇到什么,再给出最短可用路径。
阅读体验
能看懂,也能照着做
重点信息会被拆成清单、步骤和提示,减少第一次上手的理解成本。
页面重点
先把关键问题讲清楚
Shortest path
首次配置的最小闭环检查单
按这个顺序做,能把“看起来装好了”和“真的可以继续配置”区分开。
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-servicesHealth signals
先看健康信号,再决定要不要继续扩功能
首次配置最容易犯的错,不是命令不会敲,而是 gateway 还没稳定、doctor 还有阻断项,就继续追求更复杂的功能链路。
Gateway 先在线
如果 `openclaw gateway status` 还没稳定返回运行中,就不要急着继续接模型、Skills 或浏览器自动化。
Doctor 没有阻断项
`openclaw doctor` 是首次配置前最便宜的验收动作。先把阻断项清掉,再决定要不要继续放宽权限。
外部服务按需验证
只有当你真的准备接模型或第三方服务时,再执行 `openclaw doctor --verify-external-services`,避免第一天把链路拉得过长。
Official sources
这一页只优先采信 OpenClaw 官方起步与健康检查文档。
首次配置真正依赖的不是民间偏方,而是官方对 onboard、Dashboard、gateway 和 doctor 的最短验证顺序。
官方文档 · Getting Started
用于核对 onboard、Dashboard onboarding 与起步顺序。
https://docs.openclaw.ai/zh-CN/start/getting-started
官方文档 · Doctor & Health Check
用于核对 health check、阻断项与外部服务验证方式。
https://docs.openclaw.ai/zh-CN/config/doctor-and-health-check
官方文档 · 安装指南
用于核对首次配置前的 Node.js 运行时与环境准备基线。
https://docs.openclaw.ai/zh-CN/install?platform=linux