Agent skill

Wechat Channel

by aAAaqwq in aAAaqwq/AGI-Super-Team

微信 (WeChat) 与 OpenClaw 的双向集成通道。基于 Wechaty + PadLocal 实现微信消息的接收和发送,支持私聊、群聊、@提及检测、图片/文件传输。当需要通过微信与 AI 助手交互、接收微信消息触发 AI 响应、或从 OpenClaw 发送消息到微信时使用此技能。

MITAuto-check: notesProductivity & Automation

Install Wechat Channel

skills CLI
$ npx skills add aAAaqwq/AGI-Super-Team --skill wechat-channel -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aAAaqwq/AGI-Super-Team wechat-channel --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aAAaqwq/AGI-Super-Team.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/wechat-channel .claude/skills/wechat-channel && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
wechat-channel
GitHub stars
105
Used in
1 other repo
Token cost
~1.3k tokens
SKILL.md length
195 words
Files
5 (incl. scripts, references)
Skills in repo
152
Repo updated
First seen
Licence
MIT

At a glance

微信 (WeChat) 与 OpenClaw 的双向集成通道。基于 Wechaty + PadLocal 实现微信消息的接收和发送,支持私聊、群聊、@提及检测、图片/文件传输。当需要通过微信与 AI 助手交互、接收微信消息触发 AI 响应、或从 OpenClaw 发送消息到微信时使用此技能。

  • Works in 9 steps: Wechaty Bridge (消息桥接服务) → OpenClaw Webhook 接收器 → 消息发送 API → …
  • Tasks that involve Messaging and chat bots
  • SKILL.md covers 架构概述, 核心组件, 快速开始 and 配置说明, plus 5 more sections
  • Runs JavaScript scripts from its folder; calls curl, npm and node; reaches pad-local.com; needs PADLOCAL_TOKEN and OPENCLAW_WEBHOOK_SECRET

What it does

Wechat Channel is an agent skill from aAAaqwq/AGI-Super-Team. 微信 (WeChat) 与 OpenClaw 的双向集成通道。基于 Wechaty + PadLocal 实现微信消息的接收和发送,支持私聊、群聊、@提及检测、图片/文件传输。当需要通过微信与 AI 助手交互、接收微信消息触发 AI 响应、或从 OpenClaw 发送消息到微信时使用此技能。

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `TODO.md`, `package.json` and `references/wechaty-api.md`).

It sits in Productivity & Automation, covering Messaging and chat bots. It works with WeChat. The repository describes itself as: An installable, cross-framework AI organization: C-suite agents, expert subagents, curated skills, independent review, and one-command setup across 18 AI client/runtime adapters. The licence is MIT.

When your agent uses it

  • Tasks that involve Messaging and chat bots

Example prompts

  • “/wechat-channel”

Requirements

  • Node.js
  • A credential in PADLOCAL_TOKEN
  • A credential in YOUR_PADLOCAL_TOKEN
  • Pre-approved tools (allowed-tools): Bash, Read, Write, Edit

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Wechaty Bridge (消息桥接服务)
  2. OpenClaw Webhook 接收器
  3. 消息发送 API
  4. 安装依赖
  5. 配置环境变量
  6. 启动服务
  7. 个人助手
  8. 群聊助手
  9. 自动化通知

What it can do on your machine

Read from SKILL.md and the folder at commit 331ecd3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Write
    • Edit

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • curl
    • npm
    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • pad-local.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • PADLOCAL_TOKEN
    • OPENCLAW_WEBHOOK_SECRET

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Wechat Channel loads about 1.3k tokens when it runs, and up to ~2.6k if it reads all its reference files. Until then it costs about 40 tokens; SKILL.md has 195 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~40
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:69
    cp .env.example .env
  • NoteMentions a .env fileSKILL.md:70
    # 编辑 .env 填入配置
  • NoteMentions a .env fileSKILL.md:82
    ### 环境变量 (.env)
  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Write, Edit

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from aAAaqwq/AGI-Super-Team at commit 331ecd3, republished under its MIT licence (© aAAaqwq). 195 words, ~1,267 tokens.

