在 Hermes Agent 中配置与使用阿里云百炼 Token Plan 团队版。
安装 Hermes Agent
在终端中执行以下命令，安装脚本会自动安装 Python、Git 等依赖。
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash说明Windows 不支持原生安装，请先安装 WSL2，在 WSL2 中运行以上命令。
安装完成后，重新加载终端环境。
source ~/.bashrc # 如果使用 zsh，改为 source ~/.zshrc验证安装是否成功。
hermes --version若输出版本号，则安装成功。
配置 Token Plan 团队版
Hermes Agent 兼容 OpenAI 协议，通过 hermes config set 命令配置 Token Plan 团队版的 Base URL 和 API Key。
获取 Token Plan 团队版专属 API Key。
在Token Plan 团队版页面获取专属 API Key。
在终端中依次执行以下命令，配置模型提供商、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。也可以直接编辑该文件，写入以下内容：
切换模型
配置完成后，可以通过 -m 参数在对话时切换 Token Plan 团队版支持的模型。
hermes chat -m qwen3.6-plus也可以通过 hermes config set 修改默认模型：
hermes config set model.default qwen3.6-plusToken Plan 团队版支持的模型详见Token Plan 团队版概述。
编程工具仅支持文本/视觉理解类模型（如 qwen3.6-plus、kimi-k2.5 等），不支持语音和图像生成模型。
验证配置
执行以下命令，发送一条测试消息。
hermes chat -q "你好"如果返回正常的 AI 回复，则配置成功。
如需进入交互式对话模式，直接执行：
hermes接入图像生成模型
通过 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 生成图片。
错误码
请参考常见问题。
常见问题
API Key 认证失败（HTTP 401）
请确认以下几点：
确认使用的是 Token Plan 团队版专属 API Key，Token Plan 团队版、Coding Plan 和百炼按量计费的 API Key 互不相通。
Base URL 使用 Token Plan 团队版专属地址（
https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1）。Token Plan 团队版套餐未过期。
可执行以下命令查看当前配置：
cat ~/.hermes/config.yaml模型不支持（model is not supported）
Token Plan 团队版使用专属模型名称（如 qwen3.6-plus），请确认模型名称拼写正确。可参考Token Plan 团队版概述中的模型列表。
配置后仍连接到 OpenRouter
Hermes Agent 默认使用 OpenRouter 作为推理提供商。接入 Token Plan 团队版时，model.provider 必须设置为 custom。请执行以下命令确认：
hermes config set model.provider custom更多常见问题请参考常见问题。