本文将手把手教你如何在本地电脑（Mac、Windows PC 或 Linux）上，将已经部署好的 OpenClaw（原 Clawdbot） 快速接入飞书。全程可视化操作，无需编写复杂代码，只需几步配置即可完成！
🛠️ 前置准备工作
在开始起飞之前，请确保你已经准备好了以下“登机牌”：
- 飞书管理员权限或开发者权限：你需要能够登录 飞书开放平台 创建自建应用。
- 本地已运行 OpenClaw：你已经在自己的电脑上成功部署并启动了 OpenClaw 服务。
- 💡 提示：如果还没有部署，建议参考官方文档通过 Docker 或源码在本地启动 OpenClaw。推荐配置好国内大模型服务（如 Kimi、DeepSeek）的 API 凭证。
📍 第一阶段：在飞书创建你的 AI 助理应用
我们需要先在飞书里给 OpenClaw 注册一个“身份”。
1. 创建企业自建应用
登录飞书开放平台，进入控制台，点击 “创建企业自建应用”。
填写应用名称（例如：我的AI助理小龙）和应用描述，上传一个好看的头像，然后点击创建。
2. 添加机器人能力
在应用管理页面的左侧导航栏，找到 “添加应用能力”，在列表中选择 “机器人”，点击添加。
(注意：现在先不用急着发布，等我们全部配置完再统一发布。)
3. 获取核心凭证（App ID & App Secret）
在左侧导航栏找到 “凭据与基础信息”。
你会看到属于这个应用的 App ID 和 App Secret。点击右侧的复制按钮，将它们暂存到你的备忘录中。（⚠️注意保密，这是机器人的钥匙！）
📍 第二阶段：打通本地 OpenClaw 与飞书的桥梁
现在，我们需要告诉运行在你本地电脑上的 OpenClaw：你的飞书身份是什么。
1. 启动 OpenClaw 服务与交互终端 (TUI)
在进行配置前，请确保你已经启动了核心服务。打开你的本地终端（Terminal 或命令行），依次执行以下命令：
第一步：启动 Service Gateway（服务网关）
# 启动底层网关服务，请保持此终端窗口运行，不要关闭
openclaw gateway第二步：启动 OpenClaw TUI（终端用户界面） 重新打开一个新的终端窗口（或新建 Tab），输入以下命令进入命令行对话界面：
openclaw tui(💡 提示：如果你更习惯可视化操作，也可以在启动 gateway 后，打开浏览器访问 http://localhost:8080 进入 Web 控制台)
2. 通过对话命令配置飞书通道（极简推荐！）
在刚刚打开的 openclaw tui 命令行界面（或网页对话框）中，我最推荐这种直接输入命令的方式，最轻便，不用费眼睛去菜单里找按钮，直接与 AI 对话，让 OpenClaw 自己配置自己！
在对话框中，将刚才在飞书后台复制的 App ID 和 App Secret 替换到下方命令中，然后直接发送给它：
帮我配置接入飞书机器人通道。
我的 App ID 是：【这里粘贴你的 App ID】
我的 App Secret 是：【这里粘贴你的 App Secret】
请帮我把这两个参数保存到通道配置中，并使之生效。至此，OpenClaw 会自动调用自身的工具完成底层配置，并在对话中回复你配置成功。
(💡 提示：得益于飞书的“长连接”模式，你的本地电脑不需要具备公网 IP 或进行内网穿透（Ngrok），也能顺利接收飞书消息！)
📍 第三阶段：配置飞书事件与高级权限
为了让机器人能接收消息并拥有读取文档、处理文件的能力，我们需要在飞书后台为其赋予相应的权限。
1. 配置长连接与接收事件
回到 飞书开放平台 的应用管理页面：
- 左侧导航栏点击 “事件与回调” -> “事件配置”。
- 订阅方式选择 “长连接接收事件”，点击 “保存”。
- 🚨 避坑：如果提示“应用未建立长连接”，请检查本地 OpenClaw 填写的 App ID 和 Secret 是否正确。如果确认无误依然报错，请在终端里将本地的 OpenClaw 服务重启一下，再回来点保存。
- 保存成功后，点击下方的 “添加事件”，搜索并勾选 “接收消息”，按照指引开通权限。
- (强烈建议顺便添加“消息已读”、“机器人进群”、“机器人被移出群”事件，方便后续在群聊中使用)
2. 配置回调方式
在同一个页面的顶部切换到 “回调配置” 页签，同样选择 “使用长连接接收回调” 并保存。
3. 一键导入高级权限（魔法步骤 ✨）
OpenClaw 极其强大，为了让它火力全开，我们需要赋予它足够的 API 权限：
- 左侧导航栏点击 “权限管理”。
- 点击页面上方的 “批量导入权限”。
- 清空弹窗中原有的内容，将下方这段 JSON 代码完整复制并粘贴进去：
{
"scopes": {
"tenant": [
"im:message",
"im:message.p2p_msg:readonly",
"im:message.group_at_msg:readonly",
"im:message:send_as_bot",
"im:resource",
"contact:user.base:readonly",
"im:message.group_msg",
"im:message:readonly",
"im:message:update",
"im:message:recall",
"im:message.reactions:read",
"docx:document:readonly",
"drive:drive:readonly",
"wiki:wiki:readonly",
"bitable:app:readonly",
"task:task:read",
"contact:contact.base:readonly",
"docx:document",
"docx:document.block:convert",
"drive:drive",
"wiki:wiki",
"bitable:app",
"task:task:write"
],
"user": []
}
}- 点击下一步，确认开通所有权限。
**
📍 第四阶段：发布应用与首次配对
万事俱备，只欠东风！
1. 发布版本
- 左侧导航栏点击 “版本管理与发布”。
- 点击 “创建版本”，版本号填入
1.0.0，更新说明写首次接入 OpenClaw。 - 点击 “保存并申请发布”。（如果需要企业管理员审批，请联系管理员通过）。
2. 终端配固激活（关键步骤 🔑）
打开你的电脑版或手机版飞书：
- 在顶部搜索框搜索你刚才创建的机器人名称，点击进入私聊界面。
- 随便发一句话给它（比如：“你好”）。
- 此时，机器人大概率会回复一段包含命令行的配对请求（针对老版本，2026年2月之后部署的新版可能已自动跳过此步）。
- 复制机器人回复的最后一行终端命令。
- 回到你运行 OpenClaw 的 本地终端（Terminal 或命令行窗口）。
- 保持 OpenClaw 运行的状态下（如果需要，新开一个终端窗口），粘贴你刚才复制的命令并回车。
- 提示
Pairing successful（配对成功）后，回到飞书再次跟机器人说话，如果它以 AI 的口吻回复你，恭喜！大功告成！🎉
**
🌟 进阶玩法：你的飞书机器人能做什么？
接入 OpenClaw 的飞书机器人不仅是个“聊天搭子”，更是个全能生产力工具。只要你本地配置的大模型（如 Kimi, DeepSeek 等）能力足够，它就能解锁以下神仙操作：
| 功能类型 | 支持情况 | 场景举例 |
|---|---|---|
| 基础问答 | ✅ | 文本对话、代码编写、文案创作 |
| 多模态接收 | ✅ | 扔一张截图给它，让它提取文字或分析图表 |
| 多模态回复 | ✅ | 自动生成图表、语音甚至视频（需配置对应模型） |
| 富文本排版 | ✅ | 回复内容完美支持 Markdown 格式，代码高亮 |
| 飞书生态联动 | ✅ | 帮你在飞书云盘找文件，或者直接帮你用 Markdown 生成一篇飞书文档 |
| 定时与主动 | ✅ | 定时在群里发送早报或工作提醒 |
🛑 玩家避坑指南 (FAQ)
我们收集了开发者社区中大家最常遇到的几个问题，提前帮你排雷：
Q1：配置完跟机器人说话，报错 HTTP 401: Invalid Authentication 怎么办？
A： 这是你给 OpenClaw 配置的大模型 API Key 错误或失效导致的。
解决办法：重新检查你本地 OpenClaw 的模型 API 设置（环境变量或配置文件）。如果你使用的是某些平台的默认接口，可能是欠费或 Key 不对。推荐手动选择如
Moonshot AI (Kimi)或DeepSeek等模型，粘贴你自己申请的有效 API Key 即可解决。
Q2：飞书后台配置“事件与回调”时，一直提示“无法建立长连接”？
A： 这通常是因为飞书后台和本地的 OpenClaw 服务没有握手成功。
解决办法：
- 检查你本地配置的 App ID 和 Secret 是否有多余的空格。
- 终极大法：在终端里终止目前的 OpenClaw 服务，然后重新运行/重启启动命令，等重启完毕后，再回飞书后台点击保存，99% 都能连上。
Q3：对话时报错 Context overflow: prompt too large for the model？
A： 这是由于你当前选择的大模型上下文窗口太小了。建议在本地配置中，切换为支持超长上下文的模型版本（如 128k 或 200k 版本的模型）。
如果在配置过程中遇到其他有趣的玩法或问题，欢迎在评论区留言交流！把你的专属 AI 助理分享给同事们去炫耀吧！