TRAE 绿皮书
TRAE Work 实战指南 / 其他

Windows 如何用 TRAE 快速部署 OpenClaw

提示

TRAE 是面向开发者、职场人与学生的 AI 办公平台,有 TRAE Work TRAE IDE 两款产品。

TRAE Work 侧重学习、办公与工程执行场景,无论你是开发者、职场人、学生,都可以用它写方案、做分析、处理文件、推进协作,并完成需要持续执行、检查和产出结果的自动化任务。支持 桌面端网页版移动端,多端协作,随时发起任务、查看进展、持续推进。

TRAE IDE 适合写代码、读项目、改 Bug 等开发工作,更适合期望精细控制自己的代码改动和执行过程的开发者。

作者:张博思

TRAE 开发者用户


我们之前已经教学过大家,如何在 MacOS 上通过 TRAE IDE 便捷部署 OpenClaw。后台也收到了不少小伙伴的私信,希望能出一版 Windows 配置指南——今天它终于来了!

有的小伙伴在成功部署自己的 OpenClaw 之后,又遇到了新的困惑:“为什么我的小龙虾不能帮我创建日程?”“为什么我的小龙虾不能帮我写文档?”这些问题,很可能是因为还没有安装飞书官方插件。本文第二部分会手把手带大家完成飞书官方插件的安装,让你的小龙虾用起来更顺滑、更智能。

提示

当然,现在市面上已经有不少免部署的 OpenClaw 类产品。但通过这篇文章,我们更希望向大家传递一种【AI 帮 AI】的思路:当你未来再遇到一款全新的 AI 产品时,不必干着急从零摸索,而是可以立刻“召唤”身边已有的 AI 工具,反向来帮你搞定它的上手与配置。

6步帮你部署 OpenClaw

本操作指南面向 Windows 新手。

和 MacOS 部署方式只有第一步有区别,其他的步骤都保持一致。

下载并打开 TRAE 中国版

本次演示使用 TRAE IDE

图片展示的是TRAE中国版的登录界面。界面上方显示“登录”标题,下方有“+86 输入手机号”输入框,以及“输入验证码”输入框和“获取验证码”按钮。还有“我已阅读并同意 服务条款 和 隐私协议”的勾选框,以及“登录”“稀土掘金”“企业用户登录”按钮。该图片与文档中“下载后使用手机号注册登录”内容对应,是TRAE中国版下载后注册登录时的界面展示。
img-701 · 图片展示的是TRAE中国版的登录界面。界面上方显示“登录”标题,下方有“+86 输入手机号”输入框,以及“输入验证码”输

(可选)安装WSL为 OpenClaw 创建隔离的环境

官方文档中推荐 Windows 用户在 WSL 中使用 OpenClaw。一方面 WSL 对 OpenClaw 的支持更好,一方面也实现了数据隔离。

官网:https://docs.OpenClaw.ai/install

图片展示的是OpenClaw官网安装页面部分内容。页面左侧有安装概览、安装、安装内部等选项,当前选中“Install”。右侧“System requirements”部分列出系统要求,包括Node 20+、macOS/Linux/Windows等。关键信息是“On Windows, we strongly recommend running OpenClaw under WSL2”,即在Windows上,强烈建议在WSL2下运行OpenClaw。该图片与上下文关系紧密,上下文提到Windows用户在WSL中使用OpenClaw可实现数据隔离,此图进一步说明了官方推荐的运行环境。
img-702 · 图片展示的是OpenClaw官网安装页面部分内容。页面左侧有安装概览、安装、安装内部等选项,当前选中“Install”。

打开 TRAE IDE,在左侧选择远程连接的按钮,点击 WSL 连接目标右侧的”+“号

图片展示了TRAE IDE中远程资源管理器界面。左侧工具栏中“远程资源管理器”图标被红色框突出显示。右侧“WSL连接目标”下显示“Ubuntu 默认 Distro”,右侧有“添加 Distro”按钮。该图片与文档中“打开TRAE IDE,在左侧选择远程连接的按钮,点击WSL连接目标右侧的‘+’号”步骤对应,直观呈现了操作中需点击的“远程资源管理器”图标位置,帮助用户准确找到操作入口。
img-703 · 图片展示了TRAE IDE中远程资源管理器界面。左侧工具栏中“远程资源管理器”图标被红色框突出显示。右侧“WSL连接目标

