想在个人微信里直接指挥自己养的 OpenClaw「龙虾」，却分不清微信 ClawBot 插件与 Gateway 谁该先装？本文面向 2026 年已跑通或准备跑通 OpenClaw、要用腾讯官方 openclaw-weixin 渠道的开发者，给出安装前检查、npx @tencent-weixin/openclaw-weixin-cli install 与手动四步对照、2.0.x / legacy 版本矩阵、多账号 dmScope，以及微信侧单聊/文件/保活等生产注意事项；并与站内 Telegram 排错、channels probe、半安装恢复文分工，避免装错阶段。
腾讯在 2026 年推出的微信 ClawBot（设置 → 插件）是官方渠道入口；真正执行技能、调用大模型的是跑在你电脑或服务器上的 OpenClaw Gateway。社区把 OpenClaw 戏称为「龙虾」，ClawBot 则是微信里的那根「电话线」——线没接好，Gateway 再健康也收不到微信消息。
只装微信插件、没装 OpenClaw：扫码可能成功，但没有任何 Agent 处理 inbound。
OpenClaw 版本过旧：插件 2.0.x 要求宿主 >=2026.3.22，否则启动时报 requires OpenClaw >=2026.3.22 并拒绝加载。
Gateway 未常驻：笔记本合盖、Docker 未设 restart、Linux VPS 未装 systemd——表现为「昨天还能聊，今天全哑火」。
把 ClawBot 当成腾讯版元宝：元宝是腾讯自有模型产品；ClawBot 连的是你自己的 OpenClaw 与模型配置，自由度更高，运维责任也在你。
多微信号共用一个会话桶：默认私聊可能串上下文；多账号登录后未设 session.dmScope，会出现 A 用户话术回复给 B。
忽略微信产品限制：官方渠道当前仅单聊、不进群，且文件处理有「只进不出」等边界——见第四节。
| 维度 | 官方 ClawBot 插件 | 企业微信自建应用 | Telegram Bot（OpenClaw 内置） |
|---|---|---|---|
| 适合谁 | 个人快速尝鲜、单聊自动化 | 团队、要进群/合规通道 | 海外/开发者社区、群聊门控成熟 |
| 安装复杂度 | 低：openclaw-weixin-cli + 扫码 | 高：公网 IP、回调 URL、可信 IP | 中：Bot Token + pairing |
| 微信版本 | 建议 8.0.70+（插件入口） | 插件扫码关注企业号 | 不适用 |
| 群聊 | 不支持 | 可扩展 | 支持（需 mention 等策略） |
| 排错专文 | 本文 | 企业微信插件文档 | 部署后三联症 |
「能在微信里发消息」不等于「渠道已闭环」——插件 enabled、Gateway restart、probe 通过，三件套缺一不可。
推荐顺序：先确认 OpenClaw 与 Node 基线（可参考 Node 24 生产部署），再装微信插件。若 Gateway 尚不存在，请先读 半安装恢复。
检查宿主版本：openclaw --version；若 < 2026.3.22 且要用插件 2.0.x，先 openclaw update 或准备走 legacy 线（见下节）。
一键安装（推荐）：npx -y @tencent-weixin/openclaw-weixin-cli install — 自动检测版本、plugins install、引导扫码并重启 Gateway。
手动安装（等价四步）：openclaw plugins install "@tencent-weixin/openclaw-weixin" → openclaw config set plugins.entries.openclaw-weixin.enabled true → openclaw channels login --channel openclaw-weixin → openclaw gateway restart。
微信端确认：微信 8.0.70+，路径「我 → 设置 → 插件」可见「微信 ClawBot」；安卓若未灰度到，可据社区流程通过 CLI 扫码触发插件更新（关闭微信后可能需重扫）。
多账号与观测（可选）：再次 channels login 可增账号；多号时 openclaw config set session.dmScope per-account-channel-peer；在 openclaw.json 配置 channels.openclaw-weixin.botAgent 便于日志归因（仅观测，不参与鉴权）。
验收探针：openclaw channels status --probe + openclaw doctor --deep；从微信给 Bot 发测试句，同时 openclaw logs --follow 看 inbound。配对/静默问题叠加时读 channels probe 专文。
# 2026 腾讯微信渠道 — 一键 + 验收 npx -y @tencent-weixin/openclaw-weixin-cli install openclaw --version openclaw channels status --probe openclaw doctor --deep openclaw logs --follow # 版本过旧时安装 legacy 插件线 openclaw plugins install @tencent-weixin/openclaw-weixin@legacy
提示：npm 在国内网络慢时，可将 registry 切到镜像源后再执行 npx；插件安装失败时勿反复扫码，先保证 openclaw plugins list 中条目存在。
注意：消息经腾讯官方通道，会经过内容安全审查；敏感领域词汇可能触发过滤。生产环境建议用小号绑定、主号仅作观察。
| 插件线 | OpenClaw 宿主 | npm dist-tag | 典型报错 |
|---|---|---|---|
| 2.0.x | >= 2026.3.22 | latest | 宿主过旧 → 升级 OpenClaw |
| 1.0.x | >= 2026.1.0 < 2026.3.22 | legacy | 安装 @legacy 而非强行升宿主 |
把 Gateway 放在会睡眠的笔记本上，微信渠道会在合盖后集体失联；而独占、长期在线的 macOS 节点更适合 7×24 微信自动化。若你需要像租 VPS 一样快速拿到可 SSH 维护、可把「六步 Runbook」写进标准镜像的 Mac 算力，NodeMini 的 Mac Mini 云端租赁通常是更优解：与 远程 Mac launchd 常驻、iOS CI 同机编排同一运维心智，减少「家里 Gateway 睡着、公司微信还在等回复」的割裂体验。