什么是 飞书消息发送器？

飞书消息发送器是一款以开发者为中心的工具，旨在弥合自动化脚本与人工沟通之间的鸿沟。通过利用飞书和 Lark API，它允许用户使用手机号或内部 ID 直接向个人发送通知。作为 Openclaw Skills 的核心部分，它会自动处理租户鉴权和 ID 解析的复杂过程，使其成为任何自动化告警系统的重要组成部分。

该工具对于需要将实时通知集成到其编码代理或 CI/CD 流水线中，而又不想为每个请求手动管理身份验证令牌的开发者特别有用。它通过为不同的 ID 类型（包括 open_id、user_id 和 union_id）提供统一界面，简化了消息传递流程。

下载入口:https://github.com/openclaw/skills/tree/main/skills/lycohana/feishu-send-message

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

飞书消息发送器 应用场景

• 向开发者发送自动化部署通知。
• 分发带有链接和标题的格式化日报。
• 为服务器监控工具提供实时告警。
• 精简飞书和 Lark 生态系统内的用户沟通。

1. 脚本通过从本地 Openclaw 配置中提取 appId 和 appSecret 进行初始化。
2. 向指定的飞书或 Lark 域名请求 tenant_access_token。
3. 通过检查本地缓存或查询 batch_get_id API 来识别接收者。
4. 工具根据是否存在标题或 Markdown 链接等富文本标记来选择合适的消息格式（文本或富文本）。
5. 消息通过 IM API 传输，解析后的用户 ID 会被缓存在本地以便将来使用。

飞书消息发送器 配置指南

请确认您的凭据已在全局配置文件 ~/.openclaw/openclaw.json 中设置。您必须提供 appId 和 appSecret。配置完成后，您可以使用以下命令结构发送消息：

python send_message.py "+8613500000000" "Hello from Openclaw Skills!"

飞书消息发送器 数据架构与分类体系

该技能利用基于 JSON 的配置和缓存系统来优化性能并减少 API 开销：

name: feishu-send-message
description: |
  通过 API 向飞书用户发送消息。当你需要通过手机号或任意用户 ID（open_id、user_id、union_id）向飞书用户发送消息时使用。自动尝试所有 ID 类型以找到有效的那个。

  **新增**：消息长度指南和长内容多部分发送最佳实践！

飞书消息发送工具

单个工具 feishu_send_message，用于向飞书用户发送消息。

?? 关键：正确用法

这是一个 Python 脚本，不是 JSON 工具调用。

命令行用法（正确）：

python send_message.py <标识符> <消息>

# 示例：
python send_message.py "+8613560824490" "你好！"
python send_message.py "3b3ee7d1" "天气预报"
python send_message.py "ou_xxx" "你的消息"

? 错误（会失败）：

python send_message.py --json-file message.json    # 不支持 --json-file！
python send_message.py --action send xxx           # 不支持 --action！

脚本接受恰好 2 个位置参数：

1. identifier - 手机号或用户 ID（open_id/user_id/union_id）
2. message - 要发送的文本消息

功能说明

1. 从 OpenClaw 配置读取飞书凭证
2. 自动获取 tenant_access_token
3. 支持多种用户 ID 格式（手机号、open_id、user_id、union_id）
4. 自动尝试所有可用的 ID 类型以找到有效的那个
5. 通过飞书 API 发送文本消息

支持的标识符格式

• 手机号：+8613560824490 或 13560824490
• open_id：ou_xxx（当前应用中的用户 ID）
• user_id：ou_xxx（飞书中的企业用户 ID）
• union_id：on_xxx（跨应用的用户 ID）

智能查找顺序：

1. 本地配置优先（~/.openclaw/workspace/configs/feishu-users.json）- 最快，无需 API 调用
2. 手机号查找 - 调用 API 获取所有 ID，然后尝试每个
3. 直接 ID - 尝试该 ID，然后回退到其他类型

前置条件

