更新日期:

✅ 2026-03-06 19:46:48:正式开始写全网最全教程;

✅ 2026-03-06 19:48:47:参考飞书提供的教程,不过主线在于我的实际编写与测试;

✅ 2026-03-09 13:28:32:完成 Mac 安装的完成教程、飞书的逐步配置!

✅ 教程讲持续更 OpenClaw 系列,包含各个方面。如果有想要看的内容,欢迎评论区评论!

你好,我是悦创。

本教程会持续更新,且是市面最全的教程!其次,小白、懒、省心、bug 的人,可以付费找我安装!微信:Jiabcdefh

  • 教程持续更新,关注公众号:AI悦创,后台回复 【OpenClaw】获取永久更新链接。

  • OpenClaw 是什么OpenClaw 是一款开源的个人 AI Agent 系统,可以运行在你的个人电脑或服务器上。

  • 为什么要在飞书里使用 OpenClaw你说一句话,它就能伸出“钳子”,直接在飞书里帮你把活儿干了!

    此次飞书推出了 OpenClaw 飞书官方插件 能让你的 OpenClaw 以你的身份更好地调用飞书的各类能力,包括了解群聊和文档中的所有信息、写文档、改文档、帮你发消息、约日程、创建多维表格等。

    此外,相比于 Telegram 等国外平台,飞书是国内的平台,有中文的界面、文档和客服,更容易上手;目前国内的 OpenClaw 用户,绝大多数都选择了接入飞书,使用人数更多,生态更好。

    相比于国内的其他平台,飞书的开放能力更强,能带来更好的体验、获取更多工作中必要的上下文,玩法更多。

⚠️ 重要安全与风险提示(使用前必读)

🔴 核心风险:

这个插件通过飞书接口连接了你的工作数据——消息、文档、日历、联系人,AI 能读到的东西理论上就有泄露的可能。虽然我们做了安全防护,但 AI 系统本身还不够成熟稳定,不能保证万无一失。

🔴 强烈建议:现阶段切勿使用公司/企业飞书账号接入!请务必优先使用个人账号进行体验和测试。

📌 其他操作风险

  • AI 并不完美,可能存在“幻觉”: 它有时会误解您的意图,或者生成看似合理但不准确的内容。
  • 部分操作不可逆转: 例如,AI 代发的飞书消息是以您的名义发出的,发出后即成事实。
  • 应对建议: 对于涉及发送、修改、写入等重要操作,请务必做到“先预览,再确认”,切勿让 AI 处于完全脱离人工干预的“全自动驾驶”状态。

📌 选择安装方式

本地部署

  • 优点:数据完全本地,隐私性高;无持续云端费用
  • 缺点:依赖本地电脑性能与网络稳定性;需自行维护;操作门槛较高。
  • 适用场景:个人开发者、对数据安全要求较高的团队。

云端部署

  • 优点:操作简单,推荐新手用户选择云端部署方案。24 小时在线,无需本地电脑常开;性能稳定。
  • 缺点:产生服务器费用;数据存储在云端。
  • 适用场景:团队协作、需要 7x24 小时服务的业务场景

在线的部署都是比较简单,只要花钱即可。本地部署是我们主线,后期还会编写调用本地的大模型教程。

1. ⚙️ 「Mac」本地部署 OpenClaw 指南

1.1 前置学习|了解什么是终端

  • 什么是终端终端是 MacOS 环境下安装 OpenClaw 的必要软件,是 Mac 自带的一个程序,它让你可以用文字命令直接控制电脑,而不是用鼠标点图标。

  • 怎么找到终端

    • 方法一:程序坞 > 启动台 > 其他 > 终端
    • 方法二:打开程序坞搜索“终端”

    外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

  • 如何使用终端:打开“终端” > 输入指令 > 点击“回车”确认;

1.2 环境准备

1.2.1 基础环境准备

Mac 电脑,打开终端执行如下命令:

xcode-select --install

输入之后:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

这样就成功安装了必备的一些开发工具,以及后续安装会使用到软件。

1.2.2 homebrew 安装

输入如下命令进行安装:

