保姆级教程：OpenClaw接入飞书全攻略，让AI助手直接在聊天框里为你干活

设想一下这样的工作场景：你正在飞书中与团队进行频繁的沟通，突然需要AI来整理一份长文档或编写一段代码。与其繁琐地切换到聊天界面、打开浏览器、登录网页版AI再进行反复的复制粘贴，不如直接在对话框中”@”一下专属的AI助手，这样不是更加顺畅吗？今天，我们将把这个设想变为现实，将OpenClaw无缝接入飞书，让强大的AI能力直接融入你的日常办公软件中。

一、OpenClaw是什么？为什么叫”小龙虾”？

OpenClaw是一款开源的AI智能体执行框架，其核心优势在于能够对接各种大型模型，将自然语言指令转化为系统级操作，实现”思考—执行—交付”的全流程自动化，突破了传统AI”只说不做”的局限，实际上相当于一款24小时不间断的”数字助手”。该框架由海外开源团队ClawAI于2025年12月发布测试版，因其项目官方图标为一只红色波士顿龙虾，用户需要通过数据投喂、环境配置、指令训练和场景适配来完成智能体的个性化定制，整个过程与”养殖”过程高度相似，因此被国内网友称为”养龙虾”。

二、环境准备：安装Node.js和Git

在开始接入飞书之前，首先需要准备好基础环境。OpenClaw依赖于Node.js环境，要求版本为v22.0.0或更高。请访问Node.js官网下载Windows安装程序，双击安装包并一路点击下一步即可完成部署。安装完成后，打开PowerShell并输入node -v，如果出现版本号则表示安装成功。

此外，OpenClaw的安装还需要Git工具，否则在安装过程中可能会出现错误。请从Git官网下载安装程序，按照提示进行傻瓜式安装。安装完成后，在PowerShell中输入git –version，如果能显示版本号，则说明安装成功。

三、安装OpenClaw：国内镜像加速

为了杜绝网络问题，建议先切换国内镜像：

  • powershell
  • npm config set registry https://registry.npmmirror.com

然后执行OpenClaw安装脚本（需以管理员身份打开PowerShell）：

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

如果遇到执行策略限制报错，先执行以下命令放宽策略

  • powershell
  • Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

等待安装完成，期间不要关闭PowerShell窗口。安装过程中会进入配置选项，按照提示选择QuickStart、Skip for now跳过飞书配置（后续再填）、All providers显示所有可用模型，最后选中Feishu/Lark确认，这是我们要对接的目标平台。

四、飞书配置：创建应用与获取凭证

接下来需要在飞书开放平台创建应用并获取凭证。访问飞书开发者后台，点击”创建企业自建应用”，填写应用名称（如”OpenClaw智能管家”）和描述，确定创建。

创建好后，进入”凭证与基础信息”页面，可以看到App ID和App Secret，复制保存下来备用（注意千万别泄露）。

在左侧菜单点击”添加应用能力”，选择”机器人”并添加开启。然后配置权限，点击”权限管理”→”批量导入”，复制右侧JSON代码粘贴进去，点击申请开通

{
  "scopes": {
    "tenant": [
      "contact:user.base:readonly",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:chat:read"
    ]
  }
}

接着创建版本并发布：左侧导航栏找到”版本管理与发布”，点击”创建版本”，填写版本号（如1.0.0）和描述，保存并确认发布，等待飞书审核通过。

五、OpenClaw配置飞书：填入凭证并启动

回到刚才保留的PowerShell窗口，现在需要把飞书的App ID和App Secret输入进去。按照提示输入后，直接按回车确认默认的WebSocket连接模式，同时选择China。继续选择”Open – respond in all groups (requires mention)”，然后依次选择Skip for now跳过后续配置。

最后OpenClaw会启动并连上飞书，显示运行日志窗口。注意：这个小黑屏窗口是OpenClaw的网关服务，必须保持打开才能让飞书机器人持续运行。

六、事件回调配置与模型切换

回到飞书开放平台，现在可以完成之前无法保存的事件回调配置了。进入”事件与回调”，点击”添加事件”，搜索”im.message.receive_v1″并勾选接收消息，点击添加。然后再次发布新版本。

如果启动OpenClaw时出现找不到模型API Key的错误，需要更换默认模型。在PowerShell中运行openclaw configure，选择Model，然后选择有免费额度的模型（如千问大模型），按空格勾选，回车确认。

七、开始使用：在飞书中召唤你的AI助手

所有配置完成后，登录飞书客户端，在消息列表中搜索你创建的应用名称，点击进入对话。当飞书对话框里弹出那句熟悉的”hello”时，恭喜你，你的专属AI助手已经正式上线待命！现在你可以在飞书群里直接”@”机器人，让它帮你处理文档、编写代码、查询信息，享受”聊天式调用AI”的高效体验。

通过这次实战，我们不仅获得了一个便捷的聊天机器人，更重要的是拥有了一个数据完全自主可控的私有化大模型入口。你既享受了飞书丝滑的交互体验，又无需担心内部机密信息泄露给第三方公有大模型。

返回顶部