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

开启极简养虾,6步用 TRAE 快速部署 OpenClaw

提示

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

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

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

前言

最近,OpenClaw 的热度一路飙升,这个开源项目凭借强大的能力和不错的应用前景,迅速成了不少开发者和爱好者关注的对象。但在这股热潮背后,一个让人头疼的问题也随之出现——安装和配置太折腾了。

随处可见类似的求助帖:“环境怎么配?”“依赖装不上怎么办?”“报错了该怎么解决?”更夸张的是,甚至还有人上线了所谓的 “OpenClaw 上门安装服务”,收费从几十到几百不等,活生生把安装做成了一门小生意。

同时,让不熟悉的人帮你安装 OpenClaw,也可能存在一些安全风险隐患。

今天官方教你——如何用 TRAE IDE 零成本快速安装你自己的 OpenClaw。

什么是 OpenClaw

OpenClaw 是一款开源、本地优先的 AI 智能体,可在 Mac / Windows / Linux 上运行。

它能理解自然语言指令,自主执行终端命令、操作文件、自动化浏览器、对接 IM 工具,帮用户完成真实任务。主打隐私安全、数据本地存储,支持多平台部署与扩展,是轻量化、可私有化的个人数字助手。

它可以解决以下痛点:

总的来说,OpenClaw 让你可以拥有一个 7*24 小时在线、懂你、能做事、数据私有的 AI 助手。可以是生活助手,也可以是工作助手。

6 步用 TRAE 安装 OpenClaw

本次使用 TRAE IDE 进行演示。

这个操作指南面向 MacOS 新手,安全干净、零冲突、聊天式一键部署,用最优的 Node 虚拟环境 + TRAE 技能化封装,真正做到 “安全、简单、稳定、好用”。

为 OpenClaw 创建隔离的用户账号

macOS 里打开「系统设置」,找到「用户与群组」,点击「添加用户」,创建一个普通用户。

图片展示了MacOS系统设置中“用户与群组”界面。左侧为系统设置菜单栏,选中“用户与群组”。右侧界面显示了管理员、IT管理员和“客人用户”等用户信息,其中“客人用户”被红框突出显示。界面右下角有“添加群组...”和“添加用户...”按钮,其中“添加用户...”按钮被红箭头指向。该图片与上文“在macOS里打开「系统设置」,找到「用户与群组」,点击「添加用户」,创建一个普通用户”的操作步骤相关,直观呈现了操作位置。
img-673 · 图片展示了MacOS系统设置中“用户与群组”界面。左侧为系统设置菜单栏,选中“用户与群组”。右侧界面显示了管理员、IT管
图片展示的是macOS系统中“用户与群组”界面下创建新用户的设置窗口。窗口中“新用户”部分显示“普通”用户类型,有“全名”“账户名称”“密码”“确认密码”等必填项,还设有“密码提示”选项。窗口右上角有红色箭头指向“普通”用户类型处。该图片与上文“为OpenClaw创建隔离的用户账号”内容相关,是创建普通用户操作的界面展示,后续需在此用户账号下进行安装操作。
img-674 · 图片展示的是macOS系统中“用户与群组”界面下创建新用户的设置窗口。窗口中“新用户”部分显示“普通”用户类型,有“全名

创建后切换到这个用户。后续登陆该普通用户,在这个用户账号下进行安装。从而实现数据和访问权限的隔离,确保主账号数据安全。

提示

因为在过往的实践中,AI 可能会“学坏”,所以数据权限隔离很重要。

下载并打开 TRAE 中国版

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

在 TRAE 里安装和执行 OpenClaw 技能

打开 TRAE 中国版,点击左上角按钮,从 IDE 模式切换到 SOLO 模式,然后在 AI 的对话框输入:

图片展示了TRAE中国版界面。左侧为功能导航栏,上方有“IDE”字样,其右侧有“选择项目”下拉菜单,下方有“打开文件夹”“新建项目”等选项。右侧是TRAE主界面,显示“与Builder协作”等内容,下方有“@Builder”聊天窗口。该图片对应文档中“在TRAE里安装和执行OpenClaw技能”步骤,用于说明打开TRAE中国版后,点击左上角按钮,从IDE模式切换到SOLO模式的操作界面情况。
img-676 · 图片展示了TRAE中国版界面。左侧为功能导航栏,上方有“IDE”字样,其右侧有“选择项目”下拉菜单,下方有“打开文件夹”
MARKDOWN
安装这个技能并执行:https://magic-builder.tos-cn-beijing.volces.com/uploads/1772546803743_openclaw_skill.zip