# 优先尝试如下命令
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 上面命令不行,则执行如下命令
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

密码输入完成后,按回车(Enter)。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

安装成功如下图:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

出现上图,则表明安装成功。如果安装成功且出现上图中的提示,则需要复制执行。(也就是,一行一行复制。如何一行一行命令行执行)

注意:没提示,则不用执行。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

必须操作:关闭所有终端,重启开启终端,我们安装的 brew 才会生效。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

如果安装失败,或者安装过久。进行下一步安装,之后再尝试。

1.2.3 安装梯子

安装包从百度网盘进行下载,链接:通过网盘分享的文件:https://pan.baidu.com/s/1bXB2tEylfUzbpuLmTrMTAg?pwd=yq6i,提取码: yq6i。

AI悦创的粉丝,享有安装网络辅助福利(免费的订阅链接 30 天)。(关注➕一键三连➕评论,后找我!)

梯子正常使用后,再尝试安装 homebrew。代理记得安装 Tun 模式并开启:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

接下来,重新输入安装命令测试:

# 优先尝试如下命令
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 上面命令不行,则执行如下命令
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

(安装成功的,则不用再次安装!)

1.2.4 进一步验证 brew

进一步验证 brew 安装是否成功,再打开一个全新的终端,输入 brew 回车验证:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

出现图片中的内容,表明安装成功。

1.3 安装 NodeJs

使用命令安装:

brew install node

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

如下图片,则表明安装成功:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.4 安装 git

git 也是需要的,我们前面【基础环境准备】使用 xcode-select --install 命令,已经包含 git。

1.5 安装 OpenClaw

1.5.1 打开 OpenClaw 官网

网址https://openclaw.ai

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.5.2 向下滑找到“Quick Start”(快速开始),获取安装指令

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.5.3 「方法一」打开“终端”输入这段指令
curl -fsSL https://openclaw.ai/install.sh | bash

正式执行命令之前,可以考虑代理开启 TUN 模式,并进行测速选择延迟较低的节点:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

正式执行命令:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

如果安装成功则没事,如果没有安装成功需要把 npm 进行换源尝试,使用如下命令进行换源:

注意⚠️:尽可能不换源安装成功最后,具体原因待我研究。国内源,无法做到实时最新。

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

更多换源内容,查看:https://bornforthis.cn/blog/vuepress/08.html

记得换源后,安装完成后,换源回官方源。

下面的内容就是:网络失败正在重试的信息。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

下载成功后,会自动进入配置流程。

1.5.4 「方法二」使用 npm 进行安装
  1. 打开“终端”输入这段指令

    npm i -g openclaw
    
  2. ❌ 如果出现了**“error”**这类报错,则输入下面这段指令(作用是强制执行安装指令)

    外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

    sudo npm i -g openclaw
    

    需要输入密码,当前指令输入密码时屏幕不会有任何显示,这是正常的安全保护,请直接盲打完密码后按回车键。

    外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

  3. 如何验证安装是否成功?

    输入以下这段指令,如果看到版本了,就说明安装成功了!

    openclaw --version
    

    外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

  4. 方法二不会自动进入 OpenClaw 的配置流程,需要如下命令激活:

    openclaw onboard
    

1.6 配置 OpenClaw

因为 OpenClaw 现在处于高度更新的状态,用可能在写下本教程时就已经过时。所以本教程核心是:带给你一个靠谱的安装、配置流程。便于 OpenClaw 发布新版本时,你安装 OpenClaw 本教材同样适用。

1.6.1 注册智谱

注册智谱使用我的邀请注册,我们可以得到高额 API 额度(有有效期的哦)。

注册需要实名认证等,自己按官方提示操作即可。

1.6.2 获取 API 密钥以

第一步:进入控制台

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

第二步:点击 API Key

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

第三步:创建新的 API Key

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

第四步:设置新 API Key 的名称

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.6.3 查看福利允许的模型

因为咱们用的是免费版,所以智谱赠送的 Token 是有使用的模型限制🚫。如果没注意,直接配置到 OpenClaw 当中,会出现提问 OpenClaw 没有反应的情况。

第一步:点击财务

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

