接入 OpenClaw

使用 OpenClaw 自定义模型 Provider 接入 Nusabase API。

本指南用于把 OpenClaw 的模型调用接入 Nusabase API。Nusabase 的 OpenAI 兼容 Base URL 是 https://api.nusabase.com/v1。

​

适用场景

• 你需要在 OpenClaw 中显式管理多个模型 Provider。
• 你希望通过 /models 或 openclaw models list 查看模型。
• 你希望将默认模型固定为 Nusabase 网关中的模型。

​

前置条件

• 已安装 OpenClaw。
• 已准备 Nusabase API Key：sk-...。
• 当前网络可访问 https://api.nusabase.com。
• 示例模型 qwen3.5-flash、qwen3.5-plus 来自当前价格文档；实际可用模型以 GET /v1/models 返回为准。

​

先验证 Nusabase 接口

curl https://api.nusabase.com/v1/models \
  -H "Authorization: Bearer sk-你的_api_key"

curl https://api.nusabase.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.5-flash",
    "messages": [{"role": "user", "content": "hello"}],
    "stream": false
  }'

​

配置 Provider

OpenClaw 官方建议在修改 provider 或模型 allowlist 这类 map 时使用 --strict-json --merge，避免覆盖已有配置。

openclaw config set models.providers.nusabase '{
  "api": "openai-completions",
  "baseUrl": "https://api.nusabase.com/v1",
  "apiKey": "sk-你的_api_key",
  "models": [
    {"id": "qwen3.5-flash"},
    {"id": "qwen3.5-plus"}
  ]
}' --strict-json --merge

如果你的 OpenClaw 版本不支持整块 JSON 写入，也可以直接编辑 OpenClaw 配置文件中的 models.providers.nusabase，保持同样字段：

{
  "models": {
    "providers": {
      "nusabase": {
        "api": "openai-completions",
        "baseUrl": "https://api.nusabase.com/v1",
        "apiKey": "sk-你的_api_key",
        "models": [
          {"id": "qwen3.5-flash"},
          {"id": "qwen3.5-plus"}
        ]
      }
    }
  }
}

​

设置默认模型

openclaw models set nusabase/qwen3.5-flash

如启用了模型 allowlist，需要把模型加入 agents.defaults.models：

openclaw config set agents.defaults.models '{
  "nusabase/qwen3.5-flash": {},
  "nusabase/qwen3.5-plus": {}
}' --strict-json --merge

​

验证配置

openclaw models list --provider nusabase
openclaw models status
openclaw run "你好，请介绍一下当前项目"

验证通过标准：

• openclaw models list --provider nusabase 能看到 Nusabase 模型。
• openclaw models status 显示默认模型为 nusabase/qwen3.5-flash。
• openclaw run 能返回正常回答。

​

常见问题

问题	可能原因	处理方式
Model is not allowed	启用了 allowlist 但没有加入 Nusabase 模型	使用 agents.defaults.models 的 --merge 命令加入模型。
401	API Key 错误	重新设置 models.providers.nusabase.apiKey。
404	Base URL 错误	使用 https://api.nusabase.com/v1，不要填根地址。
模型列表为空	provider 未保存或模型 ID 不正确	先确认 /v1/models 返回值，再更新 models.providers.nusabase.models。

下一步可查看 错误码 了解 API 失败响应。

​

参考资料

• OpenClaw 配置与自定义 Provider
• OpenClaw Models CLI
• 首个请求示例
• 模型与价格
• 错误码