TOPIC / SETUP

OpenClaw 安装后第一步:先把认证、模型和 doctor 跑稳

安装成功不等于已经能用。真正值钱的第一步,是把网关认证模式、模型 API 入口、更新通道和 doctor 诊断这几个关键环节先逐项收稳。这页帮你按优先级完成安装后的首次配置,确保每个基础环节都验证通过,避免后续使用中反复遇到认证失败、模型不通或版本不一致等问题。

适合谁

  • 已经装好 OpenClaw,但还没有把基础链路跑稳
  • 第一次配置认证、模型和 doctor 的用户
  • 准备接渠道或技能前想先做基线验证的人

你还没有确认当前路径

这页可以继续读,但如果你想要更稳的下一步建议,先回首页回答那 3 个问题会更快。

当前阶段

Stabilize / 稳住基线

里程碑页

先把认证、模型、渠道和安全边界这些基础环节跑稳,再决定要不要继续扩权限和自动化。

风险等级

中风险

最近校验

已校验 · 2026-03-21

前置条件

2

安装成功,不等于已经进入可用状态

很多人看到服务起来了,就会直接去接渠道、装技能、跑工作流。
更稳的顺序通常是:

  1. 先把认证模式定死
  2. 先确认至少有一个模型入口
  3. 先明确更新通道
  4. 先跑一次 doctor

先显式设置认证模式

第一次最容易忽略的是:
你以为默认配置已经够安全,但实际上入口边界可能还不清楚。

这一步最重要的是明确:

  • gateway.auth.mode
  • 你现在用的是 token 还是 password

不要让它停留在“默认应该没问题”的状态。

具体操作:

openclaw config set gateway.auth.mode token
openclaw config set gateway.auth.token your-secure-token-here

验证:

openclaw config list | grep gateway.auth

应该能看到 gateway.auth.mode = token 和 token 的脱敏显示。

至少准备一个可用模型 API Key

如果你是本地或 Docker 路线,这一步更不能跳。
没有至少一个可用模型入口,很多后续动作都只是看起来服务起来了,但其实没法真正执行任务。

国内云或托管路线里,某些平台可能已经帮你预配了一部分模型入口。
但本地和 Docker 更需要你手动确认。

openclaw config set model.provider deepseek
openclaw config set model.api_key sk-***
openclaw config set model.name deepseek-chat

配完后验证模型是否可用:

openclaw doctor

如果 doctor 输出中模型状态显示为绿色(正常),说明 API Key 已生效。如果显示红色,先检查 Key 是否正确、网络是否通畅。

先把更新通道想清楚

安装之后,很容易继续沿用旧版本。
更稳的方式是先知道自己准备跟哪条更新通道:

openclaw update -channel stable
openclaw update -channel beta
openclaw update -channel dev

第一次上手通常先从 stable 更稳。

doctor 的作用不是“最后坏了再用”

doctor 更值的用法通常是:

  • 安装后先跑一遍
  • 配完认证和模型后再跑一遍
  • 出问题时用它先缩范围
openclaw doctor

必要时再决定要不要:

openclaw doctor --repair

一份够用的首次配置检查单

安装后第一步 checklist

1. 已显式设置 gateway.auth.mode
2. 已确定当前走 token 还是 password
3. 已确认至少一个模型入口可用
4. 已决定当前更新通道
5. 已执行 openclaw doctor

下一步

把下一步基线继续收稳

基础配置稳定后,先接一个真实渠道验证消息闭环。

打开下一步

路径进度

已完成 0 / 5 个里程碑

已看到 0 / 5 个关键节点

前置状态

先把安装路径跑通

先完成

还没满足

还差前置步骤

这一步会记为已查看,但要等前置步骤满足后再标记完成。