首次使用会提示你选择目录,选择任意一个目录即可。

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

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

图片展示的是TRAE中国版SOLO模式界面,显示了安装OpenClaw技能的步骤。界面左侧有“新任务”“安装并执行技能包”等选项,右侧是AI的对话框。AI正在指导用户下载并解压OpenClaw技能包,接着查看内容,包括运行“unzip -o /tmp/openclaw_skill.zip -d /tmp/openclaw_skill”命令解压文件,以及查看文件夹内容等操作。该图片与上文介绍在TRAE里安装和执行OpenClaw技能的内容相呼应,直观呈现了安装步骤中的操作界面及命令。
img-677 · 图片展示的是TRAE中国版SOLO模式界面,显示了安装OpenClaw技能的步骤。界面左侧有“新任务”“安装并执行技能包
图片展示了TRAE中国版中安装OpenClaw技能的步骤。首先,需安装nvm(Node Version Manager),打开终端运行指定命令并执行;接着激活nvm,同样运行指定命令并执行;最后安装Node.js 22,运行相关命令并执行。图片中“>运行”按钮被黄色箭头突出显示,表明点击该按钮可执行对应操作。此图与上文在TRAE里安装和执行OpenClaw技能的内容紧密相关,直观呈现了安装步骤的操作指引。
img-678 · 图片展示了TRAE中国版中安装OpenClaw技能的步骤。首先,需安装nvm(Node Version Manager)

对接飞书

创建飞书应用

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

界面截图
img-679 · 界面截图
这是创建飞书企业自建应用的页面,对应文档中创建飞书应用的操作环节。页面内有需填写的应用名称、应用描述栏,已填入名称“虾丸”、描述“我的专属助理”;还有应用图标配置区域,支持自定义上传图标,提供了不同颜色的背景色选项,且预设了多款内置图标可供选择,页面右下角设有“取消”和“创建”按钮,用于完成或取消本次应用创建操作,符合文档中创建飞书应用时填写基础信息的内容要求。
img-680 · 这是创建飞书企业自建应用的页面,对应文档中创建飞书应用的操作环节。页面内有需填写的应用名称、应用描述栏,已填入名称“虾丸

记录你创建应用的 App ID App Secret

界面截图
img-681 · 界面截图

接入火山方舟模型

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

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

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

图片展示的是火山引擎在线推理页面。左侧导航栏中“在线推理”被红色箭头指向。右侧显示在线推理相关功能,有“预置推理接入点”和“自定义推理接入点”选项,下方有“创建推理接入点”按钮,旁边有“免费Token”标识。页面还呈现了接入点名称/ID、状态等信息,其中接入点名称/ID部分被蓝色框线突出显示。该图片与文档中“创建飞书应用”步骤相关,用于辅助说明创建飞书应用时获取接入点ID等信息的操作界面。
img-682 · 图片展示的是火山引擎在线推理页面。左侧导航栏中“在线推理”被红色箭头指向。右侧显示在线推理相关功能,有“预置推理接入点”
这张图片展示的是火山引擎平台上创建OpenClaw接入点的操作界面,该界面对应文档中对接飞书相关的步骤。界面中用红色箭头分别指向两个核心操作项,一个是“接入点名称”输入框,另一个是“添加模型”按钮;界面还呈现了接入点描述、推理模式选择、接入模型、接入模式等设置选项,符合文档中提及的接入点创建相关操作场景。
img-683 · 这张图片展示的是火山引擎平台上创建OpenClaw接入点的操作界面,该界面对应文档中对接飞书相关的步骤。界面中用红色箭头
界面截图
img-684 · 界面截图
界面截图
img-685 · 界面截图
图片展示的是火山方舟API Key管理界面。界面上方有“API Key管理”标题及提示信息,说明API Key是请求火山方舟大模型服务的重要凭证,需妥善保管。下方有“创建API Key”按钮,以及“全部”和“我创建的”标签。列表中显示了API Key的名称、状态、权限、所属项目等信息,其中“名称”列有“点击复制”标识,用于复制API Key信息。该图片与文档中“创建飞书应用”步骤相关,用于指导用户复制API Key信息。
img-686 · 图片展示的是火山方舟API Key管理界面。界面上方有“API Key管理”标题及提示信息,说明API Key是请求火山

