背景介紹

OpenClaw（原 Clawdbot）是一個(gè)開源的 AI 代理框架，支持通過配置文件或 GUI 界面進(jìn)行靈活配置。安裝 OpenClaw 后，用戶可以通過修改工作目錄下的配置文件 openclaw.json 來接入不同的 LLM 模型提供商。

OpenClaw 支持眾多主流模型提供商，包括 OpenAI、Anthropic、Moonshot AI（Kimi）、OpenRouter、Vercel AI Gateway、Amazon Bedrock 等。完整的提供商目錄可參考官方文檔 模型提供商快速入門。

要使用自定義的提供商，需要通過 models.providers 配置進(jìn)行設(shè)置。這種方式允許用戶接入官方支持列表之外的其他兼容 OpenAI API 或 Anthropic 格式的模型服務(wù)。

接入配置說明

核心配置參數(shù)解析

OpenClaw 的模型配置主要分為兩個(gè)部分：models 字段用于定義提供商和模型信息，agents.defaults 用于設(shè)置默認(rèn)使用的模型。

以 Kimi（Moonshot AI）為例，完整的 JSON 配置如下：

{
  "agents": {
    "defaults": { 
      "model": { 
        "primary": "moonshot/kimi-k2.5" 
      } 
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "moonshot": {
        "baseUrl": "https://api.moonshot.ai/v1",
        "apiKey": "${MOONSHOT_API_KEY}",
        "api": "openai-completions",
        "models": [
          { 
            "id": "kimi-k2.5", 
            "name": "Kimi K2.5" 
          }
        ]
      }
    }
  }
}

關(guān)鍵參數(shù)說明

重要提示：providers 配置完成后，必須同步配置 agents.defaults.model.primary 字段，否則 OpenClaw 無(wú)法知道應(yīng)該使用哪個(gè)模型作為默認(rèn)主模型。

providers 內(nèi)部參數(shù)說明

接入模型 LongCat

LongCat 平臺(tái)介紹

LongCat 是一個(gè)美團(tuán)開發(fā)的大語(yǔ)言模型，同時(shí)提供了API 開放平臺(tái)，提供高性能的通用對(duì)話模型和深度思考模型。目前平臺(tái)支持以下模型：

賬號(hào)注冊(cè)與 API Key 獲取

1. 訪問 LongCat 開放平臺(tái) 注冊(cè)賬號(hào)
2. 新用戶注冊(cè)后可獲得 500 萬(wàn) Token 的免費(fèi)使用額度
3. 進(jìn)入 API Keys 頁(yè)面 創(chuàng)建并獲取 API Key
4. 在 用量信息頁(yè)面 可隨時(shí)查看 Token 消耗情況

完整配置示例

以下配置參考自 LongCat OpenClaw 配置文檔，展示了如何完整接入 LongCat 模型：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "longCat/LongCat-Flash-Chat"
      },
      "models": {
        "LongCat-Flash-Chat": {}
      },
      "workspace": "/Users/user/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "longCat": {
        "baseUrl": "https://api.longcat.chat/openai",
        "apiKey": "YOUR_API_KEY_HERE",
        "api": "openai-completions",
        "authHeader": true,
        "models": [
          {
            "id": "LongCat-Flash-Chat",
            "name": "LongCat-Flash-Chat",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 8192,
            "compat": {
              "maxTokensField": "max_tokens"
            }
          }
        ]
      }
    }
  }
}

配置說明：

• 將 YOUR_API_KEY_HERE 替換為從 LongCat 官網(wǎng)申請(qǐng)的實(shí)際 API Key
• contextWindow: 20000 表示支持 2 萬(wàn) Token 的上下文窗口
• maxTokens: 8192 表示單次響應(yīng)最大 Token 數(shù)
• 修改保存后配置立即生效，無(wú)需重啟服務(wù)

GUI 界面配置方式

除了直接修改配置文件，也可以通過 Web 控制頁(yè)面進(jìn)行可視化配置：

1. 訪問 http://127.0.0.1:18789 打開 OpenClaw Web 控制頁(yè)面
2. 進(jìn)入 Config → Models → Providers
3. 添加以下配置項(xiàng)：

效果演示

1.啟動(dòng)后現(xiàn)實(shí)AgentModel為我們自定義的LongCat-Flash

2.詢問具備的能力與使用的模型

3.完成本地桌面文件查找

（此處補(bǔ)充實(shí)際使用截圖）

注意事項(xiàng)

1. 配置文件位置：OpenClaw 的配置文件位于 ~/.openclaw/openclaw.json
2. WebUI 訪問地址：默認(rèn)訪問地址為 http://127.0.0.1:18789
3. 通信協(xié)議：OpenClaw 使用 WebSocket 進(jìn)行全雙工通信。如需通過 Chrome 開發(fā)者工具調(diào)試接口，可連接 ws://127.0.0.1:18789/
4. 配置生效：修改 openclaw.json 后保存即可立即生效，無(wú)需重啟 Gateway 服務(wù)

參考

• OpenClaw 模型提供商快速入門
• OpenClaw 模型提供商配置文檔
• LongCat 開放平臺(tái)
• LongCat OpenClaw 配置指南
• LongCat API Keys 管理頁(yè)面

到此這篇關(guān)于OpenClaw接入模型并基于WebUI完成智能操作的文章就介紹到這了,更多相關(guān)OpenClaw接入模型智能操作內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論