deploy-hermes-agent-on-whatsapp

title: "如何在 WhatsApp 上部署 Hermes Agent" description: "在 WhatsApp 上运行 Hermes Agent 的分步指南：Business Cloud API 配置、真实费用与限制，以及何时 Telegram 才是更明智的选择。" date: 2026-05-27 author: "Hermify Team" tags: ["Hermes", "WhatsApp", "Deployment", "AI Agents"] coverImage: "cover.jpg" socialImage: "og.jpg" coverAlt: "深色背景中，绿色 WhatsApp 气泡图标连接到一个发光的服务器节点，粗体文字写着"Hermes on WhatsApp""

WhatsApp 是全球二十亿人每天都会打开的通讯应用，因此它看起来是部署 AI 智能体的不二之选。然而一旦开始配置，你会发现它是个人智能体部署难度最高的渠道，而 Meta 在 2026 年更是让这件事愈发复杂。

本指南将带你了解让 Hermes Agent 在 WhatsApp 上运行的全部细节：所需的凭据与 Webhook、令人意外的费用与限制，以及是否值得这样做的真实答案。

开始之前：WhatsApp 不是 Telegram

如果你读过如何在 Telegram 上部署 Hermes Agent，请先忘掉那个五分钟搞定的时间线。WhatsApp 提供两种接入方式，各有代价：

官方 WhatsApp Business Cloud API（由 Meta 运营）。这是受支持、可持续的路径，需要 Meta 商业账户、企业认证、专用电话号码、公开 Webhook 以及按消息计费。
非官方库（WAHA、Baileys 及类似工具），通过自动化 WhatsApp Web 实现接入。免费且上手快，但违反 WhatsApp 服务条款，存在被永久封号的真实风险，详见下文。

对于可靠的生产部署，应选择官方 Cloud API。以下配置步骤均基于此路径。

在 WhatsApp 上部署 Hermes 所需的条件

一套可运行的部署需要四项凭据和一个基础设施组件。在修改 Hermes 配置之前，请先备齐所有内容。

1. Meta 商业账户与 Cloud API 应用

2. 电话号码 ID 和 WhatsApp 商业账户 ID

在应用的 WhatsApp 设置中，注册用于收发消息的商业电话号码。Meta 随后会显示两个必须保存的值：Phone Number ID 和 WhatsApp Business Account (WABA) ID。这两个值标识 Hermes 发送消息所使用的号码和账户，并非电话号码本身。

3. 永久访问令牌

Meta 在配置页面上显示的临时令牌 24 小时后即过期，适合初次测试，但不适用于生产环境。正式部署时，需在 Business Settings 中创建一个 System User，赋予其对应用和 WhatsApp 账户的完全控制权限，并生成永久令牌。这是 Hermes 用于验证每次发送的凭据。

4. 公开的 Webhook 端点

这一步是 Telegram 不需要的。WhatsApp 将入站消息推送到你托管的 URL，因此 Hermes 需要一个具有有效证书的公开 HTTPS 端点。你需要在 Meta Business Manager 中注册该 URL 以及自定义的验证令牌，Meta 会通过向你的端点发送包含 hub.challenge 值的请求完成一次性握手，你必须原样返回该值。验证通过后，每条入站消息都会作为 Webhook 投递，你的网关必须在 30 秒内返回 HTTP 200。

将 WhatsApp 接入 Hermes

准备好四项凭据后，Hermes 侧的配置与 Telegram 网关的配置方式类似。在 config.yaml 中添加服务商和 WhatsApp 凭据：

provider: openrouter
model: anthropic/claude-3-5-sonnet
openrouter_api_key: sk-or-your-key-here

whatsapp_phone_number_id: "123456789012345"
whatsapp_business_account_id: "987654321098765"
whatsapp_access_token: EAAG...your-permanent-token
whatsapp_verify_token: a-long-random-string-you-choose
whatsapp_allowed_users: "15551234567"

有两个字段需要特别注意。whatsapp_verify_token 必须与你在 Meta Business Manager 注册 Webhook 时填写的值完全一致，否则握手会静默失败。whatsapp_allowed_users 字段是你的安全锁：Hermes 只会回复列表中的号码（使用完整国际格式，不含 +），这样陌生人即便给你的商业号码发消息，也无法消耗你的模型额度。

启动网关

按照与其他渠道相同的方式启动消息网关：

hermes gateway start --detach

网关负责暴露 Webhook 路由、验证 Meta 每次请求的签名、将消息正文路由到 Hermes 运行时，并通过 Cloud API 回传智能体的回复。用 hermes gateway status 确认网关正常运行，然后从允许的号码发送一条测试消息。

鲜少被提及的费用与限制

