OpenClaw安裝與配置指南之如何使用自定義模型提供商

發(fā)布時(shí)間：2026-05-22 12:02:56 作者：Jeff Me

我要評(píng)論

OpenClaw 是 2026 年初爆火的開(kāi)源本地 AI 智能體框架，這篇文章主要為大家詳細(xì)介紹了OpenClaw安裝與配置指南，以及如何使用自定義模型提供商，有需要的小伙伴可以參考一下

系統(tǒng)要求

操作系統(tǒng): Linux / macOS / Windows
Node.js: v18.0.0 或更高版本
npm: v9.0.0 或更高版本
內(nèi)存: 建議 2GB 以上

基礎(chǔ)安裝

安裝 Node.js 和 npm

使用 nvm (Node Version Manager) 安裝：

# 安裝 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 重新加載配置
source ~/.bashrc
# 安裝 Node.js
nvm install 22
nvm use 22

安裝 OpenClaw

# 全局安裝 OpenClaw
npm install -g openclaw

# 驗(yàn)證安裝
openclaw --version

初始化 OpenClaw

# 運(yùn)行初始化向?qū)?
openclaw onboard

初始化過(guò)程會(huì)：

創(chuàng)建配置目錄 ~/.openclaw/
生成默認(rèn)配置文件 openclaw.json
設(shè)置工作空間目錄
配置認(rèn)證令牌

配置自定義模型

配置文件位置

~/.openclaw/openclaw.json

添加自定義模型提供商

編輯 openclaw.json，在 models.providers 中添加新的提供商配置：

示例 1: OpenAI 兼容 API (如 CrazyRouter)

{
  "models": {
    "mode": "merge",
    "providers": {
      "crazyrouter": {
        "baseUrl": "https://crazyrouter.com/v1",
        "apiKey": "sk-your-api-key-here",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

示例 2: Anthropic 兼容 API (如 MiniMax)

{
  "models": {
    "providers": {
      "minimax": {
        "baseUrl": "https://api.minimax.io/anthropic",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "MiniMax-M2.1",
            "name": "MiniMax M2.1",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 15,
              "output": 60,
              "cacheRead": 2,
              "cacheWrite": 10
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

API 類型說(shuō)明

OpenClaw 支持兩種主要的 API 格式：

openai-completions: OpenAI Chat Completions API 格式

適用于: OpenAI, Azure OpenAI, 各種 OpenAI 兼容服務(wù)

anthropic-messages: Anthropic Messages API 格式

適用于: Anthropic Claude, 兼容 Anthropic API 的服務(wù)

設(shè)置默認(rèn)模型

在 agents.defaults.model 中設(shè)置主模型：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "crazyrouter/claude-opus-4-6"
      }
    }
  }
}

格式: <provider>/<model-id>

配置 API 密鑰

方法 1: 直接在配置文件中

{
  "models": {
    "providers": {
      "your-provider": {
        "apiKey": "your-api-key-here"
      }
    }
  }
}

方法 2: 使用環(huán)境變量

export OPENCLAW_PROVIDER_APIKEY="your-api-key-here"

方法 3: 使用認(rèn)證配置

{
  "auth": {
    "profiles": {
      "provider:default": {
        "provider": "your-provider",
        "mode": "api_key"
      }
    }
  }
}

頻道配置

Telegram 配置

獲取 Bot Token

在 Telegram 中找到 @BotFather
發(fā)送 /newbot 創(chuàng)建新機(jī)器人
按提示設(shè)置名稱和用戶名
獲取 Bot Token

配置 Telegram

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "your-bot-token-here",
      "dmPolicy": "pairing",
      "groupPolicy": "open",
      "streamMode": "partial"
    }
  }
}

配置說(shuō)明:

dmPolicy: 私聊策略 (pairing 需要配對(duì), open 開(kāi)放)
groupPolicy: 群組策略 (open 開(kāi)放, whitelist 白名單)
streamMode: 流式輸出模式 (partial 部分流式, full 完整流式)

Discord 配置

獲取 Bot Token

訪問(wèn) Discord Developer Portal
創(chuàng)建新應(yīng)用
在 Bot 選項(xiàng)卡中創(chuàng)建 Bot
復(fù)制 Token
啟用必要的 Intents (Message Content Intent)

配置 Discord

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "your-discord-bot-token",
      "groupPolicy": "open"
    }
  }
}

飛書 (Feishu) 配置

創(chuàng)建飛書應(yīng)用

