Agent 快速接入

在 OpenClaw 中接入 Tokatlas

設定 OpenClaw 使用的 Tokatlas 金鑰、端點與已開通模型。

開始之前

依 OpenClaw 官方文件安裝與初始化，並備份既有設定。

準備 Tokatlas API Key 與帳戶已開通模型。替換全部 YOUR_... 佔位值，合併設定前先備份既有內容。

連線設定

設定	內容
提供方名稱	Tokatlas
協定	Chat Completions
端點／Base URL	https://api.tokatlas.ai/v1
API Key	YOUR_TOKATLAS_API_KEY
Model ID	YOUR_TOKATLAS_MODEL_ID

設定步驟

1. 將下方設定合併至 ~/.openclaw/openclaw.json，保留其他 Agent 與提供方，兩處模型佔位值須替換為同一個已開通 ID。
2. 讓 OpenClaw 程序讀取 TOKATLAS_API_KEY。背景服務須在自身環境中取得變數，僅設定終端機不夠。
3. 使用已安裝版本的診斷功能驗證設定，依需要重啟閘道，並選取 Tokatlas 模型。

設定範例

{
  "models": {
    "mode": "merge",
    "providers": {
      "tokatlas": {
        "baseUrl": "https://api.tokatlas.ai/v1",
        "apiKey": "${TOKATLAS_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "YOUR_TOKATLAS_MODEL_ID",
            "name": "Tokatlas Model"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "tokatlas/YOUR_TOKATLAS_MODEL_ID"
      }
    }
  }
}

相容性說明

models.mode: merge 保留其他提供方。若 Agent 有模型允許清單或個別覆寫，也須同步更新。上下文長度與選用能力應依已確認的模型規格設定。

驗證與排錯

1. 開啟新對話，傳送「只回覆 OK」，確認收到文字回覆。
2. 到 Tokatlas 用量記錄確認同一時間有成功請求，且模型符合設定。
3. 需要工具時，再請客戶端列出測試目錄中的檔案；確認工具結果有回到對話。
4. 若第一步失敗，先依 API 使用入門直接測試金鑰與模型。直接呼叫成功後，再依下表排查客戶端設定。

問題	檢查項目
401／403	重新貼上 Tokatlas 金鑰，移除引號與空白，核對驗證模式及模型權限。
404	對照上表檢查完整 URL，移除重複的 /v1 或端點後綴。
未知模型	從可用列表複製完整 ID，儲存後在新對話中選取該模型。
工具失敗	模型能力與客戶端協定支援。
變更未生效	切換至 Tokatlas 提供方／profile，完全退出客戶端後重新開啟。

參考文件

• OpenClaw 官方文件
• Chat API
• Messages API
• Responses API