# Wechat Bot Starter

> 微信机器人快速搭建 - 基于 wechaty/itchat 的微信机器人模板。适合：想做微信自动化的开发者。

- Skill: `dvcrn/wechat-bot-starter` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dvcrn/wechat-bot-starter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/wechat-bot-starter/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/wechat-bot-starter

---


# 微信机器人快速搭建 Skill

快速搭建微信机器人，支持自动回复、消息监控、群管理。

## 技术选型

| 方案 | 优点 | 缺点 | 推荐场景 |
|------|------|------|----------|
| Wechaty | 跨平台、生态好 | 需要付费 Pad 协议 | 生产环境 |
| itchat | 免费、简单 | 易封号 | 个人测试 |
| 企业微信 | 官方支持、稳定 | 功能受限 | 企业应用 |
| ComWechat | 免费、Web 协议 | 需登录 | 小规模 |

## 快速开始

### 方案 1：Wechaty（推荐）

```bash
# 安装
npm install wechaty wechaty-puppet-wechat

# 创建机器人
cat > bot.js << 'EOF'
const { Wechaty } = require('wechaty')
const bot = new Wechaty()

bot
  .on('scan', (qrcode) => console.log('扫码登录:\n' + qrcode))
  .on('login', (user) => console.log('登录成功:', user))
  .on('message', async (msg) => {
    if (msg.text() === 'ping') {
      await msg.say('pong')
    }
  })

bot.start()
EOF

node bot.js
```

### 方案 2：itchat（简单）

```bash
# 安装
pip install itchat

# 创建机器人
cat > bot.py << 'EOF'
import itchat

@itchat.msg_register(itchat.content.TEXT)
def reply(msg):
    if msg['Text'] == 'ping':
        return 'pong'
    return None

itchat.auto_login(hotReload=True)
itchat.run()
EOF

python bot.py
```

## 功能模板

### 1. 自动回复

```python
import itchat

# 关键词回复
REPLIES = {
    '你好': '你好！有什么可以帮你的？',
    '价格': '我们的产品价格如下...',
    '联系方式': '电话：xxx，微信：xxx'
}

@itchat.msg_register(itchat.content.TEXT)
def auto_reply(msg):
    text = msg['Text']
    for keyword, reply in REPLIES.items():
        if keyword in text:
            return reply
    return None
```

### 2. 群管理

```python
import itchat

@itchat.msg_register(itchat.content.TEXT, isGroupChat=True)
def group_admin(msg):
    # 进群欢迎
    if msg['Type'] == 'note' and '加入群聊' in msg['Text']:
        return '欢迎新成员！请阅读群公告。'
    
    # 禁言词检测
    banned_words = ['广告', '推广', '加微信']
    for word in banned_words:
        if word in msg['Text']:
            # 可以调用踢人 API
            return None
```

### 3. 消息转发

```python
import itchat

TARGET_GROUP = '目标群名称'

@itchat.msg_register(itchat.content.TEXT)
def forward(msg):
    # 转发到指定群
    if msg['Text'].startswith('#转发'):
        groups = itchat.search_chatrooms(name=TARGET_GROUP)
        if groups:
            groups[0].send(msg['Text'][3:])
```

### 4. 定时发送

```python
import itchat
import schedule
import time

def morning_greeting():
    groups = itchat.search_chatrooms(name='工作群')
    if groups:
        groups[0].send('早上好！今天也要加油💪')

schedule.every().day.at('09:00').do(morning_greeting)

while True:
    schedule.run_pending()
    time.sleep(60)
```

## 接入 OpenClaw

```python
import itchat
import requests

OPENCLAW_URL = 'http://localhost:3000/api/chat'

@itchat.msg_register(itchat.content.TEXT)
def ai_reply(msg):
    # 发送给 OpenClaw
    response = requests.post(OPENCLAW_URL, json={
        'message': msg['Text'],
        'user_id': msg['FromUserName']
    })
    
    return response.json().get('reply')
```

## 配置文件

### ~/.openclaw/workspace/WECHAT-BOT.md

```yaml
# 机器人配置
bot:
  name: "小助手"
  welcome: "你好！我是小助手，有什么可以帮你？"

# 自动回复规则
auto_reply:
  - keyword: "价格"
    reply: "请查看产品目录：https://example.com"
  - keyword: "客服"
    reply: "正在为您转接人工客服..."

# 群管理
group_admin:
  banned_words: ["广告", "推广"]
  welcome_msg: "欢迎加入！请阅读群公告。"

# 定时任务
schedule:
  - time: "09:00"
    msg: "早上好！"
    target: "工作群"
```

## 注意事项

### 防封号技巧

1. **不要频繁登录** - 使用 hotReload=True
2. **控制发送频率** - 每秒不超过 1 条
3. **避免营销内容** - 容易被举报
4. **使用企业微信** - 官方支持更安全

### Web 微信限制

- 部分账号无法登录 Web 微信
- 新注册账号通常不支持
- 建议使用企业微信替代

## 推荐架构

```
微信消息
    ↓
消息队列（Redis）
    ↓
OpenClaw Agent 处理
    ↓
回复消息
```

---

创建：2026-03-12
版本：1.0