然后选择 Ubuntu 20.04 版本。

图片展示的是TRAE IDE界面,左侧显示“远程资源管理器”中“WSL连接目标”为“Ubuntu默认Distro”。右侧终端面板中,有“选择WSL Distro进行安装(即将支持更多版本)”的提示,下方列出Ubuntu 24.04 LTS、Ubuntu 20.04 LTS、Ubuntu 22.04 LTS三个版本选项,其中Ubuntu 20.04 LTS被红色框突出显示。该图片与文档中“安装WSL为OpenClaw创建隔离环境”步骤相关,用于指导用户在TRAE IDE中选择WSL版本进行安装操作。
img-704 · 图片展示的是TRAE IDE界面,左侧显示“远程资源管理器”中“WSL连接目标”为“Ubuntu默认Distro”。右侧
提示

终端 面板中提示你创建帐号和密码,根据指引创建即可,然后直接等待安装完成。

安装完成后会显示在 WSL 连接目标 。点击右侧的”在当前窗口连接“按钮

图片展示了TRAE IDE中远程资源管理器的界面。在“WSL连接目标”下拉菜单中,选中“Ubuntu 默认 Distro”,右侧有三个图标,其中右侧的图标被红色箭头指向。点击该图标后,会弹出“在当前窗口连接”按钮。该图片与上文“安装完成后会显示在WSL连接目标。点击右侧的‘在当前窗口连接’按钮”内容对应,直观呈现了点击“在当前窗口连接”按钮的操作位置。
img-705 · 图片展示了TRAE IDE中远程资源管理器的界面。在“WSL连接目标”下拉菜单中,选中“Ubuntu 默认 Distro

连接成功后选择新建项目,给项目取个名称。这里我们取名叫 Claw。

图片展示了在TRAE中国版中新建项目的界面。左侧为TRAE界面,显示“资源管理器”等选项。右侧弹出“新建项目”窗口,路径为“/home/frank/Documents/trae_projects”,项目名称框内输入“claw”,下方有“打开文件夹”“新建项目”“克隆Git仓库”“连接远程主机”“新建文件”等选项,其中“新建项目”被红色框突出显示。该图片与上文在TRAE里安装OpenClaw的内容相关,用于指导用户在TRAE中新建项目操作。
img-706 · 图片展示了在TRAE中国版中新建项目的界面。左侧为TRAE界面,显示“资源管理器”等选项。右侧弹出“新建项目”窗口,路径

在 TRAE 里安装 OpenClaw

打开 TRAE 中国版,点击左上角按钮,在 AI 的对话框输入:

MARKDOWN代码块
https://docs.OpenClaw.ai/install 这是OpenClaw的官方文档,帮我根据该文档指引在本地安装OpenClaw
图片展示了在TRAE中国版中安装OpenClaw的界面。左侧为TRAE界面,显示“资源管理器”等选项。右侧是AI对话框,输入了“在TRAE里安装OpenClaw”后,AI给出安装步骤,包括安装安全验证命令等,还提供了OpenClaw官方文档链接。下方有“Builder with MCP”和“与AI对话”两个区域,其中“Builder with MCP”区域显示安装进度,如“已下载”“已安装”等状态。该图片与上下文紧密相关,直观呈现了在TRAE里安装OpenClaw的操作界面及AI给出的安装步骤。
img-707 · 图片展示了在TRAE中国版中安装OpenClaw的界面。左侧为TRAE界面,显示“资源管理器”等选项。右侧是AI对话框,

这里的安装需要几分钟的时间,在这段时间里,你只需要一直确认并运行 TRAE 提供的命令。如果在点击运行的过程中途有报错的情况,可以直接将报错发给 AI ,让 AI 帮你修复。

中途有部分命令需要手工确认,手动点一下运行即可