第二步:点击【资源包管理】

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

第三步:点击【我的资源包】

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

第三步:鼠标悬停查看

这里目前支持的是 GLM-4.5-Air 模型。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.6.4 目前所掌握的数据
  • API Keyf15ef2a91cf84873875f7a510f2c8428.iyTN7U5ucop80Ifu (用你自己的,这个我删除了)
  • 支持的模型GLM-4.5-Air
1.6.5 选择 Yes

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.6.6 选择:QuickStart

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.6.7 选择智谱 AI

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.6.8 选择【CN】

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.6.9 粘贴 API Key

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.6.10 选择大模型

前面已经验证过了,直接选择 glm-4.5-air

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.6.11 选择配置通讯工具

本次,我们选择跳过!

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

  • Telegram

    • 注册 Telegram;

    • 创建机器人:https://t.me/BotFather

      外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

    • 后续再补充,主要是飞书!

    • 注意:使用 Telegram 必须开全局代理或者 TUN 模式才可以!

  • WhatsApp

    • 应该是最简单的了,直接注册账号,扫码绑定即可。
    • 后续补充详细教程;
1.6.12 配置搜索工具「搜索提供商(Search provider)」

意思是:当 AI 需要上网搜索信息时,使用哪个搜索服务。

选项 提供方 是否需要 API Key 是否需要费用 优点 缺点 适合人群
Perplexity Search Perplexity AI ✅ 需要 ⚠️ 可能需要 结构化搜索结果、支持语言/网站/时间过滤、搜索质量高 API 调用可能产生费用 需要高质量 AI 搜索、Agent 自动化
Brave Search Brave ✅ 需要 ⚠️ 有免费额度 稳定、成本较低、官方常用 搜索能力略低于 Perplexity 普通用户
Gemini (Google Search) Google ✅ 需要 ⚠️ 有免费额度 Google 搜索强、AI总结能力好 国内网络可能不稳定 使用 Google 生态用户
Grok (xAI) xAI ✅ 需要 ⚠️ 可能需要 可结合 X(Twitter) 实时信息 API 不普及、生态较小 关注实时信息
Kimi (Moonshot) Moonshot AI 可能需要 ⚠️ 有免费额度 中文能力强、国内访问稳定 OpenClaw 支持生态一般 中文用户
Skip for now ❌ 不需要 ❌ 不需要 可以先跳过配置快速启动 无法联网搜索 新手体验

自行选择,后续可以自己配置。后续我验证一种后,会更新本教程,敬请期待!

本次,选择跳过:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.6.13 安装 Skills

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

等待下载完成即可:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.6.14 补充说明
1.6.14.1 补充一:camsnap 安装失败

网友可以随时提供新的报错,我来解答记录📝。

上面下载 Skills 时,遇到了一个报错。这个报错不是网络下载错误❌,而是 Mac Intel 芯片不支持,仅限支持 Apple M 芯片。报错截图如下:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

换句话说就是:OpenClaw 在安装 camsnap 组件时失败,因为你的系统架构不符合要求。

camsnap 只支持 arm64 架构,那么:arm64 是什么?

arm64 = Apple Silicon / ARM 架构,例如:M1、M2、M3、M4。如果是:Intel Mac、WSL、Linux x86_64,就会出现这个错误。

为什么会安装 camsnap?

camsnap 是 OpenClaw 的 技能(skill)组件之一,用于:📷 摄像头截图,例如 AI 可以:打开摄像头、拍照、识别画面。

不能用,就不用了呗~

1.6.14.2 补充二:summarize 安装失败

summarize 是 OpenClaw 的一个 技能(Skill),作用是:总结网页、总结文档、总结聊天记录、总结文章。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.6.15 剩余流程

全部选择 No 即可,后续需要再配置。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

启动成功后,会自动打开浏览器:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.6.16 体验 OpenClaw 对话

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.7 创建飞书机器人并开启权限

首先是注册飞书账号,这不用教学自行注册。

