概述
hermes whatsapp 用于配置 WhatsApp 桥接（Baileys）并通过二维码将其与你的 WhatsApp 账号配对。它是一个交互式向导——没有子命令。向导会引导你选择模式、设置允许的用户、安装桥接依赖并扫描二维码。配对完成后，你就可以像与任何联系人一样通过 WhatsApp 与 Hermes 聊天。
hermes whatsapp需要 TTY：向导会交互式地提示输入。
向导步骤
- 选择模式 —— 独立机器人号码（推荐）或个人号码（自言自语模式）。
- 设置允许的用户 —— 允许给 Agent 发消息的手机号（逗号分隔，
*表示任何人）。 - 安装桥接依赖 —— 首次运行会在桥接目录中执行
npm install（可能需要几分钟）。 - 检查已有会话 —— 如果
creds.json已存在，可选择保留当前配对或重新配对。 - 扫码配对 —— 在装有机器人号码的手机上打开 WhatsApp（或 WhatsApp Business），进入「已链接的设备」，扫描终端中显示的二维码。
- 启动 gateway —— 配对完成后，运行
hermes gateway即可接收消息。
示例
hermes whatsapp
# 1. 选择模式：1) 独立机器人号码（推荐） 2) 个人号码（自言自语）
# 2. 输入允许的手机号（逗号分隔，或 * 表示任何人）
# 3. 自动安装桥接依赖
# 4. 用 WhatsApp 扫描二维码 → 已链接的设备 → 链接设备
# 5. 启动 gateway：hermes gateway# 已有会话时重新运行向导
hermes whatsapp
# ✓ 发现现有 WhatsApp 会话 — 重新配对？[y/N]
# 输入 'n' 保留当前配对，输入 'y' 清除并扫描新二维码提示
- WhatsApp 只有在配对成功之后才会启用。如果提前中止向导，桥接会保持禁用状态，gateway 不会尝试启动它。
- 会话（
creds.json）存储在~/.hermes/whatsapp/session/下——请做好备份，避免重新配对。 - 生产环境请使用官方 Meta API 的
hermes whatsapp-cloud——两个适配器是互补关系，而非替代关系。