图片展示的是在TRAE中安装OpenClaw的界面。上方显示“openclaw status”命令,提示需调试时可使用“openclaw logs --follow”和“openclaw gateway probe”。下方有“openclaw dashboard --help”命令,列出相关帮助信息。关键部分是“openclaw dashboard --no-open”命令执行结果,显示沙箱运行(支持白名单),并有“跳过”“添加‘openclaw’到白名单”选项,红色框突出显示“运行”按钮。该图片与上下文介绍的在TRAE里安装OpenClaw步骤相关,用于指导用户在TRAE中运行相关命令。
img-708 · 图片展示的是在TRAE中安装OpenClaw的界面。上方显示“openclaw status”命令,提示需调试时可使用“

在等待TRAE执行的间隙,可以同时执行下一个步骤。

对接飞书

创建飞书应用

访问飞书开发者后台 https://open.feishu.cn/app,创建企业自建应用

这张图片展示的是飞书开放平台的页面,用于指导创建对接OpenClaw所需的飞书应用。页面顶部有“飞书开放平台”的标识及相关功能选项栏,核心区域设有“企业自建应用”标签,下方有两个分类项,其中“创建企业自建应用”按钮被红色框标注,是部署流程里创建飞书应用的关键操作入口,页面还展示了当前已有的应用信息,包括应用所有者、角色、状态及最新动态,旁边配有相关提示说明应用使用的注意事项。
img-709 · 这张图片展示的是飞书开放平台的页面,用于指导创建对接OpenClaw所需的飞书应用。页面顶部有“飞书开放平台”的标识及相

获取你创建的应用的 App IDApp Secret ,注意保密

界面截图
img-710 · 界面截图

登录 https://open.feishu.cn/app 飞书开放平台创建一个应用,点击创建「企业自建应用」,非「商店应用」,填写应用的基础信息。

图片展示的是飞书开放平台的界面。界面上方有“客户案例”“应用中心”“开发文档”“智能助手”等导航栏。中间部分有“平台公告”“企业自建应用”“商店应用”等选项,其中“企业自建应用”被黄色框突出显示。下方有一个蓝色的“创建企业自建应用”按钮。该图片与文档中“登录https://open.feishu.cn/app飞书开放平台创建一个应用,点击创建「企业自建应用」,非「商店应用」,填写应用的基础信息”的内容相关,直观呈现了创建企业自建应用的操作入口。
img-711 · 图片展示的是飞书开放平台的界面。界面上方有“客户案例”“应用中心”“开发文档”“智能助手”等导航栏。中间部分有“平台公告
图片展示了飞书开放平台创建企业自建应用的界面。应用名称为“虾丸”,应用描述为“我的专属助理”,并有选择应用图标和背景色的选项,可自定义上传图标,背景色有多种颜色可选。右下角有“取消”和“创建”按钮。该图片与文档中“登录https://open.feishu.cn/app飞书开放平台创建一个应用,点击创建「企业自建应用」,非「商店应用」,填写应用的基础信息”的内容对应,是创建企业自建应用操作步骤中的界面展示。
img-712 · 图片展示了飞书开放平台创建企业自建应用的界面。应用名称为“虾丸”,应用描述为“我的专属助理”,并有选择应用图标和背景色的

记录你创建应用的 App ID App Secret 待会需要用。

图片展示的是飞书开放平台的“凭证与基础信息”页面。页面上方有“飞书开放平台”“客户案例”“应用中心”等导航栏。下方“应用凭证”区域显示了App ID和App Secret,其中App ID为“cli_...”,App Secret为一系列星号。页面右下角有“复制”和“复制”按钮。该图片与文档中“创建飞书应用”部分相关,记录了创建应用时获取的App ID和App Secret,待后续接入火山方舟模型时使用。
img-713 · 图片展示的是飞书开放平台的“凭证与基础信息”页面。页面上方有“飞书开放平台”“客户案例”“应用中心”等导航栏。下方“应用

接入火山方舟模型

接下来我们需要配置大模型,后续你和机器人的每一句对话,都会先走大模型进行思考和意图识别,然后转化为各种操作和决策,最后把结果返回给你。

你可以登录火山方舟平台 https://console.volcengine.com/ark/region:ark+cn-beijing/endpoint?config=%7B%7D 。

点击「在线推理」—>「创建在线推理」—>「自定义推理接入点」。

