词元之母TOK.MOM - 平台充值汇率 1:1 即 1 人民币充值到账 1 美元，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
"WhatsApp"
WhatsApp 配置
非官方 API — 封号风险
WhatsApp Web 协议更新
发生这种情况时，Hermes 会更新桥接依赖。如果机器人在 WhatsApp 更新后停止工作，
请拉取最新版 Hermes 并重新配对。
两种模式
| 模式 | 工作方式 | 适用场景 |
|---|---|---|
| 独立机器人号码（推荐） | 为机器人专用一个手机号，用户直接向该号码发消息。 | 体验简洁、多用户、封号风险低 |
| 个人自聊 | 使用你自己的 WhatsApp，向自己发消息与 Agent 对话。 | 快速配置、单用户、测试用途 |
前置条件
第一步：运行配置向导
1.
2.
3.
4.
1.
2.
3.
4.
提示
也可以尝试换用其他终端模拟器。
第二步：获取第二个手机号（机器人模式）
| 选项 | 费用 | 说明 |
|---|---|---|
| Google Voice | 免费 | 仅限美国。在 voice.google.com 获取号码 ，通过 Google Voice 应用以短信验证 WhatsApp。 |
| 预付费 SIM 卡 | 一次性 $5–15 | 任意运营商。激活后验证 WhatsApp，SIM 卡可放置不用。号码需保持有效（每 90 天拨打一次电话）。 |
| VoIP 服务 | 免费–$5/月 | TextNow、TextFree 等。部分 VoIP 号码被 WhatsApp 屏蔽——如第一个不可用，可多试几个。 |
1.
2.
3.
hermes whatsapp 并从该 WhatsApp 账号扫描二维码第三步：配置 Hermes
~/.hermes/.env 文件中添加以下内容：允许所有人的简写
WHATSAPP_ALLOWED_USERS=* 设置为允许所有发送者（等同于 WHATSAPP_ALLOW_ALL_USERS=true）。这与 Signal 群组白名单 保持一致。
如需使用配对流程，请移除这两个变量，改用
私信配对系统。
~/.hermes/config.yaml 中可选的行为设置：unauthorized_dm_behavior: pair 是全局默认值。未知私信发送者将收到配对码。whatsapp.unauthorized_dm_behavior: ignore 使 WhatsApp 对未授权私信保持静默，通常更适合私人号码。会话持久化
~/.hermes/platforms/whatsapp/session 目录下。这意味着：重新配对
语音消息
.ogg opus 格式）会使用已配置的 STT 提供商自动转录：本地 faster-whisper、Groq Whisper（GROQ_API_KEY）或 OpenAI Whisper（VOICE_TOOLS_OPENAI_KEY）config.yaml 中自定义或禁用：消息格式与投递
分块
WhatsApp 兼容 Markdown
| Markdown | 渲染效果 | |
|---|---|---|
**bold** | *bold* | 粗体 |
~~strikethrough~~ | ~strikethrough~ | |
# Heading | *Heading* | 粗体文本（无原生标题） |
[link text](url) | link text (url) | 内联 URL |
工具进度
故障排查
| 问题 | 解决方案 |
|---|---|
| 二维码无法扫描 | 确保终端宽度足够（60 列以上）。尝试换用其他终端。确保从正确的 WhatsApp 账号（机器人号码，而非个人号码）扫描。 |
| 二维码过期 | 二维码约每 20 秒刷新一次。如果超时，重新运行 hermes whatsapp。 |
| 会话未持久化 | 检查 ~/.hermes/platforms/whatsapp/session 是否存在且可写。如在容器中运行，请将其挂载为持久卷。 |
| 意外退出登录 | WhatsApp 会在长时间不活跃后取消关联设备。保持手机开机并连接网络，如有需要使用 hermes whatsapp 重新配对。 |
| 桥接崩溃或重连循环 | 重启 gateway，更新 Hermes，如会话因 WhatsApp 协议变更而失效则重新配对。 |
| WhatsApp 更新后机器人停止工作 | 更新 Hermes 以获取最新桥接版本，然后重新配对。 |
| macOS："Node.js not installed"但终端中 node 可用 | launchd 服务不继承你的 shell PATH。运行 hermes gateway install 将当前 PATH 重新快照到 plist 中，然后运行 hermes gateway start。详见 Gateway 服务文档。 |
| 未收到消息 | 确认 WHATSAPP_ALLOWED_USERS 包含发送者号码（含国家代码，不含 + 或空格），或将其设为 * 允许所有人。在 .env 中设置 WHATSAPP_DEBUG=true 并重启 gateway，可在 bridge.log 中查看原始消息事件。 |
| 机器人向陌生人回复配对码 | 如需对未授权私信静默处理，在 ~/.hermes/config.yaml 中设置 whatsapp.unauthorized_dm_behavior: ignore。 |
安全
警告
WHATSAPP_ALLOWED_USERS 中填写具体手机号（含国家代码，不含 +），使用
* 允许所有人，或设置 WHATSAPP_ALLOW_ALL_USERS=true。若未配置上述任何一项，gateway 将拒绝所有传入消息作为安全措施。
~/.hermes/platforms/whatsapp/session 目录包含完整会话凭证——请像保护密码一样保护它chmod 700 ~/.hermes/platforms/whatsapp/session修改于 2026-05-31 00:25:01