openclaw-wx-skills

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          # Windows PowerShell (也支持 pwsh 7+)
├── deploy-to-openclaw.js           # Node.js 跨平台（推荐）
├── deploy-to-openclaw.sh           # Linux / macOS Bash
└── 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

消息存储

后端自动按来源持久化消息到文件：

• 个人消息: data/messages/personal/{wxid}.jsonl
• 群聊消息: data/messages/group/{chatroom_id}.jsonl

客户部署（一步到位）

提供三种部署方式，按你的系统任选其一：

方式 1：Node.js（推荐，跨平台）

任何装了 Node.js 的系统（Windows / Linux / macOS）都能直接运行：

# 预览（不实际部署）
node deploy-to-openclaw.js --dry-run

# 正式部署
node deploy-to-openclaw.js

方式 2：Windows PowerShell

# 预览
.\deploy-to-openclaw.ps1 -DryRun

# 正式部署
.\deploy-to-openclaw.ps1

注意：不要用 node deploy-to-openclaw.ps1，.ps1 是 PowerShell 脚本不是 JS。

方式 3：Linux / macOS Bash

chmod +x deploy-to-openclaw.sh
./deploy-to-openclaw.sh --dry-run   # 预览
./deploy-to-openclaw.sh              # 正式部署

部署产物

运行后自动完成：

• 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个核心技能 + 自动应答编排