01. 三类痛点：把 ClawBot 当「又一个 Telegram」、主号绑定、Gateway 间歇离线

1）心智模型错位：ClawBot 不是你在 openclaw.json 里填一个 Bot Token 就结束的频道。它依赖微信客户端官方插件 + 终端里腾讯发布的 @tencent-weixin/openclaw-weixin-cli 生成一次性二维码完成账号级绑定。若你仍按 Telegram/Discord 的 Allowlist 与 pairing 去改微信侧配置，会浪费整晚排查「模型路由」——微信通道的合格信号是扫码成功 + Gateway 进程持续可达 + 微信联系人里出现助手会话。

2）主号与合规风险：官方说明与社区实践都强调：消息经腾讯基础设施传输并可能触发内容安全策略；敏感领域（金融、加密货币话术等）更容易被过滤。用日常主微信号绑定 ClawBot，一旦策略调整或灰度结束，影响的是你的真实社交图谱。Runbook 应默认专用小号，并把 OpenClaw 工作目录、Skills 与文件工具限制在最小权限沙箱，与多平台安装指南中的隔离原则一致。

3）Gateway「看似在线、微信侧无回」：ClawBot 要求运行 OpenClaw 的机器（或反向隧道后的等价入口）长期可达。笔记本合盖休眠、家用宽带 NAT 漂移、或 Docker 容器未设 restart 策略，都会表现为「偶尔能回、过夜必死」。这与 Teams 的 Dev Tunnel + webhook 3978 不同：微信侧没有「再配一条公网 URL」的二次机会，核心是绑定会话与 Gateway 心跳同寿。

02. ClawBot vs Telegram/Discord：官方通道决策矩阵

下表帮助你在 30 秒内判断：该走 ClawBot，还是继续用已成熟的 IM 频道插件。

维度	微信 ClawBot（官方）	Telegram / Discord（OpenClaw 频道）	短租 macOS 证据建议
接入方式	微信「设置→功能→插件」+ CLI 二维码扫码	Bot Token / OAuth + `channels.*` 配置	保存扫码前后终端 stdout（脱敏）
会话形态	仅单聊；不支持群聊（截至 2026 公开说明）	支持群、Topic、Allowlist	用测试小号发 3 条探测消息并截图时间戳
文件能力	常见描述为可收不可发（文件只进不出）	依频道插件与权限而定	勿在验收期依赖「微信回传 PDF」
封号/合规	官方通道；内容审查；灰度政策可能变更	平台 ToS + 自建 Allowlist	Runbook 写明「非主号」与数据留存策略
客户端版本	iOS 微信 ≥ 8.0.70；安卓 ≥ 8.0.69（灰度差异以官方为准）	与微信无关	绑定前截图「关于微信」版本页

若你的自动化场景强依赖群聊 @ 机器人、出站文件、或跨租户企业 IM，应优先 Teams 或 Telegram/Discord，而不是强行把 ClawBot 当万能频道。

03. 七步落地：Gateway 就绪 → 微信插件 → CLI 扫码 → 首条消息 → doctor → 权限收口 → 证据归档

确认 OpenClaw 基线：按安装指南跑通 Gateway；记录 openclaw --version、实际加载的 openclaw.json 路径、openclaw gateway status 与 openclaw doctor 输出。Node 建议 22.19+ 或文档推荐的 24.x。
微信端开启 ClawBot：更新微信至满足版本门槛 →「我」→「设置」→「功能」→「插件」→ 开启 ClawBot。若列表不可见，先升级客户端并重启，勿在未核实版本前反复扫码。
在 Gateway 主机执行官方 CLI：在运行 OpenClaw 的同一台机器（或 SSH 会话）执行安装绑定命令；终端会出现二维码，需在数分钟内用微信「扫一扫」完成确认。
扫码绑定与首条验收：绑定成功后，微信联系人中应出现助手会话。发送一条短指令（如询问版本或 /model 类命令，以你配置的模型为准），对照 Gateway 日志是否出现 inbound/outbound 事件。
doctor 与模型鉴权：若微信无回复，先查 Gateway 是否存活、模型 API Key 是否有效，再查微信侧是否被内容策略拦截；避免一上来改频道路由。
权限与目录收口：将 Agent 工作区限制在专用目录；禁用不必要的 file_write 或高危 Skills；ClawHub 第三方技能先在隔离环境试跑（可参考站内 Skills 安全文）。
证据链与擦除：脱敏保存 CLI 输出、Gateway 日志片段、微信版本截图；在按天租用机上完成验收后，解除绑定或销毁实例，删除演示 API Key。