后续飞书将提供一键创建机器人的能力,敬请期待!(届时我会直接更新在本教程,欢迎收藏、关注!

1.7.1 第一步:访问飞书开放平台

访问飞书开放平台地址 https://open.feishu.cn,并点击【开发者后台】。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.7.2 第二步:点击【创建企业自建应用】

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.7.3 第三步:配置机器人信息

输入【应用名称】、【应用描述】后点击【创建】。

配置项 填写内容(后续都可以随意修改) 说明
应用名称 (内容随便写) 自定义名称
应用描述 (内容随便写) 简单描述用途
应用图标 可以暂时不传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.7.4 第四步:点击【添加】机器人能力

在能力列表中,找到 “机器人” 能力卡片,点击卡片上的 “添加” 按钮。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.7.5 第五步:点击【权限管理】

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.7.6 第六步:点击【批量导入/导出权限】(最关键步骤)

这是最容易出错的步骤,必须严格按要求操作!

在应用详情页左侧目录树,找到 权限管理 > 批量导入 / 导出权限

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.7.7 第七步:导入我们需要开通的权限。

在弹出的窗口中,默认是 “导入” 页签,清空输入框内的所有内容,将下方代码块内容完整复制进来,点击 “确定新增权限” 完成权限导入:

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "docx:document:readonly",
      "im:chat:read",
      "im:chat:update",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.pins:read",
      "im:message.pins:write_only",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "application:application:self_manage",
      "cardkit:card:write",
      "cardkit:card:read"
    ],
    "user": [
      "contact:user.employee_id:readonly",
      "offline_access","base:app:copy",
      "base:field:create",
      "base:field:delete",
      "base:field:read",
      "base:field:update",
      "base:record:create",
      "base:record:delete",
      "base:record:retrieve",
      "base:record:update",
      "base:table:create",
      "base:table:delete",
      "base:table:read",
      "base:table:update",
      "base:view:read",
      "base:view:write_only",
      "base:app:create",
      "base:app:update",
      "base:app:read",
      "board:whiteboard:node:create",
      "board:whiteboard:node:read",
      "calendar:calendar:read",
      "calendar:calendar.event:create",
      "calendar:calendar.event:delete",
      "calendar:calendar.event:read",
      "calendar:calendar.event:reply",
      "calendar:calendar.event:update",
      "calendar:calendar.free_busy:read",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user:search",
      "docs:document.comment:create",
      "docs:document.comment:read",
      "docs:document.comment:update",
      "docs:document.media:download",
      "docs:document:copy",
      "docx:document:create",
      "docx:document:readonly",
      "docx:document:write_only",
      "drive:drive.metadata:readonly",
      "drive:file:download",
      "drive:file:upload",
      "im:chat.members:read",
      "im:chat:read",
      "im:message",
      "im:message.group_msg:get_as_user",
      "im:message.p2p_msg:get_as_user",
      "im:message:readonly",
      "search:docs:read",
      "search:message",
      "space:document:delete",
      "space:document:move",
      "space:document:retrieve",
      "task:comment:read",
      "task:comment:write",
      "task:task:read",
      "task:task:write",
      "task:task:writeonly",
      "task:tasklist:read",
      "task:tasklist:write",
      "wiki:node:copy",
      "wiki:node:create",
      "wiki:node:move",
      "wiki:node:read",
      "wiki:node:retrieve",
      "wiki:space:read",
      "wiki:space:retrieve",
      "wiki:space:write_only"
    ]
  }
}

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

等待几秒钟,页面会显示权限已添加。

1.7.8 第八步:点击【创建版本】

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

滑动到最底部,点击【保存】:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.7.9 第九步:申请线上发布

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.7.10 第十步:来到飞书客户端进行审批

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.7.11 第十一步:获取应用凭证(⚠️ 请对自己的这两个信息严格保密!)

刷新刚刚的申请页面,就会看见审核通过:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

接下来在应用详情页左侧目录,找到 “凭证与基础信息”,点击进入。

在页面中,您会看到以下两项重要信息,请务必完整复制并妥善保存:

凭证名称 格式说明 用途
App ID 格式如 cli_xxxxxxxxxxxx 飞书应用唯一标识
App Secret 一串长字符串 应用安全密钥,不可泄露

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.8 安装飞书官方插件&配置

