303 個模型 · 40 個模型廠商了解更多
CoreAPI × OpenClaw

配置
OpenClaw,
透過 CoreAPI

將 CoreAPI 用作 OpenClaw 的自訂模型提供商:一個 API、豐富的模型目錄,價格與官方一致。本指南對應最新 OpenClaw 接入流程(2026.3.8+),涵蓋安裝、提供商配置、驗證和模型切換。

~/.openclaw/openclaw.json
# 僅供參考——請在生產環境前根據您的 OpenClaw 版本驗證
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "coreapi-claude/claude-sonnet-4-5-20250929"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "coreapi-openai": {
        "baseUrl": "https://unixcore.io/v1",
        "apiKey": "${COREAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "deepseek-flash", "name": "DeepSeek Flash" }]
      },
      "coreapi-claude": {
        "baseUrl": "https://unixcore.io",
        "apiKey": "${COREAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" }]
      }
    }
  }
}
00 — 從這裡開始

指南範圍
與前置條件

指南概覽

透過 CoreAPI 配置 OpenClaw

將 CoreAPI 用作 OpenClaw 的自訂模型提供商,透過一個 API 以官方標價存取模型目錄。本頁對應最新 OpenClaw 接入流程(2026.3.8+)。

前置條件

前置條件

需要 Node.js >= 22 和 CoreAPI API 金鑰。對於常駐程式安裝,請將 COREAPI_KEY 存放在 ~/.openclaw/.env 中,以便 openclaw.json 透過 $COREAPI_KEY 引用而無需硬式編碼。

快速指令
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard

printf 'COREAPI_KEY=%s\n' 'your_coreapi_key' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env

新增 ~/.openclaw/.env 或編輯提供商設定後,使用 openclaw gateway restart重啟一次,然後執行診斷。在所有指令和工作階段中使用完整的 provider/model 引用。版本升級後請重新檢查 設定參考.

01 — 提供商設定說明

為什麼一個 CoreAPI 金鑰
需要兩個提供商

基於 API 格式的提供商路由
OpenClaw 按 API 相容性(而非僅供應商標籤)進行路由,因此需要為 openai-completions 和 anthropic-messages 分別設定提供商。
單一金鑰,多提供商設定
保持單一 COREAPI_KEY,在 coreapi-openai、coreapi-claude 區塊中複用。所有地方均使用完整的 provider/model 引用。
當前流程驗證
執行一次引導程式,在變更後重啟閘道,然後透過 models status、provider 範圍的 models list 和 doctor 診斷進行驗證。
02 — 接入 OpenClaw

安裝、引導、設定、
驗證、切換

版本感知說明

OpenClaw 使用 ~/.openclaw/openclaw.json 作為您編輯的來源設定檔。自訂提供商將被實體化為每個 agent 的 models.json 檔案,位於 ~/.openclaw/agents/<agentId>/下。升級後請使用 設定參考 和 環境變數 指南重新檢查金鑰和行為。CoreAPI 的 base URL 僅以 即時檔案中的定義為準。

01 安裝或更新 OpenClaw
推薦:curl -fsSL https://openclaw.ai/install.sh | bash。或者如果您保持全域 npm 安裝,使用 npm install -g openclaw@latest。
02 執行一次引導程式
執行:openclaw onboard --install-daemon。在 Model/Auth 中選擇 Skip 進行基礎安裝,除非需要否則保持預設工作區,讓精靈完成常駐程式和健康檢查。
03 存放 COREAPI_KEY
對於常駐程式安裝,將 COREAPI_KEY 附加到 ~/.openclaw/.env 並執行 chmod 600。如果您已有 shell/服務金鑰工作流程,繼續使用即可。
04 在 openclaw.json 中新增 {brand} 提供商
新增 coreapi-openai(openai-completions)、coreapi-claude(anthropic-messages),然後將 primary 設為 coreapi-claude/claude-sonnet-4-5-20250929。
05 重啟並驗證
執行 openclaw gateway restart,然後執行 openclaw models status、openclaw models list --provider coreapi-claude 和 openclaw doctor。CoreAPI 提供商不應出現設定架構/驗證錯誤。
06 使用 provider/model 切換模型
使用 openclaw models set coreapi-claude/claude-sonnet-4-5-20250929 設定預設模型。在對話中,透過 /model coreapi-openai/deepseek-flash 切換。
07 選用:全新重新安裝
如果在修復舊的損壞安裝,請停止閘道,刪除 ~/.openclaw,重新執行引導程式,然後重新套用 CoreAPI 設定。這將重置本地設定、工作階段、記錄和驗證狀態。
設定片段(合併到 openclaw.json)
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "coreapi-claude/claude-sonnet-4-5-20250929"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "coreapi-openai": {
        "baseUrl": "https://unixcore.io/v1",
        "apiKey": "${COREAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "deepseek-flash", "name": "DeepSeek Flash" }]
      },
      "coreapi-claude": {
        "baseUrl": "https://unixcore.io",
        "apiKey": "${COREAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" }]
      }
    }
  }
}

基礎設定無需手動建立 auth-profiles.json。在提供商中使用 ${COREAPI_KEY} ,並透過 ~/.openclaw/.env、shell 或服務管理器注入變數。

03 — 參考定價

即時費率以
CoreAPI 官網為準

下表使用示意性的每百萬 Token 價格。模型目錄、定價和 SLA 以 CoreAPI 目前條款為準。 CoreAPI 檔案與主控台 當前顯示的資料為準。

04 — 常見問題

整合前請先
查看這些問題

此設定需要 auth-profiles.json 嗎?

基礎設定不需要。OpenClaw 可以透過 $COREAPI_KEY 從 models.providers.*.apiKey 解析提供商 apiKey。僅在需要按配置檔案存放金鑰或金鑰輪換時才使用 auth-profiles.json。

為什麼一個供應商需要 2 個提供商條目?

OpenClaw 按 API 格式相容性路由。請為 openai-completions 和 anthropic-messages 保持獨立條目。

設定實際在哪裡編輯和實體化?

編輯 ~/.openclaw/openclaw.json。自訂提供商在同步/載入後會實體化為 ~/.openclaw/agents/<agentId>/ 下每個 agent 的 models.json。

本指南使用哪些模型 ID?

deepseek-flash、claude-sonnet-4-5-20250929。您可以將 CoreAPI 模型頁面上的任意模型新增到對應的提供商區塊中。

CoreAPI × OpenClaw | OpenAI 相容 API 與智能體閘道 - 所有 AI 模型均包含在一個 API 中 - CoreAPI