OpenClaw

OpenClaw 是一個 AI 程式開發助手命令列工具，支援透過自訂 Provider 接入 OpenAI 相容的 API 服務。官方推薦使用 openclaw onboard 設定精靈完成配置，也可以手動撰寫設定檔。

準備工作复制锚点链接

確保系統滿足以下要求：

• Node.js 22+ 版本
• macOS / Linux / Windows 系統
• 如果從原始碼建置，需要額外安裝 pnpm

安裝 Node.js复制锚点链接

macOS（使用 Homebrew）：

brew install node

其他系統：

前往 Node.js 官網下載 LTS 版本：https://nodejs.org/en/download

驗證安裝复制锚点链接

node -v
npm -v

注意： Windows 使用者建議在 WSL2 環境中執行 OpenClaw。

安裝 OpenClaw复制锚点链接

使用官方安裝腳本（推薦）：

macOS / Linux复制锚点链接

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell复制锚点链接

iwr -useb https://openclaw.ai/install.ps1 | iex

安裝腳本會自動偵測並補裝缺少的相依套件。如果你已經自行管理 Node 環境，也可以使用 npm 或 pnpm 安裝方式（詳見官方文件）。

啟動設定精靈复制锚点链接

執行精靈指令：

openclaw onboard

在精靈中依序填寫以下資訊：

• Provider 類型：選擇 Custom Provider
• Compatibility：選擇 OpenAI-compatible
• Base URL：https://aicentos.com/v1
• API Key：填寫你的 API Key
• Model ID：參考控制台「模型廣場」中的模型名稱
• Endpoint ID：建議填寫 aicentos

注意： API Key 直接填明文即可，不需要額外改成環境變數 OPENAI_API_KEY。

設定預設模型复制锚点链接

完成精靈後，將預設模型設定為：

aicentos/gpt-4o

這樣後續使用時會自動使用設定好的模型。

手動設定（可選）复制锚点链接

如果不使用精靈，可以直接撰寫 OpenClaw 的 provider 設定檔：

{
  "models": {
    "providers": {
      "aicentos": {
        "baseUrl": "https://aicentos.com/v1",
        "apiKey": "your_api_key_here",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4o", "name": "gpt-4o" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "aicentos/gpt-4o" }
    }
  }
}

設定中可以直接寫 API Key 明文，也可以使用環境變數參照（如果你更偏好 SecretRef 方式）。

驗證設定复制锚点链接

檢查模型狀態以確認接入成功：

openclaw models list
openclaw models status

如果能看到 aicentos/gpt-4o 並且狀態顯示正常，表示接入設定成功。

注意事項复制锚点链接

• OpenClaw 官方支援自訂 Provider 功能，可選擇 OpenAI-compatible 或 Anthropic-compatible 模式
• 對目前服務，推薦優先使用 OpenAI-compatible 模式
• 直接填寫 API Key 是預設做法；環境變數參照只是可選方案
• 如果希望用工具自動寫入設定，可以考慮使用 cc-switch 工具
• 官方文件還提供了其他安裝和設定方式，可依實際需求選擇

相關連結复制锚点链接

• 官方文件：https://docs.openclaw.ai/install/index