飞书插件安装

📱 飞书插件安装指南

本教程将指导你如何在飞书中安装和配置 OpenClaw 插件，让你的AI助手在飞书中随时可用。

第一步：注册飞书开放平台

1. 访问 飞书开放平台
2. 使用飞书账号登录
3. 点击"创建应用"按钮
4. 选择"企业自建应用"

第二步：创建应用

应用名称：OpenClaw AI助手
应用描述：智能AI助手，帮助处理日程、任务、文档等
应用图标：可以上传自定义图标

第三步：配置应用权限

在"权限管理"页面，添加以下权限：

• 通讯录权限：读取组织架构信息
• 消息权限：接收和发送消息
• 日历权限：读取和创建日程
• 任务权限：读取和创建任务
• 文档权限：读取和编辑文档

第四步：配置事件订阅

在"事件订阅"页面，配置以下内容：

请求地址：https://你的域名.com/feishu/webhook
加密密钥：随机生成并保存
订阅事件：
  - im.message.receive_v1 (接收消息)
  - calendar.calendar.event.changed_v1 (日历事件变更)
  - task.task.updated_v1 (任务更新)

第五步：配置消息卡片

在"消息卡片"页面，配置卡片模板：

• 创建回复消息卡片模板
• 配置任务创建卡片模板
• 配置日程提醒卡片模板

第六步：发布应用

1. 在"版本管理与发布"页面创建新版本
2. 填写版本说明
3. 选择可用范围（建议先选择测试部门）
4. 提交审核并发布

第七步：在飞书中安装

1. 在飞书工作台中搜索"OpenClaw"
2. 点击"添加"按钮
3. 同意权限申请
4. 完成安装

🔧 常见问题

Q1: 权限申请被拒绝怎么办？

A: 需要联系企业管理员审批权限申请，或者使用测试环境进行开发。

Q2: Webhook 验证失败怎么办？

A: 检查以下几点：

• 确保服务器可以公网访问
• 检查加密密钥是否正确
• 验证URL是否包含正确的路径
• 检查服务器日志查看具体错误

Q3: 消息收不到怎么办？

A: 检查事件订阅配置，确保订阅了正确的事件类型。

Q4: 如何测试插件功能？

A: 可以在飞书中直接@OpenClaw机器人发送消息测试。

⚙️ 高级配置

自定义回复模板

// 自定义消息回复模板
{
  "msg_type": "interactive",
  "card": {
    "config": {
      "wide_screen_mode": true
    },
    "header": {
      "title": {
        "tag": "plain_text",
        "content": "OpenClaw 回复"
      }
    },
    "elements": [
      {
        "tag": "div",
        "text": {
          "tag": "lark_md",
          "content": "{{reply_content}}"
        }
      }
    ]
  }
}

配置自动回复规则

• 设置关键词自动回复
• 配置定时任务提醒
• 设置群聊@规则
• 配置免打扰时段

性能优化建议

• 使用消息队列处理高并发请求
• 配置合理的超时时间
• 启用消息缓存
• 监控API调用频率