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 驗收真正跑穩。