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

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

v_cloudbuilder 2026-04-273275

概述

欢迎使用Lighthouse部署Hermes Agent！

👋 还没有一台云服务器？点此即可享 轻量应用服务器专属优惠，快速部署Hermes Agent～

更多语言：
玩转Hermes Agent｜使用Lighthouse快速部署云上Hermes Agent
https://www.tencentcloud.com/techpedia/143917
Getting Started with Hermes Agent: Deploying on Tencent Cloud Lighthouse
https://www.tencentcloud.com/techpedia/143916
클라우드에서 Hermes 원클릭 배포 가이드
https://www.tencentcloud.com/techpedia/143922
クラウドでHermesを簡単デプロイ：ワンクリック設定ガイド
https://www.tencentcloud.com/techpedia/143920
Panduan Deploy Hermes di Cloud dengan Sekali Klik
https://www.tencentcloud.com/techpedia/143921
Guía de Despliegue de Hermes en la Nube con Un Solo Clic
https://www.tencentcloud.com/techpedia/143923

引言

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 配置模型（AI大脑）。Hermes Agent 本身不包含AI模型，需要连接外部大语言模型（LLM）来驱动其智能，本教程以 MiniMax China 为例进行配置。

步骤一：登录服务器

打开轻量云控制台，找到已安装 Hermes Agent 的 Lighthouse 实例。

点击实例卡片上的登录按钮，浏览器自动跳转至腾讯云 Web 终端工具 OrcaTerm。

在弹窗中配置：

  • 登录方式：选择免密登录
  • 用户名：修改为 agentuser（Hermes Agent 安装在该用户下）

提示：如果你的 Hermes Agent 实例是在 2026 年 4 月 15 日之前创建的，需要将用户名切换为 lighthouse。也可以登录后执行 su lighthouse 命令切换。

确认后点击登录按钮，成功登录后进入服务器终端界面。

步骤二：获取 MiniMax API 密钥

在配置模型之前，需要先在 MiniMax 平台获取 API 密钥。

  1. 打开 MiniMax 开放平台 - 接口密钥页面
  2. 注册或登录你的 MiniMax 账号
  3. 点击创建 API Key，在弹窗中输入密钥名称

系统会生成一串以 sk-api- 开头的密钥字符串，立即复制并妥善保存。

重要：页面关闭后将无法再次查看完整密钥，请立即复制保存。

重要：确保 MiniMax 账号余额不为 0。如果余额为零，即使 API 密钥配置正确，Hermes Agent 也无法正常调用模型。你可以在 MiniMax 费用中心 - 余额页面 查看和充值。

步骤三：运行 hermes setup 配置模型

回到服务器终端，执行以下命令启动交互式配置向导：

hermes setup

执行后，终端显示配置向导界面：

使用上下方向键选择 Quick setup — provider, model & messaging (recommended)，按回车确认。

3.1 选择模型提供商（Provider）

向导显示支持的模型服务商列表，使用上下方向键滚动，选择 More providers... 并回车。

找到并选中 MiniMax (China)，按回车确认。

说明：MiniMax 和 MiniMax (China) 是两个不同选项。国内用户从 MiniMax 中国站获取的 API 密钥，请选择 MiniMax (China)。

3.2 输入 API 密钥

选择提供商后，向导提示输入 API 密钥：

MiniMax CN API key:

将步骤二中复制的 API 密钥粘贴到此处（粘贴方式：右键单击，或按 Ctrl+Shift+V），按回车确认。

注意：为保证安全，密钥输入时不会在屏幕上显示任何字符，直接粘贴后按回车即可。

输入成功后，显示确认信息：

API Key Saved.

此时提示 Base URL 信息，直接回车确认：

3.3 选择模型

API 密钥保存成功后，向导显示 MiniMax China 支持的模型列表：

->   MiniMax-M2
     MiniMax-M2.5
     MiniMax-M2.7
     MiniMax-M2.7-highspeed
     MiniMax-M2.1
     MiniMax-M2.5-highspeed
     Enter custom model name
     Skip (keep current)

使用上下方向键选择模型，推荐选择 MiniMax-M2.7（最新版本，能力最强），按回车确认。

确认后显示：

✓ Default model set to: MiniMax-M2.7

3.4 跳过聊天通道配置

模型配置完成后，向导询问是否连接聊天平台：