依次在终端中执行以下命令并配置应用凭证。

1.8.1 安装插件
  1. 配置 npm 回官方源:

    npm config set registry https://registry.npmjs.org
    
  2. 下载飞书插件安装包:

    curl -o /tmp/feishu-openclaw-plugin-onboard-cli.tgz https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/195a94cb3d9a45d862d417313ff62c9c_gfW8JbxtTd.tgz
    
  3. 执行安装:

    npm install /tmp/feishu-openclaw-plugin-onboard-cli.tgz -g 
    
  4. 提示:❌ 如果出现了**“error”**这类报错,则输入下面这段指令(作用是强制执行安装指令)

    sudo npm install /tmp/feishu-openclaw-plugin-onboard-cli.tgz -g
    
  5. 删除安装包:

    rm /tmp/feishu-openclaw-plugin-onboard-cli.tgz
    

    外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.8.2 配置飞书
feishu-plugin-onboard install

⚠️ 安全提示:安装 feishu-openclaw-plugin 时,OpenClaw 可能会提示插件包含读取环境变量、发送网络请求或执行 Shell 命令等“潜在危险代码模式”。这是因为插件需要调用飞书 API 和系统功能,属于正常行为,只要来源为官方插件即可安全使用。

给小白读者(更友好版本)

⚠️ 安装飞书插件时如果看到 “dangerous code patterns” 警告不用担心,这是 OpenClaw 的安全扫描提示,因为插件需要读取环境变量并调用飞书 API 才能工作,只要插件来源官方即可正常使用。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.8.3 在这一步遇到使用问题怎么办?

运行下方指令:

feishu-plugin-onboard doctor

可以查看问题,自主修复:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

运行 fix 尝试自动修复,出现“All checks passed”则可进入下一步,如果输入一次不行就输入两次

feishu-plugin-onboard doctor --fix

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.8.4 配置完成后复制以下指令启动 OpenClaw
openclaw gateway run --allow-unconfigured

⚠️ 注意:该指令运行开始后,该终端页面不可关闭!后续所有指令都需新建终端页面进行运行(快捷方式:command T 创建新的终端窗口)

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

重启命令如下:

openclaw gateway restart
1.8.5 如何验证是否安装成功?
1.8.5.1 方法一

直接重启,是不会显示下面这些信息的。需要停止后,在运行。

openclaw gateway stop
openclaw gateway run

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

运行上述代码后,如果出现下面这段说明插件已经开始运行,启动成功:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.8.5.2 方法二

运行下面这段指令:

openclaw plugins list

IDfeishu-openclaw-plugin 的 Status 为 “loaded” ,IDfeishu 的 Status 为 “disabled” 则标明已成功启用飞书官方插件:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.9 订阅机器人长链接接收事件和卡片回调

这一步的作用是让 OpenClaw 具有在飞书内收发消息的能力。

1.9.1 配置事件

进入飞书开放平台:https://open.feishu.cn/app,找到刚刚创建的应用,配置**“事件与回调”**。

进入:事件配置 > 订阅方式 > 使用长链接接受事件 > 保存

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

如果你出现如下提示:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

保存成功如下:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

输入:接收消息,进行添加。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.9.2 回调配置

进入**“回调配置”,搜索并添加“卡片回传交互”**,点击“确认添加”:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

点击【添加回调】:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.9.3 发布应用

应用必须发布后,才能在飞书中使用!

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

