Hermes Agent需完成模型、工具、网关三项配置方可运行:执行hermes model配置大模型(如kimi-long-context)及API Key;运行hermes tools启用Web Search、File Editor、Shell Executor并配置各工具Key;再通过hermes gateway setup接入微信等消息通道,最后用hermes启动验证状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Hermes Agent安装完成后,必须完成模型、工具和网关三项核心配置才能真正运行起来,缺一不可——跳过任一环节都会导致启动报错或功能缺失。
配置主力大模型
打开终端,执行命令:hermes model,进入模型配置向导。
选择模型供应商(如DeepSeek、Kimi、Xiaomi等),按提示输入对应API Key;【Base URL务必留空或回车,默认即可,填错会导致连接超时】。
从列表中选中一个默认模型(推荐国内用户选kimi-long-context或deepseek-v4-pro),确认后自动保存配置。
这一步操作起来很简单,直接照着提示一步步选就行,但注意:如果API Key复制漏了最后一位字符,后续所有对话都会卡在“thinking…”状态,无任何错误提示。
启用并配置实用工具
在终端中运行:hermes tools。
第一步:选择「1. Enable tools」开启工具系统;
第二步:在多选界面用空格键勾选以下三项——Web Search(联网搜索)、File Editor(文件读写)、Shell Executor(终端命令执行);【务必勾选Shell Executor,否则无法执行本地脚本或调试命令】。
第三步:对已勾选的每个工具,逐个配置其API Key;以Web Search为例,推荐选Tavily(免费额度充足),填入从tavily.com申请的API Key即可。
统一LLM网关 - 一个API对接70+AI模型,使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
配置完任意一个工具后,按方向键下移到「Done」并回车,退出工具配置流程。
接入微信消息通道(网关配置)
执行命令:hermes gateway setup。
方法一:微信直连(推荐个人使用)
选择「Weixin」→ 输入「y」确认 → 复制终端输出的链接 → 用手机微信浏览器打开 → 扫码绑定。
方法二:飞书/Telegram等平台接入
需提前在对应开放平台创建应用、获取Bot Token与回调地址;执行命令后选择对应平台,粘贴Token和Webhook URL即可。
注意:微信扫码后若5分钟内未完成授权,链接自动失效,需重新执行hermes gateway setup。
验证配置是否生效
全部配置完成后,在终端输入:hermes 启动交互界面。
看到光标闪烁等待输入,且左上角显示「✅ Model: kimi-long-context|✅ Tools: 3|✅ Gateway: Weixin」即表示配置成功。
此时可直接输入「你好,帮我查一下今天北京天气」,Hermes会自动调用Web Search工具返回结果。

