# 在 Gateway 主机执行（腾讯官方 npm 作用域）
npx -y @tencent-weixin/openclaw-weixin-cli@latest install

# 绑定后验收（示例）
openclaw gateway status
openclaw doctor 2>&1 | tee /tmp/clawbot-doctor.txt
# 微信端：向助手发送探测消息，并对照 Gateway 日志时间戳

二维码过期：重新运行 npx 命令生成新码，不要复用截图。扫码后仍无联系人：确认 CLI 与 Gateway 是否同一台可达主机，以及防火墙是否阻断 Gateway 出站。

04. 分诊表：症状 → 优先动作 → 常见误操作

症状	优先动作	常见误操作
插件列表里没有 ClawBot	升级微信；检查灰度与地域说明；重启客户端	在旧版微信上反复安装第三方 OpenClaw 桥
扫码提示失败或过期	重新 `npx … install`；确保手机与主机时钟同步	用相册旧二维码多次尝试
能收消息、回复空白或极短	查内容审查与敏感词；换模型提供商；看 Gateway OOM	立刻重装微信主号
夜间必定断连	检查主机休眠、systemd/launchd 守护、公网可达性	仅重启微信不清 Gateway
想在群里 @ 助手	改用 Telegram/Discord/Teams 频道；ClawBot 当前不支持群聊	寻找非官方群机器人桥（封号风险）

05. 三条可引用数据、误区与 1～3 日按天租用 macOS 日程

数据 1：腾讯微信团队通过 npm 作用域 @tencent-weixin 发布 openclaw-weixin-cli，社区文档将 ClawBot 插件公开时间锚定在 2026 年 3 月 量级，可作为「官方通道」审计依据（非第三方逆向）。
数据 2：公开安装说明列出的客户端门槛为 iOS 微信 ≥ 8.0.70、安卓 ≥ 8.0.69（灰度节奏以腾讯为准）；不满足版本时，插件入口可能完全不可见。
数据 3：在 M4 按天租用节点上，若已具备 OpenClaw 基线，「CLI 扫码 + 首条双向消息 + doctor 归档」 常可压缩到 2～4 小时 单会话（团队样本）；比在家用笔记本合盖休眠后反复重绑更省一个晚上。

误区 A：认为 ClawBot 支持企业微信群机器人。误区 B：用主号绑定并授予 Agent 全盘文件权限。误区 C：未设 Gateway 守护进程就宣称「已上生产」。

第 1 日：在租机或隔离机完成 OpenClaw 安装与 doctor；傍晚开启微信插件并扫码，保存日志。

第 2 日：压测 20 轮对话、测试文件只进不出边界、记录审查触发样本（勿用真实客户数据）。

第 3 日：编写生产切换 Runbook、解除绑定、擦除密钥，决定是否保留 Telegram/Teams 作为群聊补充通道。

06. 家用 PC / 云主机 vs 按天租 Mac：扫码绑定与 Control UI 证据链

把 Gateway 放在合盖即睡的家用 Mac或无图形界面的廉价 VPS上，ClawBot 验收的隐性成本往往高于租机：你要在手机上扫码，却在另一台机器上看日志，还要担心休眠断链。短租原生 macOS 可把 npx @tencent-weixin/...、openclaw gateway status、Control UI 与钥匙串中的只读密钥放在同一证据链，再决定是否迁回主力机或云上生产。

虽然你可以用长期云主机 + systemd 跑通大部分步骤，那更适合已确定要 7×24 在线的阶段；若你仍在 1～3 天内验证「微信是否值得作为个人助手入口」，按天租用 Mac 通常更划算：避免污染主力微信号与主力开发目录。套餐见套餐价格页；连线见 SSH/VNC FAQ。