- name
- wechat-sender
- description
- 通过OpenClaw微信通道主动发送消息。Use when: (1) 用户要求发送微信消息, (2) 需要主动推送微信通知, (3) 定时发送微信消息, (4) 批量发送微信消息。支持文字、图片、文件等多种消息类型。
WeChat Sender Skill
通过OpenClaw的openclaw-weixin通道主动发送微信消息。
工作原理
本Skill利用OpenClaw Gateway与微信客户端的WebSocket连接，通过发送特定格式的消息包实现主动推送。
前置条件
- OpenClaw Gateway已运行
openclaw gateway status- 微信通道已配置
- openclaw-weixin 插件已启用 - 微信客户端已扫码登录
- 目标联系人已存在聊天记录
- 首次使用前需先收到对方消息或手动发送过消息
使用方法
发送文字消息
# 使用脚本发送
python3 scripts/send_message.py --to "联系人备注名" --text "消息内容"
# 示例
python3 scripts/send_message.py --to "张三" --text "你好，这是一条测试消息"发送图片
python3 scripts/send_message.py --to "联系人备注名" --image "/path/to/image.jpg"发送文件
python3 scripts/send_message.py --to "联系人备注名" --file "/path/to/document.pdf"安全限制
| 限制项 | 说明 |
|---|---|
| 联系人白名单 | 只能发送给已存在的聊天对象 |
| 频率限制 | 个人号20条/分钟，超过会被限制 |
| 内容审核 | 敏感词会被拦截 |
| 用户确认 | 首次使用需用户显式授权 |
API参考
发送消息接口
POST http://127.0.0.1:18789/api/wechat/send
Content-Type: application/json
{
"channel": "openclaw-weixin",
"recipient": {
"type": "user", // user | group
"name": "联系人备注名"
},
"message": {
"type": "text", // text | image | file
"content": "消息内容"
}
}响应格式
{
"success": true,
"messageId": "msg-xxx",
"timestamp": 1701234567890
}错误处理
| 错误码 | 说明 | 解决方案 |
|---|---|---|
E001 | 未登录微信 | 检查微信通道状态 |
E002 | 联系人不存在 | 确认备注名正确，或先接收对方消息 |
E003 | 频率限制 | 等待60秒后重试 |
E004 | 消息内容违规 | 检查敏感词 |
脚本说明
scripts/send_message.py- 发送消息主脚本scripts/contact_manager.py- 联系人管理scripts/auth_helper.py- 授权验证
相关文档
references/wechat-api.md- 微信API详细说明references/rate-limits.md- 频率限制详情