OpenClaw 设置

选择自定义 Provider

从 OpenClaw 官方文档安装并完成基础设置。为运行 OpenClaw 的进程配置 WUDI_API_KEY，使用支持工具调用的模型。API 连接和你自己的消息渠道、工具权限是独立设置。

配置示例

在当前 OpenClaw 配置中合并下面的模型段落。文件路径以你的安装版本与活动 profile 为准；保留其他 Agent、渠道与鉴权配置。

{
  "models":{
    "mode":"merge",
    "providers":{
      "wudi":{
        "baseUrl":"https://wudiapi.com/v1",
        "apiKey":"${WUDI_API_KEY}",
        "api":"openai-completions",
        "models":[{"id":"gpt-5.6-sol","name":"GPT · WuDi API"}]
      }
    }
  },
  "agents":{"defaults":{"model":{"primary":"wudi/gpt-5.6-sol"}}}
}

openai-completions 是该工具对 Chat Completions 适配器的命名，并非让你调用旧的文本补全接口。若改用 Responses，须同时核对当前客户端和目标模型的协议支持。

验证

按当前版本提供的配置检查命令或界面验证，重新加载配置后开启新会话。先让 Agent 回答一个不调用工具的问题，再测试读取一个你允许访问的文件。核对 WuDi 日志中模型与分组是否正确。

排查

变量插值报错时检查运行服务是否真的读取到 WUDI_API_KEY。无模型时检查 Provider ID 与 primary 前缀一致。工具参数报错时检查适配器、模型能力和消息历史。不要通过对外开放管理界面或关闭鉴权处理模型连接失败。

恢复

将 primary 改回原值后，移除新增的 providers.wudi。如有多个 Agent，分别检查它们是否单独覆盖默认模型。

参考：OpenClaw 自定义提供商。