如果你最近在AI圈子里混,大概率已经听说过 OpenClaw 这个名字了——那只红色的龙虾图标,在各种技术群和社交媒体上刷屏的频率越来越高。
先搞清楚 OpenClaw 到底是什么
说白了,OpenClaw 是一款开源的个人 AI 助手,它直接运行在你常用的聊天软件里——不是那种你打开浏览器、登网页才能用的工具。你在飞书发消息,它在飞书回复;你让它帮你整理文件,它就默默去做了。本质上,OpenClaw 不是一个 AI 模型,而是一个「AI 网关」——它负责连接你的聊天软件和 AI 大模型 API,让 AI 能力无缝融入日常沟通工具。 OpenClaw 曾数次更名,最终定名于此。三次改名,这段经历本身就挺戏剧性的。
为什么国内用户首选飞书来接入
很多教程上来就讲 Telegram、Discord,但对大多数国内用户来说,这些软件日常根本用不上。相比于 Telegram 等国外平台,飞书是国内的平台,有中文的界面、文档和客服,更容易上手;目前国内的 OpenClaw 用户,绝大多数都选择了接入飞书,使用人数更多,生态更好。
而且飞书的开放能力真的比较强。官方插件能让你的 OpenClaw 以你的身份调用飞书的各类能力,包括了解群聊和文档中的所有信息、写文档、改文档、帮你发消息、约日程、创建多维表格等。说起来有点玄,但用起来的感觉就是:你说一句话,它真的能直接去飞书里帮你把事情干完。
开始之前,你需要先把 OpenClaw 装好
飞书接入这件事,前提是你本地已经跑起来了 OpenClaw。如果还没装,先把这步搞定。
安装 OpenClaw 需要满足以下环境要求:操作系统推荐 Linux,也支持 macOS / Windows WSL2;Node.js 版本需要 ≥ 22.x;内存建议 4GB,否则需要配置 swap;同时需要能访问 GitHub 和 npm 仓库,国内服务器可能需要代理;另外还需要准备一个 AI 模型的 API Key,通义千问的免费额度比较充足,适合入门。 环境准备好了之后,安装本体很简单,一行命令搞定:
等它跑完,看到那只龙虾的 ASCII 艺术字就说明装好了。如果服务器在国内,安装可能会因为网络问题失败;另外新版脚本对内存要求变高了,2G 内存大概率会 OOM,建议先配置好 swap。不想折腾这些的话,阿里云和腾讯云都有 OpenClaw 的一键部署方案,直接跳过安装这步也行。
飞书那边要先创建一个自建应用
登录飞书开放平台(feishu.cn/open),用企业管理员账号进去,找到「创建企业自建应用」,给它起个名字,随便什么都行,然后在应用能力里找到「机器人」并添加。
应用创建完成后,你需要拿到两个关键信息:App ID 和 App Secret,这两个在「凭证与基础信息」页面里能找到,记下来,后面要填进 OpenClaw 的配置里。
接下来是最容易卡住的一步——权限配置。飞书这边需要你手动开通一批权限,不然机器人收不到消息、也回不了话。在权限管理页面,可以点击批量导入按钮,粘贴 JSON 配置一键导入所需权限。这个 JSON 在 OpenClaw 的官方文档里能找到,复制粘贴就行,省得一个个手动勾。
然后是事件订阅。你需要开启「接收消息」相关的事件,并且填入 OpenClaw 的回调地址。如果你的 OpenClaw 跑在本地电脑而不是公网服务器上,这里就需要用内网穿透工具(比如 frp 或者 ngrok)把本地端口暴露出去,否则飞书那边回调不过来。
回到 OpenClaw 完成配置
飞书那边设置完,回到 OpenClaw 这边,按照官方文档的引导把 App ID 和 App Secret 填入对应配置项,开启飞书渠道后重启网关即可。具体命令格式以你安装版本的官方文档为准,不同版本之间可能略有差异。
关于插件,现在有三种方式可以选
这块稍微复杂一点,因为飞书接入 OpenClaw 的方式在不断迭代,目前飞书接入 OpenClaw 共有三种插件方式:飞书官方插件(由飞书团队开发维护,支持以用户身份操作文档、日历、任务等)、OpenClaw 内置飞书插件(OpenClaw ≥ 2026.2 已内置)、以及早期社区开发的第三方插件(已停止更新,推荐迁移)。
新用户直接用官方插件就行,具体安装命令参考 OpenClaw 官方文档(docs.openclaw.bot)。需要注意的是,两个插件不能同时使用,如果两个都装了,会出现 duplicate plugin id 报错导致飞书功能不可用。遇到这种情况也别慌,删掉重复的插件目录再重启网关就能解决。 验证一下是否跑通了
全部配置完成,回到飞书客户端,找到你刚刚创建的那个机器人,发一句「你好」或者「Hello」——正常回复说明流程跑通了。
如果没有回复,先检查几个常见问题:回调地址有没有填错、飞书应用有没有发布到正确的版本、OpenClaw 的网关是不是还在运行。80% 的卡壳都出在这几个地方。
用起来之前,有个安全问题值得重视
这一点我觉得很多教程都讲得不够:强烈建议现阶段切勿使用公司或企业飞书账号接入,请务必优先使用个人账号进行体验和测试。原因也很直接——这个插件通过飞书接口连接了你的工作数据,包括消息、文档、日历、联系人,AI 能读到的东西理论上就有泄露的可能。
另外,对于涉及发送、修改、写入等重要操作,请务必做到「先预览,再确认」,切勿让 AI 处于完全脱离人工干预的全自动驾驶状态。AI 干活确实很爽,但它代替你发出去的飞书消息,是真的以你的名义发出去的,发完就收不回来了。
整体配置下来大概需要20到30分钟,比接 Telegram 稍微费事一些,但功能上确实比其他平台丰富很多。跑通之后,在飞书里指挥 AI 帮你写文档、查信息、管日程,那种感觉……挺上头的。