Hermes Agent 是 Nous Research 团队历时 9 个月打造的开源 AI 智能体，GitHub 上已收获 6.6 万星。它最大的特点是"自我进化"：完成任务后自动提炼可复用的 Skills，后续使用中持续改进。现在它已原生支持微信，扫个码就能连接。这篇文章带你从零完成安装和配置。

Hermes Agent 是什么

简单说，Hermes Agent 是一个开源的、可自托管的 AI 智能体。它可以部署在本地电脑或云端环境中长期运行，并接入 Telegram、Slack、Discord、WhatsApp、iMessage、飞书、钉钉、微信等常用聊天工具。你在任何一个对话框里直接和它对话，让它后台独立完成任务。

它区别于其他 Agent 的核心能力是学习闭环：完成复杂任务后，自动从中提炼出可复用的 Skills，保存为独立文档。后续使用中，这些 Skills 按需加载，根据新的使用反馈不断自我改进。

加上持久化的跨会话记忆、自然语言定义的定时任务、多个子代理的并行运行机制，Hermes Agent 能够长期运行、不断进化。

开始前的准备

• 操作系统：Linux、macOS 或 Windows（也支持安卓手机 Termux）
• 模型 API：至少一个支持 64K 上下文窗口的模型 API Key。GPT、Claude、GLM、MiniMax、Kimi、Qwen、DeepSeek 等均可
• 费用：3.99 美元即可上手。租个 5 美元的服务器就能 7x24 小时运行
• GitHub 仓库：https://github.com/nousresearch/hermes-agent

第一步：安装 Hermes Agent

打开终端，复制粘贴一行命令：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

不必担心环境问题，Python、Node.js 等缺了什么 Hermes Agent 都会自己帮你装好。

提示: 如果你同时养了 OpenClaw，Hermes 会自动检测，问你要不要自动导入 OpenClaw 的设置、记忆、技能和 API 配置。

第二步：配置模型 API

安装完成后，Hermes 会引导你完成模型配置。需要准备好你想用的模型 API Key。

支持的模型提供商包括：OpenAI、Anthropic、Groq、DeepSeek、MiniMax、GLM、Kimi、Qwen 等 13 种。也可以通过 --ollama 参数接入本地大模型，无需联网。

要求模型的上下文窗口至少是 64K，以维持足够的工作记忆。

切换模型使用命令：

hermes model

第三步：接入微信

这是目前最受关注的功能。Hermes 通过腾讯官方的 iLink Bot API 接入微信，不是第三方破解协议。

安装依赖

两个包是硬要求：

pip install aiohttp cryptography

想在终端里直接看到二维码的，再加一个：

pip install qrcode

扫码登录

一行命令拉起 setup 向导：

hermes gateway setup

选择 Weixin。向导会自动拉出二维码，用手机微信扫码确认。账号凭证会写入 ~/.hermes/weixin/accounts/ 目录。

确认成功后，终端会显示：

微信连接成功，account_id=your-account-id

配置环境变量

打开 ~/.hermes/.env，最少把 account_id 填进去：

WEIXIN_ACCOUNT_ID=your-account-id

想限定只有自己能给 Bot 发消息：

WEIXIN_DM_POLICY=allowlist
WEIXIN_ALLOWED_USERS=user_id_1,user_id_2

群消息默认关闭，要手动开 allowlist：

WEIXIN_GROUP_POLICY=allowlist
WEIXIN_GROUP_ALLOWED_USERS=group_id_1

启动服务

hermes gateway

手机微信里随便给 Bot 发一句话，几秒钟内就能看到回信，连"正在输入"的状态都能在对话框里看到。

注意: 建议先用小号试一下，再决定要不要挂主号。微信单条消息上限 4000 token，超过会自动分段，长回复体验目前不太理想。

第四步：日常使用

启动 Hermes 对话：

hermes

看到欢迎界面后就可以开始对话了。Hermes 空闲时会自动休息，几乎不消耗 token，直到你再次唤醒它。

如果你想更新到最新版本并启用 Web 管理界面：

hermes update
hermes dashboard

浏览器打开 127.0.0.1:9119，可以直接管理系统状态、查看历史会话、分析 token 用量、管理定时任务和技能开关。API Key 的配置也终于有可视化界面了，不用再手动编辑 YAML 文件。

常见问题

• 微信消息被切成多段发送：微信单条消息上限 4000 token，超过就自动分段，暂无更好的处理方案。
• 掉线（错误码 -14）：最常见的原因是 session 过期。重新跑 hermes gateway setup 扫个新码即可。
• 报 "Another local Hermes gateway is already using this Weixin token"：一个 token 只能挂一个 poller，把另一个先停掉。
• 媒体文件收发失败：先确认 cryptography 装了。微信的 CDN 走的是 AES-128-ECB 加密，少了这个库连图片都拉不下来。

核心特性一览

官方资源

• GitHub 仓库：https://github.com/nousresearch/hermes-agent
• 官方文档：https://hermes-agent.nousresearch.com/docs/getting-started/quickstart
• 微信接入文档：https://hermes-agent.nousresearch.com/docs/user-guide/messaging/weixin