OpenClaw 飞书机器人实战指南

飞书是字节跳动推出的企业协作平台，支持自定义机器人开发。本文将详细介绍如何将 OpenClaw 接入飞书，打造你的专属 AI 助手。

准备工作

在开始之前，你需要：

飞书企业账号 - 需要管理员权限创建应用
OpenClaw 已安装 - 参考上一篇文章
API Key - 你的 AI 模型 API Key

步骤一：创建飞书应用

1.1 访问开发者后台

打开飞书开放平台
使用企业账号登录
点击「创建应用」

1.2 配置应用信息

应用名称: OpenClaw AI 助手
应用描述: 基于 OpenClaw 的 AI 助手
应用图标: 可以上传一个可爱的机器人图标

1.3 获取 App ID 和 App Secret

创建成功后，在「凭证与基础信息」中获取：

App ID
App Secret

步骤二：配置机器人权限

2.1 添加权限

在「权限管理」中添加以下权限：

权限名称	权限描述
im:chat:message:send_as_bot	以机器人身份发消息
im:message:send.as	发送消息
im:chat:list	获取群列表
im:chat:members	获取群成员

2.2 发布应用

点击「版本管理与发布」
创建新版本
填写版本信息
提交审核（需要企业管理员审批）

步骤三：在 OpenClaw 中配置飞书

3.1 启用飞书插件

openclaw plugins enable feishu

3.2 配置飞书凭证

编辑配置文件 ~/.openclaw/openclaw.json：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "你的App ID",
      "appSecret": "你的App Secret",
      "dmPolicy": "pairing"
    }
  }
}

3.3 配置环境变量（推荐）

export FEISHU_APP_ID="你的App ID"
export FEISHU_APP_SECRET="你的App Secret"

步骤四：配置回调地址

4.1 获取公网地址

飞书机器人需要公网回调地址，你可以使用：

方式一：使用 ngrok
```
ngrok http 18789
```

方式二：使用 Cloudflare Tunnel

cloudflared tunnel --url http://localhost:18789

4.2 配置事件订阅

在飞书开发者后台进入「事件订阅」
添加以下事件：
- im.message.message_received_v1 - 接收消息
- im.chat.member.bot_added_v1 - 机器人被添加
- im.chat.member.bot_removed_v1 - 机器人被移除
设置回调地址为你的公网地址：

https://你的域名/gateway/v1/feishu/webhook

4.3 验证回调

点击「检验」按钮，确认回调配置成功。

步骤五：启动服务

# 重启 OpenClaw 网关
openclaw gateway restart

# 查看日志
openclaw logs --follow

使用场景

5.1 私聊模式

用户可以直接添加机器人为好友，进行一对一对话：

用户打开与机器人的私聊窗口
发送消息
AI 自动回复

5.2 群聊模式

将机器人添加到群聊中：

在群设置中点击「添加机器人」
选择「OpenClaw AI 助手」
在群中 @机器人发送消息

5.3 配置提及模式

在群聊中，你可以设置需要 @ 才会回复：

{
  "channels": {
    "feishu": {
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

高级配置

6.1 会话管理

{
  "channels": {
    "feishu": {
      "dmPolicy": "allowlist",
      "allowFrom": ["用户ID1", "用户ID2"]
    }
  }
}

6.2 消息过滤

{
  "channels": {
    "feishu": {
      "blockWords": ["敏感词1", "敏感词2"]
    }
  }
}

6.3 自定义回复前缀

{
  "channels": {
    "feishu": {
      "replyPrefix": "🤖 "
    }
  }
}

常见问题

Q: 机器人收不到消息？

A: 检查以下几点：

确认应用已发布并通过审核
确认事件订阅已配置
检查回调地址是否可访问
查看 OpenClaw 日志确认错误信息

Q: 消息发送失败？

A: 检查权限是否完整，特别是 im:message:send.as 权限。

Q: 如何获取用户 ID？

A: 在消息事件中，sender_id 字段包含用户 ID。

Q: 群聊中@机器人无响应？

A: 确认 requireMention 配置，或者检查是否开启了隐私模式。

测试你的机器人

完成以上步骤后，尝试：

私聊测试：给机器人发送「你好」
群聊测试：在群中 @机器人发送「帮我写首诗」

如果一切正常，你应该能收到 AI 的回复！

总结

通过本文，你应该已经掌握了：

创建和配置飞书应用
在 OpenClaw 中启用飞书插件
配置消息回调
使用私聊和群聊模式

飞书机器人的玩法远不止这些，你可以继续探索：

定时任务通知
集成企业业务流程
自定义技能插件

有问题欢迎在评论区交流！🦞