前置准备在开始之前请确保您已准备好✅ OpenClaw 已安装并运行✅ 飞书账号个人或企业账号都可以✅ 电脑上可以访问飞书开放平台 第一阶段飞书开放平台配置步骤 1.1登录飞书开放平台打开浏览器访问https://open.feishu.cn/2. **登录您的飞书账号** - 如果没有账号先注册一个 - 推荐使用手机号或邮箱注册 --- ### 步骤 1.2创建自建应用 1. **进入管理后台** - 登录后点击右上角的管理后台 - 或直接访问: https://open.feishu.cn/app 2. **创建新应用** - 点击创建企业自建应用 - 或者创建自建应用如果没有企业选项 3. **填写应用信息** | 字段 | 填写内容 | 说明 | |------|---------|------| | 应用名称 | OpenClaw AI 助手 | 可以自定义 | | 应用描述 | 我的个人 AI 助手24/7 在线 | 简单描述即可 | | 应用图标 | 上传一个图标可选 | 可以上传喜欢的图片 | 4. **创建并记录重要信息** - 创建成功后会自动进入应用详情页 - **重要**记录以下两个信息后续需要 - **App ID**: 在应用凭证页面类似 cli_a1b2c3d4e5f6g7h8i9j0 - **App Secret**: 在应用凭证页面点击查看或生成类似 abc123def456789... --- ### 步骤 1.3配置应用权限 1. **进入权限管理页面** - 在左侧导航栏找到权限管理 2. **申请必需权限** 逐一搜索并添加以下权限 **必需权限** | 权限名称 | 权限值 | 用途 | |---------|--------|------| | 获取与发送消息 | im:message | 接收和发送消息 | | 以应用身份发消息 | im:message:send_as_bot | 机器人发送消息 | | 读取聊天信息 | im:chat | 读取群组/私聊信息 | | 获取群组信息 | im:group | 获取群组成员等 | | 获取用户信息 | contact:user.base:readonly | 获取发送消息的用户信息 | 3. **申请权限** - 每个权限后面点击申请权限 - 选择全部员工或指定成员选择自己即可 - 点击确定 4. **批量申请推荐** - 某些版本支持批量申请可以一次性申请所有权限 - 在批量申请权限中粘贴上述权限值 --- ### 步骤 1.4获取应用凭证 1. **进入凭证与基础信息页面** - 左侧导航栏 → 凭证与基础信息 2. **记录 App ID 和 App Secret** 您会看到类似以下信息App ID: cli_a1b2c3d4e5f6g7h8i9j0klmApp Secret: ***************** (点击查看显示)3. **保存 App Secret** - 点击 App Secret 旁边的查看或显示 - **重要**App Secret 只显示一次务必立即复制保存 - 建议保存到记事本或密码管理器 4. **配置事件订阅可选但推荐** 在同一页面您会看到 - **Encrypt Key**加密密钥- 可选用于消息加密 - **Verification Token**验证令牌- 可选用于验证请求来源 如果是个人使用可以先跳过这两项 5. **截图保存** - 建议截图保存这一页面的所有信息 - 特别是 App ID 和 App Secret --- ### 步骤 1.5发布应用 1. **进入版本管理与发布** - 左侧导航栏 → 版本管理与发布 2. **创建新版本** - 点击创建新版本 - 版本号1.0.0 - 版本描述初始版本支持 OpenClaw 集成 3. **申请发布** - 点击申请发布 - 选择发布范围可以选择全部成员或指定成员 - 如果是个人账号直接点击确定即可 4. **等待审核** - 自建应用通常会自动通过审核 - 几分钟内会显示已发布状态 --- ## 第二阶段配置事件订阅重要 ### 步骤 2.1启用事件订阅 1. **进入事件订阅页面** - 左侧导航栏 → 事件订阅 → 添加事件 2. **选择订阅事件** 勾选以下事件 - ✅ im.message.receive_v1 - **必需**接收消息事件 - ✅ im.message.message_read_v1 - 可选消息已读事件 - ✅ im.chat.member.user_added_v1 - 可选成员加入群组事件 3. **点击确定保存** --- ### 步骤 2.2配置 Request URL关键 #### 方案 A本地测试使用内网穿透 1. **安装内网穿透工具** 推荐使用以下任一工具 **选项 1: ngrok推荐简单** bash # 下载 ngrok # 访问 https://ngrok.com/ 注册并下载 # 使用方法 ngrok http 18789运行后会显示Forwarding https://abc123.ngrok.io - http://localhost:18789您的 Webhook URL 就是:https://abc123.ngrok.io/channels/feishu/webhook选项 2: localhost.run更简单无需注册# 直接在命令行运行ssh-R80:localhost:18789 nojacklocalhost.run会生成一个公网 URL例如:https://random-name.localtunnel.me配置 Request URL在飞书开放平台的事件订阅页面找到Request URL输入框填入https://your-ngrok-url.io/channels/feishu/webhook点击验证验证通过如果显示验证成功说明配置正确点击保存或确定方案 B服务器部署推荐用于生产环境如果您有服务器云服务器、VPS 等确保 OpenClaw 部署在服务器上服务器需要开放 18789 端口或者使用 Nginx 反向代理配置 Request URLhttp://your-server-ip:18789/channels/feishu/webhook # 或使用域名 https://your-domain.com/channels/feishu/webhook配置防火墙# 开放 18789 端口sudoufw allow18789# 或sudofirewall-cmd --add-port18789/tcp--permanentsudofirewall-cmd--reload方案 C仅本地测试暂不配置 Webhook如果您只是想在本地测试可以暂时跳过事件订阅配置不使用 Webhook使用轮询模式或者手动触发消息后续再配置 Webhook步骤 2.3测试事件订阅发送测试消息在飞书中给您的应用发送消息或者将应用拉入一个测试群组查看事件订阅日志飞书开放平台 → “事件订阅” → “事件日志”应该能看到消息事件如果看到错误检查 Request URL 是否正确确认防火墙是否开放端口查看 OpenClaw 日志 第三阶段在 OpenClaw 中配置飞书渠道步骤 3.1准备配置信息确保您已准备好以下信息飞书应用信息:App ID:cli_a1b2c3d4e5f6g7h8i9j0App Secret:abc123def456789...Encrypt Key:(可选)Verification Token:(可选)Webhook 信息:URL:http://your-server:18789/channels/feishu/webhook步骤 3.2添加飞书渠道到 OpenClaw方式 1交互式配置推荐运行添加命令openclaw channelsadd--channelfeishu按提示输入信息输入 App ID输入 App Secret输入 Encrypt Key如果没有按 Enter 跳过输入 Verification Token如果没有按 Enter 跳过配置自动保存方式 2命令行配置快速openclaw channelsadd\--channelfeishu\--accountdefault\--name飞书机器人然后会提示您输入凭证信息。步骤 3.3验证配置检查渠道状态openclaw channels list查看详细状态openclaw channels status查看日志openclaw channels logs feishu 第四阶段测试和使用步骤 4.1在飞书中测试找到您的机器人应用在飞书中搜索您的应用名称或者直接使用应用链接发送测试消息你好查看回复OpenClaw 应该会自动回复可以测试更复杂的问题步骤 4.2拉入群组测试创建测试群组在飞书中创建一个新的群组添加机器人邀请您的飞书应用加入群组在群组中测试OpenClaw AI 助手 介绍一下你自己验证功能机器人应该会响应 提及可以执行各种任务步骤 4.3常用命令示例在飞书中可以直接使用的命令基础对话你好请介绍一下你自己 帮我制定今天的工作计划 搜索今天的科技新闻文件操作帮我在桌面创建一个测试文件 读取 C:\Users\test.txt 的内容系统操作查看当前系统状态 列出正在运行的进程高级功能帮我搜索最新的 AI 新闻并总结 创建一个待办事项列表 故障排查常见问题及解决方案问题 1找不到创建自建应用症状在飞书开放平台找不到创建应用的入口解决方案确保您使用的是飞书开放平台账号open.feishu.cn个人账号和企业账号都可以创建自建应用尝试刷新页面或使用其他浏览器问题 2App Secret 忘记保存症状App Secret 显示后忘记复制现在找不到了解决方案在凭证与基础信息页面点击重置可以生成新的 Secret注意旧 Secret 会立即失效需要重新配置 OpenClaw问题 3事件订阅验证失败症状配置 Request URL 后验证一直失败解决方案检查 Webhook URL 是否正确# 正确格式http://your-ip:18789/channels/feishu/webhook https://your-domain.com/channels/feishu/webhook确认 OpenClaw Gateway 正在运行openclaw gateway status检查防火墙设置# Windowsnetsh advfirewall firewalladdrulenameOpenClawdirinactionallowprotocolTCPlocalport18789# Linuxsudoufw allow18789查看 OpenClaw 日志openclaw logs--follow问题 4机器人没有回复消息症状在飞书中给机器人发消息但没有回复排查步骤检查 Gateway 状态openclaw gateway status应该显示:Listening: 127.0.0.1:18789检查飞书渠道状态openclaw channels status查看飞书渠道日志openclaw channels logs feishu--follow检查应用权限确认已在飞书开放平台申请了必需权限确认应用已发布检查事件订阅确认 Request URL 配置正确查看事件订阅日志测试 AI 模型openclaw agent--agentmain-m测试消息如果本地能工作说明问题在飞书集成问题 5没有公网服务器症状想在本地测试但没有公网 IP解决方案选项 1使用 ngrok推荐# 1. 下载并安装 ngrok# 访问 https://ngrok.com/# 2. 运行 ngrokngrok http18789# 3. 复制生成的 URL# 例如https://abc123.ngrok.io# 4. 在飞书配置 Request URL# https://abc123.ngrok.io/channels/feishu/webhook选项 2使用 localhost.runssh-R80:localhost:18789 nojacklocalhost.run选项 3使用其他内网穿透工具Cloudflare Tunnelfrp花生壳选项 4暂不配置 Webhook先使用命令行测试 OpenClaw后续有服务器再配置飞书问题 6权限申请被拒绝症状在飞书开放平台申请权限时被拒绝解决方案自建应用通常不会拒绝权限申请如果是企业账号可能需要管理员审批联系企业管理员审批权限或使用个人账号创建应用问题 7消息发送失败症状机器人收到消息但无法回复排查步骤检查应用是否发布确认应用在版本管理与发布中已发布未发布的应用无法发送消息检查消息发送权限确认已申请im:message:send_as_bot权限在权限管理页面查看权限状态查看错误日志openclaw channels logs feishu--follow重新配置渠道# 删除现有配置openclaw channels remove feishu# 重新添加openclaw channelsadd--channelfeishu问题 8Windows 环境问题症状在 Windows 上运行遇到各种问题解决方案推荐使用 WSL2# 安装 WSL2wsl--install# 在 WSL2 中运行 OpenClaw使用 PowerShell 管理员权限# 右键以管理员身份运行 PowerShell检查防火墙# 添加防火墙规则netsh advfirewall firewall add rule nameOpenClawdirin actionallow protocolTCP localport18789检查 Node.js 版本node--version# 需要 22 版本 附录A. 快速参考命令# OpenClaw 基础命令openclaw--version# 查看版本openclaw gateway status# 查看 Gateway 状态openclaw gateway restart# 重启 Gatewayopenclaw health# 健康检查openclaw logs--follow# 实时日志# 渠道管理openclaw channels list# 列出所有渠道openclaw channels status# 查看渠道状态openclaw channelsadd--channelfeishu# 添加飞书渠道openclaw channels remove feishu# 删除飞书渠道openclaw channels logs feishu# 查看飞书日志# Agent 交互openclaw agent--agentmain-m消息# 发送消息openclaw agent--agentmain--thinking消息# 带思考过程# 插件管理openclaw plugins list# 列出所有插件openclaw pluginsenablefeishu# 启用飞书插件openclaw plugins disable feishu# 禁用飞书插件B. 配置文件位置# 主配置文件~/.openclaw/openclaw.json# 工作区~/.openclaw/workspace/# 会话存储~/.openclaw/agents/main/sessions/# 日志文件/tmp/openclaw/openclaw-YYYY-MM-DD.log# Windows 路径示例C:\Users\YourName\.openclaw\openclaw.jsonC. 端口说明端口用途说明18789Gateway 默认端口OpenClaw Gateway 服务端口22SSH用于远程服务器管理80/443HTTP/HTTPSWeb 服务D. 相关链接官方文档OpenClaw 官方文档: https://docs.openclaw.aiOpenClaw GitHub: https://github.com/openclaw/openclaw飞书开放平台: https://open.feishu.cn飞书开发文档: https://open.feishu.cn/document教程资源OpenClaw飞书官方插件上线2026年OpenClaw极速部署集成飞书攻略OpenClaw飞书通道配置工具下载ngrok: https://ngrok.com/Node.js: https://nodejs.org/WSL2: https://docs.microsoft.com/windows/wsl✅ 配置检查清单完成配置后请逐项检查飞书开放平台已创建自建应用已记录 App ID 和 App Secret已申请必需权限im:message, im:message:send_as_bot 等已发布应用已启用事件订阅已配置 Request URL如需要事件订阅验证通过OpenClaw 配置OpenClaw 正常运行Gateway 运行在 18789 端口飞书插件已启用已添加飞书渠道渠道状态正常测试验证能在飞书中发送消息给机器人机器人能正常回复能在群组中使用 机器人能执行基本命令日志中无错误信息 进阶使用1. 配置多个飞书应用# 添加第一个账号openclaw channelsadd--channelfeishu--accountwork# 添加第二个账号openclaw channelsadd--channelfeishu--accountpersonal# 列出所有账号openclaw channels list2. 自定义机器人行为编辑配置文件~/.openclaw/openclaw.json{agents:{defaults:{model:{primary:zai/glm-4.7},personality:你是一个友好、专业 的AI助手}}}3. 配置定时任务# 添加每日新闻推送openclawcronadd\--name每日新闻\--cron0 8 * * *\--tzAsia/Shanghai\--channelfeishu\--message生成今日科技新闻摘要4. 启用高级功能# 启用浏览器自动化openclaw configsettools.browsertrue# 启用文件操作openclaw configsettools.filesystemtrue# 启用网络搜索openclaw configsettools.webtrue 获取帮助如果遇到问题查看日志openclaw logs--followopenclaw channels logs feishu--follow运行诊断openclaw doctor openclaw health--deep查看官方文档OpenClaw 文档: https://docs.openclaw.ai飞书开发文档: https://open.feishu.cn/document提交问题OpenClaw GitHub Issues飞书开发者社区 更新日志2026-03-07: 初始版本创建基于 OpenClaw v2026.2.25支持飞书/Lark 集成包含完整的配置步骤和故障排查祝您使用愉快如有任何问题或建议欢迎反馈