Technology Encyclopedia Home >玩转Hermes Agent|使用Lighthouse快速部署云上Hermes Agent

玩转Hermes Agent|使用Lighthouse快速部署云上Hermes Agent

概述

欢迎使用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 赛道上的一次全面进化。


Hermes 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是一款面向轻量级应用场景的云服务器产品,无需理解复杂的云计算概念,提供了高性价比的服务器套餐。

与在本地电脑运行相比,使用Lighthouse服务器部署 Hermes Agent 具有以下优势:

  • 快速上手:几分钟内即可完成部署
  • 成本友好:几十块钱即可开始体验
  • 7×24在线:天然支持全天候运行,随时通过聊天软件与 Hermes Agent 交互
  • 安全隔离:云端环境与本地电脑强隔离,保护个人数据安全

在腾讯云Lighthouse上安装Hermes Agent

方式一:新购一台轻量应用服务器

前往腾讯云Lighthouse产品的购买页选购一台服务器,建议配置如下:

  • 镜像:Hermes Agent
  • 地域:请根据使用场景选择。接入 Discord 等海外平台通常选择海外地域(如中国香港);如需调用国内模型(如 Kimi、MiniMax、智谱GLM),则建议选择国内地域。
  • 套餐配置:推荐2核4G内存或更高配置,最低配置支持2核2G内存(适合简单体验)。

点击立即购买,按照页面引导完成支付,等待30秒左右即可完成服务器创建。

方式二:重装一台现有的轻量应用服务器

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

如果您已有存量吃灰的Lighthouse实例,可以通过"重装系统"方式选择 Hermes Agent 镜像,然后按后续步骤配置 Hermes Agent。


为Hermes Agent配置模型和通道

在完成安装后,接下来需要为 Hermes Agent 配置模型(Models)通道(Gateways)

  • 模型:Hermes Agent 的"大脑",需要接入大语言模型的 API 服务
  • 通道(Gateway):与 Hermes Agent 交互的消息平台,如 Telegram、Discord、Slack、WhatsApp 等

配置模型 (Models)

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。

Step 1:获取 DeepSeek API Key

首先,前往 DeepSeek 开放平台 注册账号并创建 API Key。

Step 2:登录服务器

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

Step 3:配置 API Key 和模型

登录服务器后,查看当前用户是否为 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 环境变量以获得更好的上下文支持。


配置通道 (Gateways)

Hermes Agent 的通道(Gateway)系统支持15+主流消息平台的接入,包括国内常用的企业微信、钉钉、飞书以及海外的 Telegram、Discord、Slack、WhatsApp 等,使用一个后台进程即可同时连接所有已配置的平台。各平台功能对比如下:

平台 语音 图片 文件 线程 流式输出
CLI (命令行)
企业微信 (WeCom)
钉钉 (DingTalk)
飞书 (Feishu/Lark)
Telegram
Discord
Slack
WhatsApp
Signal
Email

下面我们以Telegram为例,手把手演示如何配置通道。

接入Telegram

根据所有搜索到的资料和你之前的截图内容,下面是为你写好的 接入 Telegram 部分的 Markdown 教程内容:


接入 Telegram

接入 Telegram 主要分为两大步骤:创建 Telegram Bot在 Hermes 中配置 Gateway

第一步:创建 Telegram Bot

  1. 打开 Telegram,搜索 @BotFather,进入对话。

  2. 发送 /newbot 命令,BotFather 会引导你创建一个新 Bot。

  3. 依次设置两个名称:

    • Display name(显示名称):可以随意取,例如 My Hermes
    • Username(用户名):必须以 bot 结尾且全局唯一,例如 my_hermes_test_bot

  1. 创建成功后,BotFather 会返回一个 Bot Token请复制并妥善保存,后面配置时需要用到。

第二步:获取你的 Telegram User ID

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

  1. 在 Telegram 中搜索 @userinfobot,进入对话。

  1. 发送任意消息,它会回复你的 User ID(一串纯数字,例如 123456789)。

  2. 复制这个数字,后面配置时需要填入。

第三步:运行 Hermes Gateway 配置向导

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

hermes gateway setup

配置向导会依次询问你以下信息:

1. 选择平台

在平台列表中选择 Telegram

2. 粘贴 Bot Token

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

3. 输入 User ID

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

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

4. 设置 Home Channel ID

终端提示:

Home Channel 用于接收定时任务和通知消息。这里有两种选择:

  • 直接回车跳过:终端会显示 Skipped (can configure later),后续可以在 Telegram 聊天中发送 /set-home 来设置。
  • 手动输入 Channel ID

此处我们选择直接跳过

5. 确认使用 User ID 作为 Home Channel

跳过上一步后,终端会追问:

输入 y 并回车,即可将你的私聊设为 Home Channel。

