# OpenClaw WeChat Skill

微信智能体的 OpenClaw 技能集合。通过 GEWE API 实现微信消息收发、联系人管理，支持按来源（个人/群聊）分目录存储消息和基础自动应答。

## 目录结构

```
openclaw-wechat-skill/
├── __config/
│   └── wechat-credentials.template.json
├── wechat/
│   ├── wechat-check-online/       # 检查微信在线状态
│   ├── wechat-send-text/          # 发送文字消息
│   ├── wechat-get-messages/       # 获取消息列表(支持增量)
│   ├── wechat-get-conversations/  # 获取会话列表
│   ├── wechat-get-contact-list/   # 获取通讯录列表
│   └── wechat-get-contact-detail/ # 获取联系人详情
├── deploy-to-openclaw.ps1
└── README.md
```

## 自动应答编排 (Workflow)

```
workflows/
├── wechat-auto-reply.workflow.json   # 核心编排定义
└── pipeline.md                       # 流程图 + 回复策略文档
```

龙虾通过 workflow 知道自己要做什么：

```
每10秒轮询:
1. wechat-check-online           → 确认微信在线
2. wechat-get-messages(since)    → 增量拉取新消息
3. 分类消息来源:
   ├── 个人私聊 (wxid_xxx)       → AI生成个性化回复 → wechat-send-text
   └── 群聊 (xxx@chatroom)      → 仅被@或关键词触发时回复
4. 忽略: 系统消息/公众号/表情/语音等
```

### 回复策略
- **个人私聊**: 每条文字消息都AI回复，图片/语音回复确认
- **群聊**: 仅被@或包含关键词("帮我"/"请问")时回复，避免刷屏
- **忽略列表**: system/emoji/voice + weixin/fmessage/gh_*

详见 [`workflows/pipeline.md`](workflows/pipeline.md)

## 消息存储

后端自动按来源持久化消息到文件：
- 个人消息: `data/messages/personal/{wxid}.jsonl`
- 群聊消息: `data/messages/group/{chatroom_id}.jsonl`

## 客户部署（一步到位）

```powershell
# 预览（不实际部署）
.\deploy-to-openclaw.ps1 -DryRun

# 正式部署技能 + workflow + 凭证
.\deploy-to-openclaw.ps1
```

运行后自动完成：
- 6个技能 → `~/.openclaw/skills/`
- 自动应答编排 → `~/.openclaw/workflows/`
- 凭证配置 → `~/.openclaw/wechat-credentials.json`（已预设后端地址）

**客户无需额外配置**，后端统一托管在 `http://8.138.37.248/api/wechat-agent`。

部署完成后龙虾即可开始工作：轮询消息 → 分类来源 → AI生成回复 → 自动发送。

## 版本

v1.0.0 (2026-04-12) - 初始版本，6个核心技能 + 自动应答编排