这张图片展示的是火山引擎平台的页面,用户进入了左侧导航栏的“在线推理”板块,页面右上方标注了当前区域为华北2(北京)。页面中间偏上的“自定义推理接入点”标签处于选中状态,用户可点击带有“免费Token”标识的“创建推理接入点”按钮生成接入点,页面下方还显示有已创建、状态为健康的接入点,该内容对应文档中创建推理接入点的操作指引,帮助用户明确接入点的创建入口位置。
img-714 · 这张图片展示的是火山引擎平台的页面,用户进入了左侧导航栏的“在线推理”板块,页面右上方标注了当前区域为华北2(北京)。页
这是火山引擎平台接入点创建页面,页面左上角是区域选择、账号相关功能栏,左侧为功能导航栏,右侧是页面介绍区域。页面核心区域的接入点名称输入框中已有占位内容,有红色箭头指向该输入框,提示此处需填写接入点信息;“推理模式”区域选中“指定单一模型”选项,“接入模型”板块中有“添加模型”按钮,也有红色箭头指向该按钮,页面下方还提供了按Token付费、TPM保额度等多种接入模式选项。该页面是对接飞书创建飞书应用流程的一部分,用于完成OpenClaw部署过程中接入点及相关配置的创建操作。
img-715 · 这是火山引擎平台接入点创建页面,页面左上角是区域选择、账号相关功能栏,左侧为功能导航栏,右侧是页面介绍区域。页面核心区域
图片展示的是TRAE中选择模型的界面。界面上方有模型名称、模型描述、模型版本等信息,如Doubo - Seedream 2.0 - mini模型可免费使用50万tokens推理额度。下方有字节跳动、深视求索、智臻AI等模型类别,可选择不同模型。右侧有版本列表,选中的是260215版本,其描述为面向对话的、高成本与低成本模型兼顾、强逻辑快速响应与泛化推理部署、支持四轮定位考与答。该界面与文档中TRAE部署OpenClaw步骤3中选择模型的内容相关。
img-716 · 图片展示的是TRAE中选择模型的界面。界面上方有模型名称、模型描述、模型版本等信息,如Doubo - Seedream
图片展示的是火山引擎方舟平台的API接入页面。页面左侧有导航栏,选中“在线推理”下的“API接入”。右侧上方显示接入点ID为“ep - 20260303191131 - zhm5x”。下方有“通过API Key授权”说明,以及“具体接入流程”步骤,其中第1步为选择API Key,需按指定方式设置API Key作为环境变量。该图片与文档中创建飞书应用后获取接入点ID及API Key的内容相关,直观呈现了获取信息的平台界面。
img-717 · 图片展示的是火山引擎方舟平台的API接入页面。页面左侧有导航栏,选中“在线推理”下的“API接入”。右侧上方显示接入点I
图片展示的是火山引擎API Key管理界面。界面上方有“API Key管理”标题及提示信息,说明API Key是请求火山方舟大模型服务的重要凭证,需妥善保管。下方有“创建API Key”按钮,以及“全部”和“我创建的”标签。表格中显示了API Key的名称、状态、权限、所属项目等信息,其中“名称”列下有“点击复制”图标,用于复制API Key。该图片与文档中“在TRAE中步骤3执行完成后,把上述信息填充到下方文案中发给AI”的内容相关,用于指导用户找到并复制API Key。
img-718 · 图片展示的是火山引擎API Key管理界面。界面上方有“API Key管理”标题及提示信息,说明API Key是请求火山

在 TRAE 中步骤3执行完成后,把上述信息填充到下方文案中发给 AI 。其中需要替换几个内容:

PLAIN TEXT代码块
请帮我初始化配置 OpenClaw:
飞书应用的App ID是 「xxx」 ,App Secret是 「xxx」
火山引擎上 doubao 模型的接入点是 「xxx」,API Key 是 「xxx」。
图片展示的是在TRAE中与AI交互的界面。上方显示“Master-Frank”头像及“请帮我初始化配置OpenClaw: 飞书应用的App ID是...,App Secret是... 火山引擎上doubao模型的接入点是...,API Key是...”,下方有“Builder with MCP”标识。该图片与文档中“在TRAE中步骤3执行完成后,把上述信息填充到下方文案中发给AI”的内容相关,用于说明在TRAE中向AI发送配置OpenClaw所需信息的操作场景。
img-719 · 图片展示的是在TRAE中与AI交互的界面。上方显示“Master-Frank”头像及“请帮我初始化配置OpenClaw:

