夜雨聆风
不用懂技术，不用写代码，只需要会扫码就能用上 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 篇
