位置：AI门户网
> AI应用 > AI智能体 > OpenClaw接入飞书到底难不难？新手能搞定吗？
你是不是也刷到过别人晒图，在飞书里@一下机器人，就能让它帮你写日报、查资料、甚至操作电脑？是不是感觉特别酷，但一想到要自己动手部署什么“小龙虾”OpenClaw，就觉得头大，感觉那是程序员才能玩转的东西？心里可能还在琢磨，这玩意儿能不能像“新手如何快速涨粉”一样，有个傻瓜式的步骤？别担心，今天这篇文章就是为你准备的。咱们就用大白话，一步一步拆解，目标就一个：让你这个纯小白也能顺利地把OpenClaw接进飞书，拥有一个24小时在线的AI私人助理。我保证，不整那些虚头巴脑的术语，就聊怎么一步步做下来。
很多人一听OpenClaw就懵，其实你可以把它理解成一个超级接线员。它本身不生产“智慧”，它的核心工作是连接。一边连着像Kimi、通义千问这样的大脑（大模型），另一边连着飞书、微信这些你天天用的工具。^^11^^ 你的命令从飞书发出来，它接收后交给“大脑”思考，思考完再指挥具体的“手”去干活，比如读写文档、发消息，最后把结果通过飞书回给你。 所以，部署OpenClaw，本质上就是在你的电脑或服务器上搭建好这个“接线员”，并告诉它飞书那边的电话号码（App ID和Secret）。
弄明白这个，我们再来看准备工作。你需要三样东西：一台能联网的电脑（Windows/Mac都行）、一个飞书账号、以及那么一丁点跟着教程操作的耐心。对了，虽然它叫“本地部署”，但对于新手，我非常非常推荐使用云服务器，比如阿里云、腾讯云提供的那些。为什么？因为你本地电脑一关机，你的AI助理就“下班”了。用云服务器，它就能7×24小时不间断为你服务，更稳定，也省心。
这是基础，但别怕，现在有非常省事的方法。如果你是Windows用户，最推荐的方式就是通过PowerShell（以管理员身份运行）来安装。你不需要懂代码，就像安装一个软件一样，输入几行命令。
首先，你需要安装Node.js环境，这是OpenClaw的运行基础。去Node.js官网下载安装包，一路点“下一步”就行。装好后，打开PowerShell，输入 `node -v` 和 `npm -v`，如果显示出版本号，说明环境装好了。
接下来，安装OpenClaw本身。在PowerShell里输入：
```
npm install -g openclaw-cn@latest
```
等待它下载安装完成。然后，运行初始化向导：
```
openclaw-cn onboard --install-daemon
```
这个过程会引导你进行一些基本配置，比如选择模型（你可以先选免费的，比如DeepSeek）、设置时区等。 按照提示一步步来，遇到不懂的选项可以先按默认的来。完成之后，启动网关服务：
```
openclaw-cn gateway --port 18789
```
看到服务成功运行，没有报错，那么恭喜你，OpenClaw的核心部分就已经在你机器上跑起来了！
现在，“接线员”准备好了，我们得去飞书申请一个合法的“机器人”身份，这样才能让两边对上话。
1.打开飞书开放平台：用浏览器访问 `https://open.feishu.cn/app`，用你的飞书账号登录。
2.创建应用：点击“创建企业自建应用”。应用名称可以随便起，比如“我的AI小助手”，描述也写一下，图标选个顺眼的。
3.添加机器人能力：应用创建好后，在左侧找到“添加应用能力”，选择“机器人”，点击添加。 这就好比给你的应用赋予了可以收发消息的“灵魂”。
4.拿到关键凭证：这是最重要的一步！在左侧菜单进入“凭证与基础信息”页面，找到App ID和App Secret，把它们复制下来，妥善保存在记事本里。这俩就是飞书机器人的“身份证”和“密码”，后面配置OpenClaw时要填。
5.给它开权限：光有身份还不够，得告诉飞书这个机器人能干什么。进入“权限管理”页面，需要开通一些权限。一个比较省事的方法是使用“批量导入导出权限”功能，粘贴一段权限JSON代码（很多详细教程里都会提供这段代码）。 如果不想找代码，也可以手动搜索添加以下几个核心权限：`im:message`（收发消息）、`im:message:send_as_bot`（以机器人身份发消息）等。
两边都准备妥当了，现在要让它们建立连接。
回到你的PowerShell（如果之前网关关了，记得用 `openclaw-cn gateway` 命令重新启动），输入命令开始配置飞书通道：
```
openclaw-cn config
```
或者有些教程会指导你使用 `openclaw channels add` 命令。 接着，你会进入一个交互式的配置向导：
*它会问你是否要添加一个新渠道，选 `Yes`。
*在渠道列表里选择 `飞书 (Feishu)`。
*然后它会让你输入之前保存的App ID和App Secret，依次粘贴进去。
*后续一些问题，比如选择国内飞书 (`Feishu (feishu.cn) - China`)，是否在群内响应（可以先选否），按提示操作即可，最后选择 `Finished` 完成。
配置完成后，务必重启一下网关服务，让配置生效。命令是：
```
openclaw-cn gateway restart
```
或者先停止再启动。
还差临门一脚。我们回到飞书开放平台的应用管理页面。
1.设置事件订阅：在左侧找到“事件与回调”。在“事件配置”里，将订阅方式选择为“使用长连接接收事件”，然后保存。 这个很关键，它意味着飞书会通过一个持续的连接把消息推送给你的OpenClaw，而不是需要你提供一个公网网址。
2.添加接收消息事件：在“已添加事件”区域，点击“添加事件”。搜索并添加`im.message.receive_v1`（接收消息）这个事件。 这样，当你在飞书里给机器人发消息时，飞书才知道要把这个事件通知给你的OpenClaw服务。
3.发布应用：进入“版本管理与发布”，创建一个新版本（比如版本号写1.0.0），填写更新说明，然后提交发布。如果你是个人测试，通常自己审批通过就行。
走到这里，理论上你已经成功了。但根据大量小白的实战经验，这时候最容易出问题。别慌，我们来看看几个高频问题。
问题一：我在飞书里发了消息，机器人怎么不回我？
这可能是最让人沮丧的情况。首先，检查你的OpenClaw网关服务是不是一直在正常运行（PowerShell窗口不要关）。其次，去飞书开放平台“事件与回调”页面，看看“长连接”状态是否正常。如果显示异常，通常是因为OpenClaw那边的飞书渠道没配置好或者网关没启动。 按照第三步重新检查一下配置和重启网关。
问题二：机器人回复了一个“配对码”（Pairing Code），这是啥？
这是安全验证机制。第一次在飞书里和机器人私聊时，它可能会回复一串配对码。这时，你需要回到部署OpenClaw的服务器终端（PowerShell），输入命令：
```
openclaw pairing approve feishu 你的配对码
```
完成配对后，就能正常对话了。
问题三：教程里的命令和我电脑上提示的不一样？
OpenClaw版本更新很快，命令可能会有细微差别。如果你安装的是 `openclaw-cn`，那么命令通常都带 `-cn` 后缀（如 `openclaw-cn gateway`）。如果是官方国际版，可能就是 `openclaw`。以你实际安装的版本提示为准。
问题四：我想用更强大的官方插件，怎么弄？
飞书官方后来推出了专用的OpenClaw插件，功能更强大稳定。安装方法也简单，在服务器上执行：
```
npx -y @larksuite/openclaw-lark-tools install
```
然后按提示用飞书扫码就能快速配置，能省去手动配置凭证和事件的麻烦。
*从云服务器开始：再强调一次，对于新手，用阿里云、腾讯云这样的云服务器来部署，体验会好很多。它们甚至有提供预装了环境的镜像，几乎是点几下就能完成基础部署，避开了最头疼的环境配置问题。
*权限给够：在飞书开放平台配置权限时，如果不太确定，可以把“通讯录”、“云文档”等常用权限也开了，这样你的AI助手才能更好地帮你处理文件、联系人信息。
*善用Skills：OpenClaw的强大在于它可以安装各种“技能”（Skills）。部署成功后，你可以探索为其安装总结网页、读写文件、查天气等技能，让它真正成为你的多面手助理。
好了，整个流程就是这样。是不是感觉虽然步骤不少，但每一步要你做的事情其实都很明确？无非就是“装软件、填信息、连起来”这三件套。过程中可能会遇到一两个小波折，但根据上面列的排查方法，大部分都能解决。说到底，这件事需要的不是多高的技术，就是一份照着做的细心。当你第一次在飞书里收到AI助手根据你指令完成的回复时，那种成就感，绝对值得你花这一两个小时折腾一下。别等了，现在就打开电脑试试吧，你的24小时数字同事正在等着上岗呢。
版权说明：