从 ~/.openclaw/openclaw.json：

• appId：飞书应用 ID（如 cli_a98251e3d1f8900c）
• appSecret：飞书应用密钥
• domain：（可选）API 域名 - feishu（中国版）或 lark（国际版）

首次查找后，用户 ID 会保存到 ~/.openclaw/workspace/configs/feishu-users.json。

API 端点

1. 获取 tenant_access_token：

   POST https://open.{domain}/open-apis/auth/v3/tenant_access_token/internal
   

2. 通过手机号获取用户 ID：

   POST https://open.{domain}/open-apis/contact/v3/users/batch_get_id
   

3. 发送消息：

   POST https://open.{domain}/open-apis/im/v1/messages?receive_id_type={user_id|union_id|open_id}
   

消息类型

发送富文本消息（推荐 ?）

用于格式化的消息。支持：

• ? 标题：# 标题
• ? 链接：[文本](链接)
• ? 表情符号：原样保留
• ? 换行：分隔段落
• ? 列表：- 事项

示例：

# 卡片格式 ?
python send_message.py "+8613560824490" "# ??? 天气通知

东莞天气预报

- 天气：多云 ??
- 气温：12-22℃

详情请查看 [天气预报](https://weather.com.cn)

祝你有美好的一天！"

发送纯文本消息

用于简单消息。支持：

• ? 换行（ ）
• ? 表情符号（??? ?? ??）

示例：

# 简单消息
python send_message.py "+8613560824490" "? 任务完成！
感谢你的使用～"

卡片格式支持的功能

自动检测

脚本自动选择正确的格式：

• 当检测到 # 或 ]( 时使用 post 格式
• 纯消息使用 text 格式

配置

无需额外配置 - 自动从 OpenClaw 配置读取。

错误处理

• 缺少凭证：返回错误
• 无效标识符：尝试检测并使用正确格式
• API 错误：自动尝试其他 ID 类型
• 最终失败：返回带详细信息的错误

常见错误

使用示例

发送天气卡片格式消息（推荐）：

python send_message.py "+8613560824490" "# ??? 东莞天气预报

更新于：2月7日 05:30

详细预报：
- 天气：多云 ??
- 气温：12℃ ~ 22℃
- 风力：无持续风向 <3级

小贴士：
早晚温差大，记得添衣哦~ ??

查看详情 [天气预报](https://weather.com.cn)"

发送简单消息：

python send_message.py "+8613560824490" "你好，来自 OpenClaw！"

发送带标题和链接的消息：

python send_message.py "+8613560824490" "# 重要通知
这是标题内容
详见链接：[天气预报](https://weather.com.cn)"

直接发送至 ID：

python send_message.py "ou_9a013a756733f6910ebd9e3a1fe350fb" "你好！"

?? 重要：消息长度限制

飞书消息限制：

• 文本消息：无严格限制，但建议 < 5000 字符
• 富文本（post）：建议总共 < 20000 字符
• 如果消息太长：飞书 API 可能返回 HTTP 400 或截断

长内容最佳实践：

1. 拆分为多条消息

   # 第1部分
   python send_message.py "3b3ee7d1" "# 报告 - 第1部分（共3部分）
   ...内容...
   （待续...）"
   
   # 第2部分（确认收到后）
   python send_message.py "3b3ee7d1" "# 报告 - 第2部分
   ...更多内容...
   （待续...）"
   

2. 使用文件作为内容来源

   # 从文件读取（避免 CLI 参数问题）
   python send_message.py "3b3ee7d1" "$(cat long_message.txt)"
   

3. 发送前检查字符数

   • 如果内容 > 3000 字符，考虑拆分
   • 使用 wc -c 或 Measure-Object -Line 检查长度

?? 常见问题与解决方案

• feishu.cn - 中国版（默认）
• larksuite.com - 国际版

通过配置中的 channels.feishu.domain 或 channels.feishu.accounts.main.domain 设置。