手把手教你把 OpenClaw 接入飞书：30 分钟打造你的“数字打工人”

你有没有想过，让 AI 不只是“聊天”，而是真正替你干活？
比如：在飞书里说一句“整理我昨天收到的所有发票 PDF”，它就自动重命名、归档；或者远程指挥家里的电脑帮你跑脚本、查日程、发邮件？

这不再是科幻——OpenClaw 就是这样一个开源的 AI 智能体（Agent），它不仅能思考，还能行动。而飞书，作为国内最开放的企业协作平台，正是 OpenClaw 最佳的“工作入口”。

好消息是：2026 年起，飞书全面放开 API 调用限制，无限次免费调用！
今天，我们就用一篇保姆级教程，带你从零安装 OpenClaw，并完整对接飞书，让你拥有一个全年无休、不领工资的“AI 员工”。

第一步：安装 OpenClaw（本地部署）

OpenClaw 支持 Windows、macOS 和 Linux，推荐使用 WSL2（Windows） 或原生 Unix 系统以获得最佳体验。

⚠️ 前置要求：

Node.js ≥ 22.0（不要用 25+ 版本，已知兼容问题）

Git

稳定网络（建议开启科学上网，部分依赖需访问海外源）

快速安装命令（官方一键脚本）：

Windows（PowerShell 管理员模式）：

iwr -useb https://openclaw.ai/install.ps1 | iex

macOS / Linux：

curl -fsSL https://openclaw.ai/install.sh | bash

安装完成后，运行初始化向导：

openclaw onboard --install-daemon

按提示选择：

使用场景：个人
大模型提供商：可选 Kimi、智谱、阿里百炼等（注册送额度）
聊天渠道：先跳过（我们稍后手动配置飞书）

💡 小贴士：若安装卡住，可尝试换 npm 源为淘宝镜像：
npm config set registry https://registry.npmmirror.com

安装 OpenClaw 的终端界面

第二步：在飞书开放平台创建应用

访问飞书开放平台，用手机号注册/登录。
点击右上角 「开发者后台」→「创建企业自建应用」。
填写应用名称（如 “我的 OpenClaw 助手”），上传图标，点击创建。
添加机器人能力：
- 左侧菜单 → 「添加应用能力」 → 选择 「机器人」 → 点击添加。
获取凭证（关键！）：
- 左侧 → 「凭证与基础信息」
- 复制 App ID 和 App Secret，妥善保存！

飞书开放平台创建应用界面

第三步：安装飞书插件并配置 OpenClaw

回到终端，执行以下命令：

# 安装飞书官方插件
openclaw plugins install feishu-openclaw

# 启用飞书通道
openclaw config set channels.feishu.enabled true --json

# 配置 App ID 和 Secret（替换为你自己的）
openclaw config set channels.feishu.appId "cli_xxxxxxx"
openclaw config set channels.feishu.appSecret "your_secret_here"

# 设置连接模式（推荐 WebSocket，无需公网 IP）
openclaw config set channels.feishu.connectionMode websocket

# 设置访问策略
openclaw config set channels.feishu.dmPolicy pairing        # 私聊需配对
openclaw config set channels.feishu.groupPolicy allowlist   # 群聊白名单
openclaw config set channels.feishu.requireMention true     # 群聊需 @ 机器人

# 重启网关使配置生效
openclaw gateway restart

✅ 此时务必保持 openclaw gateway 在后台运行（不要关闭终端）！

第四步：配置飞书事件订阅（关键！顺序不能错）

必须先启动 OpenClaw 网关，再配置飞书！

回到飞书开放平台 → 应用管理页 → 「事件与回调」。
订阅方式：选择 「使用长连接接收事件」 → 保存。
- 若提示“未建立长连接”，说明 OpenClaw 网关未运行或配置错误，请检查并重试。
添加事件：
- 点击 「添加事件」
- 搜索并勾选：im.message.receive_v1（接收消息）
- 可选：im.chat.member.bot.added_v1（被拉入群通知）
保存，应显示 “长连接已建立”。

飞书事件订阅配置界面

第五步：配置权限并发布应用

左侧 → 「权限管理」 → 「批量导入/导出权限」
粘贴以下 JSON 权限（覆盖原有内容）：

{
  "scopes": {
    "tenant": [
      "im:message.p2p_msg:readonly",
      "im:message.group_at_msg:readonly",
      "contact:user.base:readonly",
      "im:message.group_msg",
      "docx:document:readonly",
      "drive:drive:readonly"
    ],
    "user": []
  }
}

点击 「确定新增权限」 → 「申请开通」。
左侧 → 「版本管理与发布」 → 「创建版本」
- 版本号：v1.0.0
- 可见范围：「仅我自己」（测试阶段）
- 点击 「保存」→「确认发布」
若为企业账号，需管理员审批（个人测试通常秒过）。

第六步：配对与测试

打开飞书客户端，搜索你创建的机器人名称。
发送任意消息（如 “你好”）。

机器人会回复一条配对指令，例如：

请在服务器执行：openclaw pairing approve feishu ABC123XYZ

在 OpenClaw 运行的终端执行该命令：
```
openclaw pairing approve feishu ABC123XYZ
```
配对成功后，即可正常对话！

🔍 验证状态：
openclaw status
应看到 Feishu │ ON │ OK │ configured

第七步（进阶）：开启文件操作与 Shell 权限

默认 OpenClaw 只能发消息。若想让它操作本地文件、执行命令，需修改配置：

编辑配置文件：
```
nano ~/.openclaw/openclaw.json
```
找到 "tools" 字段，将 profile 从 "messaging" 改为 "full"：
```
"tools": {
  "profile": "full"
}
```
重启网关：
```
openclaw gateway restart
```

⚠️ 安全警告：开启 full 权限后，AI 可执行任意 shell 命令！切勿在主力机或公司电脑上启用，建议使用虚拟机或隔离环境。

恭喜你！现在你已经拥有了一个能真正干活的 AI 助手。
它可以在飞书里：

自动整理文件
查询系统状态
发送邮件、创建日程
甚至远程部署服务

技术早已成熟，缺的只是你动手的那一刻。

📌 最后提醒：

初期务必用个人飞书账号测试，避免数据泄露风险。

AI 仍有“幻觉”，重要操作请人工复核。

关注 Token 消耗，合理选择模型。

你准备好让 AI 替你打工了吗？
欢迎在评论区分享你的 OpenClaw 使用场景，或提出配置中遇到的问题！👇

🔗 延伸阅读：

OpenClaw 官网

飞书机器人开发文档

#OpenClaw #飞书机器人 #AI智能体 #办公自动化 #开发者教程