OpenClaw · 原生客户端配置

适用环境

OpenClaw 原生桌面客户端（通过配置文件接入自定义 API Provider）。

配置步骤

第一步：找到配置文件

OpenClaw 的配置文件位于用户目录下：

~/.openclaw/openclaw.json

macOS / Linux：~/.openclaw/openclaw.json
Windows：C:\Users\你的用户名\.openclaw\openclaw.json

💡 如果该文件不存在，首次运行 OpenClaw 后会自动生成，您也可以手动创建。

第二步：添加万事屋 Provider

用文本编辑器打开 openclaw.json，在 models.providers 中添加万事屋的配置：

{
  "models": {
    "providers": {
      "wanshiwu": {
        "baseUrl": "https://maas.apiniclaw.com/v1",
        "apiKey": "sk-你的API Key",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" },
          { "id": "gpt-4o", "name": "GPT-4o" },
          { "id": "claude-opus-4-7", "name": "Claude Opus 4.7" },
          { "id": "claude-sonnet-4-20250514", "name": "Claude Sonnet 4" }
        ]
      }
    }
  }
}

配置说明

字段	说明
`baseUrl`	万事屋 API 地址，固定填 `https://maas.apiniclaw.com/v1`
`apiKey`	您在万事屋创建的 API Key（`sk-` 开头），如何创建？
`api`	接口协议类型，固定填 `openai-completions`
`models`	您要使用的模型列表，每个模型需要 `id`（模型标识）和 `name`（显示名称）

第三步：保存并重启

保存配置文件后，重启 OpenClaw 客户端即可在模型列表中看到万事屋提供的模型。

可选：添加更多模型

您可以在 models 数组中添加任意万事屋支持的模型，例如：

"models": [
  { "id": "gpt-4o", "name": "GPT-4o" },
  { "id": "gpt-4o-mini", "name": "GPT-4o Mini" },
  { "id": "gpt-5.4", "name": "GPT-5.4" },
  { "id": "claude-opus-4-7", "name": "Claude Opus 4.7" },
  { "id": "claude-sonnet-4-20250514", "name": "Claude Sonnet 4" },
  { "id": "claude-3-5-haiku-20241022", "name": "Claude 3.5 Haiku" },
  { "id": "gemini-2.5-pro-preview-05-06", "name": "Gemini 2.5 Pro" }
]

完整的模型列表请参考支持模型及分组。

常见问题

Q: 配置后模型列表没有变化？

请确认已保存文件并重启 OpenClaw。检查 JSON 格式是否正确（可用在线 JSON 校验工具检查）。

Q: 调用时报错 401 Unauthorized？

请检查 apiKey 是否填写正确，确保是完整的 sk- 开头的密钥。

Q: 如何同时使用多个 Provider？

在 providers 中添加多个键即可，OpenClaw 会自动合并所有 Provider 的模型：

"providers": {
  "wanshiwu": { ... },
  "another-provider": { ... }
}

原生客户端