在 Goose 中使用 NexRouter

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

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

1. 准备三项信息复制锚点链接

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

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

2. 在 Goose 中填写配置复制锚点链接

复制下面的示例时，先替换这些内容；不要原样保留 YOUR_...：

创建 ~/.config/goose/custom_providers/nexrouter.json（Windows：%APPDATA%\Block\goose\config\custom_providers\nexrouter.json）：

{
  "name": "nexrouter",
  "engine": "openai",
  "display_name": "NexRouter",
  "description": "NexRouter OpenAI-compatible endpoint",
  "api_key_env": "NEXROUTER_API_KEY",
  "base_url": "YOUR_API_BASE_URL/chat/completions",
  "models": [
    {
      "name": "YOUR_MODEL_ID"
    }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

这里的 base_url 要填完整 /v1/chat/completions 地址。在同一终端设置密钥并启动：

export NEXROUTER_API_KEY='YOUR_API_KEY'
goose session --provider nexrouter --model YOUR_MODEL_ID

3. 发一句话试试复制锚点链接

选择刚配置的模型，打开新对话，发送：

你好，请只回复：连接成功

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

如果没有收到回复，先看错误提示：

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

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

想了解更多复制锚点链接

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