跳转到主要内容
千问云 home page
开放平台文档
客户端与工具

Hermes Agent

在 Hermes Agent 中使用千问云模型

安装 Hermes Agent

  1. 在终端中执行以下命令，安装脚本会自动安装 Python、Git 等依赖。
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Windows 不支持原生安装，请先安装 WSL2，在 WSL2 中运行以上命令。
  1. 安装完成后，重新加载终端环境。
source ~/.bashrc    # 如果使用 zsh，改为 source ~/.zshrc
  1. 验证安装是否成功。
hermes --version
若输出版本号，则安装成功。

配置 Token Plan 团队版

Hermes Agent 兼容 OpenAI 协议，通过 hermes config set 命令配置 Token Plan 团队版的 Base URL 和 API Key。
  1. 获取 Token Plan 团队版专属 API Key。 在 Token Plan 团队版页面获取专属 API Key。
  2. 在终端中依次执行以下命令，配置模型提供商、Base URL、API Key 和默认模型。将 YOUR_API_KEY 替换为实际的 Token Plan 团队版 API Key。 
hermes config set model.provider custom
hermes config set model.base_url https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.6-plus
以上命令将配置写入 ~/.hermes/config.yaml。也可以直接编辑该文件，写入以下内容： 
model:
  default: qwen3.6-plus
  provider: custom
  base_url: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
  api_key: YOUR_API_KEY

配置按量计费

将 YOUR_API_KEY 替换为千问云 API Key。可用模型请参考支持的模型。
配置项说明
Base URLhttps://dashscope.aliyuncs.com/compatible-mode/v1
API Key千问云 API Key（格式为 sk-xxxxx）
可用模型支持的模型
hermes config set model.provider custom
hermes config set model.base_url https://dashscope.aliyuncs.com/compatible-mode/v1
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.6-plus
以上命令将配置写入 ~/.hermes/config.yaml。也可以直接编辑该文件，写入以下内容：

切换模型

配置完成后，可以通过 -m 参数在对话时切换模型。 
hermes chat -m qwen3.6-plus
也可以通过 hermes config set 修改默认模型： 
hermes config set model.default qwen3.6-plus
Token Plan 团队版支持的模型详见 Token Plan 团队版概述。
文本模型（如 qwen3.6-plus、glm-5 等）可直接使用。图像生成模型需通过 Skill 接入，参见下方「接入图像生成模型」章节。

接入图像生成模型

通过 Hermes Agent 的 Skill 机制，可以调用 Token Plan 团队版的图像生成模型（qwen-image-2.0、wan2.7-image 等）。

步骤一：配置环境变量

将 Token Plan 团队版专属 API Key 设置为环境变量 TOKEN_PLAN_API_KEY。 
# 添加到 ~/.bashrc 或 ~/.zshrc
export TOKEN_PLAN_API_KEY="YOUR_API_KEY"

步骤二：创建 Skill

创建文件 ~/.hermes/skills/media/text-to-image/SKILL.md，写入以下内容： 
---
name: text-to-image
description: "Generates images from text descriptions using Token Plan multimodal generation API (qwen-image-2.0, wan2.7-image, etc.). Triggers when the user asks to draw, generate, or create an image."
version: 1.0.0
---

# Text-to-Image Generation

Generate images from text prompts via the Token Plan DashScope-compatible API.

## Trigger

Activate this skill when the user requests image generation.

## Pipeline

1. Extract parameters: prompt, model (default: qwen-image-2.0), size (default: 1024*1024).
2. Call the API:

```bash
curl -s -X POST "https://token-plan.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation" \
  -H "Authorization: Bearer $TOKEN_PLAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<model>",
    "input": {"messages": [{"role": "user", "content": [{"text": "<prompt>"}]}]},
    "parameters": {"size": "<size>"}
  }'
```

3. From the response JSON, extract `output.choices[*].message.content[*].image` URLs and download.
4. Report the saved file path to the user.

## Models

| Model | Notes |
|-------|-------|
| qwen-image-2.0 | Default, good at Chinese text rendering |
| qwen-image-2.0-pro | Higher quality |
| wan2.7-image | Multi-style, returns 4 images by default |
| wan2.7-image-pro | Supports 4K output |

## Sizes

1024*1024, 720*1280, 1280*720. wan2.7-image-pro supports 2048*2048.

步骤三：使用

在 Hermes Agent 中描述图像需求（如"画一只猫"），Hermes Agent 会自动调用 text-to-image Skill 生成图片。

验证配置

执行以下命令，发送一条测试消息。 
hermes chat -q "你好"
如果返回正常的 AI 回复，则配置成功。 如需进入交互式对话模式，直接执行： 
hermes

常见问题

错误码

配置过程中遇到报错，请参考对应计费方案的常见问题文档：

配置后仍连接到 OpenRouter

Hermes Agent 默认使用 OpenRouter 作为推理提供商。接入 Token Plan 团队版时，model.provider 必须设置为 custom。请执行以下命令确认： 
hermes config set model.provider custom