看到绿色提示 ✓ Home channel set to 0123456789 表示设置成功。

紧接着会显示 ✓ 📱 Telegram configured! —— Telegram 通道配置完成!


第四步:安装 Gateway 为系统服务

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

1. 是否安装为 systemd 服务?

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

2. 选择运行用户

输入运行服务的用户名。如果你用的是 root 账户,直接输入 root

⚠️ 第一次如果直接回车会提示 ✗ Enter a username.,需要手动输入用户名

显示 System service started 表示安装成功


第五步:验证与测试

  1. 检查服务状态
sudo hermes gateway status --system
  1. 查看实时日志
journalctl -u hermes-gateway -f
  1. 打开 Telegram,找到你刚创建的 Bot,发送一条消息测试。如果一切正常,Bot 会回复你的消息

⚠️ 注意:在测试 Bot 之前,请确保你已经配置好了大模型连接(通过 hermes setup 配置 LLM Provider 和 API Key),否则 Bot 虽然能接收消息但无法生成回复。

接入企业微信 (WeCom)

企业微信是国内最常用的企业级即时通讯工具之一,Hermes Agent 原生支持通过 WebSocket 方式连接企业微信,无需公网 IP、无需 Webhook 回调地址,配置简单。

Step 1:在企业微信管理后台创建 AI Bot
  1. 前往企业微信官网,使用有企业管理员权限的账号登录。如您尚未在企业微信中拥有企业,可以参考创建&注册企业来创建一个新企业。

  1. 在企业微信管理后台左侧导航依次找到并进入 安全与管理 > 管理工具,选择智能机器人,然后在页面内点击创建机器人

  1. 在弹出的弹窗中点击手动创建按钮。

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

使用长连接方式接入企微机器人
  1. 选择以「长连接」方式创建,在配置方法中的Secret处单击点击获取

  2. 单击页面内的保存

Step 2:在服务器上配置企业微信凭据

登录服务器后,依次执行以下命令,设置企业微信的 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 来设置白名单。

Step 3:启动网关

注册网关为服务:

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 Agent 交互:

hermes

启动后,您将看到一个功能丰富的TUI(终端用户界面),支持多行编辑、斜杠命令自动补全、会话历史等功能。

常用的斜杠命令包括:

命令 功能
/help 查看帮助信息
/new/reset 开始新对话(重置上下文)
/model [provider:model] 动态切换模型
/personality [name] 设置Agent人设
/skills 查看和调用技能
/save 保存当前会话
/retry 重试上一次回复
/undo 撤销上一次操作

提示:Alt+EnterCtrl+J 可以输入多行内容,适合粘贴代码。按 Ctrl+C 可以中断当前正在运行的任务。

恢复上次会话

如果退出后希望继续之前的对话,可以使用:

hermes --continue
# 或简写
hermes -c

设置Agent人设(SOUL.md)

Hermes Agent 支持通过 SOUL.md 文件自定义Agent的人格和语气风格。编辑 ~/.hermes/SOUL.md 文件即可:

nano ~/.hermes/SOUL.md

例如:

你是一个温暖、幽默的AI助手,喜欢用简洁的中文回答问题。
在回答技术问题时,你会先给出简明的结论,再展开详细解释。
偶尔会使用一些俏皮的比喻来让解释更生动。

提示: SOUL.md 文件每条消息都会重新加载,修改后无需重启即可生效。

使用定时任务(Cron)

Hermes Agent 内置了 Cron 调度器,支持使用自然语言创建定时任务。例如,在聊天中直接告诉它:

  • "每天早上9点检查 Hacker News 并通过 Telegram 发送技术摘要"
  • "每周一上午10点生成项目进度报告"

定时任务会自动执行,并将结果通过配置好的通道发送给你。

安装和使用技能(Skills)

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 Agent 为最新版本:

hermes update

从OpenClaw迁移

如果您此前使用过 OpenClaw(龙虾),Hermes Agent 支持一键迁移:

hermes claw migrate

该命令会自动导入 OpenClaw 的设置、记忆、技能和 API 密钥。


Hermes Agent 核心特性一览

特性 说明
🧠 自我学习闭环 自主创建技能、使用中自我改进、跨会话记忆召回
🌍 多平台接入 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 等工具保持终端会话。

加入我们的 Discord 群组!

扫描二维码加入用户讨论群,解锁并交流在云端使用 OpenClaw 的经验。探索与 Telegram、Discord、WhatsApp、QQ、钉钉、企业微信和 Lark 等应用集成后的各种实用有趣的用法!

🚀 腾讯云开发者社区与支持

1️⃣ 腾讯云开发者交流社区

Discord 解锁更多进阶玩法

点击一键加入社群

2️⃣ 专属服务支持

加入 Whatsapp/企业微信享受专属技术支持

渠道 扫描/点击进入
Whatsapp 频道
企业微信