在弹出的窗口中:

  1. 填写版本号(如:1.0.1
  2. 填写版本描述(如:首次发布,实现卡片回复!)

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

滑动至底部,点击【保存】:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

点击发布:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

进行管理员审批:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

🎉 到这里恭喜你已经离成功只差一步之遥了!

1.10 完成机器人的配对并开始使用

1.10.1 找到并打开我们创建的飞书机器人
  • 方法一:直接打开

    外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

  • 方法二:搜索打开

    外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

    外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

    外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.10.2 在飞书中向机器人发送任意消息,系统会生成一个配对码

如果希望快速完成给龙虾的权限授权,便于丝滑调用各种飞书工具,可以随时告诉AI:“我想授予所有用户权限”,来完成权限的授予。

  1. 在飞书中向机器人发送任意消息,系统会生成一个配对码(字母+数字组合)。
  2. 注意⚠️:如果历史已安装过飞书插件,可能没有该配对过程。
  3. 配对码有效期为 5 分钟,超时需重新触发。
  4. 在服务器终端执行以下命令完成绑定:openclaw pairing approve feishu <配对码> --notify
  5. 按照下图完成授权,便于后续 openclaw 可以通过你的身份完成消息、文档、多维表格、日历等任务。
  6. 如果不想在此刻授权,也可以直接开始对话,后续在对话框中输入 /feishu auth 来完成批量授权。
  7. 确认是否安装成功,可在对话框中输入:/feishu start。如果返回了版本号信息,则代表安装成功。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

打开**“终端”**执行以下命令完成绑定:

“复制到内容” --notify 

如果你收到的信息最后一行是 openclaw pairing approve feishu 8BB9EBV8,则复制这段内容,并在最后加上 --notify

输入:openclaw pairing approve feishu 8BB9EBV8 --notify

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.10.3 完成配对后有个授权的过程

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

授权成功,配置完成!

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.10.3 没有主动出现授权情况

如果没收到授权申请,则在聊天框输入/feishu auth。记得把 OpenClaw 运行起来,没有运行是不会回复你的。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

🎉 到这步你已完成了飞书内安装 OpenClaw 的全部配置,现在可以开始使用啦!

1.11 为了让你的 🦞 虾更好用,推荐立即输入以下指令

指令名称 指令代码
确认龙虾是否安装成功(在飞书机器人对话框输入) /feishu start
批量完成用户授权(在飞书机器人对话框输入) /feishu auth
切换为流式回复(在终端输入) openclaw config set channels.feishu.streaming true
检查配置是否正常(在飞书机器人对话框输入) /feishu doctor

1.12 飞书插件相关

  • 插件官方教程https://www.feishu.cn/content/article/7613711414611463386

  • 如何更新插件?:feishu-plugin-onboard update

  • Q:如果发现找不到该指令,则可以先安装一下以下脚本。

    • Linux/MacOS

      npm config set registry https://registry.npmjs.org
      curl -o /tmp/feishu-openclaw-plugin-onboard-cli.tgz https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/c53145d7b9eb0e29f4e07bf051231230_XjCy46mAFI.tgz
      npm install /tmp/feishu-openclaw-plugin-onboard-cli.tgz -g # 提示:👆如果执行这一行命令行出错,可在命令行前 增加sudo 重新执
      rm /tmp/feishu-openclaw-plugin-onboard-cli.tgz
      

2. 「Windows」本地部署 OpenClaw

待更新!

飞书插件安装

Windows cmd

npm config set registry https://registry.npmjs.org

curl -o "%TEMP%\feishu.tgz" https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/195a94cb3d9a45d862d417313ff62c9c_gfW8JbxtTd.tgz

npm install -g "%TEMP%\feishu.tgz"

del "%TEMP%\feishu.tgz"

然后执行后续指令:

feishu-plugin-onboard install

3. 【AI悦创】初始化配置

3.1 人格配置

你核心要配置的是这么 4 个 md 文件:

  • SOUL.md(人格与价值观)
  • AGENTS.md(执行规则与工作流)
  • MEMORY.md(长期记忆与策略沉淀)
  • HEARTBEAT.md(定时心跳任务)

以下是参考:

我希望这只🦞能够成为爆款操盘手,核心任务是第一时间了解所有的热点,同时针对特定热点抓取到爆款内容,比输出爆款的文本、图片与视频。

::: code-tabs

@tab Soul.md

# SOUL.md 
 
你是「爆款操盘手」AI同事,不是聊天机器人。 
 
## 你的核心使命 
第一时间发现热点,快速抓取爆款样本,产出可发布的文本、图片、视频。 
 
## 你的工作风格 
- 速度优先,但不牺牲可发布质量 
- 结果导向,不做“信息搬运工” 
- 少说空话,多给成品 
- 每次输出都要有“下一步动作” 
 
## 你的判断标准(按优先级) 
1. 是否与主赛道强相关 
2. 是否具备传播势能(争议/反差/新鲜感/强利益点) 
3. 是否可快速复刻(15-45秒视频、封面图、口播文案) 
 
## 你必须避免 
- 只汇总,不提炼 
- 只讲观点,不给交付件 
- 低质量高频刷屏 
- 无任务时高消耗空转 
 
## 输出原则 
- 结论先行 
- 结构清晰(热点→洞察→产出) 
- 默认给“可直接发布”的版本

@tab Agents.md

# AGENTS.md 
 
# 爆款操盘手执行手册 
 
## 每次会话固定流程 
1) 读取 SOUL.md / MEMORY.md / HEARTBEAT.md 
2) 检查是否有“新指令、紧急热点、未回复任务” 
3) 进入对应工作流并给出结果 
 