Connect a messaging platform? (Telegram, Discord, etc.)
  ● Set up messaging now (recommended)
  ○ Skip — set up later with 'hermes setup gateway'

选择 Skip — set up later with 'hermes setup gateway'，按回车跳过。

向导显示配置完成摘要，提示是否立刻连接 Hermes 对话：

步骤四：验证模型配置

在命令行中输入 Y 后按回车，或在终端中直接运行 hermes 命令，启动内置命令行聊天界面（TUI）。

如果模型配置正确，你会看到 Hermes Agent 欢迎界面，底部显示当前使用的模型信息（例如 MiniMax-M2.7 via minimax-cn）。

在输入框中输入测试消息：

你好，请做一下自我介绍

按回车发送。如果一切正常，Hermes Agent 通过 MiniMax 模型生成回复：

如果遇到报错（如 API key invalid 或连接超时），请检查：

  • API 密钥是否正确粘贴（运行 hermes doctor 诊断）
  • 服务器是否能够访问 MiniMax 的 API 服务（国内 Lighthouse 通常正常）

验证成功后，输入 /quit 并按回车退出 TUI 界面：

/quit

下一步：模型配置完成后，可继续配置企业微信聊天通道，实现与 Hermes Agent 的实时对话。

Hermes Agent 企业微信接入完整指南

接入企业微信 (WeCom)

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

Step 1：在企业微信管理后台创建 AI Bot

模型验证通过后，接下来我们要配置企业微信作为聊天通道，这样你就可以像发微信一样和 Hermes Agent 对话了。

5.1 登录企业微信管理后台

在浏览器中打开 企业微信管理后台。

使用企业微信扫码登录（你需要有一个企业微信组织的管理员权限）。

提示： 如果你还没有企业微信组织，可以免费注册一个。访问 企业微信官网 点击"立即注册"，按照流程创建一个组织即可。

5.2 创建 AI Bot 应用

登录管理后台后，在左侧菜单栏中找到并点击 安全与管理。

点击 管理工具，在智能专区中选择 智能机器人。

在创建页内单击创建机器人按钮。

在弹出的弹窗中选择手动创建。

在创建智能机器人的页面，单击编辑按钮，并在接下来的弹窗中依次填写机器人的头像、名称（例如"Hermes"）和描述信息。

滑动至页面右侧底部，选择API模式创建。

使用长连接方式接入企微机器人

在接下来的页面中按需配置可见范围。

在API配置中，找到Secret，并且单击后面的点击获取按钮：

在可使用权限中选择消息（其他权限可按需授予）：

授权完成后返回页面，单击保存按钮。

5.3 获取 Bot ID 和 Secret

创建完成后，进入该机器人的详情页面，你会看到以下两个关键信息：

  • Bot ID：机器人的唯一标识符
  • Secret：机器人的密钥

请复制并妥善保存这两个值，后面配置 Hermes Agent 时需要用到。

安全提示： Secret 等同于机器人的密码，请不要泄露给他人。

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

回到服务器终端，我们需要把刚才获取的企业微信 Bot ID 和 Secret 配置到 Hermes Agent 中。

Hermes Agent 的所有敏感信息（如 API 密钥、Bot 凭据等）都保存在 ~/.hermes/.env 文件中。我们可以使用以下命令逐一写入企业微信的凭据。

6.1 写入 Bot ID 与 Secret

在终端中运行以下命令（请将 your-bot-id 替换为你在步骤 5.3 中复制的实际 Bot ID）：

hermes config set WECOM_BOT_ID your-bot-id

例如，如果你的 Bot ID 是 bot_abc123xyz，则命令为：

hermes config set WECOM_BOT_ID bot_abc123xyz

运行以下命令（请将 your-secret 替换为你在步骤 5.3 中复制的实际 Secret）：

hermes config set WECOM_SECRET your-secret

6.2 私信权限设置

你可以通过设置 WECOM_DM_POLICY 来限制可以私聊 Hermes Agent 的用户范围，此处设置为 pairing。

这样当有未授权用户给你的 Bot 发私信时，不会直接开放对话，而是会触发配对码（pairing code）验证流程——Bot 会给对方发一个一次性配对码，你需要在服务器端确认后才能通过。

hermes config set WECOM_DM_POLICY pairing

6.3 配置访问限制（可选）

