WhatsApp 接入——全球用户最多的聊天应用

这篇教程教你如何把 Hermes Agent 接入 WhatsApp，让全世界超过 20 亿用户都能通过聊天软件跟你的人工智能对话。

先搞懂原理：它像“扫码登录网页版”

Hermes 连接 WhatsApp 的方式，不是官方企业 API，而是模拟“WhatsApp 网页版登录”——就像你在电脑上扫码登录微信一样。不需要注册 Meta 开发者账号，也不用企业认证，个人就能用。

⚠️ 风险提示：WhatsApp 官方并不支持第三方机器人。用这种方式有小概率被封号。建议用专用号码（别用自己主号），并且不要群发消息，只做一对一聊天。

第 1 步：运行向导，扫码配对

打开终端，输入：

hermes whatsapp

向导会问你要哪种模式：

模式	说明	适合谁
机器人专用号（推荐）	给机器人单独一个手机号	多人使用、体验干净、风险低
个人自聊	用你自己的 WhatsApp，给自己发消息	快速测试、单人使用

选好后，终端会显示一个 二维码。用手机 WhatsApp 扫一扫：

打开 WhatsApp → 设置 → 已链接设备
点 关联设备
对准终端上的二维码

配对成功，会话自动保存，下次不用再扫。

第 2 步：搞一个机器人专用号码（可选）

如果你选了“机器人专用号”模式，需要一个没注册过 WhatsApp 的新号码。三个办法：

Google Voice（免费，仅美国）— 去 voice.google.com 申请
预付费 SIM 卡（约 5–15 美元）— 激活验证后放抽屉里，每 90 天打个电话保号
VoIP 服务（免费到 5 美元/月）— TextNow 等，但有些号码会被 WhatsApp 屏蔽，多试几个

拿到号码后，用这个号码注册 WhatsApp，再跑一次 hermes whatsapp 扫码即可。

第 3 步：配置 Hermes

编辑 ~/.hermes/.env 文件，加入：

WHATSAPP_ENABLED=true
WHATSAPP_MODE=bot                    # 或 self-chat
WHATSAPP_ALLOWED_USERS=15551234567   # 允许谁给你发消息（国家码+号码，逗号分隔）
# WHATSAPP_ALLOWED_USERS=*           # 或者用 * 允许所有人

然后启动网关：

hermes gateway              # 前台运行
hermes gateway install      # 后台服务（开机自启）

语音消息与格式

语音输入：收到的语音会自动转成文字（支持本地 Whisper 或 Groq/OpenAI 云端识别）
语音回复：AI 的文字回复可以转成 MP3 发给你
长消息自动分段：超过 4096 字符会自动拆成多条发送，不用你操心
Markdown 自动转换：AI 回复里的 **加粗**、~~删除线~~、链接等，会自动变成 WhatsApp 原生格式

小结

接入 WhatsApp 就像“扫码登录网页版”一样简单。核心三步：跑向导扫码 → 准备专用号码（可选）→ 配置环境变量。记住用专用号码、别群发，就能安心使用。

下篇预告：接入全球用户最多的应用之后，我们下一篇聊聊怎么接入 Telegram——那个功能最丰富、机器人生态最完善的聊天平台。敬请期待！