WhatsApp / Telegram 接入 — 海外渠道和个人移动场景
为什么要接
WhatsApp 和 Telegram 是海外主流的聊天工具,在以下场景下接入很有用:
- 人在海外,主要通讯工具是 WhatsApp / Telegram
- 需要从手机上方便地给 Sophclaw 派活(手机 App + WhatsApp 双入口)
- 团队成员分散在不同国家,用 Telegram 作为统一协作通道
Telegram 接入(相对简单)
第一步:创建 Telegram Bot
在 Telegram 里找 @BotFather:
- 发送
/newbot命令 - 给 Bot 起个名字和用户名(用户名必须以 bot 结尾)
- BotFather 返回一个 botToken,保存好
第二步:获取你的 User ID
给 @userinfobot 发一条消息,它会返回你的 User ID(数字)。User ID 用于限制只有你自己能用这个 Bot。
第三步:在 Sophclaw 里配置
{
"channels": {
"telegram": {
"enabled": true,
"botToken": "你的 botToken",
"allowedUsers": ["你的 User ID"]
}
}
}
第四步:测试
在 Telegram 里找到你的 Bot,发一条消息测试。Bot 应该会回复 Sophclaw 的输出。
WhatsApp 接入(相对复杂)
WhatsApp 的接入比 Telegram 麻烦——WhatsApp 对自动化 Bot 的官方支持是 WhatsApp Business Platform,需要企业资质审核。
普通用户的可行路径:OpenClaw 生态支持通过 web channel runtime(Baileys Web)连接 WhatsApp Web 会话。这条路径不需要企业资质,但稳定性和合规性需要自行评估。
接入步骤概要
- 在 Sophclaw 配置里启用 whatsapp web channel
- 首次启动时扫描 WhatsApp Web 的二维码登录
- 保持 PC 上的 WhatsApp Web 会话活跃
- 在手机 WhatsApp 里发送消息给自己的号(或配置自动转发规则)
注意事项:
- WhatsApp 可能会检测非官方客户端使用,有封号风险
- 会话需要保持活跃,长时间断线后可能需要重新扫码
- 这条路径适用于个人用户小范围使用,不建议做大规模商业用途
渠道之间的差异
| 对比 | Telegram | 飞书/钉钉 | |
|---|---|---|---|
| 接入难度 | 简单(BotFather 一站式) | 中(Web 模式需要扫码) | 中(开发者后台) |
| 稳定性 | 高 | 中(Web 会话易断) | 高(企业级) |
| 合规风险 | 低 | 有封号风险 | 低 |
| 适合场景 | 海外个人/小团队 | 海外个人测试 | 企业内部 |
多渠道并存
Sophclaw 支持同时接多个渠道。如果你既有飞书团队、又想用 Telegram 做个人入口,完全可以:
- 飞书 channel 绑定飞书 Agent(workspace 隔离)
- Telegram channel 绑定主 Agent
- 各自的记忆和文件互不干扰
详细配置参考多 Agent 工作区隔离。