前言¶

把 Agent 接到微信渠道后，界面里渠道常常是 ON / OK，发消息却没有任何回复。日志里可能只有 weixin monitor started，随后报 createTypingCallbacks is not a function，或者根本看不到 inbound 记录。这类问题往往分散在插件导入路径、openclaw.json 的 channels 与 plugins.allow 配置，以及网关是否重启几处，手工排查成本高。下面介绍 SkillHub 上的「连接微信渠道 skill」（坐标 @user_e784c2fd/weixin-link），它把现象、日志关键字和修复步骤写进标准 SKILL.md，并附带一键脚本，方便交给 Cursor 等 Agent 按步骤执行。

这是什么¶

「连接微信渠道 skill」是社区发布者 user_e784c2fd 在 SkillHub 上架的运维类 Skill（分类 business-ops，当前版本 1.0.1，来源 community）。SkillHub 页面简介仅有一行占位文案「12」，实际能力以包内的 SKILL.md、README.md 与 fix-weixin.sh 为准：面向 OpenClaw 的 openclaw-weixin 微信渠道，在已完成扫码登录的前提下，处理「渠道显示正常但收不到、回不了消息」的常见故障。

平台元数据显示：requires_api_key=false，安装本 Skill 本身不需要额外 API Key。SkillHub 统计（以抓取资料为准）：评分 100000，下载约 1410 次。

核心功能¶

经核对 Skill 包内容，已核实的能力如下。

1. 问题现象与触发语：归纳无响应、导入错误、无 inbound 日志等表现，并列出适合启用本 Skill 的用户描述（例如「微信渠道配置好了但没有回应」）。
2. 分步诊断：用 openclaw status 查看 Channels；用当日日志 /tmp/openclaw/openclaw-YYYY-MM-DD.log 过滤 weixin，对照 createTypingCallbacks is not a function、weixin not configured: missing token、plugins.allow is empty 等模式。
3. 修复 A：插件导入路径：针对 @tencent-weixin/openclaw-weixin@1.0.0 将 createTypingCallbacks 从 openclaw/plugin-sdk/channel-runtime 导入，而非错误的 command-auth 模块（文件 ~/.openclaw/extensions/openclaw-weixin/src/messaging/process-message.ts）。
4. 修复 B/C：配置 openclaw.json：根据 ~/.openclaw/openclaw-weixin/accounts.json 写入 channels.openclaw-weixin.accounts.<账户ID>.enabled，并设置 plugins.allow 包含 openclaw-weixin。
5. 重启与验证：openclaw gateway restart 后检查 weixin monitor started、inbound/outbound 日志及渠道状态。
6. 附带脚本：目录内 fix-weixin.sh 串联备份、改导入、写配置、重启与简单验证（依赖本机已安装 OpenClaw 与微信插件）。

README 中写明适用 OpenClaw 2026.3.x 及以上、微信插件 @tencent-weixin/openclaw-weixin@1.0.0；并给出官方文档与插件仓库链接。

安装与启用¶

安装 SkillHub CLI（若尚未安装）¶

按 SkillHub 安装说明 检查或安装 CLI：

command -v skillhub && skillhub --version

未安装时可执行完整安装脚本（需网络权限）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装本 Skill¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。Cursor 常用路径为 ~/.cursor/skills/。

skillhub install weixin-link --namespace user_e784c2fd --dir ~/.cursor/skills/

等价坐标写法为 @user_e784c2fd/weixin-link。官方页面亦支持将下列提示交给 AI，让其按 install 文档完成安装：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_e784c2fd/weixin-link`。

Claude Code、Codex 等客户端的 skills 目录不同（例如 ~/.claude/skills/、~/.codex/skills/），将 --dir 换成对应路径即可，命令形式相同。安装后按各客户端要求刷新或重启 Agent，使 Skill 被加载。

典型用法¶

前提¶

Skill 文档要求先完成微信渠道登录，账户写入 ~/.openclaw/openclaw-weixin/accounts.json：

openclaw channels login --channel openclaw-weixin

若渠道状态不是 ON / OK，应先处理登录，再进入修复流程。

让 Agent 按 Skill 诊断¶

用户侧描述符合「配置正常但无回复」时，Agent 读取 SKILL.md 后，可先执行状态与日志检查：

openclaw status 2>&1 | grep -A10 "Channels"

cat /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log | grep -i "weixin" | tail -30

根据日志分支执行修复 A/B/C，最后重启网关：

openclaw gateway restart

使用包内一键脚本¶

将 Skill 安装目录中的 fix-weixin.sh 放到可执行位置（或在该目录下直接运行），例如：

chmod +x fix-weixin.sh
./fix-weixin.sh

脚本会修改 process-message.ts、更新 openclaw.json、重启网关，并在日志中查找 weixin monitor started。验证阶段可从微信发测试消息，再查 outbound 是否出现 text sent OK（与 SKILL.md 中验证小节一致）。

多账号与会话隔离（可选）¶

多账户时在 channels.openclaw-weixin.accounts 下为每个账户设置 enabled: true。若需按「渠道 + 对端」隔离 DM 会话，Skill 文档给出：

openclaw config set session.dmScope "per-channel-peer"

适用场景与注意¶

适合谁：已在 OpenClaw 上接入 openclaw-weixin、完成扫码，但消息链路不通的开发者或运维；希望把排障步骤固化给 Agent 执行，而不是每次翻日志猜配置。

限制与注意：

• 本 Skill 解决的是文档中列出的导入与配置类问题，不替代微信侧账号失效、token 过期等场景；文档建议出现 session expired 时重新执行 openclaw channels login --channel openclaw-weixin。
• SKILL.md 中的 sed -i '' 示例针对 macOS BSD sed；在 Linux 上更稳妥的做法是使用包内 fix-weixin.sh 或文档中的 Node 替换片段，避免 sed 语法差异。
• 修改 openclaw.json 与插件源码前，脚本会备份；生产环境仍建议自行确认 jq/配置合并是否覆盖你已有的 channels 或 plugins 字段。
• SkillHub 列表简介过短，选用前应以安装包内 SKILL.md 为准。

结尾¶

「连接微信渠道 skill」把 OpenClaw 微信渠道「显示正常却无响应」的排查路径写进可复用的 Agent Skill，并附带自动修复脚本，适合作为 business-ops 类技能放进 Cursor 等环境。需要查看元数据或安装入口时，可使用：

• API 页：https://api.skillhub.cn/user_e784c2fd/weixin-link
• SkillHub 页：https://www.skillhub.cn/skills/user_e784c2fd/weixin-link

更深层的渠道说明见 OpenClaw 文档：https://docs.openclaw.ai/channels/openclaw-weixin