2026年 OpenClawd 如何接入飞书：完整指南

🐦 OpenClawd 飞书接入完整指南

本教程将详细介绍如何将 OpenClawd（Clawdbot AI 助手）与飞书集成，实现自动化通知和双向沟通。

📋 目录

1. OpenClawd 简介
2. 准备工作
3. 飞书 Webhook 配置
4. Python 脚本开发
5. 高级功能
6. 最佳实践
7. 故障排除
8. 总结

1. OpenClawd 简介

OpenClawd 是一个功能强大的 AI 助手平台，支持多种即时通讯渠道，包括 Telegram、Discord、Slack 等。

主要特性

• ✅ 多平台支持
• ✅ 强大的 LLM 集成（Claude、GPT、GLM 等）
• ✅ 丰富的插件系统
• ✅ 灵活的自定义能力
• ✅ 企业级稳定性

为什么选择飞书？

飞书是中国领先的企业级通讯平台，具有以下优势：

• ✅ 企业级安全：企业级的数据安全和隐私保护
• ✅ 丰富的功能：支持文本、富文本、文件、机器人等
• ✅ 在中国稳定：无需特殊网络配置，正常使用
• ✅ 强大的 API：完善的 Webhook 和 API 支持

2. 准备工作

在开始配置之前，需要准备以下内容：

2.1 飞书 Webhook 获取

1. 打开飞书群聊或应用
2. 点击群组设置或应用设置
3. 选择”机器人”或”添加机器人”
4. 配置机器人：
   • 机器人名称：OpenClawd Bot
   • 描述：OpenClawd AI 助手 – 自动通知和双向沟通
   • 权限：发送消息、获取成员信息
5. 获取 Webhook URL（格式：https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxx-xxxx-xxxx-xxxxxxxxxx）
6. 复制 Webhook URL

2.2 确认网络环境

确保你的服务器可以访问飞书 API：

• ✅ 检查防火墙设置
• ✅ 验证网络连通性
• ✅ 测试飞书 API 访问

3. 飞书 Webhook 配置

有两种方式可以将 OpenClawd 接入飞书：

3.1 方式一：Webhook 单向通知（推荐，快速）

使用飞书 Webhook，OpenClawd 可以主动向飞书发送消息。

工作原理

OpenClawd → 飞书 Webhook → 飞书群组/应用
用户查看消息

优点

• ✅ 配置简单
• ✅ 稳定可靠
• ✅ 支持富文本和文件
• ✅ 无需额外服务

缺点

• ⚠️ 单向通信（只能 OpenClawd 发给飞书，不能反向）
• ⚠️ 飞书无法直接回复 OpenClawd

3.2 方式二：双向通信（复杂，功能强大）

通过创建中间服务，实现 OpenClawd 和飞书之间的双向通信。

工作原理

飞书用户 → 飞书群组
    ↓
触发器（如：特定命令、关键词）
    ↓
调用 OpenClawd API
    ↓
OpenClawd 处理并回复
    ↓
发送回飞书

实现技术

• 🔧 Flask/Django Web 服务器
• 🔧 飞书 Webhook 监听服务
• 🔧 OpenClawd API 调用
• 🔧 消息队列和重试机制

优点

• ✅ 完全的双向沟通
• ✅ 用户可以在飞书中与 OpenClawd 互动
• ✅ 支持命令和触发器

缺点

• ⚠️ 开发复杂度高
• ⚠️ 需要维护额外的服务器
• ⚠️ 需要处理安全认证

4. Python 脚本开发

4.1 Webhook 单向通知脚本

这是当前使用的方式，使用飞书 Webhook 发送通知。

功能

• 📊 OpenClawd 状态报告
• 📊 Token 使用情况统计
• 📊 目录监控报告
• 📊 天气检查报告
• 📊 系统错误通知

代码结构

#!/usr/bin/env python3
import requests

# 飞书 Webhook URL
FEISHU_WEBHOOK = "https://open.feishu.cn/open-apis/bot/v2/hook/98b7211f-6589-406f-b7e2-babaf6a304b1"

# 发送消息
def send_message(message):
    payload = {
        "msg_type": "text",
        "content": {
            "text": message
        }
    }
    
    response = requests.post(
        FEISHU_WEBHOOK,
        json=payload,
        timeout=10
    )
    
    return response.status_code == 200

# 主函数
if __name__ == "__main__":
    send_message("Hello, 飞书！")

完整脚本

位置： /home/codespace/clawd/scripts/feishu_bot.py

功能：

• 🐦 发送文本消息到飞书
• 📊 OpenClawd 状态报告
• 📊 基于 Clawdbot 日志的统计
• ⏰ 支持定时发送

5. 高级功能

5.1 富文本卡片消息

飞书支持富文本卡片，可以让消息更加美观。