在 TRAE IDE 执行完毕步骤三之后,把上述信息整理成如下消息指令发给 AI 。

提示

请帮我初始化配置 OpenClaw:

  • 飞书应用的App ID是 「xxx」 ,App Secret是 「xxx」
  • 火山引擎上 doubao 模型的接入点是 「xxx」,API Key 是 「xxx」。

在这个过程中,也需要一些交互式的确认,你可以关注 TRAE 里的提示信息并确认执行完毕。

飞书开放平台配置并发版

至此,OpenClaw服务已经成功运行起来了,接下来我们回到飞书开放平台,来把飞书机器人和OpenClaw服务对接起来。

点击 https://open.feishu.cn/app 飞书开发者后台,找到你的应用,按以下步骤操作:

1⃣ 配置添加“机器人”能力

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

界面截图
img-687 · 界面截图

2⃣ 在“事件与回调”中设置“事件配置”订阅方式为“长连接”,并添加「接收消息」订阅事件。

提示

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

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

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

这张图片展示的是飞书开放平台的应用事件配置页面,左侧为应用功能导航栏,当前选中的是“事件与回调”选项。页面主区域顶部有“事件配置”“回调配置”“加密策略”三个Tab,当前处于“事件配置”页面。该页面的“订阅方式”处标注有箭头,提示此处的编辑操作,页面显示订阅事件可采用长连接接收事件,同时说明配置方式相关内容,还展示了“已添加事件”的区域,整体对应文档中飞书开放平台配置并发版的相关步骤内容,突出了订阅方式设置的操作提示信息。
img-688 · 这张图片展示的是飞书开放平台的应用事件配置页面,左侧为应用功能导航栏,当前选中的是“事件与回调”选项。页面主区域顶部有“
这张图展示的是飞书开放平台的事件配置界面,核心是完成OpenClaw安装步骤里的相关配置。界面的订阅方式显示为“使用长连接接收事件”,这是符合配置要求的订阅设置;配置方式标注无需注册公网域名或配置加密策略,仅需用官方SDK启动长连接飞书客户端,保障连接成功后即可开启对应模式。界面设有“已添加事件”板块,板块上方有一个蓝色的“添加事件”按钮,配有红色箭头专门指向该按钮,明确该按钮是添加操作的入口,与上下文提及的回调配置设置操作相关。
img-689 · 这张图展示的是飞书开放平台的事件配置界面,核心是完成OpenClaw安装步骤里的相关配置。界面的订阅方式显示为“使用长连
界面截图
img-690 · 界面截图

3⃣ 配置右侧的“回调配置” Tab,也设置为长连接,并添加回调“卡片回传交互”。

界面截图
img-691 · 界面截图
界面截图
img-692 · 界面截图

4⃣ 权限管理里,导入如下权限:

删除默认模板上的信息,直接将下方的代码库复制粘贴进去,点击下一步确认新增完毕。

这张图片是飞书开放平台的权限管理页面,对应文档中用TRAE部署OpenClaw的第4步操作场景。页面展示了批量导入权限的弹窗,弹窗内的JSON代码区域被红色箭头标注,提示需全选替换该区域内的内容,右侧还有“恢复默认值”“格式化JSON”的选项,底部有“取消”“下一步,新增权限”的操作按钮,页面左侧的菜单也显示了处于“权限管理”板块中,是该步骤操作的直观展示。
img-693 · 这张图片是飞书开放平台的权限管理页面,对应文档中用TRAE部署OpenClaw的第4步操作场景。页面展示了批量导入权限的
JSON
{
  "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"
    ]
  }
}

5⃣ 创建版本并发布。

这张图片展示了飞书开放平台配置环节的提示信息,内容为橙黄色背景的提示框,带有警示标识,提示文字为“版本发布后,当前修改方可生效”,右侧配有蓝色的“创建版本”按钮。该提示对应文档中安装OpenClaw流程的第5步,用于提醒用户完成权限导入等修改操作后,需先创建版本再发布,才能使修改内容生效,确保后续的配置或功能部署能够正常进行。
img-694 · 这张图片展示了飞书开放平台配置环节的提示信息,内容为橙黄色背景的提示框,带有警示标识,提示文字为“版本发布后,当前修改方

飞书里发消息并配对

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

