whatsapp-ultimate

📱 原生协议驱动的 WhatsApp 全能管家

🥥8总安装量 2评分人数 1
100% 的用户推荐

基于 Baileys 原生协议的完整 WhatsApp 集成方案,支持消息收发、群组管理、历史搜索与媒体处理,零外部依赖实现企业级通讯自动化。

B

存在边界风险,建议在隔离环境中验证

  • 来自社区或个人来源,建议先隔离验证
  • ⚠️ 本地 SQLite 数据库存储完整消息历史,缺乏额外加密保护,设备入侵可导致敏感信息泄露
  • ⚠️ `open` 访问策略允许任意 WhatsApp 用户触发 agent,建议强制使用 `allowlist` 策略限制可信号码
  • ⚠️ 媒体下载功能可解密群组中他人的语音消息,需妥善管理下载文件存储位置
  • ✅ 提供多级访问控制(allowlist/pairing/disabled)和触发前缀机制,安全配置选项完善
  • ⚠️ 依赖第三方 Baileys 库维护,协议更新和安全补丁需及时跟进

使用说明

核心用法

whatsapp-ultimate 是 OpenClaw 平台最完整的 WhatsApp 集成技能,基于 Baileys 原生协议实现,无需 Docker 或外部 CLI 工具。该技能提供 22 种独立操作,覆盖消息发送(文本、媒体、投票、贴纸、语音、GIF)、消息交互(反应、回复、编辑、撤回)、群组全生命周期管理(创建、重命名、成员管理、权限控制)以及历史消息管理四大核心场景。

用户通过 message 工具调用各类操作,配合 whatsapp_history 工具实现基于 SQLite + FTS5 的全文搜索。历史同步功能支持通过重新链接设备拉取数年消息记录,语音消息可下载解密后转录为文本。

显著优点

功能完整性:对比 wacli 和 whatsapp-business,该技能是唯一支持投票、贴纸、语音消息、GIF、消息反应、编辑/撤回、完整群组管理等高级功能的方案。

原生集成:零外部依赖,直接通过 Baileys 与 WhatsApp 服务器通信,避免第三方 API 限制和商业账户要求。

数据主权:所有消息本地存储于 SQLite,支持全文搜索和历史导入导出,用户完全掌控数据。

灵活访问控制:提供 open/allowlist/pairing/disabled 四级策略,支持触发前缀和自聊模式,满足个人到企业的不同安全需求。

潜在缺点与局限性

格式兼容性:语音消息强制要求 OGG/Opus 格式,GIF 需转换为 MP4,贴纸需 WebP 格式,需要 ffmpeg 预处理。

反垃圾机制:WhatsApp 对批量消息和陌生联系人发送有限制,不适合大规模营销场景。

历史同步依赖:完整历史同步需重新链接设备,过程需要用户手动扫码,无法后台静默完成。

媒体时效性:下载的媒体 URL 会过期,需及时获取或保持活跃连接。

适合的目标群体

  • 需要自动化 WhatsApp 客服或通知的中小企业
  • 研究团队和社区管理员,需要归档和搜索群聊历史
  • 个人用户构建 AI 助手管理社交沟通
  • 开发者集成 WhatsApp 到现有工作流,替代官方商业 API

使用风险

性能风险:大型群组历史同步可能耗时数分钟,SQLite 在极端数据量下需优化索引。

依赖风险:Baileys 库更新可能影响协议兼容性,需关注上游安全补丁。

合规风险:自动化消息发送需遵守 WhatsApp 服务条款,避免账号封禁。

数据泄露风险:本地数据库未加密,设备入侵可导致消息历史泄露。

whatsapp-ultimate 内容

手动下载zip · 8.0 kB
SKILL.mdtext/markdown
请选择文件