wecom-helper

Files (1)

• SKILL.md

SKILL.md (first lines)

# 企业微信助手 Skill

这个 skill 帮助 AI 更好地理解和处理企业微信相关的任务。

## 何时激活此 Skill

当用户：
- 提到"企业微信"、"WeCom"、"微信工作"
- 要求发送企业微信消息
- 询问企业微信相关配置
- 需要通过企业微信进行通知或提醒

## 企业微信渠道信息

### 配置参数
- **corpid**: 企业 ID（从企业微信管理后台获取）
- **corpsecret**: 应用 Secret
- **token**: 应用 Token（用于消息验证）
- **encodingAESKey**: 消息加密密钥

### API 端点
- **接收消息**: `POST /openclaw-wechat/message`
- **轮询消息**: `GET /openclaw-wechat/messages?email=xxx`

## 使用场景示例

### 场景 1: 发送通知
用户请求："给张三发一条企业微信消息，提醒他明天的会议"

响应思路：
1. 确认收件人标识（通常是企业微信账号或邮箱）
2. 构造消息内容
3. 使用 openclaw-wechat 渠道发送

### 场景 2: 文件分享
用户请求："把这个报告发给团队"

响应思路：
1. 确认文件路径或 URL
2. 识别团队成员列表
3. 通过企业微信发送带附件的消息

### 场景 3: 定时提醒
用户请求："每天早上 9 点提醒我查看待办事项"

响应思路：
1. 建议使用系统的定时任务（cron/scheduled task）
2. 配置定时调用企业微信 API
3. 发送提醒消息

## 消息格式

### 纯文本消息
```json
{
  "email": "user@example.com",
  "text": "这是一条文本消息"
}
```

### 带附件消息
```json
{
  "email": "user@example.com",
  "text": "请查收附件",
  "mediaUrl": "https://example.com/file.pdf"
}
```

### 同步响应（等待回复）
```json
{
  "email": "user@example.com",
  "text": "请问你现在有空吗？",
  "sync": true
}
```

## 最佳实践

1. **身份识别**: 始终确认收件人的正确标识符（企业微信账号/邮箱）
2. **消息内容**: 保持消息简洁、清晰、专业
3. **错误处理**: 如果发送失败，提供明确的错误信息和建议
4. **隐私保护**: 不要在消息中包含敏感信息（密码、密钥等）
5. **批量发送**: 如果需要发送给多人，逐个调用 API（避免群发滥用）

## 故障排查

### 消息发送失败
- 检查 `corpid`、`corpsecret` 是否正确
- 验证收件人账号是否存在
- 确认 Gateway 正在运行（`openclaw channels status`）

### 收不到回调
- 确认 `token` 和 `encodingAESKey` 配置正确
- 检查企业微信应用配置的回调 URL
- 验证网络防火墙设置

## 相关命令

```bash
# 查看渠道状态
openclaw channels status

# 测试发送消息
curl -X POST http://localhost:18789/openclaw-wechat/message \
  -H "Content-Type: application/json" \
  -d '{"email": "test@example.com", "text": "测试消息"}'

# 查看配置
openclaw config get channels.openclaw-wechat
```

## 限制和注意事项

- 企业微信 API 有频率限制，避免短时间内大量请求
- 消息内容长度限制：文本消息最多 2048 字节
- 附件大小限制：根据企业微信配置而定
- 必须是企业内部成员才能接收消息

From magicwang1111/openclaw-wechat-plugin, MIT.

More from magicwang1111/openclaw-wechat-plugin