这里是 WhatsApp 与免费机器人平台产生明显分歧的地方，也是许多部署悄然失败的根源。

WhatsApp 于 2025 年中转为按消息计费。智能体主动发送的每条消息，按类别和收件人所在国家收费，实用类消息约为 $0.004 至 $0.046，营销类消息在高费用国家可高达约 $0.14。官方 API 本身的月费在 $0 至 $99 区间，大多数团队还需额外支付 Business Solution Provider 的加价。

对于智能体来说，更棘手的是 24 小时客服窗口规则。用户向你发送消息后，你可以在 24 小时内自由回复。一旦窗口关闭，你就无法发送自由格式的消息，只能发送预先审批通过的模板，且每次模板发送均单独计费。个人智能体天生具有主动性：它会推送晨间日报、通知你某项长时间任务已完成、在三天后提醒你某张发票。但在 WhatsApp 上，所有这些都发生在窗口之外，因此每条都是付费的模板消息。我们在AI 智能体：Telegram vs WhatsApp中对此进行了完整分析。

非官方捷径（以及为何会适得其反）

搜索"免费 WhatsApp 机器人"，你会找到 WAHA、Baileys 以及十几个基于 WhatsApp Web 的封装库。它们上手确实快，也无需支付消息费用。但对于任何你认真对待的部署，它们都是陷阱。

这些库是通过逆向工程实现的，违反 WhatsApp 服务条款。Meta 运行着多层检测系统，包括注册指纹识别、行为分析、用户举报和内容模式识别，并在 2026 年初加强了对第三方 AI 聊天机器人的执法力度。在任何规模下运行自托管的非官方网关，现实结果是被永久封禁你所使用的号码。用一张备用 SIM 卡做一次性测试尚可接受，但用你的常用联系号码冒这个风险，得不偿失。

常见故障排查

Webhook 始终无法验证。 config.yaml 中的验证令牌与 Meta Business Manager 中的不一致，或者你的端点无法通过带有有效证书的 HTTPS 访问。Meta 必须成功回传 hub.challenge 才会发送任何消息。

消息已收到，但 Hermes 从不回复。 要么网关未运行（执行 hermes gateway status 检查），要么发送方不在 whatsapp_allowed_users 中。请确认号码使用完整国际格式且不含 +。

令牌工作了一天后一切停止。 你使用的是 24 小时临时令牌而非永久 System User 令牌。重新生成永久令牌并更新配置。

主动消息静默失败。 你正在尝试在 24 小时窗口之外发送未经审批的模板消息。这是平台规则，不是 bug，也是智能体在 WhatsApp 上举步维艰的核心原因。Telegram 故障排查指南中的排查思路同样适用于任何你运行的网关。

保持持续运行

即便机器人开始回复，你还承担着在更简单渠道上不存在的持续运维责任：需要保持在线且证书有效的公开 HTTPS 端点、不能泄露的永久令牌、需要管理的模板审批流程，以及需要关注的按消息账单。网关在进程和端点均健康时正常工作，任何一方出现问题都会立即静默。在笔记本电脑或临时容器上，这种情况发生的频率往往超出预期。

Telegram 才是个人智能体更好的归宿

跳出配置细节，结论不言而喻：对于个人 AI 智能体，Telegram 在每一个关键维度上都胜出。

开放且免费。 Telegram 的 Bot API 公开、文档完善，每条消息零费用。WhatsApp 的 Cloud API 需要通过 Meta 商业认证才能访问，且按对话计费。
天生支持主动推送。 智能体可以在任务完成的瞬间、每天早上、或三天后就某张发票主动联系你，无 24 小时窗口、无预审模板、无按消息费用。
分钟级上线，而非数周。 无需企业认证、无需专用号码、无需维护带有效证书的公开 Webhook。
无封号风险。 你使用的是受支持的一流 API，而非随时可能被检测扫描封禁号码的逆向工程库。

如果你确实需要这个特定渠道，并能接受相应的费用和运维开销，WhatsApp 是可以运行的。对于其他所有人，Telegram 才是更明智的默认选择。

跳过繁琐配置：在 Telegram 上通过 Hermify 运行你的智能体

Hermify 是 Hermes Agent 的托管服务，与 Telegram 原生集成，这正是为始终在线的个人智能体量身打造的渠道。你只需提供模型 API 密钥，运行时即在托管基础设施上完成部署，像联系普通好友一样与你的智能体对话。无需维护服务器，无需保活 Webhook，无按消息计费。

你将获得一个持久化记忆、可运行定时技能、随时随地触手可及的智能体，注册完成即刻上线，无需等待 Meta 审核队列。

立即开始使用 Hermify，你的智能体将在几分钟内在 Telegram 上运行。