mixgateway.io

OpenClaw（Clawdbot）— 設定與 API 串接

OpenClaw 是什麼？

可在常見作業系統上執行的智慧體閘道，可連接 WhatsApp、Telegram、Discord、iMessage 等頻道；傳送訊息即可從多種介面取得代理回覆，更多頻道可透過外掛擴充。

最新功能與文件請見官方：OpenClaw。

1. 安裝 OpenClaw

依作業系統選擇流程。

指令碼安裝（建議）

macOS / Linux

  1. 安裝
curl -fsSL https://openclaw.ai/install.sh | bash
  1. 確認
openclaw --version

Windows（PowerShell）

說明： OpenClaw 的安裝程式常於 WSL2 內執行。請在 PowerShell 啟動 WSL，並在 WSL 內執行下列安裝。

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

確認：

openclaw --version

2. 初始化 OpenClaw

執行互動式精靈：

openclaw onboard

常見流程（實際用語可能隨版本而異）：

  1. 選擇 QuickStart
  2. 尚不需要廠商金鑰時可選 Skip for now
  3. 選擇 All providers（或與方案相符的選項）
  4. 不確定時選 Keep current
  5. 選用的聊天工具、skills 等步驟可先 Skip 完成引導
  6. 若精靈建議隱私／閘道相關選項，可依建議啟用

完成後可能會在瀏覽器開啟 閘道 Web 介面。

若閘道未執行：

openclaw gateway

2. 將 OpenClaw 連到 mixgateway.io

1. 取得閘道 API 金鑰

  1. 開啟 mixgateway.io 並登入。
  2. 在 [主控台](/dashboard) 開啟 API Keys（或同等項目）。
  3. 建立金鑰並複製；請求時使用 Authorization: Bearer … 存取閘道。

2. 編輯 openclaw.json

安裝後設定通常位於 OpenClaw 設定目錄（多為 ~/.openclaw）。

開啟資料夾

open ~/.openclaw

在 Windows + WSL 下，可於該目錄執行：

explorer.exe .

編輯 openclaw.json。將下列概念與現有檔案合併：設定指向 OpenAI 相容基底 URL https://api.mixgateway.io/v1 的 provider，並讓 agents.defaults.model.primary 使用該 provider 的模型 ID。

範例（請依 OpenClaw 版本調整名稱；結構參考 ApiSet 的 OpenClaw 文件 等）：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "mixgateway/deepseek:deepseek-chat"
      },
      "models": {
        "mixgateway/deepseek:deepseek-chat": {}
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "mixgateway": {
        "baseUrl": "https://api.mixgateway.io/v1",
        "apiKey": "PASTE_YOUR_GATEWAY_API_KEY_HERE",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek:deepseek-chat",
            "name": "deepseek-chat",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

注意事項：

  • 將 PASTE_YOUR_GATEWAY_API_KEY_HERE 換成主控台的真實金鑰。
  • 將 deepseek:deepseek-chat 改為閘道支援的任一模型（見 模型與路由）。
  • mixgateway 僅為此範例的 provider 鍵名 — 可重新命名，但須與 agents.defaults.model.primary 一致（providerKey/modelId）。

3. 重新啟動閘道

openclaw gateway restart

閘道介面應會反映新的 provider 與模型。

另請參閱

  • OpenClaw 概覽 — 為何與 mixgateway.io 一併使用 OpenClaw。
  • 快速開始 — 直接呼叫 https://api.mixgateway.io/v1/chat/completions。