在这个过程中,也有部分命令需要手工确认。你可以关注 TRAE 里的提示信息并确认执行完毕。

飞书开放平台配置并发版

接下来回到飞书开放平台 https://open.feishu.cn/app,把飞书机器人和OpenClaw服务对接起来。

添加机器人的应用能力

找到「应用能力」—>「添加应用能力」—>「按能力添加」—>选择【机器人】能力点击配置

界面截图
img-720 · 界面截图

在权限管理导入权限

找到「开发配置」—>「权限管理」,点击「批量导入/导出权限」

界面截图
img-721 · 界面截图

删除默认信息,粘贴下面内容到输入框,然后确认权限开通。

PLAIN TEXT
{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "im:chat:read",
      "im:chat:update",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "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"
    ],
    "user": [
      "contact:user.employee_id:readonly"
    ]
  }
}
界面截图
img-722 · 界面截图

配置事件与回调

图片展示的是飞书开放平台的事件回调配置界面。左侧为导航栏,选中“事件回调”。右侧上方有“当前修改均已发布”提示。事件配置部分,订阅方式为“使用长连接接收事件”,并有“了解更多”链接。配置方式说明无需注册公网域名或配置加密策略,仅需使用官方SDK启动长连接飞书客户端,并确保连接成功后,即可开启读模式。下方显示已添加事件,但无具体事件名称。该图与文档中“创建版本并发布”步骤相关,用于配置事件回调。
img-723 · 图片展示的是飞书开放平台的事件回调配置界面。左侧为导航栏,选中“事件回调”。右侧上方有“当前修改均已发布”提示。事件配置
提示

如果遇到报错“未检测到应用连接信息”报错,请回到TRAE,检查确认第四个步骤是否执行成功。

如果一直提示,可以直接把这段话发给 TRAE AI,让它帮你修复:

「为什么飞书创建事件回调的时候一直提示:未检测到应用连接信息,请确保长连接建立成功后再保存配置」

图片展示的是飞书开放平台的事件配置界面。左侧导航栏选中“事件与通知”选项。右侧“已添加事件”区域显示了“机器人进群”和“消息已读”两个事件,其订阅方式均为长连接,对应应用身份为“应用身份”,操作栏有“删除事件”按钮。该图片与文档中“添加「机器人进群」「机器人被移出群」「消息已读」「接收消息」这几个事件”及“切换到回调配置Tab,同样订阅方式设置为长连接”等内容相关,是配置事件时的参考界面。
img-724 · 图片展示的是飞书开放平台的事件配置界面。左侧导航栏选中“事件与通知”选项。右侧“已添加事件”区域显示了“机器人进群”和“

切换到回调配置Tab,同样订阅方式设置为长连接

界面截图
img-725 · 界面截图

添加回调选择「卡片回传交互」

这是飞书开放平台的「回调配置」页面,用于配置飞书的事件回调相关内容,页面当前选中的是「事件配置」栏下的「回调配置」标签页,其中标注了回调配置的相关说明,展示了订阅方式支持选择HTTP、私有回呼、推送等,配置方式为通过服务端完成配置后可开启回调模式。页面右侧有一个被红框突出标注的「添加回调」按钮,是操作的关键入口,该页面对应文档中飞书开放平台配置流程里,完成事件添加后切换到回调配置Tab进行设置的步骤。
img-726 · 这是飞书开放平台的「回调配置」页面,用于配置飞书的事件回调相关内容,页面当前选中的是「事件配置」栏下的「回调配置」标签页
图片展示的是飞书开放平台配置并发版中添加回调的界面。在“卡片”选项卡下,有“卡片回传交互”和“消息卡片回传交互”两个选项,其中“卡片回传交互”被勾选。该图片与上文“切换到回调配置Tab,同样订阅方式设置为长连接,添加回调选择‘卡片回传交互’”的内容对应,直观呈现了添加回调选择“卡片回传交互”的操作界面,帮助用户明确操作步骤。
img-727 · 图片展示的是飞书开放平台配置并发版中添加回调的界面。在“卡片”选项卡下,有“卡片回传交互”和“消息卡片回传交互”两个选项

创建版本并发布

点击页面上方的toast中的「创建版本」并发布。

