OpenClaw API Key 和模型怎么配
2026 安装配置保姆教程
OpenClaw 安装完成后，若模型未连通，它只是一个空壳。API Key 填错、本地推理服务未启动、默认模型与任务不匹配，都会让你误以为 OpenClaw 本身坏了。本文仍是 2026 完整安装配置保姆教程，只是把模型、密钥与首次验收这条链路讲透：云端与本地怎么选、密钥怎么存、Dashboard 如何证明真的在调模型。
Key → provider → 模型名 → 网络 → 日志
Dashboard 与探活入口
云端 / 本地 / 混合
一安装完成 ≠ 模型能调用
OpenClaw 是否可用，很大程度取决于模型配置是否连通、密钥是否安全、默认模型是否匹配任务，而不只是 npm install -g openclaw 是否成功。网关进程起来、18789 探活通过，只说明「壳子在跑」；真正干活要靠 provider/model 引用与鉴权。下文在完整安装流程中，把这条链路单独讲透。
openclaw models status 或一次最小 Agent 调用确认上游有 HTTP 请求与 token 消耗。
二安装前：模型与密钥准备
动手前备好：① 当前版本支持的 provider 列表（以官方文档为准）；② 云端 API Key 及环境变量名；③ 若用本地推理，先确认兼容 HTTP 端点已监听、内存够用；④ 网络能访问 provider 或本机端口。混合部署要分清网关与推理各在哪台机器。
三官方安装与初始化
安装 Node 24 与 CLI 后执行 openclaw onboard（可加 --install-daemon），写入默认模型与网关。核对 node -v 与 launchd 是否继承环境变量——否则重启后 Key 失效。Node/18789 细节见
冷启动教程。
四云端模型与 API Key
内置 provider 通常只需鉴权：openclaw onboard --auth-choice openai-api-key（选项以向导为准），或 export OPENAI_API_KEY="sk-your-placeholder" 后 openclaw models set provider/model。自定义代理写 models.providers，Key 用 ${ENV} 占位。验证：openclaw models status。
五本地模型接入
适合隐私与控成本场景，性能因硬件而异。在 models.providers 填本机 baseUrl（如 http://127.0.0.1:PORT/v1）与模型 id。先 curl 端点、再起 OpenClaw。
六三种方式怎么验收
| 验收项 | 云端模型 | 本地模型 | 混合 |
|---|---|---|---|
| 鉴权 | models status 显示 provider 已认证 |
本地端点无需 Key 或仅内网 Token | 两套配置均需在 status 中可见 |
| 连通 | 外网可达 provider API | curl 本机 baseUrl |
分别探活，勿混用排错顺序 |
| Dashboard | 18789 健康 + 会话有上游请求 | 日志见本地 HTTP 调用 | 主模型云端、敏感步骤走本地常见 |
| 成本 / 隐私 | 按调用计费，数据出网 | 电费与硬件，数据留本机 | 需明确哪些任务走哪条链路 |
Dashboard 默认 127.0.0.1:18789，看网关状态与日志；能开页面却无响应，按上表逐项查。
七首次实战验收
openclaw agent --local --session-id smoke-test --message "只回复：模型连通 OK" --timeout 90 —— JSON 中 provider/model 正确且日志有出站请求，即模型链路通过。
八模型排错：别和安装问题混在一起
openclaw models list 核对 provider/model 拼写；自定义 provider 检查 models.providers.*.models[].id。lsof -iTCP:18789，再查 launchd；与模型 API 无关，勿先换 Key。九后续维护
定期轮换 Key、用 models list 跟 catalog 变更、监控账单；新增 provider 后需 openclaw models set 才改默认主模型。
- ①安装前先备 Key、网络与（可选）本地端点
- ②
onboard→models status→ Dashboard → 最小 Agent 四步验收 - ③排错顺序：Key → provider → 模型名 → 网络/本地服务 → 日志
- ④密钥永不进仓库；模型问题与端口/权限问题分开查
在 Mac mini 上跑通模型链路更顺
网关与本地推理在 macOS 上路径清晰：Node 24、launchd、环境变量继承一体。Mac mini M4 统一内存适合中等本地模型试验，约 4W 待机适合 7×24；Gatekeeper / FileVault 也利于收敛 Key 暴露面。现在即可入手，让 onboard 与 Dashboard 验收真正跑稳。