前言¶
把 Agent 接到即时通讯里，常见做法是单独写桥接服务或维护一套 Webhook。若你已经在用 OpenClaw 做多渠道编排，更省事的路径是直接装官方 WhatsApp 通道插件，走 QR 登录、统一配置私聊与群策略。下面介绍 SkillHub 上的社区 Skill openclaw-whatsapp-qinghong：它把 @openclaw/whatsapp 插件打成可安装包，便于在国内通过 SkillHub 拉取。
这是什么¶
openclaw-whatsapp-qinghong 坐标为 @user_5c68097a/openclaw-whatsapp-qinghong，版本 1.0.0，来源 community，分类 business-ops，由 user_5c68097a 发布。SkillHub 页面标注 requires_api_key=false（安装该 Skill 本身不强制填写 API Key）。
包内附带 npm 包 @openclaw/whatsapp（构建版本 2026.5.7），描述为「OpenClaw WhatsApp channel plugin」，上游仓库指向 openclaw/openclaw。通道在 OpenClaw 中的 id 为 whatsapp，对接方式为 WhatsApp Web（QR link），说明文案为：使用你自己的号码；建议使用独立手机或 eSIM。
需要说明：根目录 SKILL.md 当前仅为占位内容（test），Agent 侧自然语言指引很少；实际能力来自 bundled 的 OpenClaw 插件与 openclaw.plugin.json 中的通道配置 schema。因此它主要面向 OpenClaw 宿主，而不是给 Cursor / Claude Code 等通用「Markdown Skill」单独用的工作流说明。
核心功能¶
以下均来自包内 package.json、openclaw.plugin.json 与编译产物可核对的能力描述。
通道与登录¶
- 注册 whatsapp 通道，支持 QR 扫码登录（
selectionLabel: WhatsApp (QR link)）。 - 支持通过
--auth-dir <path>覆盖 WhatsApp 认证目录；认证状态可持久化（persistedAuthState）。 - 依赖 @whiskeysockets/baileys
7.0.0-rc.9连接 WhatsApp Web。
消息与动作¶
- 出站能力包括 发送消息、投票（polls）、表情反应（reactions），由
channels.whatsapp.actions下的sendMessage/polls/reactions开关控制。 - 支持长文 分块（
textChunkLimit、chunkMode:length或newline）、流式块合并（blockStreaming、blockStreamingCoalesce）、去抖合并（debounceMs，默认 0 表示关闭）。 - 可选 已读回执（
sendReadReceipts）、回复模式（replyToMode:off/first/all/batched）。
访问控制与会话¶
- 私聊策略 dmPolicy：
pairing（默认）、allowlist、open、disabled；文档提示open需配置channels.whatsapp.allowFrom=["*"]。 - 群策略 groupPolicy：默认
allowlist，可选open、disabled。 - allowFrom / groupAllowFrom 白名单、selfChatMode（同机自用号）、按群 requireMention、按联系人或群定制 systemPrompt。
- 多账号：
channels.whatsapp.accounts与defaultAccount；单账号可设authDir、mediaMaxMb（默认媒体上限 50 MB）。
插件钩子¶
- 可选
pluginHooks.messageReceived：向已加载插件广播入站 WhatsAppmessage_received钩子载荷。
宿主版本要求¶
openclawpeerDependencies:>=2026.5.7- 安装元数据 minHostVersion:
>=2026.4.25，pluginApi 兼容>=2026.5.7
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可按 SkillHub 官方说明执行：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安装本 Skill 到 OpenClaw 的 skills 目录¶
SkillHub 要求 --dir 指向当前 Agent 能识别的 skills 目录；OpenClaw 及其变体使用各自的 skills 路径。安装命令形如：
skillhub install @user_5c68097a/openclaw-whatsapp-qinghong --dir <你的 OpenClaw skills 目录>
也可让 Agent 按官方提示安装（SkillHub 页面给出的话术为：根据 https://skillhub.cn/install/skillhub.md 安装 @user_5c68097a/openclaw-whatsapp-qinghong）。
3. 在 OpenClaw 中启用 WhatsApp 通道¶
插件通过 OpenClaw 的通道配置写入 channels.whatsapp（或多账号下的 channels.whatsapp.accounts.<id>）。openclaw.plugin.json 中通道标签为 WhatsApp，并指向文档路径 /channels/whatsapp（OpenClaw 文档站内路径）。
若不走 SkillHub 包、直接与上游 npm 对齐，包内声明的安装方式为：
"install": {
"npmSpec": "@openclaw/whatsapp",
"defaultChoice": "npm",
"minHostVersion": ">=2026.4.25"
}
具体 openclaw CLI 子命令以你本机安装的 OpenClaw 版本为准；setup 流程会引导填写主人号码（E.164）、白名单，并可检测 creds.json 是否已链接。
Cursor / Codex CLI / Claude Code¶
SkillHub 通用路径示例：Cursor 为 ~/.cursor/skills/，Codex 为 ~/.codex/skills/ 或项目下 .agents/skills/，Claude Code 为 ~/.claude/skills/。本 Skill 的核心是 OpenClaw 插件产物，仅复制到上述目录不会让非 OpenClaw 客户端自动获得 WhatsApp 通道；若你的目标是在 OpenClaw 里接 WhatsApp，应把 --dir 指向 OpenClaw 的 skills 目录并完成宿主侧的通道 setup。
典型用法¶
通过 SkillHub 安装¶
skillhub install @user_5c68097a/openclaw-whatsapp-qinghong --dir <OpenClaw skills 目录>
安装完成后，在 OpenClaw 中走 WhatsApp 通道 setup（QR 登录、填写个人号码做 allowlist 等）。setup 向导中会提示：需要主人号码以便 OpenClaw 将你加入白名单，并可在「独立手机专用于 OpenClaw」与自用号模式间选择。
配置片段示例（字段以 schema 为准）¶
下列 JSON 仅展示常见字段组合，实际需并入 OpenClaw 总配置并满足 schema 必填项（含 dmPolicy、groupPolicy、debounceMs、mediaMaxMb）：
{
"channels": {
"whatsapp": {
"enabled": true,
"dmPolicy": "pairing",
"groupPolicy": "allowlist",
"debounceMs": 0,
"mediaMaxMb": 50,
"allowFrom": ["+15555550123"],
"actions": {
"sendMessage": true,
"reactions": true,
"polls": true
}
}
}
}
登录与监听由插件运行时负责；入站消息是否转发给其它插件，取决于是否开启 pluginHooks.messageReceived。
适用场景与注意¶
适合谁
- 已部署 OpenClaw（或兼容其插件 API 的宿主），需要在 business-ops 场景把客户或同事 WhatsApp 会话接到 Agent。
- 希望从 SkillHub 一键拉取社区镜像，而不是自行从 npm 拼装
@openclaw/whatsapp。
限制与注意
- SkillHub 元数据：评分 100000，下载 871（以 SkillHub 抓取为准）；安装 0 仅表示站内统计，不代表不可用。
SKILL.md无完整操作文档，排障与最佳实践应优先查 OpenClaw 文档路径/channels/whatsapp及上游仓库。- 使用个人号码有封号与合规风险；插件文案建议 独立手机 + eSIM。
- WhatsApp Web 方案依赖 Baileys 与本地认证目录，需妥善保管
authDir与creds.json。 - SkillHub 标签 requires_api_key=false 指 Skill 安装层面；WhatsApp 本身仍受 Meta 服务条款与你的号码策略约束。
结尾¶
openclaw-whatsapp-qinghong 的价值在于：通过 SkillHub 分发 OpenClaw 官方 WhatsApp 通道插件，集中提供 QR 登录、私聊/群策略、多账号与消息动作等配置能力。若你要在 OpenClaw 上接 WhatsApp，可从官方 Skill 页获取坐标并安装。
- SkillHub：https://www.skillhub.cn/skills/user_5c68097a/openclaw-whatsapp-qinghong
- API 入口：https://api.skillhub.cn/user_5c68097a/openclaw-whatsapp-qinghong
