WeChat Sender Skill

通过OpenClaw的openclaw-weixin通道主动发送微信消息。

工作原理

本Skill利用OpenClaw Gateway与微信客户端的WebSocket连接，通过发送特定格式的消息包实现主动推送。

前置条件

1. OpenClaw Gateway已运行

```bash

openclaw gateway status

```

1. 微信通道已配置
• openclaw-weixin 插件已启用
• 微信客户端已扫码登录

1. 目标联系人已存在聊天记录
• 首次使用前需先收到对方消息或手动发送过消息

使用方法

发送文字消息

# 使用脚本发送
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"

安全限制

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
}

错误处理

脚本说明

• scripts/send_message.py - 发送消息主脚本
• scripts/contact_manager.py - 联系人管理
• scripts/auth_helper.py - 授权验证

相关文档

• references/wechat-api.md - 微信API详细说明
• references/rate-limits.md - 频率限制详情