欢迎使用Lighthouse部署Hermes Agent!
文章被收录于专栏:玩转Lighthouse
👋 还没有一台云服务器?点此即可享 轻量应用服务器专属优惠,快速部署Hermes Agent~
2026年4月,Nous Research 正式发布了开源AI Agent项目 Hermes Agent,迅速在GitHub和AI社区引发广泛关注。与市面上绑定在IDE中的编码助手或单一API聊天机器人不同,Hermes Agent 是一个真正意义上的自主智能体(Autonomous Agent)——它运行在你的服务器上,拥有持久化记忆,能随着使用时间的增长不断变强。更令人兴奋的是,它具备完整的自我学习闭环:自主创建技能、在使用中改进技能、跨会话召回记忆,真正做到"越用越聪明"。
Hermes Agent 与此前大火的 OpenClaw(龙虾) 项目有着千丝万缕的联系——它甚至内置了 hermes claw migrate 命令,支持一键迁移 OpenClaw 的设置、记忆、技能和 API 密钥。可以说,Hermes Agent 是 AI Agent 赛道上的一次全面进化。
与 OpenClaw 类似,Hermes Agent 同样具备完整的系统操作权限(终端执行、文件读写、浏览器自动化等),因此官方建议将其部署在一个与个人主力电脑隔离的环境中,以保障数据安全。
Hermes Agent 支持 Linux、macOS、WSL2 以及 Android(Termux)等平台,其中 Linux 是最推荐的部署环境。将 Hermes Agent 部署在云服务器中,不仅能实现与本地电脑的安全隔离,还能实现7×24小时不间断在线,让你随时随地通过 Telegram、Discord 等聊天软件与它交互。
注意: Hermes Agent 目前不支持 Windows 原生环境,Windows 用户需要先安装 WSL2 后在其中运行。
腾讯云轻量应用服务器Lighthouse是一款面向轻量级应用场景的云服务器产品,无需理解复杂的云计算概念,提供了高性价比的服务器套餐。
与在本地电脑运行相比,使用Lighthouse服务器部署 Hermes Agent 具有以下优势:
前往腾讯云Lighthouse产品的购买页选购一台服务器,建议配置如下:
点击立即购买,按照页面引导完成支付,等待30秒左右即可完成服务器创建。

注意: 重装系统将清空服务器内的全部数据,请谨慎操作!

如果您已有存量吃灰的Lighthouse实例,可以通过"重装系统"方式选择 Hermes Agent 镜像,然后按后续步骤配置 Hermes Agent。
在完成安装后,接下来需要为 Hermes Agent 配置模型(Models)和通道(Gateways):
Hermes Agent 支持丰富的模型提供商,包括但不限于:
| 提供商 | Provider ID | 所需环境变量 | 说明 |
|---|---|---|---|
| OpenRouter | openrouter |
OPENROUTER_API_KEY |
默认提供商,可路由200+模型 |
| Anthropic (Claude) | anthropic |
ANTHROPIC_API_KEY |
直接调用Claude系列模型 |
| Google Gemini | gemini |
GOOGLE_API_KEY |
Google AI Studio |
| DeepSeek | deepseek |
DEEPSEEK_API_KEY |
DeepSeek深度求索 |
| 智谱GLM (z.ai) | zai |
GLM_API_KEY |
智谱AI GLM系列模型 |
| Kimi / 月之暗面 | kimi-coding |
KIMI_API_KEY |
Kimi Code / Moonshot |
| MiniMax | minimax |
MINIMAX_API_KEY |
MiniMax国际版 |
| MiniMax国内版 | minimax-cn |
MINIMAX_CN_API_KEY |
MiniMax中国版 |
| 通义千问 | alibaba |
DASHSCOPE_API_KEY |
阿里云百炼平台 |
| Hugging Face | huggingface |
HF_TOKEN |
Hugging Face推理 |
| 自定义端点 | custom |
可选 | Ollama/vLLM/LM Studio等 |
下面我们以 DeepSeek(深度求索) 为例,手把手演示如何配置模型 API Key。
首先,前往 DeepSeek 开放平台 注册账号并创建 API Key。

通过腾讯云OrcaTerm远程终端或第三方SSH工具登录服务器。进入轻量云控制台,找到已部署 Hermes Agent 的实例,点击免密登录进入服务器终端。