訪問(wèn) 飛書開(kāi)放平臺(tái)
創(chuàng)建企業(yè)自建應(yīng)用
獲取 App ID 和 App Secret
配置權(quán)限和事件訂閱

安裝飛書插件

openclaw plugin install @m1heng-clawd/feishu

配置飛書

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_your_app_id",
      "appSecret": "your_app_secret",
      "connectionMode": "websocket",
      "dmPolicy": "pairing"
    }
  },
  "plugins": {
    "entries": {
      "feishu": {
        "enabled": true
      }
    }
  }
}

啟動(dòng)與管理

啟動(dòng) Gateway

# 啟動(dòng) WebSocket Gateway (默認(rèn)端口 18789)
openclaw gateway --port 18789

# 后臺(tái)運(yùn)行
openclaw gateway --port 18789 &

# 綁定到所有網(wǎng)絡(luò)接口
openclaw gateway --port 18789 --bind 0.0.0.0

查看狀態(tài)

# 查看健康狀態(tài)
openclaw health

# 查看服務(wù)狀態(tài)
openclaw status

# 查看會(huì)話列表
openclaw sessions

停止服務(wù)

# 停止 Gateway
openclaw gateway stop

# 或使用 systemctl (如果配置了服務(wù))
systemctl --user stop openclaw-gateway.service

升級(jí) OpenClaw

# 升級(jí)到最新版本
npm update -g openclaw

# 驗(yàn)證版本
openclaw --version

WebUI 訪問(wèn)

啟動(dòng) Gateway 后，可以通過(guò)瀏覽器訪問(wèn) WebUI：

http://localhost:18789

認(rèn)證令牌: 在 openclaw.json 的 gateway.auth.token 中查看

常見(jiàn)問(wèn)題

422 Unsupported request body 錯(cuò)誤

原因: API 請(qǐng)求格式不兼容

解決方案:

檢查 api 字段是否正確 (openai-completions 或 anthropic-messages)
確認(rèn)模型 ID 是否正確
驗(yàn)證 API 提供商是否支持該格式

端口已被占用

錯(cuò)誤: Address already in use

解決方案:

# 查找占用端口的進(jìn)程
lsof -i :18789

# 停止現(xiàn)有服務(wù)
openclaw gateway stop

# 或使用不同端口
openclaw gateway --port 18790

插件 ID 重復(fù)警告

警告: Duplicate plugin ID: feishu

解決方案: 這是已知的配置警告，不影響使用，可以忽略。

無(wú)法連接到 Gateway

錯(cuò)誤: disconnected [WS] unauthorized gateway token missing

解決方案:

檢查 Gateway 是否正在運(yùn)行: openclaw health
驗(yàn)證認(rèn)證令牌是否正確
檢查防火墻設(shè)置
嘗試使用 127.0.0.1 而不是 localhost

模型調(diào)用失敗

檢查清單:

API Key 是否正確
baseUrl 是否可訪問(wèn)
模型 ID 是否存在
API 格式是否匹配
網(wǎng)絡(luò)連接是否正常

配置文件完整示例

{
  "meta": {
    "lastTouchedVersion": "2026.2.15",
    "lastTouchedAt": "2026-02-18T00:00:00.000Z"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "openai": {
        "baseUrl": "https://api.openai.com/v1",
        "apiKey": "sk-your-openai-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-4",
            "name": "GPT-4",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 30,
              "output": 60,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 4096
          }
        ]
      },
      "anthropic": {
        "baseUrl": "https://api.anthropic.com",
        "apiKey": "sk-ant-your-key",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-3-5-sonnet-20241022",
            "name": "Claude 3.5 Sonnet",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 3,
              "output": 15,
              "cacheRead": 0.3,
              "cacheWrite": 3.75
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-3-5-sonnet-20241022"
      },
      "workspace": "~/.openclaw/workspace",
      "maxConcurrent": 4
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "your-telegram-bot-token",
      "dmPolicy": "pairing",
      "groupPolicy": "open"
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "your-generated-token"
    }
  }
}

有用的命令

# 查看幫助
openclaw --help
openclaw gateway --help

# 查看配置
cat ~/.openclaw/openclaw.json

# 查看日志
tail -f ~/.openclaw/agents/main/sessions/*.jsonl

# 測(cè)試 API 連接
curl -X POST https://your-api-endpoint/v1/chat/completions \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-model","messages":[{"role":"user","content":"test"}]}'

# 備份配置
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup

到此這篇關(guān)于OpenClaw安裝與配置指南之如何使用自定義模型提供商的文章就介紹到這了,更多相關(guān)OpenClaw安裝與配置內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！