你可以通过设置 WECOM_ALLOWED_USERS 来限制哪些企业微信用户可以和 Hermes Agent 对话：

hermes config set WECOM_ALLOWED_USERS your_user_id

如果允许多个用户，用英文逗号分隔：

hermes config set WECOM_ALLOWED_USERS user_id_1,user_id_2

如何获取企业微信的用户 ID：在企业微信管理后台 → 通讯录 → 点击成员 → 查看"账号"字段，即为用户 ID。

如果你暂时不需要访问限制（仅自己测试使用），可以跳过这一步。默认情况下，所有能联系到该 Bot 的企业微信成员都可以与其对话（需配对）。

提示： 如果您希望所有企业微信用户都能与Bot交互，可以执行 hermes config set GATEWAY_ALLOW_ALL_USERS true。如果只想允许特定用户访问，可以通过 hermes config set WECOM_ALLOWED_USERS user_id_1,user_id_2 来设置白名单。

Step 3：启动网关

所有配置完成后，我们需要启动 Hermes Agent 的消息网关（Gateway），它负责接收和发送企业微信的消息。

为了让 Hermes Agent 在后台持续运行，并且在服务器重启后自动启动，建议将网关安装为系统服务：

hermes gateway install

安装完成后，启动服务：

hermes gateway start

你可以随时通过以下命令检查网关服务的运行状态：

hermes gateway status

至此，你的 Hermes Agent 已经完全配置完成并在后台运行。

此时我们回到企业微信后台，可以通过获取并扫描机器人二维码，来将其加入至对话框：

在企业微信内发送任意消息后，将会看到一条配对信息：

复制配对信息中的最后一条命令，回到服务器命令行中粘贴并回车运行，看到如下信息后，表示配对完成。

此时回到企业微信内，即可开始与 Hermes Agent 对话！

这里如果你遇到类似 📬 No home channel is set for Wecom. A home channel is where Hermes delivers cron job results and cross-platform messages. 的提示，可以通过对话框直接发送 /sethome 来完成。

安全提示： Hermes Agent 的 WebUI 并未提供鉴权能力，任何知道访问地址的人都可以直接操作你的 Agent。我们强烈不推荐自行开启 WebUI 并通过公网访问使用。

企业微信高级配置

您还可以在 ~/.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"

常见问题

输入配对命令后提示 Code not found or expired

现象： 在服务器终端中运行企业微信消息中提供的配对命令后，提示：

Code 'XXXXXXXX' not found or expired for platform 'wecom'.
Run 'hermes pairing list' to see pending codes.

原因： 配对码存在有效期（1小时），可能在你复制命令的过程中已经过期或发生了变化。

解决方案：

  1. 运行以下命令查看当前待审批的配对请求：
hermes pairing list
  1. 在返回的列表中找到 Code 列对应的配对码（如 XXXXXXXX）：
Pending Pairing Requests (1):
Platform    Code        User ID        Name           Age
--------    ----        -------        ----           ---
wecom       XXXXXXXX    JIAYU          JIAYU    1m ago
  1. 复制该配对码，重新运行审批命令：
hermes pairing approve wecom XXXXXXXX

将 XXXXXXXX 替换为你在列表中看到的实际配对码即可。

常用管理命令速查

完成以上配置后，你后续可能会用到以下命令来管理你的 Hermes Agent：

命令 说明
hermes 在终端中直接与 Hermes Agent 聊天（TUI 界面）
hermes gateway 前台启动消息网关
hermes gateway start 启动后台网关服务
hermes gateway stop 停止后台网关服务
hermes gateway status 查看网关服务状态
hermes setup 重新运行配置向导
hermes setup model 仅重新配置模型/提供商
hermes setup gateway 仅重新配置聊天平台
hermes model 切换模型
hermes doctor 诊断配置问题
hermes update 更新到最新版本
hermes config 查看当前配置

启动与管理网关

配置完成后，使用以下命令管理网关服务：

# 前台运行（适合调试）
hermes gateway

# 后台启动
hermes gateway start

# 查看运行状态
hermes gateway status

# 停止网关
hermes gateway stop

提示： 一个网关进程可以同时连接所有已配置的平台（企业微信、Telegram、Discord等），无需为每个平台单独启动服务。

加入我们的 Discord 群组！

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

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

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

Discord 解锁更多进阶玩法

点击一键加入社群

2️⃣ 专属服务支持

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

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