OpenClaw 自訂模型供應商

備份目前設定並確認協定

網站維護中。以下是規劃中的設定範例；api.ubtl.net 為預定網域，沒有執行真實 API 測試，也未確認 OpenClaw 可連線。使用前必須核實 OpenAI 相容請求路徑、所選協定、驗證方式與模型識別碼。

先找出目前設定檔與啟動中的設定檔案位置；一般設定可能位於 ~/.openclaw/openclaw.json，但應以目前使用的設定檔為準。停止相關工作或選擇合適維護時段，備份原檔，再合併以下區塊。這不是要求將整份既有設定替換成範例，尤其應保留其他供應商、工具權限與通訊設定。

合併供應商與模型參照

範例使用合法 JSON，models.mode 設為 merge，將 ubtl 加入供應商集合。api 的 openai-completions 是 OpenClaw 的介面選擇值，必須先確認對應協定得到服務支援；不要只因網址含 /v1 就假定相容。模型清單與 agents.defaults.model.primary 應使用同一個已確認識別碼，後者以供應商名稱作前綴。

apiKey 以 ${UBTL_API_KEY} 參照環境變數，不應改成寫入真實金鑰。請在真正啟動閘道的程序環境中，將 UBTL_API_KEY 設為之後取得的授權值；只有互動終端機設定變數，不代表背景服務也讀得到。YOUR_MODEL_ID 與模型顯示名稱不代表任何既定能力、上下文長度或價格。

需合併的 OpenClaw JSON 範例 · json

{
  "models": {
    "mode": "merge",
    "providers": {
      "ubtl": {
        "baseUrl": "https://api.ubtl.net/v1",
        "apiKey": "${UBTL_API_KEY}",
        "api": "openai-completions",
        "models": [
          {"id": "YOUR_MODEL_ID", "name": "UBTL model"}
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {"primary": "ubtl/YOUR_MODEL_ID"}
    }
  }
}

重新載入閘道與最小驗證

依安裝版本的操作文件重新載入或重新啟動閘道，先檢查 JSON 能解析、環境變數參照可解析且模型指向正確。等服務確認可用後，使用無外部副作用的測試工作階段傳送短提示，不啟用不必要的工具。若失敗，先查背景程序是否繼承金鑰，再查 /v1 拼接與介面選擇，最後核對模型權限。分享紀錄前移除認證內容；需要回復時還原備份並重新載入。