安装成功,不等于已经进入可用状态
很多人看到服务起来了,就会直接去接渠道、装技能、跑工作流。
更稳的顺序通常是:
- 先把认证模式定死
- 先确认至少有一个模型入口
- 先明确更新通道
- 先跑一次 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