OpenClaw 接入

OpenClaw 支持自定义 Provider。模型引用必须使用 provider/model 格式，本页统一使用 Provider ID niuapi。

Provider IDniuapi

API 类型openai-completions

Base URLhttps://api.reniuniu.win/v1

默认模型niuapi/YOUR_MODEL_ID

方法一：使用 Control UI

1. 启动 OpenClaw Gateway；
2. 运行 openclaw dashboard 打开 Control UI；
3. 进入 AI 与代理 → Models → Model Providers；
4. 新增 Provider，填写 ID、Base URL、API Key 和模型 ID；
5. 保存后，在 Default models 中选择 niuapi/YOUR_MODEL_ID。

第一次进入时会显示 No custom entries。点击右上角 Add Entry 创建 Provider。

OpenClaw Model Providers 表单。按图填写 Provider ID、API Adapter 和 Base URL，再粘贴牛API专用 Key。

图中的关键字段应为：

字段	填写值
Provider ID	niuapi
API Adapter	openai-completions
API Key	你的专用牛API Key
Base URL	https://api.reniuniu.win/v1

Test connection 会发起真实 Provider 探测，可能消耗少量 Token。确认字段无误后再点击，不要连续重复测试。

方法二：编辑配置文件

配置文件通常位于 ~/.openclaw/openclaw.json。在现有 JSON5 配置中合并以下字段，不要整文件覆盖：

{
  agents: {
    defaults: {
      model: { primary: "niuapi/YOUR_MODEL_ID" }
    }
  },
  models: {
    mode: "merge",
    providers: {
      niuapi: {
        baseUrl: "https://api.reniuniu.win/v1",
        apiKey: "${NIUAPI_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "YOUR_MODEL_ID", name: "牛API模型" }
        ]
      }
    }
  }
}

先设置环境变量 NIUAPI_API_KEY，不要把真实 Key 写进配置文件。

验证配置

openclaw config validate
openclaw models list
openclaw models set niuapi/YOUR_MODEL_ID

然后只在本机发送一次纯文本请求。确认基础回复和控制台用量后，再连接消息平台或开放工具。

常见问题

现象	处理
配置无法加载	运行 openclaw config validate，检查 JSON5 层级
模型不显示	models.providers.niuapi.models 中必须存在相同 ID
模型名错误	使用 niuapi/YOUR_MODEL_ID，不要只写模型 ID
401	确认 Gateway 进程继承了 NIUAPI_API_KEY
工具循环	停止 Gateway，关闭工具和自动重试

先不要连接外部通道

在工具调用未验证前，不要连接公开群聊、生产 Webhook、Shell、浏览器或文件删除权限。