feishu-channel

飞书适配器，让 Agent 接入飞书平台进行消息交互。

功能

• 📨 接收飞书单聊和群聊消息
• 📤 发送消息（文本、富文本、卡片）
• 🔔 支持 @ 提及和回复
• 🧩 兼容飞书开放平台 API
• 🔐 基于租户授权的安全认证

配置步骤

1. 在飞书开放平台创建应用
2. 获取 App ID 和 App Secret
3. 配置事件订阅（消息、用户变更等）
4. 设置 Verification Token 和 Encrypt Key
5. 在 OpenClaw 配置文件中填入凭证

channels:
  feishu:
    app_id: "your_app_id"
    app_secret: "your_app_secret"
    verification_token: "your_token"
    encrypt_key: "your_encrypt_key"
    enabled: true

使用方法

Agent 自动通过 OpenClaw 主处理器接收和发送消息，无需额外代码。

发送消息示例：

from openclaw import send_message

await send_message(
    channel="feishu",
    target="oc_xxxxx",  # 会话ID或用户ID
    content="你好，我是你的AI助手！",
    content_type="text"
)

发送卡片消息：

card = {
    "config": {"wide_screen_mode": True},
    "header": {"title": {"tag": "plain_text", "content": "通知"}},
    "elements": [{"tag": "div", "text": {"tag": "plain_text", "content": "任务已完成"}}]
}
await send_message(channel="feishu", target="oc_xxxxx", content=card, content_type="interactive")

支持的消息类型

• 文本消息（text）
• 富文本（post）
• 交互卡片（interactive）
• 图片（image）
• 文件（file）

注意事项

• 飞书 API 有频率限制，请合理控制发送速率
• 事件订阅需要公网可访问的回调 URL
• 建议开启消息加密以保障安全
• 群机器人需要先添加到群组才能发送消息

---

版本: 1.0.0 更新日期: 2026-03-05