图片展示的是飞书机器人对话界面,显示OpenClaw未配置访问权限。内容包括飞书用户ID、配对码,以及“请让机器人所有者使用以下指令批准配对”的指令“openclaw pairing approve feishu”。图片与上文“飞书里发消息并配对”内容相关,是配对操作中收到的回复,提示需执行指令以确认当前用户的管理员身份。
img-695 · 图片展示的是飞书机器人对话界面,显示OpenClaw未配置访问权限。内容包括飞书用户ID、配对码,以及“请让机器人所有者

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

MARKDOWN
请执行命令:这里替换为上面的最后一行内容
图片展示的是在SOLO Coder中执行OpenClaw配对指令的操作界面。左侧为任务列表,右侧显示代码编辑区域,有配对指令及代码执行提示。画面右下角有“运行”按钮,被黄色箭头突出显示。该图片与上文“飞书里发消息并配对”内容相关,用于指导用户在SOLO Coder中点击“运行”按钮,执行“openclaw pairing approve feishu”指令,以完成飞书配对操作,最终实现飞书机器人上线。
img-696 · 图片展示的是在SOLO Coder中执行OpenClaw配对指令的操作界面。左侧为任务列表,右侧显示代码编辑区域,有配对

TRAE 执行结束后,回到飞书机器人对话里,再发消息,就会收到类似这样的的回复。恭喜你,你的虾成功上线啦。

该图片展示了飞书机器人的对话回复内容,是TRAE执行对应指令后返回的消息。消息以拟人化的口吻称“刚上线了”,并给出四个需要用户选择的内容选项,分别是机器人的名称、自身的存在设定、风格,以及要选一个喜欢的表情符号作为签名,呼应了文档中“TRAE执行结束后回到飞书机器人对话会收到对应回复”的相关内容。
img-697 · 该图片展示了飞书机器人的对话回复内容,是TRAE执行对应指令后返回的消息。消息以拟人化的口吻称“刚上线了”,并给出四个需
提示

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

例如:

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

如何培养你的「小虾」

完成部署只是开始,持续优化才能让 OpenClaw 真正成为你的得力助手。可以参考以下建议:

OpenClaw 技能推荐

要让 OpenClaw 发挥更大的效力,离不开技能生态的支持,如果将OpenClaw比作是一个智能AI控制系统,那插件就是这个系统中应用软件。我们既可以安装其他人分享一些成熟技能,也可以根据自己的需求,来创建自己专属的自定义技能。

按照本实践指南,我们的「OpenClaw」是运行在本地的。

官方技能仓库

OpenClaw安装完成后,默认已经带了一些常用技能,可在管理后台的Skill菜单下进行查看,你可以在 AI 中输入命令:

PLAIN TEXT
启动openclaw dashboard
界面截图
img-698 · 界面截图

如果想要扩展新的插件可访问官方的 ,根据诉求搜索对应的功能插件,或按照排名下载热门高频插件,到自己的运行环境中。

图片展示的是ClawHub官网界面,其为OpenClaw智能代理的技能仓库。界面顶部有导航栏,可进行技能搜索、上传、导入等操作。中间部分介绍ClawHub是为智能代理设计的技能码头,可上传AgentSkills包、版本化并使其可搜索。下方有“Publish a skill”和“Browse skills”按钮。右侧是技能推荐区域,展示了Trello、Slack、Caldav Calendar、Answer Overflow等技能,每个技能卡片包含名称、描述、作者、评分及下载量等信息。
img-699 · 图片展示的是ClawHub官网界面,其为OpenClaw智能代理的技能仓库。界面顶部有导航栏,可进行技能搜索、上传、导入

开源社区推荐

地址:https://github.com/VoltAgent/awesome-openclaw-skills

这个开源项目按照按照编程、浏览器、自动化、运维、图像生成、PDF、购物、IOT等不同使用场景,推荐了一些不错的技能,同样可按需一键完成插件的下载。更多玩法大家也可以自行深入探索。

界面截图
img-700 · 界面截图

写在最后

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

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

接下来,你可以正式开启养成之旅:根据自己的工作场景和习惯,继续为这只虾补充「技能饲料」、配置专属记忆,让它越来越懂你、帮你自动处理更多重复琐事。

当然你也可以不断尝试新的玩法,观察它在不同任务中的表现,一点点调优、训练,慢慢把这只「Baby 虾」培养成真正贴身的智能小助手!

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