这张图片展示了操作提示栏,内容为提示“版本发布后,当前修改方可生效”,同时配有“创建版本”的操作选项按钮,对应文档中“创建版本并发布”的步骤,指引用户在完成相关配置后,点击“创建版本”进行后续的发布操作,确保修改内容生效。
img-728 · 这张图片展示了操作提示栏,内容为提示“版本发布后,当前修改方可生效”,同时配有“创建版本”的操作选项按钮,对应文档中“创

飞书里发消息并配对

打开你的飞书,搜索机器人并发送任意消息(比如 你好 ),会收到类似这样的消息。收到这个消息说明飞书的消息已经成功被 OpenClaw 接收到了。当前需要执行一下配对操作,以确认当前用户的管理员身份。

复制这段消息的最后一行。

图片展示了飞书机器人与OpenClaw的对话界面。机器人发送消息“你好”,OpenClaw回复“访问未配置。Your Feishu user id: ou_... 配对码: M8H22V34 请让机器人所有者执行以下命令批准: openclaw-cn pairing approve feishu”。其中,配对码和执行命令部分被红色框突出显示。该图片与上文提到的在飞书里发消息并配对的操作相关,是配对操作中收到的回复信息,需将执行命令复制并添加“执行命令”指令发给TRAE以完成配对。
img-729 · 图片展示了飞书机器人与OpenClaw的对话界面。机器人发送消息“你好”,OpenClaw回复“访问未配置。Your F

复制最后一行内容,添加“执行命令”指令,发给 TRAE:

MARKDOWN
请执行命令:「刚刚复制的这一行」
界面截图
img-730 · 界面截图

TRAE 执行完成后,回到飞书的机器人对话里,再次发消息,就会收到类似这样的的回复。恭喜你,你的虾成功上线啦。给你的龙虾取个好听的名字吧~

图片展示的是飞书机器人对话界面。左侧为用户“小田”,右侧为机器人“小田 小田 机器人”。对话中,小田先打招呼,机器人回应很高兴认识小田,询问其想叫什么名字及自己叫什么。小田回复自己叫小田,机器人则称自己叫博士哥,表示很高兴认识小田,询问有什么可以帮助的。此图与文档中介绍TRAE快速部署OpenClaw流程相关,展示了与TRAE机器人交流的场景。
img-731 · 图片展示的是飞书机器人对话界面。左侧为用户“小田”,右侧为机器人“小田 小田 机器人”。对话中,小田先打招呼,机器人回应
提示

小 Tips:如果你在执行过程中遇到任何问题,都可以直接复制发给 TRAE AI,它会帮你解决。

例如:

  • 执行过程中的报错,你可以直接复制点击“添加到对话”
  • 飞书无法配置订阅方式,直接把飞书的提示复制给到 TRAE AI,让它帮你分析解决

延伸学习:安装飞书官方插件,解锁更多功能

飞书官方插件,能以用户身份读写消息、文档等,支持更多功能,体验更丝滑。以下为OpenClaw内置飞书功能和飞书官方插件的对比,供参考,可以看出来,如果你期望在飞书上“养虾”,飞书的官方插件更完整和系统。

图片为OpenClaw内置飞书与飞书官方插件对比表。对比内容涵盖维护方、形态、安装心智、上手难度、官方背书、Feishu原生对象能力、消息能力、流式回复、交互卡片、文档/表格/日历/任务、配置对授权引导、配置模型、群策略/权限策略、运维工具、诊断能力、扩展性、网络/企业环境适配、升级路径、风险、最适合谁等维度。该表直观呈现了两者在各方面的差异,为安装飞书官方插件提供参考。
img-732 · 图片为OpenClaw内置飞书与飞书官方插件对比表。对比内容涵盖维护方、形态、安装心智、上手难度、官方背书、Feishu

接下来为大家介绍怎么安装和使用飞书官方插件。

安装飞书官方插件

首先在终端执行下面命令,你可以直接在 AI 对话框发出以下对话:

PLAIN TEXT
请在终端执行:npx -y https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/879b06f872058309ef70f49bcd38a71f_Pr8pNIJ9J9.tgz install
界面截图
img-733 · 界面截图

这里在运行中会有2个选项让你选择,分别是「新增机器人」和「使用已有机器人」,你可以使用键盘上下选择,按「回车」确认。

