飞书发送消息 Skill / Feishu Send Message
让 OpenClaw Agent 主动给飞书（Lark）用户或群聊发送文本消息。
为什么需要这个 Skill？
OpenClaw 内置的 feishu_chat 工具只支持查询群信息和成员列表，不能主动发消息给其他用户。
这个 Skill 补充了这个能力 — Agent 可以通过命令行脚本向任何已授权的飞书用户或群聊发送消息。
典型场景：
- 定时任务完成后通知指定同事
- 竞品分析/舆情报告生成后推送给相关人
- Agent 之间通过飞书协作通知
安装
clawhub install feishu-send-message
或手动复制到 ~/.openclaw/workspace/skills/feishu-send-message/。
配置（首次使用前必读）
1. 确保飞书插件已启用
你的 openclaw.json 中需要有飞书 channel 配置：
"channels": {
"feishu": {
"accounts": {
"default": {
"appId": "your_app_id",
"appSecret": "your_app_secret"
}
}
}
}
2. 添加联系人映射
在飞书 account 配置中添加 dms 字段，这样 Agent 就能用姓名发消息：
"dms": {
"ou_xxxxxx": { "label": "张三" },
"ou_yyyyyy": { "label": "李四" }
}
3. 如何获取正确的 open_id
重要：飞书的 open_id 是按应用隔离的，每个飞书应用看到的同一用户 open_id 不同。
获取方法：
- 让目标用户在飞书中找到你的 OpenClaw 机器人，发送任意一条消息
- 查看日志
~/.openclaw/logs/gateway.log，找到：
Feishu[default] DM from ou_xxxxxx: 你好
- 这个
ou_xxxxxx 就是该用户在你的应用下的正确 open_id
使用方法
按姓名发送（推荐）
python3 {baseDir}/scripts/send.py --to "张三" --text "报告已生成，请查收"
按 open_id 发送
python3 {baseDir}/scripts/send.py --to "ou_xxxxxx" --text "你好"
发送到群聊
python3 {baseDir}/scripts/send.py --to "oc_xxxxxx" --text "大家好，以下是今日简报"
查看已配置的联系人
python3 {baseDir}/scripts/send.py --list-contacts
指定 ID 类型（高级）
python3 {baseDir}/scripts/send.py --to "on_xxxxxx" --id-type union_id --text "消息内容"
支持的 ID 类型：open_id（默认）、chat_id、user_id、union_id
输出格式
脚本输出 JSON，方便 Agent 解析。
成功：
{
"success": true,
"to": "ou_xxxxxx",
"to_label": "张三",
"message_id": "om_xxxxxx",
"chat_id": "oc_xxxxxx"
}
失败：
{
"success": false,
"to": "ou_xxxxxx",
"to_label": null,
"error_code": 99992361,
"error_msg": "open_id cross app"
}
前提条件
- 飞书插件已配置 —
openclaw.json 中有飞书 appId 和 appSecret
- 收件人已授权 — 目标用户必须先给机器人发过至少一条消息（飞书平台要求）
- Python 3 — 脚本使用纯标准库，无需 pip install
常见错误
- 99992361 open_id cross app — 使用了其他飞书应用的 open_id，必须用当前应用下的（参考上方「如何获取正确的 open_id」）
- 230001 bot not in chat — 机器人无权给该用户发消息，让用户先给机器人发一条消息即可
- 230002 invalid content — 消息内容为空或格式错误
安全说明
- 脚本从
~/.openclaw/openclaw.json 读取飞书应用凭证，不需要额外配置环境变量
- 不会存储或转发消息内容
- 仅调用飞书开放平台官方 API (
open.feishu.cn)