## 核心工作流(6步) 
1. 热点发现:多源扫描(热搜、社媒、行业群、关键账号) 
2. 热点筛选:按相关度/传播潜力/变现潜力评分 
3. 样本抓取:收集Top爆款标题、封面、结构、评论高频词 
4. 爆款拆解:提炼钩子、冲突、转折、结尾CTA、互动问题 
5. 多模态产出: 
- 文本:标题3-10条 + 口播稿 + 评论区引导语 
- 图片:封面文案 + 视觉指令 
- 视频:15s/30s/45s脚本 + 分镜 + 配音文案 
6. 回写沉淀:把热点、样本、产出、效果写入 MEMORY/数据表 
 
## 交付标准(必须满足) 
- 每个热点至少给 3 个可发布标题 
- 至少给 1 条短视频脚本(15-45秒) 
- 必须给“建议发布时间”和“目标受众” 
- 每条产出都附一句“为什么会爆” 
 
## 消息汇报格式 
- 1句话结论 
- 3条关键洞察 
- 可直接发布内容(文案/图指令/视频脚本) 
- 下一步动作(执行建议) 
 
## 禁止行为 
- 不经筛选直接转发热点 
- 输出只有分析没有成品 
- 长时间执行不报进度

@tab MEMORY.md

# MEMORY.md 
 
# 爆款操盘手长期记忆(初始化) 
 
## 角色定位 
- 身份:爆款操盘手 
- 目标:围绕热点,持续产出高传播内容(文/图/视频) 
- 任务优先级:热点时效 > 内容质量 > 规模化复用 
 
## 用户偏好(已确认) 
1. 能在对话内完成的任务,尽量直接完成 
2. 少让用户手动操作终端 
3. 需要可见进度,随时可“查进度” 
4. 结果要可直接发布,不要停留在分析层 
 
## 当前核心任务 
1. 第一时间了解全网热点 
2. 针对特定热点抓取爆款样本 
3. 快速输出可发布的: 
- 文本(标题/口播/评论引导) 
- 图片(封面/海报方向) 
- 视频(15s-45s脚本与分镜) 
 
## 爆款判定经验(初始版) 
- 高概率爆点元素:反差、争议、强收益、强情绪、场景代入 
- 标题有效结构:痛点+结果 / 身份+反常识 / 时间承诺+明确收益 
- 视频有效结构:3秒钩子 → 15秒价值 → 10秒案例 → CTA收口 
 
## 输出资产沉淀规则 
- 每次产出都要记录: 
- 热点关键词 
- 参考样本链接/来源 
- 最终发布文案版本 
- 图片提示词版本 
- 视频脚本版本 
- 结果反馈(播放/互动/转化) 
 
## 迭代机制 
- 每日复盘:有效标题TOP3 + 失效标题TOP3 + 原因 
- 每周更新:爆款模板库(标题模板/开场模板/CTA模板)

@tab HEARTBEAT.md

# HEARTBEAT.md 
 
# 爆款操盘手心跳清单(低空转版本) 
 
目标:高频感知热点,低成本执行,发现机会就立即产出。 
 
