NexRouter · 帮助中心
客户端接入

在 OpenClaw 中使用 NexRouter

配置本站地址、密钥和模型,在 OpenClaw 中完成首次接入。

完成下面几步,就可以在 OpenClaw 中使用你的 NexRouter 密钥和模型。

还没安装?先看官方说明,安装好后再回来。

1. 准备三项信息

  • 接入地址:打开本站接入设置,复制本教程要求的地址。
  • API 密钥:到密钥管理创建或复制一把密钥。不要填写登录密码。
  • 模型 ID:从模型列表复制准确 ID,不要用展示名称代替。

地址和密钥要来自同一个站点:国内密钥配国内地址,海外密钥配海外地址。

2. 在 OpenClaw 中填写配置

复制下面的示例时,先替换这些内容;不要原样保留 YOUR_...:

示例中的文字换成什么
YOUR_API_BASE_URL接入设置中的 OpenAI Base URL,保留 /v1
YOUR_API_KEY刚复制的完整 API 密钥
YOUR_MODEL_ID刚复制的模型 ID
YOUR_MODEL_NAME便于你识别的名称,也可以填写模型 ID

完成官方首次配置后,将这些字段合并到 ~/.openclaw/openclaw.json,保留原有配置:

~/.openclaw/openclaw.json
{
  models: {
    providers: {
      nexrouter: {
        baseUrl: "YOUR_API_BASE_URL",
        apiKey: "${NEXROUTER_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "YOUR_MODEL_ID",
            name: "YOUR_MODEL_NAME",
          },
        ],
      },
    },
  },
  agents: {
    defaults: {
      model: {
        primary: "nexrouter/YOUR_MODEL_ID",
      },
    },
  },
}

baseUrl 保留 /v1。在启动进程的环境中设置 NEXROUTER_API_KEY;后台服务可通过权限受限的 ~/.openclaw/.env 提供,更新后重启对应网关。不要提交密钥文件。

export NEXROUTER_API_KEY='YOUR_API_KEY'
openclaw models list
openclaw models set nexrouter/YOUR_MODEL_ID

3. 发一句话试试

选择刚配置的模型,打开新对话,发送:

你好,请只回复:连接成功

看到正常回复,就完成了第一次连接。 接下来可以开始自己的任务。

如果没有收到回复,先看错误提示:

  • 401 / API Key 错误:重新复制完整密钥,确认地址与密钥属于同一站点。
  • 404 / 找不到接口:对照上面的地址格式,检查是否多写或漏写了 /v1。
  • 找不到模型:重新复制模型 ID,并确认当前密钥有权使用它。

其他问题见常见问题。想先单独检查接口,可以使用首次调用示例。

想了解更多

安装、完整参数及高级功能请查阅 OpenClaw 官方文档。