Hermes Agent安装配置含一键安装、百炼模型配置、飞书/微信接入及Windows依赖修复。执行irm ... | iex安装，hermes model配qwen-turbo，hermes gateway setup接飞书或微信，Windows需用uv装lark-oapi。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
一、一键安装 Hermes 核心程序
Windows 或 Linux 系统下，Hermes Agent 提供了高度自动化的安装入口，可绕过手动配置环境依赖的复杂流程。该步骤会统一拉取最新稳定版本，并内置检测与补全机制。
1、打开 PowerShell（Windows 建议以管理员身份运行）或终端（Linux/macOS），执行以下命令：
2、irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
3、脚本将自动识别系统并依次安装 Python 3.11+、Node.js 20+、Git、ripgrep 等必要组件，全程无需人工干预。
4、安装完成后，终端将自动启动交互式配置向导，此时可直接进入下一步。
二、模型配置：解决无响应与空输出问题
Hermes Agent 不自带模型，必须显式指定模型提供商及凭证，否则会出现“无响应”“消息发送后无回复”等典型故障。国内用户推荐使用阿里云百炼服务，兼容性好且中文理解稳定。
1、执行命令启动模型配置向导：hermes model
2、在提供商列表中选择：Custom endpoint (OpenAI compatible)
3、输入百炼 Base URL：https://dashscope.aliyuncs.com/compatible-mode/v1
4、粘贴从阿里云百炼控制台获取的 API Key（格式为 sk-xxxxxxxxxxxxxxxxxxxxxxxx）
5、默认模型选择：qwen-turbo（轻量、低延迟、适合日常指令）
6、全部确认后，配置将写入 ~/.hermes/config.yaml，无需手动编辑。
三、飞书机器人接入：跳过向导限制，直连 Gateway
当前 Hermes 配置向导未在消息平台列表中提供飞书选项，需绕过向导，单独调用 Gateway 模块完成渠道绑定。此方式确保凭证注入路径正确，避免权限错配。
1、新开一个 PowerShell 终端，执行：hermes gateway setup
2、在渠道列表中选择：Feishu
3、依次填入飞书开放平台创建应用后获得的：App ID 与 App Secret
使用AIsa生成图像与视频。仅需一个API密钥即可调用Gemini 3 Pro Image（图像）和Qwen Wan 2.6（视频）。
4、来源字段填：feishu（国内版）或 lark（海外版）
5、连接方式保持默认 websocket，直接回车
6、允许的 User ID 留空；在鉴权步骤中输入 1 表示不限制对话人
四、微信通道配置：扫码即连，规避 iLink 凭证失效
iLink Bot 是 Hermes 微信适配器的底层通信桥梁，其凭证具有时效性。若手动填写过期 token 或账户 ID，会导致长轮询中断、消息丢失。推荐优先使用扫码登录方式建立初始连接。
1、执行命令启动微信网关配置：hermes gateway setup
2、在渠道列表中选择：Weixin
3、终端将生成二维码（或提供 URL 链接），请使用微信手机版扫描
4、在手机端点击「确认登录」，完成身份绑定
5、成功后终端显示：微信连接成功, account_id=your-account-id
6、凭证自动保存至 ~/.hermes/weixin/accounts/ 目录，无需手动干预
五、关键依赖修复：Windows 下 lark-oapi 缺失问题
Hermes Gateway 在 Windows 上启动飞书通道时，常因虚拟环境中缺失 lark-oapi SDK 而报错退出。错误信息通常包含 “ModuleNotFoundError: No module named 'lark_oapi'”。该问题源于 Hermes 内置 venv 未预装飞书官方 SDK，需定向注入。
1、先定位 Hermes venv 中 Python 解释器路径：Get-Command hermes | Select-Object -ExpandProperty Source
2、根据返回路径，拼出 Scripts 目录下的 python.exe 全路径，例如：C:\Users\XXX\AppData\Local\hermes\hermes-agent\venv\Scripts\python.exe
3、执行 uv pip 安装命令（使用 Hermes 自带 uv 工具）：uv pip install lark-oapi --python "C:\...\python.exe"
4、安装完成后，再次运行 hermes gateway 即可正常加载飞书通道