Download SKILL.mdSave it as .claude/skills/wechat-channel/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
wechat-channel
description
微信 (WeChat) 与 OpenClaw 的双向集成通道。基于 Wechaty + PadLocal 实现微信消息的接收和发送,支持私聊、群聊、@提及检测、图片/文件传输。当需要通过微信与 AI 助手交互、接收微信消息触发 AI 响应、或从 OpenClaw 发送消息到微信时使用此技能。
allowed-tools
Bash, Read, Write, Edit
author
Daniel Li

微信 Channel 集成

  • Author: Daniel Li
  • Copyright © Daniel Li. All rights reserved.

将微信接入 OpenClaw,实现双向消息通道。

架构概述

┌─────────────┐     ┌──────────────────┐     ┌─────────────┐
│   微信用户   │ ←→  │  Wechaty Bridge  │ ←→  │  OpenClaw   │
│  (私聊/群聊) │     │  (PadLocal协议)   │     │   Gateway   │
└─────────────┘     └──────────────────┘     └─────────────┘
                           ↓
                    ┌──────────────────┐
                    │   消息格式转换    │
                    │   - 文本/图片/文件 │
                    │   - @提及检测     │
                    │   - 群聊/私聊路由  │
                    └──────────────────┘

核心组件

1. Wechaty Bridge (消息桥接服务)

独立运行的 Node.js 服务,负责:

  • 微信登录(扫码)
  • 消息收发
  • 联系人/群组管理
  • 与 OpenClaw Gateway 通信
2. OpenClaw Webhook 接收器

接收来自 Wechaty Bridge 的消息,转发给 AI Agent。

3. 消息发送 API

OpenClaw Agent 通过 HTTP API 发送消息到微信。

快速开始

前置条件
  • Node.js >= 18
  • PadLocal Token(付费服务,约 ¥200/月)
  • OpenClaw Gateway 运行中
1. 安装依赖
bash
cd /home/aa/clawd/skills/wechat-channel
npm init -y
npm install wechaty wechaty-puppet-padlocal axios dotenv
2. 配置环境变量
bash
cp .env.example .env
# 编辑 .env 填入配置
3. 启动服务
bash
node scripts/wechat-bridge.js
# 扫描终端显示的二维码登录

配置说明

环境变量 (.env)
env
# PadLocal Token (必需)
# 获取方式: https://pad-local.com
PADLOCAL_TOKEN=YOUR_PADLOCAL_TOKEN

# OpenClaw Gateway 配置
OPENCLAW_GATEWAY_URL=http://127.0.0.1:18789
OPENCLAW_WEBHOOK_SECRET=your_webhook_secret

# 微信 Bot 配置
WECHAT_BOT_NAME=OpenClaw助手

# 安全配置
# 允许的用户微信ID (逗号分隔,留空允许所有)
ALLOWED_USERS=wxid_xxx,wxid_yyy
# 允许的群聊ID (逗号分隔,留空允许所有)
ALLOWED_GROUPS=xxx@chatroom,yyy@chatroom

# 群聊行为
# 是否需要@才响应群消息
REQUIRE_MENTION_IN_GROUP=true

# 日志级别
LOG_LEVEL=info
OpenClaw 配置 (openclaw.json)
json
{
  "channels": {
    "wechat": {
      "enabled": true,
      "webhookUrl": "http://localhost:3001/webhook",
      "webhookSecret": "your_webhook_secret",
      "dmPolicy": "allowlist",
      "allowFrom": ["wxid_xxx", "wxid_yyy"],
      "groups": {
        "xxx@chatroom": {
          "name": "工作群",
          "requireMention": true
        }
      }
    }
  }
}

消息格式

