把 OpenClaw 接入微信
社区维护的 OpenClaw 微信渠道插件，提供 npm 与 ClawHub 两个安装源。
本插件需要 OpenClaw >=2026.6.1。
OpenClaw 2026.9.1 / 2026.9.2 的固定版本及运行环境 CI 覆盖见
兼容矩阵。
把下面这段话粘贴到 OpenClaw 聊天框并发送：
请安装或更新当前 OpenClaw 的微信插件。优先使用 `clawhub:openclaw-wechat`；不可用时使用 `npm:openclaw-weixin`，二选一。npm 安装或替换安装时加 `--force`。
不要先卸载，保留现有配置和登录状态。按提示确认插件能力；使用 OpenClaw 插件流程，不要直接运行 `npm install`。
之前使用下方 ClawHub 或 npm 命令安装社区版： 运行
openclaw plugins update openclaw-weixin。
首次安装、替换腾讯官方包，或现有插件通过其他来源安装： 从下面任选一个安装命令，无需先卸载。
替换现有插件时，在所选安装命令末尾加 --force。配置和登录状态会保留。
ClawHub：openclaw-wechat
openclaw plugins install clawhub:openclaw-wechatnpm：openclaw-weixin
openclaw plugins install npm:openclaw-weixin如果当前 OpenClaw 已有微信登录状态，安装后通常只需确认连接。 全新安装需要 展开完整检查并扫码绑定；安装报错、未自动恢复连接或需要确认目标账号时，也在此检查。
完整检查、扫码与恢复
仅在安装命令报告版本不兼容时检查：
openclaw --version需要 OpenClaw >=2026.6.1。若版本过低或 Nix 模式禁止安装，请不要卸载现有插件；按
安装限制与故障排查处理。
安装可能使启用了配置重载的受管 Gateway 自动重载。若仍未连接，请重启实际承载 OpenClaw 的服务、容器或 Pod，然后执行：
openclaw plugins list
openclaw channels status --probe满足以下条件即表示连接成功：
openclaw plugins list显示插件已启用，并且没有加载错误。openclaw channels status --probe对目标微信账号探测成功。- 使用多账号时，探测结果对应你准备使用的别名或账号 ID。
| 检查结果 | 下一步 |
|---|---|
| 插件显示已停用 | 执行 openclaw plugins enable openclaw-weixin，重载 Gateway，然后重新探测 |
| 插件无加载错误，且目标账号探测成功 | 已完成，无需继续操作 |
| 账号显示未登录 | 继续下面的扫码绑定 |
Channel 显示 OK 但未连接 |
按连接故障排查重载实际运行单元 |
仅在探测显示目标账号未登录时执行：
openclaw plugins enable openclaw-weixin
openclaw channels login --channel openclaw-weixin登录命令会在终端显示二维码。扫码并等待登录完成，然后再次执行：
openclaw channels status --probe如果会同时使用多个微信账号，建议先按「账号 + 渠道 + 对端」隔离私聊上下文：
openclaw config set session.dmScope per-account-channel-peer这是 OpenClaw 的全局会话设置，会影响所有渠道；它不影响账号登录，只决定之后收到的 私聊消息如何分配会话。
再次执行登录命令即可绑定其他微信账号。建议为每个号使用稳定别名，以便
openclaw.json / bindings 用可读 accountId（而不是仅服务端 hash）：
openclaw channels login --channel openclaw-weixin --account wukong
openclaw channels login --channel openclaw-weixin --account nezha账号 ID 与状态文件
登录成功后会写入：
openclaw-weixin/accounts/<ilink_bot_id 规范化>.json（凭证与状态命名空间；listAccountIds/ monitor 只用此 id）openclaw-weixin/account-aliases.json（一对一alias → hash逻辑映射，供 bindings / 出站解析；别名不会再起一条 transport）
未传 --account 时（宿主会传入 default 哨兵）只索引服务端 bot id，不会创建名为
default 的账号。已绑定过的 hash 账号再执行 login --account <alias> 时，会在
不歧义的情况下登记别名映射（不在线改名、不搬迁状态命名空间）。
凭证、账号 ID 和 context token 均为敏感数据；不要共享
~/.openclaw/openclaw-weixin/ 下的状态文件。
微信后端要求每条出站消息携带由该收件人入站消息下发的账号级 context token。插件收到 消息后会按账号保存该 token：
- 尚未收到该收件人的消息或 token 缺失时，插件会拒绝发送消息，不会返回本地“成功” 结果。
- 已保存的 token 仍可能失效；长时间无交互后发送失败时，请让收件人先向对应 bot 发送一条消息以刷新 token，再重试。
多账号部署的定时任务应同时显式设置 delivery.to 和 delivery.accountId。未指定
accountId 时，只有恰好能从账号级上下文选出一个账号才会发送；缺失或歧义都会失败。
context token 属于敏感数据，不要跨账号复制或写入任务配置。
- 详细指南：安装行为、可选配置、主动发送限制、卸载和故障排查
- 社区版与腾讯版
- 后端 API 协议
- 架构说明
- 参与贡献与 Agent 工作流：开 Issue、修复 Bug 和开发新功能
- Coding Agent 指引
- 变更日志
- 安全策略
- 问题反馈
- llms.txt：面向智能体的文档索引