Windows 原生部署 Hermes Agent + 火山引擎 Agent Plan + Harness + 飞书机器人完整实战教程与踩坑总结

大家好，我是 GoodTime。最近成功在 Windows 上部署了 Hermes Agent，完整接入火山引擎 Agent Plan + Harness 联网搜索，并打通飞书机器人，同时增加了图片、视频生成等能力。以下是详细部署流程和踩坑总结。

一、准备工作

开通 Agent Plan
www.volcengine.com/activity/ag…
新建 API Key
console.volcengine.com/ark/region:…
- 配置模型及 Base URL
- 配置 Harness（可选）
- 创建 Agent Plan 个人版专属 API Key

二、安装 Hermes

Nous Research 为 Hermes Agent 推出了 Windows 原生支持（Early Beta）。Windows 10/11 用户现在只需在 PowerShell 中执行一行命令，即可完成安装，无需 WSL2、Cygwin 或 Docker。

安装命令：

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

该脚本会自动安装 Python 3.11、Node.js 22、Git 等全部依赖，数据统一存放至 %LOCALAPPDATA%\hermes 目录下。

安装完成后输入命令：

hermes chat

进入 Hermes 聊天界面，可查看当前已配置的工具和 Skills。

三、配置模型 / Agent Plan

输入命令：hermes model

Select Provider：选择 Custom endpoint(enter URL manually) （输入 36）
API base URL：https://ark.cn-beijing.volces.com/api/plan/v3
API Key：使用前面准备好的 Key
Model name：doubao-seed-2.0-pro（或其他支持的文本生成模型）
Context length in tokens：262144
Display name：volcengine-agent-plan

配置完成后重新启动 Hermes，进行简单聊天测试（如“你是谁”），看到正常回复且能看到 Token 消耗，即代表配置成功。

四、接入飞书机器人

1. 配置

输入命令：

hermes gateway setup

按照以下提示操作（完整保留中英文）：

Select a platform to configure（选择配置平台） ：11
How would you like to set up Feishu / Lark?（飞书设置方式） ：1
扫码，创建飞书智能助手，完成创建，命令行端捕获结果进入下一步
How messages should be authorized?（信息授权方式） ：1
How should group chats be handled?（群聊处理方式） ：1
Home chat ID：直接回车，暂不配置
继续回车，完成飞书配置
Install the gateway as a Scheduled Task service?（是否将网关作为计划任务服务进行安装） ：n

2. 测试
机器人对话输入：“介绍下你自己”

五、增加图片视频生成能力

图片和视频能力在相应页面下载 ZIP 压缩包，将解压后的文件粘贴至 ~/.hermes/skills/ 目录下即可。注意：导入 Skills 后要重启 Hermes。

1. 配置图片生成

下载地址：findskill.com/volcengine/…

测试示例：“生成一张代表这个季节的图片”

2. 配置视频生成

下载地址：findskill.com/volcengine/…

测试示例：“生成介绍火山引擎 Agent Plan 的视频”

除了视频生成也可以做攻略，生成PPT等
696

六、增加 Harness 能力

订阅 Agent Plan 套餐后可以领取免费的搜索额度，不同套餐赠送额度不同（Small 50 次、Medium 150 次、Large 400 次、Max 800 次）。

在控制台使用配置 - 配置 Harness 中领取权益并获取联网搜索 API Key。
通过 MCP 形式接入，编辑 .hermes/config.yaml 文件，添加以下配置：

mcp_servers:
  volcengine-search:
    args:
    - --from
    - git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_askecho_search_infinity
    - mcp-server-askecho-search-infinity
    command: uvx
    enabled: true
    env:
      ASK_ECHO_SEARCH_INFINITY_API_KEY: 你的联网搜索的APIKEY

3. 测试：在 Hermes 或飞书机器人中发送需要实时联网查询的问题。

七、部分踩坑总结

一句话总结：安装过程中遇到问题不要担心，可以直接复制错误信息给豆包或者常用大模型进行解答。

典型踩坑：

安装 Hermes 错误：本地已安装 Python 高版本，建议降低到 3.9 或直接使用官方安装脚本。
飞书配置未生成二维码：执行 pip install qrcode
扫码无反应：复制链接到浏览器手动创建飞书智能助手。
接入飞书后无响应：
检查 gateway 是否正常运行，可尝试重启。如果启动gateway有警告或错误信息，可以直接粘贴警告或错误信息到豆包等大模型即可，比如用户未授权：可以在.env(没有可新建)配置允许用户

FEISHU_APP_ID=你的飞书机器人APP_ID
FEISHU_APP_SECRET=你的飞书机器人APP_SECRET
FEISHU_DOMAIN=feishu
FEISHU_CONNECTION_MODE=websocket
FEISHU_ALLOW_ALL_USERS=false
FEISHU_ALLOWED_USERS=ou_xxxxxxx(警告日志会显示）
FEISHU_GROUP_POLICY=open

八、附录

1. 什么是 AFP
Agent 燃料值（Agent Fuel Point，简称 AFP）是 Agent Plan 套餐的统一用量计费单位，用于量化智能体资源的消耗。详细抵扣公式请参考官方文档。

2. 官方 CLI 命令参考
CLI Commands Reference | Hermes Agent

总结
通过 Hermes Agent + 火山引擎 Agent Plan 的组合，我们可以在 Windows 上快速搭建一个支持多模态（文字、图片、视频）、带实时联网搜索、并能落地到飞书机器人的强大智能体方案。整体部署体验不错，值得尝试。

部署过程中如果遇到其他问题，欢迎在评论区留言交流，一起玩转 Agent！

点赞 + 在看，支持更多实用干货～

Windows 原生部署 Hermes Agent + 火山引擎 Agent Plan + Harness + 飞书机器人 完整实战教程与踩坑总结