WhatsApp 设置

Hermes 通过基于 Baileys 的内置桥接连接到 WhatsApp。它通过模拟 WhatsApp Web 会话工作——不是通过官方 WhatsApp Business API。无需 Meta 开发者账户或业务验证。

账户封禁风险

WhatsApp 官方不支持 Business API 外的第三方机器人。使用第三方桥接有账户限制的小风险。使用专用电话号码作为机器人（不是你的个人号码），保持对话式使用。

两种模式

模式	工作原理	适用于
独立机器人号码（推荐）	为机器人专用一个电话号码。他人直接消息该号码。	干净 UX，多用户，低封禁风险
个人自拍	使用你自己的 WhatsApp。你给自己发消息来与代理交谈。	快速设置，单用户，测试

前置要求

• Node.js v18+ 和 npm
• 安装 WhatsApp 的手机（用于扫描 QR 码）

设置步骤

步骤 1：运行设置向导

hermes whatsapp

向导会：

1. 询问模式（bot 或 self-chat）
2. 安装桥接依赖（如果需要）
3. 在终端显示 QR 码
4. 等待你扫描

扫描 QR 码：在手机上打开 WhatsApp → Settings → Linked Devices → Link a Device → 扫描终端上的 QR 码。

步骤 2：配置 Hermes

# Required
WHATSAPP_ENABLED=true
WHATSAPP_MODE=bot  # "bot" or "self-chat"
WHATSAPP_ALLOWED_USERS=15551234567  # 带国家代码，无 +

或者允许所有人：WHATSAPP_ALLOWED_USERS=*

hermes gateway

获取第二个电话号码（Bot 模式）

选项	成本	备注
Google Voice	免费	仅美国。在 voice.google.com 获取号码。
预付费 SIM	$5–15 一次性	任何运营商。
VoIP 服务	免费–$5/月	TextNow、TextFree。部分号码被屏蔽。

语音消息

• 传入：语音消息自动转录（faster-whisper、Groq 或 OpenAI）
• 传出：TTS 响应作为 MP3 音频文件附件发送

消息格式

WhatsApp 支持 Markdown 自动转换：

Markdown	WhatsApp
**bold**	*bold*
~~strikethrough~~	~strikethrough~
[link](url)	link (url)

故障排除

问题	解决方案
QR 码不扫描	确保终端足够宽（60+ 列）
会话不持久	检查 ~/.hermes/platforms/whatsapp/session 存在
机器人停止工作	WhatsApp 协议可能更新，更新 Hermes 并重新配对
消息未接收	验证 WHATSAPP_ALLOWED_USERS 包含发送者号码

安全

注意

设置 WHATSAPP_ALLOWED_USERS 限制访问。保护 ~/.hermes/platforms/whatsapp/session 目录——它包含完整会话凭证。使用专用电话号码隔离风险。