⌘K

Goose

概述

Goose 可以连接 OpenAI 兼容接口. 将 Goose 的 OpenAI provider 指向 Vtrix host 和 chat completions path, 配置 Vtrix API Key, 再选择 Vtrix 模型 ID 即可.

环境要求

  • Goose CLI
  • Vtrix API Key, 在 设置 中创建
可选：使用 Vtrix Doctor

也可以先使用 Vtrix Doctor 检查本机 Base URL、API Key 和模型配置。已支持的工具，包括 OpenClaw 和 Hermes，可在确认后一键写入配置。

配置步骤

1

安装 Goose

• 使用官方安装脚本

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

安装完成后运行：

goose --version
2

配置 Vtrix API

Goose 的 OpenAI provider 会分开读取 OPENAI_HOST 和 OPENAI_BASE_PATH. 在 ~/.bashrc 或 ~/.zshrc 中加入：

export GOOSE_PROVIDER="openai"
export GOOSE_MODEL="gpt-5.5"
export OPENAI_API_KEY="YOUR_VTRIX_API_KEY"
export OPENAI_HOST="https://cloud.vtrix.ai"
export OPENAI_BASE_PATH="llm/chat/completions"

修改后请重启终端, 或执行：

source ~/.zshrc
Base URL

Vtrix 的 OpenAI 兼容 Base URL 是 https://cloud.vtrix.ai/llm. Goose 需要拆成 OPENAI_HOST=https://cloud.vtrix.ai 和 OPENAI_BASE_PATH=llm/chat/completions, 最终请求地址为 https://cloud.vtrix.ai/llm/chat/completions.

3

选择 Vtrix 模型

将 GOOSE_MODEL 设置为 Vtrix 模型 ID.

类型示例模型说明
高性能gpt-5.5通用代码与推理能力较强
标准gpt-5.4日常开发, 均衡
Qwenqwen3.7-max同样通过 Vtrix 接口路由

如需切换模型：

export GOOSE_MODEL="qwen3.7-max"
提示

在 模型页面 查看当前可用模型 ID. 请按页面展示的模型 ID 原样复制.

4

启动 Goose 会话

进入项目目录并启动 Goose：

cd /path/to/your/project
goose session

输入一个简单问题, 例如：

请用一句话总结当前项目.

如果 Goose 能正常回复, 说明请求已通过配置的接口到达 Vtrix. 也可在 Vtrix 设置 中查看账单或用量.

故障排查

报错：401 Unauthorized

原因： Vtrix API Key 未设置、设置错误, 或启动 Goose 的终端未加载环境变量.

处理：

echo $OPENAI_API_KEY

如果为空, 请检查 shell 配置并重新打开终端.

请求发往了错误地址

原因： OPENAI_HOST 或 OPENAI_BASE_PATH 缺失, 或仍然指向其他服务.

处理：

env | grep -E 'GOOSE_|OPENAI_'

确认 OPENAI_HOST 是 https://cloud.vtrix.ai, 且 OPENAI_BASE_PATH 是 llm/chat/completions.

报错：model not found

原因： GOOSE_MODEL 与 Vtrix 模型 ID 不一致.

处理： 前往 模型页面 复制正确的模型 ID, 然后更新 GOOSE_MODEL.

Goose 仍然使用旧 provider

原因： 之前的 Goose 配置仍在生效, 或当前 shell 未加载新的环境变量.

处理： 重启终端后运行：

goose configure

如果 Goose 询问使用哪个 provider, 选择 OpenAI provider.