
不用懂技术,不用写代码,只需要会扫码就能用上 OpenClaw。飞书官方插件让部署变得超级简单。
01. 为什么选飞书插件?
在安装 OpenClaw 之前,我先告诉你为什么推荐飞书插件:
| 对比项 | 传统安装 | 飞书官方插件 |
|---|---|---|
| 门槛 | 需要理解开发者后台 | 扫码就能用 |
| 配置 | 手动配置 App ID/Secret | 自动铺好 |
| 权限 | 需要自己开权限 | 自动开通关键权限 |
| 维护 | 自己维护升级 | 官方统一维护 |
| 飞书能力 | 仅聊天 | 文档/表格/日历/任务全支持 |
选飞书插件的 3 个理由:
- 1. 门槛最低 - 不用懂技术,扫码就行
- 2. 能力最全 - 不只是聊天,还能操作日历、文档、多维表格、任务
- 3. 官方维护 - 升级、诊断都更省心
02. 安装步骤
第 1 步:安装 OpenClaw 本体
打开终端(命令行),粘贴以下命令并回车:
# Linux/MacOS
curl -fsSL https://openclaw.ai/install.sh | bash
# Windows
iwr -useb https://openclaw.ai/install.ps1 | iex第 2 步:安装飞书官方插件
npx -y @larksuite/openclaw-lark install第 3 步:扫码创建机器人
安装过程中终端会弹出一个二维码,用飞书扫码完成授权。
第 4 步:确认创建成功
终端会显示机器人创建成功的信息。
03. 4 件必须核对的事
安装完成后,回到飞书开发者后台,核对以下 4 件事:
✅ 1. 机器人已经出现
登录飞书开发者后台,确认机器人已经创建成功。
✅ 2. App ID / Secret 已经就位
在"凭证与基础信息"页面,确认 App ID 和 App Secret 已经生成。
✅ 3. 事件与回调已经是长连接
进入"事件与回调"页面:
- • 确认已启用长连接模式
- • 确认
im.message.receive_v1已在列表中
✅ 4. 关键权限已经开通
进入"权限管理"页面,确认以下权限已开通:
- • im.message
- • im.chat
- • im.resource
04. 验证安装成功
方法 1:发送命令验证
在飞书里给机器人发送:
/feishu start如果返回了版本号信息,说明安装成功。
方法 2:批量授权
发送以下命令完成用户授权:
/feishu auth这样 OpenClaw 可以通过你的身份操作飞书了。
05. 首次启动
启动 Gateway
安装完成后,需要启动 Gateway 才能让机器人跑起来。
方式一:前台运行(测试用)
openclaw gateway --port 18789 --verbose方式二:后台运行(长期使用)
openclaw gateway --install-daemon验证是否启动成功
启动后,在飞书里给机器人发一条消息:
你好
如果机器人回复了,说明已经跑起来了!
06. 常见问题
问题 1:二维码显示不出来
解决方法:确保终端支持图形界面,或者使用远程工具显示
问题 2:扫码后提示"无权限"
解决方法:确认你扫码的飞书账号有创建应用的权限
问题 3:安装命令执行报错
解决方法:确保 Node.js 版本 >= 22,运行
node -v检查
问题 4:cannot find module xxx
解决方法:进入插件安装目录,运行
npm install
cd ~/.openclaw
npm install本篇小结
| 步骤 | 操作 |
|---|---|
| 第 1 步 | 安装 OpenClaw 本体 |
| 第 2 步 | 安装飞书官方插件 |
| 第 3 步 | 扫码授权 |
| 第 4 步 | 核对 4 件事 |
| 验证 | /feishu start |
按照这个流程,5 分钟内就能用上你的 AI 助手!
下篇预告
下一篇文章我们将讲到:
- • 6 个必开设置:让 AI 更好用、更省钱
- • 流式回复、耗时显示、状态展示…
- • 省钱秘籍:上下文压缩
敬请期待!
本文是《OpenClaw 新手实践课程》第 2 篇
夜雨聆风