OpenClaw 配置

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

什么是 OpenClaw？

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

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

安装 OpenClaw

npm install -g openclaw

配置 Clauddy 作为模型提供商

编辑 ~/.openclaw/openclaw.json，在 models.providers 中添加 Clauddy：

Anthropic 模型（Claude）

{
  "models": {
    "providers": {
      "clauddy": {
        "baseUrl": "https://clauddy.com",
        "apiKey": "sk-your-clauddy-token",
        "auth": "api-key",
        "api": "anthropic-messages",
        "authHeader": true,
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "claude-sonnet-4-6",
            "api": "anthropic-messages",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192,
            "compat": {
              "supportsReasoningEffort": true,
              "maxTokensField": "max_tokens"
            }
          },
          {
            "id": "claude-opus-4-6",
            "name": "claude-opus-4-6",
            "api": "anthropic-messages",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192,
            "compat": {
              "supportsReasoningEffort": true,
              "maxTokensField": "max_tokens"
            }
          }
        ]
      }
    }
  }
}

OpenAI 模型（GPT / Codex）

{
  "models": {
    "providers": {
      "clauddy-openai": {
        "baseUrl": "https://clauddy.com/v1",
        "apiKey": "sk-your-clauddy-token",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5.3-codex",
            "name": "gpt-5.3-codex",
            "api": "openai-responses",
            "reasoning": true,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

Google 模型（Gemini）

{
  "models": {
    "providers": {
      "clauddy-gemini": {
        "baseUrl": "https://clauddy.com/v1beta",
        "apiKey": "sk-your-clauddy-token",
        "auth": "api-key",
        "api": "google-generative-ai",
        "models": [
          {
            "id": "gemini-3.1-pro-preview",
            "name": "gemini-3.1-pro-preview",
            "api": "google-generative-ai",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 65536
          }
        ]
      }
    }
  }
}

配置说明

字段	说明
baseUrl	Anthropic 模型用 https://clauddy.com；OpenAI 模型用 https://clauddy.com/v1；Gemini 模型用 https://clauddy.com/v1beta
apiKey	您在 Clauddy 创建的 API 令牌
api	API 协议：anthropic-messages（Claude）、openai-responses（GPT）、google-generative-ai（Gemini）
auth	认证方式，设为 api-key
authHeader	Anthropic 模型需设为 true
models	模型列表，包含 id、名称、能力等信息

使用模型

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

# 格式：provider名/model名
clauddy/claude-sonnet-4-6
clauddy/claude-opus-4-6
clauddy-openai/gpt-5.3-codex
clauddy-gemini/gemini-3.1-pro-preview

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

{
  "models": {
    "default": "clauddy/claude-sonnet-4-6"
  }
}

应用配置

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

openclaw gateway restart

TIP

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

故障排除

模型切换失败

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

解决方法：

1. 删除模型缓存文件：

rm ~/.openclaw/agents/main/agent/models.json

2. 重启网关：

openclaw gateway restart

重启后 OpenClaw 会重新加载 openclaw.json 中的模型配置。

连接失败

• 确认 baseUrl 正确（Anthropic: https://clauddy.com，OpenAI: https://clauddy.com/v1，Gemini: https://clauddy.com/v1beta）
• 确认 apiKey 有效且令牌分组包含对应模型
• 运行 openclaw gateway restart 重新加载配置

更多信息请参考 OpenClaw 官方文档。