Goose 接入猫云
Goose 依赖模型的工具调用能力，能回复文本不等于工具链兼容。本页使用官方支持的 OpenAI 兼容接入方式；本站尚未逐个工具链验收，不保证所有模型可用。1
1. 准备
从官方安装指南安装 Goose。先备份现有 Goose 配置和自定义提供商文件，不使用 Reset 清空原设置。创建猫云密钥，确认余额、分组权限及模型广场的完整模型 ID。
2. 最小配置：内置 OpenAI 提供商
在 Linux/macOS 终端设置并启动新会话：
export OPENAI_API_KEY="REPLACE_WITH_API_KEY"
export OPENAI_HOST="https://api.nekocloud.vip"
export OPENAI_BASE_PATH="v1/chat/completions"
export GOOSE_PROVIDER="openai"
export GOOSE_MODEL="REPLACE_WITH_MODEL_ID"
goose session| 字段 | 含义 |
|---|---|
OPENAI_HOST | 仅主机根地址，不带 /v1 |
OPENAI_BASE_PATH | v1/chat/completions 请求路径 |
OPENAI_API_KEY | 实际密钥，不加 Bearer |
GOOSE_PROVIDER / GOOSE_MODEL | 提供商路由 / 完整模型 ID |
最终目标是 https://api.nekocloud.vip/v1/chat/completions。这与其他客户端直接填写 /v1 的 base 不同，不要拼出双重 /v1；密钥不要放进普通 config.yaml。1
3. 独立自定义提供商
需要保留其他 OpenAI 连接时，运行 goose configure → Custom Providers → Add A Custom Provider；选 OpenAI Compatible，名称 NekoCloud，启用认证并录入实际密钥，模型填真实 ID。官方自定义 JSON 示例的 base_url 是完整 Chat Completions URL，因此该路线填 https://api.nekocloud.vip/v1/chat/completions，不是内置路线的主机值。1
生成文件位于 Linux/macOS 的 ~/.config/goose/custom_providers/，真实字段包括 name、engine、api_key_env、base_url、models；使用向导生成，不猜上下文限制。不要把 api_key_env 当实际 Key，也不要混用上面的 OPENAI_* 配置。1
4. 模型、重载与闭环
更改后新建会话；桌面端可在 Settings → Models 切换并输入自定义模型。CLI 向导不支持任意自定义模型名，必要时使用 GOOSE_MODEL。1 确认所选提供商与 ID，先发简短问候，再仅允许文件读取扩展读取 README 并引用原句；拒绝写入和命令执行，检查工具结果、最终回答及文件未变。测试可能收费，须自行确认。
对照客户端 usage 与猫云用量记录中的时间、模型和 token；缺少统计不能当作零费用。Key 不进 Git、日志或截图，实际推荐隐藏输入；桌面进程未必继承终端变量。401 查凭证，404 查路径，工具失败查模型能力，停止重复重试。