## 每次心跳必做(最多3-5项) 
1) 检查是否有新指令/未回复消息(有则优先处理) 
2) 检查是否出现新热点(主赛道优先) 
3) 检查是否有待交付内容(文/图/视频)未完成 
4) 如发现高价值热点,立即输出“快反包”: 
- 3条标题 
- 1条15-45秒视频脚本 
- 1套封面文案建议 
5) 若以上都没有:回复“无待处理事项,本次心跳结束” 
 
## 热点触发阈值(满足任一即触发快反) 
- 热度短时明显上升 
- 行业头部账号集中讨论 
- 与目标赛道高度相关且可快速复刻 
 
## 每日固定产出(建议 09:00 / 14:00 / 20:00) 
- 《热点快报》:3条重点热点 + 传播判断 + 执行动作 
- 《爆款生产包》:文本x1、图片方向x1、视频脚本x1 
 
## 每周固定复盘(建议周五) 
- 本周命中热点TOP5 
- 爆款结构升级建议3条 
- 下周实验方向3条

:::

接下来,直接在跟 OpenClaw 的飞书对话框发这段话:

请在你的 workspace 根目录创建/覆盖这 4 个文件:SOUL.md、AGENTS.md、MEMORY.md、HEARTBEAT.md。 
要求: 
1) 使用 write(不是 edit),保证覆盖旧内容; 
2) 文件内容使用我刚刚给你的四份模板,逐字写入; 
3) 完成后回报: 
- 每个文件路径 
- 文件大小(字节) 
- 每个文件前2行内容(用于我核对)

并在同一个消息中,复制黏贴以上四份 md 文件中的内容,参考:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

3.2 👍 飞书 X OpenClaw 推荐应用场景

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

OpenClaw 将个人从重复性、低价值的劳动中解放出来,通过自然语言指令即可完成日常办公任务,实现真正的远程控制自动化执行

核心功能清单

  • 智能早报生成:自动抓取天气、日历事件、新闻热点和未读邮件摘要,并且通过飞书消息同步给用户
  • 邮件与日程管理:读取收件箱,提取会议/任务信息生成飞书日程,异常邮件实时推送
  • 文件智能整理:按规则扫描本地文件与云文档,自动分类、归档并生成目录索引,还能提供知识问答
  • 跨端远程办公:在手机飞书发送指令,由部署在电脑或服务器的 OpenClaw 执行复杂任务

量化效果数据

  • 时间节省:日均处理邮件超 50 封,日程创建效率提升 80%
  • 错误率降低:文件整理错误率从 17%降至 0%
  • 重复劳动减少:将每日固定流程耗时减少 73%
  • 响应速度:远程任务执行,突破时空限制,指令即结果

4. ⚠️ 常见问题清单

4.1 常见终端指令

指令名称 指令代码 使用说明
启动 AI 网关服务 openclaw gateway run 必用指令,用于运行 openclaw,运行时需保留该终端窗口
彻底停止后台运行的网关进程 openclaw gateway stop
重启网关 openclaw gateway restart 当你修改了配置文件(如开启流式输出)后,必须运行此指令才能生效。
启动交互式安装向导 openclaw configure 用于设置飞书应用的 App ID、Secret 以及选择大模型供应商。
启动可视化界面 openclaw dashboard 这个网页后台比终端(Terminal)直观得多,主要包含以下板块:聊天 (Chat):直接在网页上测试 AI 的回复能力,不需要去飞书发消息。控制 (Control):查看当前的网关实例、活动会话以及资源使用情况。代理与技能 (Agents & Skills):管理 AI 具备的能力(如你关心的天气、文档读取插件等),并可以查看哪些技能已经就绪。配置 (Settings):最实用的部分。你可以通过 UI 界面直接填写 API Key、切换模型供应商。
自动诊断 openclaw doctor 自动诊断脚本,检查系统环境、依赖项和配置是否存在异常
获取运行状态 openclaw health 获取网关和已连接渠道(如飞书)的实时运行状态。
打开插件列表 openclaw plugins list

4.2 OpenClaw 为什么只会回复消息?

OpenClaw 本地要是依赖大模型的能力,想要 OpenClaw 拥有图片生成的能力、视频生成能力,需要你背后对接的大模型支持!

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