接收消息 (Webhook Payload)
json
{
  "type": "message",
  "channel": "wechat",
  "messageId": "msg_123456",
  "from": {
    "id": "wxid_sender",
    "name": "张三",
    "alias": "zhangsan"
  },
  "chat": {
    "id": "wxid_sender",
    "type": "private"
  },
  "text": "你好,帮我查一下天气",
  "timestamp": 1706745600000,
  "mentions": [],
  "replyTo": null
}
群聊消息
json
{
  "type": "message",
  "channel": "wechat",
  "messageId": "msg_789012",
  "from": {
    "id": "wxid_sender",
    "name": "张三"
  },
  "chat": {
    "id": "xxx@chatroom",
    "type": "group",
    "name": "工作群"
  },
  "text": "@OpenClaw助手 帮我总结一下今天的会议",
  "mentions": ["bot_wxid"],
  "isMentioned": true
}
发送消息 (API)
bash
# 发送文本
curl -X POST http://localhost:3001/api/send \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SECRET" \
  -d '{
    "to": "wxid_receiver",
    "type": "text",
    "content": "收到,正在处理..."
  }'

# 发送图片
curl -X POST http://localhost:3001/api/send \
  -H "Content-Type: application/json" \
  -d '{
    "to": "wxid_receiver",
    "type": "image",
    "url": "https://example.com/image.png"
  }'

# 发送文件
curl -X POST http://localhost:3001/api/send \
  -d '{
    "to": "wxid_receiver",
    "type": "file",
    "path": "/path/to/file.pdf",
    "filename": "report.pdf"
  }'

安全策略

私聊策略 (dmPolicy)
策略说明
open允许所有人私聊(危险)
allowlist仅允许 allowFrom 列表中的用户
pairing需要配对审批
群聊策略
配置说明
requireMention: true必须@机器人才响应
allowFrom群内允许触发的用户列表

使用场景

1. 个人助手
用户: 帮我查一下明天北京的天气
Bot: 明天北京天气:晴,温度 -5°C ~ 5°C,建议穿羽绒服。
2. 群聊助手
用户: @OpenClaw助手 总结一下刚才的讨论
Bot: 刚才讨论的要点:
1. 项目进度需要加快
2. 下周三前完成设计稿
3. 周五进行代码评审
3. 自动化通知
javascript
// 从 OpenClaw Agent 发送通知
await sendWechatMessage({
  to: 'xxx@chatroom',
  text: '⚠️ 服务器 CPU 使用率超过 90%,请检查!'
});

故障排查

登录问题

问题: 扫码后无法登录 解决:

  1. 检查 PadLocal Token 是否有效
  2. 确认微信账号未被限制
  3. 尝试重新获取 Token
消息收发问题

问题: 消息发送失败 解决:

  1. 检查网络连接
  2. 确认目标用户/群组 ID 正确
  3. 查看日志中的错误信息
连接断开

问题: 服务运行一段时间后断开 解决:

  1. 使用 PM2 管理进程,自动重启
  2. 检查 PadLocal 服务状态
  3. 实现心跳检测和重连机制

限制说明

PadLocal 限制
  • 需要付费 Token(约 ¥200/月)
  • 单 Token 只能登录一个微信号
  • 可能受微信风控影响
微信平台限制
  • 发送频率限制(建议间隔 1-2 秒)
  • 群聊人数限制
  • 文件大小限制(约 100MB)
  • 不支持小程序消息
功能限制
  • 不支持语音消息转文字(需额外集成)
  • 不支持视频号内容
  • 红包、转账等敏感功能不可用

相关文件

  • scripts/wechat-bridge.js - 主服务代码
  • scripts/message-handler.js - 消息处理逻辑
  • .env.example - 环境变量模板
  • references/wechaty-api.md - Wechaty API 参考

TODO

  • 获取 PadLocal Token
  • 配置 OpenClaw Webhook 接收
  • 测试私聊消息收发
  • 测试群聊 @提及
  • 配置安全策略
  • 部署为系统服务
  • 实现断线重连
  • 添加消息队列(高并发场景)