登录服务器后,查看当前用户是否为 lighthouse,若不是需要执行:
su lighthouse
依次执行以下三条命令,即可完成 DeepSeek 模型的全部配置:
# 设置 DeepSeek API Key(自动写入 ~/.hermes/.env)
hermes config set DEEPSEEK_API_KEY 替换成你的DeepSeekAPIKey
# 设置默认模型为 DeepSeek
hermes config set model.default deepseek-chat
# 设置推理提供商为 DeepSeek
hermes config set model.provider deepseek
# 设置base_url
hermes config set model.base_url https://api.deepseek.com/v1

每条命令执行成功后,都会显示类似 ✓ Set ... in ... 的确认信息。
提示: 您也可以使用
hermes model命令进入交互式向导来选择模型和提供商,操作更加直观。
如果您希望使用其他模型服务商,配置方式与上述 DeepSeek 类似——使用 hermes config set 命令设置 API Key、模型名称和提供商即可。以下是常用模型的快速配置参考:
Kimi Code(月之暗面,国内模型推荐):
hermes config set KIMI_API_KEY sk-kimi-xxxxxxxxxxxxxxxx
hermes config set model.default kimi-k2.5
hermes config set model.provider kimi-coding
智谱GLM(国内模型):
hermes config set GLM_API_KEY your-glm-api-key
hermes config set model.default glm-4-plus
hermes config set model.provider zai
本地模型(Ollama):
hermes config set model.default qwen2.5:32b
hermes config set model.provider ollama
hermes config set model.base_url http://localhost:11434/v1
提示: 使用本地模型时,需先安装 Ollama(
curl -fsSL https://ollama.ai/install.sh | sh)并拉取模型(ollama pull qwen2.5:32b),同时建议设置OLLAMA_CONTEXT_LENGTH=32768环境变量以获得更好的上下文支持。
Hermes Agent 的通道(Gateway)系统支持15+主流消息平台的接入,包括国内常用的企业微信、钉钉、飞书以及海外的 Telegram、Discord、Slack、WhatsApp 等,使用一个后台进程即可同时连接所有已配置的平台。各平台功能对比如下:
| 平台 | 语音 | 图片 | 文件 | 线程 | 流式输出 |
|---|---|---|---|---|---|
| CLI (命令行) | ✅ | ✅ | ✅ | — | ✅ |
| 企业微信 (WeCom) | ✅ | ✅ | ✅ | ✅ | ✅ |
| 钉钉 (DingTalk) | ✅ | ✅ | ✅ | — | ✅ |
| 飞书 (Feishu/Lark) | ✅ | ✅ | ✅ | ✅ | ✅ |
| Telegram | ✅ | ✅ | ✅ | ✅ | ✅ |
| Discord | ✅ | ✅ | ✅ | ✅ | ✅ |
| Slack | ✅ | ✅ | ✅ | ✅ | ✅ |
| — | ✅ | ✅ | — | ✅ | |
| Signal | — | ✅ | — | — | ✅ |
| — | ✅ | ✅ | ✅ | — |
下面我们以Telegram为例,手把手演示如何配置通道。
根据所有搜索到的资料和你之前的截图内容,下面是为你写好的 接入 Telegram 部分的 Markdown 教程内容:
接入 Telegram 主要分为两大步骤:创建 Telegram Bot 和 在 Hermes 中配置 Gateway。
打开 Telegram,搜索 @BotFather,进入对话。
发送 /newbot 命令,BotFather 会引导你创建一个新 Bot。
依次设置两个名称:
My Hermesbot 结尾且全局唯一,例如 my_hermes_test_bot

User ID 是一个安全措施,确保只有你本人能与 Bot 对话。

发送任意消息,它会回复你的 User ID(一串纯数字,例如 123456789)。
复制这个数字,后面配置时需要填入。

回到你的服务器终端,执行以下命令:
hermes gateway setup

配置向导会依次询问你以下信息:
在平台列表中选择 Telegram。

将第一步从 BotFather 获取的 Token 粘贴进去,按回车确认。

将第二步从 @userinfobot 获取的 User ID 填入,按回车确认。

好的,我看到你的截图了,里面包含了完整的 hermes gateway setup 配置流程中更多细节步骤。让我根据截图内容把之前缺失的部分补充完整,重新给你写一版:
终端提示:

Home Channel 用于接收定时任务和通知消息。这里有两种选择:
Skipped (can configure later),后续可以在 Telegram 聊天中发送 /set-home 来设置。此处我们选择直接跳过
跳过上一步后,终端会追问:

输入 y 并回车,即可将你的私聊设为 Home Channel。
看到绿色提示 ✓ Home channel set to 0123456789 表示设置成功。
紧接着会显示 ✓ 📱 Telegram configured! —— Telegram 通道配置完成!

Telegram 配置完成后,向导会继续询问是否安装为系统后台服务。

输入 y 并回车。安装为系统服务后,Gateway 会在后台运行并开机自启。

输入运行服务的用户名。如果你用的是 root 账户,直接输入 root。
⚠️ 第一次如果直接回车会提示
✗ Enter a username.,需要手动输入用户名。

显示 System service started 表示安装成功
sudo hermes gateway status --system
journalctl -u hermes-gateway -f
⚠️ 注意:在测试 Bot 之前,请确保你已经配置好了大模型连接(通过
hermes setup配置 LLM Provider 和 API Key),否则 Bot 虽然能接收消息但无法生成回复。
企业微信是国内最常用的企业级即时通讯工具之一,Hermes Agent 原生支持通过 WebSocket 方式连接企业微信,无需公网 IP、无需 Webhook 回调地址,配置简单。





4.滑到页面最底端,点击 API模式创建 按钮。

选择以「长连接」方式创建,在配置方法中的Secret处单击点击获取。

单击页面内的保存。

登录服务器后,依次执行以下命令,设置企业微信的 Bot ID 和 Secret:
hermes config set WECOM_BOT_ID 替换成你的BotID
hermes config set WECOM_SECRET 替换成你的Secret
每条命令执行成功后,会显示 ✓ Set ... in ~/.hermes/.env 的确认信息。

提示: 如果您希望所有企业微信用户都能与Bot交互,可以执行
hermes config set GATEWAY_ALLOW_ALL_USERS true。如果只想允许特定用户访问,可以通过hermes config set WECOM_ALLOWED_USERS user_id_1,user_id_2来设置白名单。
注册网关为服务:
hermes gateway install
启动网关:
hermes gateway start

此时您可以在企业微信中找到刚创建的 AI Bot,发送一条消息来验证 Hermes Agent 是否正常工作。

企业微信高级配置: 您还可以在 ~/.hermes/config.yaml 中进一步配置企业微信的访问策略,例如限制哪些群组可以使用Bot、设置群内用户白名单等:
platforms:
wecom:
enabled: true
extra:
dm_policy: "open" # 私聊策略:open/allowlist/disabled
group_policy: "allowlist" # 群聊策略:open/allowlist
group_allow_from: # 允许响应的群ID列表
- "group_id_1"
Hermes Agent 同样支持接入 Telegram、Discord、Slack、钉钉、飞书等众多平台。最简单的方式是使用交互式向导:
hermes gateway setup
系统会列出所有支持的平台,使用方向键选择后按提示输入对应的 Token/凭据即可完成配置。以下是各平台的详细接入文档:
国内平台:
海外平台:
配置完成后,使用以下命令管理网关服务:
# 前台运行(适合调试)
hermes gateway
# 后台启动
hermes gateway start
# 查看运行状态
hermes gateway status
# 停止网关
hermes gateway stop
提示: 一个网关进程可以同时连接所有已配置的平台(企业微信、Telegram、Discord等),无需为每个平台单独启动服务。
配置完模型后,最简单的使用方式就是直接在服务器终端中与 Hermes Agent 交互:
hermes
启动后,您将看到一个功能丰富的TUI(终端用户界面),支持多行编辑、斜杠命令自动补全、会话历史等功能。
常用的斜杠命令包括:
| 命令 | 功能 |
|---|---|
/help |
查看帮助信息 |
/new 或 /reset |
开始新对话(重置上下文) |
/model [provider:model] |
动态切换模型 |
/personality [name] |
设置Agent人设 |
/skills |
查看和调用技能 |
/save |
保存当前会话 |
/retry |
重试上一次回复 |
/undo |
撤销上一次操作 |
提示: 按
Alt+Enter或Ctrl+J可以输入多行内容,适合粘贴代码。按Ctrl+C可以中断当前正在运行的任务。
如果退出后希望继续之前的对话,可以使用:
hermes --continue
# 或简写
hermes -c
Hermes Agent 支持通过 SOUL.md 文件自定义Agent的人格和语气风格。编辑 ~/.hermes/SOUL.md 文件即可:
nano ~/.hermes/SOUL.md
例如:
你是一个温暖、幽默的AI助手,喜欢用简洁的中文回答问题。
在回答技术问题时,你会先给出简明的结论,再展开详细解释。
偶尔会使用一些俏皮的比喻来让解释更生动。
提示:
SOUL.md文件每条消息都会重新加载,修改后无需重启即可生效。
Hermes Agent 内置了 Cron 调度器,支持使用自然语言创建定时任务。例如,在聊天中直接告诉它:
定时任务会自动执行,并将结果通过配置好的通道发送给你。
Hermes Agent 的技能系统是其最强大的特性之一——Agent可以自动创建和改进技能,也可以从社区安装现成的技能:
# 搜索技能
hermes skills search kubernetes
# 安装技能
hermes skills install openai/skills/k8s
# 查看已安装的技能
hermes skills list
在对话中使用 /skills 或 /<skill-name> 即可调用对应技能。
如果遇到任何问题,可以运行诊断命令:
hermes doctor
该命令会检查 Python 环境、依赖包、配置文件、API Key、目录结构、工具可用性等,并提示需要修复的问题。
保持 Hermes Agent 为最新版本:
hermes update
如果您此前使用过 OpenClaw(龙虾),Hermes Agent 支持一键迁移:
hermes claw migrate
该命令会自动导入 OpenClaw 的设置、记忆、技能和 API 密钥。
| 特性 | 说明 |
|---|---|
| 🧠 自我学习闭环 | 自主创建技能、使用中自我改进、跨会话记忆召回 |
| 🌍 多平台接入 | 15+平台:Telegram、Discord、Slack、WhatsApp、Signal等 |
| 🔧 47种内置工具 | 终端、文件、浏览器、代码执行、图像生成、TTS等 |
| 🔌 MCP协议支持 | 可连接任何MCP服务器扩展工具能力 |
| ⏰ Cron调度器 | 自然语言定时任务,结果自动推送 |
| 🤖 子Agent委派 | 隔离的子Agent并行处理复杂任务 |
| 🐳 多终端后端 | 本地、Docker、SSH、Modal、Daytona、Singularity |
| 🗣️ 语音模式 | CLI和消息平台的实时语音交互 |
| 📝 SOUL.md人设 | 通过文件定义Agent个性,实时生效 |
| 🔒 安全机制 | 命令审批、密钥脱敏、容器隔离、用户白名单 |
Q:Hermes Agent 和 OpenClaw 是什么关系?
A:Hermes Agent 是由 Nous Research 团队开发的新一代 AI Agent 项目,与 OpenClaw 有相似的理念(运行在用户自有环境中的自主AI助理),但在架构、功能和扩展性上进行了全面升级。Hermes Agent 支持通过 hermes claw migrate 一键迁移 OpenClaw 的配置。
Q:支持哪些操作系统?
A:支持 Linux、macOS、WSL2 和 Android(Termux)。不支持 Windows 原生环境。
Q:最低服务器配置要求是多少?
A:最低2核2G内存即可运行,推荐2核4G或更高配置以获得更好的体验。
Q:模型 API 如何计费?
A:Hermes Agent 本身开源免费(MIT协议),但调用的模型 API 需要单独付费。推荐使用 OpenRouter,充值灵活,按实际用量计费。
Q:如何让Bot在后台持续运行?
A:使用 hermes gateway start 命令可以将网关作为后台服务启动,或者使用 screen / tmux 等工具保持终端会话。
扫描二维码加入用户讨论群,解锁并交流在云端使用 OpenClaw 的经验。探索与 Telegram、Discord、WhatsApp、QQ、钉钉、企业微信和 Lark 等应用集成后的各种实用有趣的用法!

Discord 解锁更多进阶玩法
加入 Whatsapp/企业微信享受专属技术支持
| 渠道 | 扫描/点击进入 |
|---|---|
| Whatsapp 频道 |
|
| 企业微信 |
|