跳转到主要内容
🎉 限时免费 — MiniMax: MiniMax M3 Free 现在体验 🔥

OpenClaw

OpenClaw 是一款开源、自托管的个人 AI 助手。通过自定义 Provider，可以让 OpenClaw 使用 ModelGo 的 OpenAI 兼容接口调用模型。

接入前准备

  • 已安装 Node.js 22.22.3 或更高版本。
  • 已在 ModelGo 控制台创建 API Key。
  • 已在模型广场确认一个当前 API Key 可调用的逻辑模型名。

1. 安装 OpenClaw

macOS / Linux

bash
curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell

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

检查安装是否成功：

bash
openclaw --version

2. 设置 API Key

OpenClaw 配置支持从环境变量读取 Provider API Key。将 ModelGo API Key 设置为 MODELGO_API_KEY：

macOS / Linux（zsh）

bash
echo 'export MODELGO_API_KEY="YOUR_MODELGO_API_KEY"' >> ~/.zshrc
source ~/.zshrc

如果使用 Bash，将 ~/.zshrc 替换为 ~/.bashrc 或 ~/.bash_profile。

Windows PowerShell

powershell
[Environment]::SetEnvironmentVariable("MODELGO_API_KEY", "YOUR_MODELGO_API_KEY", "User")
$env:MODELGO_API_KEY = [Environment]::GetEnvironmentVariable("MODELGO_API_KEY", "User")

3. 配置 ModelGo Provider

创建并打开 OpenClaw 配置文件：

macOS / Linux

bash
mkdir -p ~/.openclaw
${EDITOR:-vi} ~/.openclaw/openclaw.json

Windows PowerShell

powershell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.openclaw"
notepad "$env:USERPROFILE\.openclaw\openclaw.json"

将下面内容粘贴到 openclaw.json，并将 YOUR_MODELGO_MODEL 替换为模型广场中的逻辑模型名：

json
{
  "models": {
    "mode": "merge",
    "providers": {
      "modelgo": {
        "baseUrl": "https://api.modelgo.com/v1",
        "apiKey": "${MODELGO_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "YOUR_MODELGO_MODEL",
            "name": "YOUR_MODELGO_MODEL",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "modelgo/YOUR_MODELGO_MODEL"
      }
    }
  }
}

配置项说明：

配置项ModelGo 填写内容
baseUrlhttps://api.modelgo.com/v1
apiKey${MODELGO_API_KEY}
apiopenai-completions
models[].idModelGo 逻辑模型名
agents.defaults.model.primarymodelgo/<逻辑模型名>

4. 启动并验证

保存配置后，在终端执行：

bash
openclaw onboard --install-daemon

查看当前模型和 Provider 状态：

bash
openclaw models status

如果状态正常，启动 Gateway：

bash
openclaw gateway start

在 OpenClaw 对话界面发送一条简单消息，例如“用三句话介绍这个项目”。能够正常返回结果，即表示 ModelGo 接入成功。

常见问题

找不到模型

确认 models.providers.modelgo.models[].id 与 agents.defaults.model.primary 中的模型名一致，并使用 modelgo/<模型名> 格式。

返回 401 或认证失败

检查当前终端是否存在 MODELGO_API_KEY，并确认 apiKey 使用 ${MODELGO_API_KEY}，没有多余空格。

返回 403 或模型不可用

确认模型 ID 是模型广场中、且当前 API Key 策略允许调用的逻辑模型名。

返回 404 或接口路径错误

baseUrl 应为 https://api.modelgo.com/v1，不要填写完整的 /chat/completions 地址；OpenClaw 会按 openai-completions 协议拼接路径。

Gateway 没有加载新配置

修改配置后重启 Gateway：

bash
openclaw gateway restart

相关文档