© aAAaqwq, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts, references) in skills/wechat-channel of aAAaqwq/AGI-Super-Team.

  • SKILL.md
  • TODO.md
  • package.json
  • references/wechaty-api.md
  • scripts/wechat-bridge.js

Open the folder on GitHubat commit 331ecd3

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in aAAaqwq/AGI-Super-Team, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Wechat Channel next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Wechat Channel compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wechat Channel this skillaAAaqwq/AGI-Super-Team1051 repos~1.3kAutomated safety check: NotesMIT
Weixin Accessqufei1993/cc-weixin154—~372Automated safety check: PassMIT
Add WeChat Channelnanocoai/nanoclaw31k—~1.9kAutomated safety check: NotesMIT
Cloudbase Wechat IntegrationTencentCloudBase/CloudBase-AI-Toolkit1.1k2 repos~1.9kAutomated safety check: PassMIT
Minimal Web Baas DemoTencentCloudBase/CloudBase-AI-Toolkit1.1k1 repos~2.2kAutomated safety check: PassMIT
Miniprogram DevelopmentLeoYeAI/openclaw-master-skills2.2k1 repos~2kAutomated safety check: PassMIT

Similar skills

  • Weixin Access

    qufei1993/cc-weixin

    Manage WeChat access control (pairing codes and allowlist). An agent skill from qufei1993/cc-weixin.

    154 GitHub stars~372 tokensUpdated 5 mo ago
    Productivity & AutomationAuto-check passed
  • Add WeChat Channel

    nanocoai/nanoclaw

    Adds a personal WeChat channel to a NanoClaw install through Tencent's iLink Bot API, with QR-code login and long polling instead of a public webhook.

    31k GitHub stars~1.9k tokensUpdated 2 days ago
    Productivity & AutomationAuto-check: notes
  • Cloudbase Wechat Integration

    TencentCloudBase/CloudBase-AI-Toolkit

    CloudBase WeChat integration guide for Mini Program WeChat Pay, Mini Program virtual payment (虚拟支付, wx.requestVirtualPayment), Official Account JSAPI Pay, Native QR-code Pay, Official Account OAuth…

    1.1k GitHub starsUsed in 2 repos~1.9k tokens
    Productivity & AutomationAuto-check passed
  • Minimal Web Baas Demo

    TencentCloudBase/CloudBase-AI-Toolkit

    Fast path for a minimal CloudBase Web + database demo (最小前后端 / 最小可用 fullstack / Lovable-like BaaS).

    1.1k GitHub starsUsed in 1 repo~2.2k tokens
    Productivity & AutomationAuto-check passed
  • Miniprogram Development

    LeoYeAI/openclaw-master-skills

    WeChat Mini Program development rules. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub starsUsed in 1 repo~2k tokens
    Productivity & AutomationAuto-check passed
  • Wechat Miniprogram

    infometa/workbuddyskills

    WeChat Mini Program (微信小程序) development framework. An agent skill from infometa/workbuddyskills.

    344 GitHub stars~1.5k tokensUpdated yesterday
    Productivity & AutomationAuto-check: notes

More from aAAaqwq/AGI-Super-Team