这里需要选择使用现有机器人」。

图片展示的是Windows PowerShell窗口,显示了OpenClaw插件安装相关命令及结果。其中,`npm install`命令执行后,`plugins`部分列出多个飞书插件,如`feishu_bitable_app_table_record`等。在`Configuring channel`步骤后,提示“? What would you like to do do?”,下方有“使用新机器人”和“使用已有机器人”两个选项,当前选中的是“使用已有机器人”。该图片与文档中安装飞书官方插件的后续配置步骤相关,用于说明配置时的机器人选择操作。
img-734 · 图片展示的是Windows PowerShell窗口,显示了OpenClaw插件安装相关命令及结果。其中,`npm in

根据指引完成后续配置。

验证插件是否启用

在 AI 中运行下面命令:

PLAIN TEXT代码块
请帮我打开:OpenClaw plugins list

我们可以看到 ID 为「feishu-OpenClaw-plugin的 Status 为 loaded ,如何 ID 为 feishu 的 Status 为 disabled 则表示已成功启用飞书官方插件。

图片展示了飞书插件OpenClaw的运行状态。左侧显示“Feishu”标识,中间部分以红色框突出显示“feishu-openclaw -plugin”字样,右侧绿色框内显示“loaded”。该图片与文档中安装飞书官方插件的内容相关,用于直观呈现插件安装成功后的运行状态,帮助用户确认插件是否已正常加载。
img-735 · 图片展示了飞书插件OpenClaw的运行状态。左侧显示“Feishu”标识,中间部分以红色框突出显示“feishu-op

运行下面命令重新启动OpenClaw

PLAIN TEXT代码块
OpenClaw gateway run

然后在飞书与AI 的对话中发送:/feishu start;如果返回了版本号信息,则代表安装成功

如果显示:

图片展示了在飞书与AI对话中发送“/feishu start”命令后的回复界面。上方显示用户发送“/feishu start”,下方回复显示“飞书 OpenClaw 插件已启动 v2026.3.8(存在警告)”,并提示“工具 Profile 当前为 coding,飞书工具可能无法加载。请检查配置是否正确。”该图片与文档中“安装飞书官方插件,解锁更多功能”部分相关,用于说明在飞书与AI对话中发送指定命令后,飞书OpenClaw插件启动及可能存在的警告情况。
img-736 · 图片展示了在飞书与AI对话中发送“/feishu start”命令后的回复界面。上方显示用户发送“/feishu sta

继续在终端运行

PLAIN TEXT代码块
OpenClaw config set tools.profile full
OpenClaw gateway run

运行完成就恢复正常啦

图片展示了在飞书与AI对话中发送“/feishu start”命令后的回复。左侧显示用户发送“/feishu start”,右侧回复显示“飞书 OpenClaw 插件已启动 v2026.3.8”,并有绿色对勾标识。该图片与文档中“安装飞书官方插件,解锁更多功能”部分相关,用于说明在飞书与AI对话中发送指定命令后,飞书OpenClaw插件成功启动,代表安装成功。
img-737 · 图片展示了在飞书与AI对话中发送“/feishu start”命令后的回复。左侧显示用户发送“/feishu start

学习飞书官方插件的能力

为了让你的“小龙虾”能学会这些新技能并正确使用,请和龙虾说“学习一下我安装的新飞书插件,列出有哪些能力”

这是飞书平台的对话界面,由名为“小田”的机器人展示。用户向“小龙虾”(OpenClaw)发送指令“学习一下我安装的新飞书插件,列出有哪些能力”后,机器人反馈插件包含4项核心能力,分别是文档工具feishu-doc、云空间工具feishu-drive、权限管理工具feishu-perm以及知识库工具feishu-wiki,并逐一列明各项功能,界面右上角还显示对话的时间戳为01:58,整体内容对应安装飞书官方插件后获取功能列表的操作场景。
img-738 · 这是飞书平台的对话界面,由名为“小田”的机器人展示。用户向“小龙虾”(OpenClaw)发送指令“学习一下我安装的新飞书

完成功能授权

直接和龙虾说”授权所有用户权限“,会给出一个授权卡片,点击卡片完成授权

界面截图
img-739 · 界面截图

配置流式输出

如果你期望和 TRAE 中与 AI 对话一样,实时得到AI的输出,你可以运行下面的命令切换到流式输出

PLAIN TEXT代码块
OpenClaw config set channels.feishu.streaming true
这张图片展示了在Windows命令行中执行配置OpenClaw相关操作的过程,核心是红框标注的命令“openclaw config set channels.feishu.streaming true”,该命令用于设置飞书渠道的流式输出,以实现和TRAE中AI对话类似的实时输出效果。命令执行后提示“Updated channels.feishu.streaming. Restart the gateway to apply.”,说明修改已完成,只需重启网关即可生效。后续命令界面还显示了多个工具注册信息,包括飞书相关的用户、日历、会议等工具,这些内容对应文档中关于飞书官方插件可读写飞书文档的描述,为功能实现提供了技术支撑。
img-740 · 这张图片展示了在Windows命令行中执行配置OpenClaw相关操作的过程,核心是红框标注的命令“openclaw c

配置完成后,你的“小龙虾”回复的内容就会在飞书上实时输出啦

图片展示了TRAE与飞书官方插件“小龙虾”在飞书中的对话界面。用户询问“vibe coding知识库里有什么文档”,“小龙虾”回复称知识库有8个文档,包括首页、Trae Guangzhou Meetup等,类型均为docx。图片中“想看...”处被红色框突出显示,表明有更多文档内容未展示,需点击“...”查看全部。该图片与上下文紧密相关,直观呈现了TRAE配置完成后,飞书官方插件“小龙虾”读取飞书文档的功能效果。
img-741 · 图片展示了TRAE与飞书官方插件“小龙虾”在飞书中的对话界面。用户询问“vibe coding知识库里有什么文档”,“小

读取和编辑飞书文档

有没有发现,上一张图中我们让“小龙虾”读取了账号下的飞书文档?

飞书官方插件支持读写飞书文档,所以后续需要写文档可以交给龙虾啦!直接告诉龙虾需要写的文档内容即可。

图片展示的是飞书聊天界面,用户“小龙虾”回复了“在云空间新增一篇飞书文档,内容是介绍安装的飞书插件的功能和使用方法”的消息。回复内容显示文档已创建成功,标题为“飞书 OpenClaw 插件功能介绍”,并列出了文档包含的内容,如日历与日程管理、任务管理等。该图片与上文提到的“小龙虾”读取飞书文档及后续写文档交给“小龙虾”等内容相关,直观呈现了文档创建后的效果。
img-742 · 图片展示的是飞书聊天界面,用户“小龙虾”回复了“在云空间新增一篇飞书文档,内容是介绍安装的飞书插件的功能和使用方法”的消

这是“小龙虾”写的文档的效果,是不是感觉内容清晰排版自然?节省了梳理排版的时间!

图片展示的是飞书OpenClaw插件功能介绍文档页面。左侧为文档目录,包含日历与日程管理、任务管理、会议管理、云文档管理、云文档文件管理、飞书应用管理、飞书应用插件、飞书应用插件管理、飞书应用插件使用、飞书应用插件使用示例、飞书应用插件使用示例(Sheet)、飞书应用插件使用示例(飞书)。右侧是文档内容,介绍飞书OpenClaw插件功能,如日历与日程管理、任务管理等,还给出使用示例,如创建日程、添加任务等。该图片与上文介绍飞书官方插件支持读写飞书文档,后续可让“小龙虾”写文档的内容相关,直观呈现了文档效果。
img-743 · 图片展示的是飞书OpenClaw插件功能介绍文档页面。左侧为文档目录,包含日历与日程管理、任务管理、会议管理、云文档管理

写在最后

大家现在有没有跟随着官方的安装步骤在 TRAE IDE 的帮助下 Windows 成功领养了自己的第一只「Baby 虾」呢?

如果以后遇到什么困难 ,可以灵活询问 TRAE IDE,说不定就可以帮助你快速解决哦!AI Helps AI !

龙虾的上限很高,通过Skills和插件可以实现丰富的功能和玩法,接下来就交给你和你的虾一起去探索啦!别忘了注意你的数据安全哦!

如果你成功根据本教程领养了自己的第一只「虾」,欢迎在留言区晒图!