Skip to content

OpenClaw 配置

OpenClaw 是一个开源 AI 智能体平台,可以配置 model-go 作为模型提供商。

什么是 OpenClaw?

OpenClaw 是一个运行在本地的 AI 助手框架,支持:

  • 多渠道消息(Telegram、Discord、WhatsApp 等)
  • 工具调用(浏览器、文件系统、Shell 等)
  • 记忆系统和技能扩展

安装 OpenClaw

bash
npm install -g openclaw

配置 model-go 作为模型提供商

编辑 ~/.openclaw/openclaw.json,在 models.providers 中添加 model-go。

Anthropic 模型(Claude)

json
{
  "models": {
    "providers": {
      "model-go": {
        "baseUrl": "https://model-go.com",
        "apiKey": "你的 model-go 令牌",
        "auth": "api-key",
        "api": "anthropic-messages",
        "authHeader": true,
        "models": [
          {
            "id": "替换为模型广场中的 Claude 模型名称",
            "name": "替换为模型广场中的 Claude 模型名称",
            "api": "anthropic-messages",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192,
            "compat": {
              "supportsReasoningEffort": true,
              "maxTokensField": "max_tokens"
            }
          }
        ]
      }
    }
  }
}

OpenAI 模型(GPT / Codex)

json
{
  "models": {
    "providers": {
      "model-go-openai": {
        "baseUrl": "https://model-go.com/v1",
        "apiKey": "你的 model-go 令牌",
        "api": "openai-responses",
        "models": [
          {
            "id": "替换为模型广场中的 OpenAI 模型名称",
            "name": "替换为模型广场中的 OpenAI 模型名称",
            "api": "openai-responses",
            "reasoning": true,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

Google 模型(Gemini)

json
{
  "models": {
    "providers": {
      "model-go-gemini": {
        "baseUrl": "https://model-go.com/v1beta",
        "apiKey": "你的 model-go 令牌",
        "auth": "api-key",
        "api": "google-generative-ai",
        "models": [
          {
            "id": "替换为模型广场中的 Gemini 模型名称",
            "name": "替换为模型广场中的 Gemini 模型名称",
            "api": "google-generative-ai",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 65536
          }
        ]
      }
    }
  }
}

配置说明

字段说明
baseUrlAnthropic 模型用 https://model-go.com;OpenAI 模型用 https://model-go.com/v1;Gemini 模型用 https://model-go.com/v1beta
apiKey您在 model-go 创建的 API 令牌
apiAPI 协议:anthropic-messagesopenai-responsesgoogle-generative-ai
auth认证方式,设为 api-key
authHeaderAnthropic 模型需设为 true
models模型列表,包含 id、名称、能力等信息

使用模型

配置完成后,可以在 OpenClaw 中使用模型别名引用:

text
# 格式:provider名/model名
model-go/替换为模型广场中的 Claude 模型名称
model-go-openai/替换为模型广场中的 OpenAI 模型名称
model-go-gemini/替换为模型广场中的 Gemini 模型名称

在 OpenClaw 配置中设置默认模型:

json
{
  "models": {
    "default": "model-go/替换为模型广场中的 Claude 模型名称"
  }
}

应用配置

修改 openclaw.json 后,需要重启网关使配置生效:

bash
openclaw gateway restart

提示

OpenClaw 支持模型热切换。配置多个提供商后,可以随时在对话中用 /model 命令切换不同的 AI 模型。

故障排除

模型切换失败

如果配置了新模型但 OpenClaw 无法识别或切换,可能是模型缓存文件过期。

解决方法:

bash
rm ~/.openclaw/agents/main/agent/models.json
openclaw gateway restart

连接失败

  • 确认 baseUrl 正确
  • 确认 apiKey 有效且令牌分组包含对应模型
  • 运行 openclaw gateway restart 重新加载配置