All 152 skills in this repo
  • Content Creator

    aAAaqwq/AGI-Super-Team

    Create SEO-optimized marketing content with consistent brand voice.

    105 GitHub starsUsed in 3 repos~1.9k tokens
    Auto-check passed
  • Financial Calculator

    aAAaqwq/AGI-Super-Team

    Advanced financial calculator with future value tables, present value, discount calculations, markup pricing, and compound interest.

    105 GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Frontend Design Ultimate

    aAAaqwq/AGI-Super-Team

    Create distinctive, production-grade static sites with React, Tailwind CSS, and shadcn/ui — no mockups needed.

    105 GitHub starsUsed in 2 repos~2.7k tokens
    Auto-check passed
  • Sysadmin Toolbox

    aAAaqwq/AGI-Super-Team

    Tool discovery and shell one-liner reference for sysadmin, DevOps, and security tasks.

    105 GitHub starsUsed in 2 repos~775 tokens
    Auto-check passed
  • Zsxq Smart Publish

    aAAaqwq/AGI-Super-Team

    Publish and manage content on 知识星球 (zsxq.com). An agent skill from aAAaqwq/AGI-Super-Team.

    105 GitHub stars~1.5k tokensUpdated 11 days ago
    Auto-check passed
  • Content Extract

    aAAaqwq/AGI-Super-Team

    Robust URL-to-Markdown extraction for OpenClaw workflows. An agent skill from aAAaqwq/AGI-Super-Team.

    105 GitHub starsUsed in 1 repo~650 tokens
    Auto-check passed

Works with

Questions about Wechat Channel

What does Wechat Channel do?

微信 (WeChat) 与 OpenClaw 的双向集成通道。基于 Wechaty + PadLocal 实现微信消息的接收和发送,支持私聊、群聊、@提及检测、图片/文件传输。当需要通过微信与 AI 助手交互、接收微信消息触发 AI 响应、或从 OpenClaw 发送消息到微信时使用此技能。. Wechat Channel is an agent skill from aAAaqwq/AGI-Super-Team.

When should I use Wechat Channel?

Wechat Channel fits situations like: tasks that involve Messaging and chat bots.

How do I install Wechat Channel in Claude Code?

Run `npx skills add aAAaqwq/AGI-Super-Team --skill wechat-channel -a claude-code`. Or copy the skill folder (skills/wechat-channel in aAAaqwq/AGI-Super-Team) into .claude/skills/wechat-channel in your project. Claude Code loads it when a task matches its description.

How do I install Wechat Channel in Codex?

Run `npx skills add aAAaqwq/AGI-Super-Team --skill wechat-channel -a codex`. Or copy the skill folder (skills/wechat-channel in aAAaqwq/AGI-Super-Team) into .agents/skills/wechat-channel in your project. Codex loads it when a task matches its description.

Can I use Wechat Channel in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aAAaqwq/AGI-Super-Team --skill wechat-channel -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wechat-channel, .gemini/skills/wechat-channel, .github/skills/wechat-channel and .opencode/skills/wechat-channel in your project.

What does Wechat Channel need to run?

Going by SKILL.md and its folder, Wechat Channel needs JavaScript for the scripts in its folder, the command-line tools its instructions call (curl, npm and node) and credentials named PADLOCAL_TOKEN and OPENCLAW_WEBHOOK_SECRET. Our summary lists: Node.js; A credential in PADLOCAL_TOKEN; A credential in YOUR_PADLOCAL_TOKEN. Its frontmatter pre-approves these tools: Bash, Read, Write, Edit.

Does Wechat Channel access the network?

SKILL.md names 1 domain. In commands or code: pad-local.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Wechat Channel safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file; pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Wechat Channel use?

Wechat Channel is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Wechat Channel use?

About 1.3k tokens (SKILL.md is roughly 5.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.3k tokens, read only when the agent opens those files.

What are the alternatives to Wechat Channel?

Skills that share tags, products or a category with Wechat Channel: Weixin Access (qufei1993/cc-weixin, 154 stars), Add WeChat Channel (nanocoai/nanoclaw, 31k stars), Cloudbase Wechat Integration (TencentCloudBase/CloudBase-AI-Toolkit, 1.1k stars) and Minimal Web Baas Demo (TencentCloudBase/CloudBase-AI-Toolkit, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wechat Channel?

aAAaqwq (a GitHub user) maintains it in aAAaqwq/AGI-Super-Team, which has 105 GitHub stars. The repository holds 152 skills in this directory. The repository was last updated on September 27, 2026.

Source: aAAaqwq/AGI-Super-Team on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.