Clawdbot 飞书集成指南

Clawdbot 飞书集成概述

Clawdbot 飞书集成让您可以将个人 AI 助手连接到飞书，这是字节跳动旗下的企业协作平台（国际版称为 Lark）。通过 Clawdbot 飞书集成，您可以自动化办公通讯、提供智能回复，并通过 AI 驱动的自动化提升团队生产力。

为什么选择 Clawdbot 飞书？

飞书是一个综合性的办公平台，集成了即时通讯、文档、日历和视频会议。将 Clawdbot 与飞书集成可获得：

设置 Clawdbot 飞书

前置条件

在将 Clawdbot 连接到飞书之前，请确保您已具备：

• 设备上已安装 Clawdbot
• 一个飞书账户（个人或企业）
• 飞书开发者控制台访问权限
• 应用创建权限

步骤 1：创建飞书应用

设置您的 Clawdbot 飞书应用：

1. 前往飞书开放平台
2. 点击"创建企业自建应用"
3. 为您的 Clawdbot 飞书应用命名
4. 配置应用能力（机器人、文档、日历）
5. 获取 App ID 和 App Secret

步骤 2：配置 Clawdbot 飞书

将您的飞书应用添加到 Clawdbot：

clawdbot channels add feishu --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET

步骤 3：设置权限

配置 Clawdbot 飞书权限：

Clawdbot 飞书所需权限：

• im:message - 发送和接收消息
• im:chat - 访问聊天信息
• contact:user.base - 读取用户信息
• docs:doc - 访问文档（可选）
• calendar:calendar - 日历访问（可选）

步骤 4：部署 Clawdbot 飞书机器人

发布您的 Clawdbot 飞书机器人：

clawdbot channels start feishu

步骤 5：验证 Clawdbot 飞书连接

检查您的 Clawdbot 飞书状态：

clawdbot channels status feishu

预期输出：

飞书频道状态:
- 连接: 已连接
- 应用: Clawdbot 助手
- 模式: 事件订阅
- Clawdbot: 活跃

Clawdbot 飞书功能特性

消息处理

Clawdbot 飞书处理各种消息类型：

交互式卡片

Clawdbot 飞书支持交互式消息卡片：

clawdbot configure feishu --cards enabled

功能：

• 按钮交互
• 表单提交
• 动态内容更新
• 动作回调

群聊集成

将 Clawdbot 飞书添加到群聊：

clawdbot configure feishu --groups "团队A,项目X"

配置 Clawdbot 飞书响应：

• 所有消息
• 仅提及（@Clawdbot）
• 斜杠命令（/ask, /help）

文档集成

Clawdbot 飞书可以与飞书文档交互：

• 总结文档
• 回答关于内容的问题
• 提取关键信息
• 创建文档草稿

clawdbot feishu docs summarize --doc-id DOC_ID

日历集成

使用 Clawdbot 飞书进行日历管理：

• 安排会议
• 检查可用时间
• 发送会议提醒
• 创建日历事件

clawdbot feishu calendar schedule --title "团队会议" --time "2024-01-15 10:00"

斜杠命令

Clawdbot 飞书支持自定义斜杠命令：

Clawdbot 飞书配置

应用设置

配置您的 Clawdbot 飞书应用：

{
  "feishu": {
    "appId": "YOUR_APP_ID",
    "appSecret": "YOUR_APP_SECRET",
    "encryptKey": "YOUR_ENCRYPT_KEY",
    "verificationToken": "YOUR_VERIFICATION_TOKEN",
    "eventSubscription": true
  }
}

事件订阅

设置 Clawdbot 飞书事件订阅：

clawdbot configure feishu --webhook https://your-domain.com/feishu/events

订阅事件：

• im.message.receive_v1 - 收到消息
• im.chat.member.bot.added_v1 - 机器人被添加到聊天
• im.chat.member.bot.deleted_v1 - 机器人被移出聊天

企业部署

企业级 Clawdbot 飞书部署：

1. 提交应用审核
2. 配置租户权限
3. 部署到组织
4. 设置管理员控制

Clawdbot 飞书凭证存储

Clawdbot 安全存储飞书凭证：

~/.clawdbot/credentials/feishu/app_credentials.json
~/.clawdbot/credentials/feishu/tenant_token.json

您的 Clawdbot 飞书数据保留在本地机器上。

Clawdbot 飞书使用场景

团队助手

将 Clawdbot 飞书部署为团队助手：

• 回答团队问题
• 总结讨论内容
• 跟踪行动项
• 提供信息查询

会议助手

使用 Clawdbot 飞书进行会议管理：

• 自动安排会议
• 发送会议总结
• 跟踪后续事项
• 管理参会者

知识库

Clawdbot 飞书作为知识助手：

• 搜索公司文档
• 回答政策问题
• 提供入职帮助
• 分享最佳实践

项目管理

Clawdbot 飞书用于项目团队：

• 状态更新
• 任务提醒
• 进度跟踪
• 团队协调

Clawdbot 飞书故障排除

机器人无响应

如果 Clawdbot 飞书不响应：

1. 验证应用凭证：clawdbot channels verify feishu
2. 检查事件订阅 URL
3. 查看日志：cat /tmp/clawdbot/feishu.log

权限错误

如果 Clawdbot 飞书缺少权限：

1. 在开发者控制台检查应用权限
2. 重新授权应用
3. 检查租户级别限制

事件订阅问题

如果 Clawdbot 飞书事件失败：

1. 验证 webhook URL 可访问性
2. 检查加密密钥配置
3. 检查事件订阅设置

Clawdbot 飞书最佳实践

1. 使用事件订阅：Clawdbot 飞书使用 webhook 性能更好
2. 谨慎配置权限：只请求必要的权限
3. 处理速率限制：为 Clawdbot 飞书实现适当的速率限制
4. 监控使用情况：跟踪 Clawdbot 飞书机器人分析数据
5. 企业合规：遵循组织安全策略

Clawdbot 飞书 vs Lark

Clawdbot 同时支持飞书（中国）和 Lark（国际）：

下一步

• Clawdbot 微信集成 - 将 Clawdbot 连接到微信
• Clawdbot Telegram 集成 - 在 Telegram 上设置 Clawdbot
• Clawdbot 设置指南 - 完整安装指南