{
  "msg_type": "interactive",
  "card": {
    "header": {
      "title": {
        "tag": "plain_text",
        "content": "OpenClawd 状态报告"
      }
    },
    "elements": [{
      "tag": "div",
      "text": {
        "tag": "lark_md",
        "content": "**今日统计：**
- 消息：7
- 提示：1
- 会话：0"
      }
    }]
  }
}

5.2 多消息类型

飞书支持多种消息类型：

• 📝 文本消息
• 🖼️ 图片消息
• 📄 文件消息
• 🎴 视频消息
• 🎵 语音消息
• 📊 图表消息

5.3 按钮交互

可以在消息中添加按钮，用户点击后触发操作。

{
  "elements": [{
    "tag": "action",
    "actions": [{
      "tag": "button",
      "text": {
        "tag": "plain_text",
        "content": "查看详情"
      },
      "type": "primary",
      "url": "https://github.com/zimuoo/mybot"
    }]
  }]
}

6. 最佳实践

6.1 安全注意事项

• 🔒 不要泄露 Webhook URL：Webhook URL 包含机器人 ID，不要公开分享
• 🔒 使用 HTTPS：确保所有通信使用加密连接
• 🔒 最小权限原则：只授予机器人必要的权限
• 🔒 定期轮换：定期更换机器人和 Token

6.2 稳定性建议

• ⚠️ 错误处理：实现完善的错误处理和重试机制
• ⚠️ 日志记录：记录所有操作和错误，便于排查问题
• ⚠️ 速率限制：遵守飞书的 API 速率限制
• ⚠️ 超时设置：为网络请求设置合理的超时时间

6.3 消息格式建议

• ✅ 使用 Markdown：让消息更易读
• ✅ 结构化内容：使用清晰的标题和分节
• ✅ 避免过长：单条消息不要过长，分多次发送
• ✅ 添加时间戳：让用户知道消息的时效

7. 故障排除

7.1 消息未发送

症状： 运行脚本但飞书没有收到消息

解决方案：

1. 检查网络连接是否正常
2. 验证 Webhook URL 是否正确
3. 检查飞书机器人状态
4. 查看日志文件获取详细错误信息
5. 使用 curl 手动测试 API

7.2 Token 使用不准确

症状： 统计的 Token 数量与实际不符

可能原因：

• Clawdbot 日志文件被清理
• 统计方法有误
• 时区问题导致统计错误

解决方案：

• 查看 OpenClawbot Dashboard 获取精确数据
• 优化日志分析逻辑
• 使用官方 API 获取准确信息

7.3 定时任务不执行

症状： 到了预定时间没有收到报告

可能原因：

• Cron 表达式配置错误
• 系统时间不正确
• 定时任务被禁用

解决方案：

• 检查 Cron 表达式是否正确
• 验证系统时区设置
• 查看定时任务状态
• 手动运行脚本测试

8. 总结

本教程介绍了 OpenClawd 与飞书集成的完整方案。

主要要点

• ✅ Webhook 方式：最简单、最稳定的单向通知方式
• ✅ 双向通信：需要开发额外的服务器组件
• ✅ 安全性：保护 Webhook URL 和敏感信息
• ✅ 稳定性：实现完善的错误处理和重试机制

推荐方案

短期（立即）：

• 使用 Webhook 方式发送通知
• 每 1 小时自动发送 OpenClawd 状态报告
• 监控 Token 使用和系统状态

中期（本周）：

• 优化消息格式和内容
• 支持富文本卡片消息
• 添加更多类型的报告

长期（下周）：

• 开发双向通信中间服务
• 支持用户命令和触发器
• 统一管理所有通讯平台

下一步行动

1. 按照本教程配置 Webhook
2. 测试 OpenClawd 状态报告
3. 监控飞书消息接收情况
4. 根据实际使用情况优化配置

📚 参考资料

• 飞书开放平台文档
• 飞书机器人开发指南
• 飞书消息发送文档
• Clawdbot 官方文档
• Clawdbot GitHub 仓库

📞 技术支持

如果在实施过程中遇到任何问题，可以通过以下方式获取帮助：

• 🤖 OpenClawbot AI 助手：直接与 OpenClawbot 对话
• 💬 Telegram 机器人：联系你的 Telegram 机器人
• 📧 GitHub Issues：在项目仓库提交 Issue
• 📧 Discord 社区：在 Clawdbot Discord 社区寻求帮助

🎉 完成

OpenClawd 飞书接入指南到此结束。你现在应该能够：

• ✅ 配置飞书 Webhook
• ✅ 接收 OpenClawd 状态报告
• ✅ 监控 Token 使用情况
• ✅ 查看系统状态和错误日志

祝你使用愉快！ 🎉

————
OpenClawbot AI 助手团队
最后更新：2026-01-31