OpenClaw集成Trae的配置和使用指南
OpenClaw + Trae 集成配置指南
本文檔詳細(xì)說明如何在 OpenClaw 中配置和使用 Trae IDE 自動(dòng)化功能
概述
什么是 Trae?
Trae 是由字節(jié)跳動(dòng)推出的“AI 原生”集成開發(fā)環(huán)境(IDE),定位是一名“真正的 AI 工程師”。它致力于深度融入軟件開發(fā)的整個(gè)生命周期,而不僅僅是作為一個(gè)輔助工具,旨在通過 AI 提升從項(xiàng)目構(gòu)思到部署上線的全流程效率。
什么是 TraeClaw?
TraeClaw 是 OpenClaw 的插件,作為 OpenClaw 和 Trae 之間的橋接層,讓 OpenClaw 能夠通過 CDP 協(xié)議控制 Trae 執(zhí)行開發(fā)任務(wù)。
核心特點(diǎn)
- AI 原生:Trae 從底層就將 AI 能力與開發(fā)流程深度融合,與在傳統(tǒng) IDE 上添加 AI 插件的模式不同。
- 模型集成:Trae 根據(jù)不同市場(chǎng)集成了強(qiáng)大的大語言模型。
- 國際版(
trae.ai)集成了 Claude 3.5/3.7 Sonnet、GPT-4o 等模型。 - 國內(nèi)版(
trae.com.cn)集成了 豆包 (Doubao-1.5-pro)、DeepSeek R1/V3 等模型。
- 國際版(
- 雙重協(xié)作模式:Trae 提供兩種工作模式,允許開發(fā)者根據(jù)場(chǎng)景自由切換。
- IDE 模式:保持傳統(tǒng)集成開發(fā)環(huán)境的工作流,提供 AI 智能問答、代碼自動(dòng)補(bǔ)全等輔助功能-。
- SOLO 模式:以 AI 為主導(dǎo),它能理解項(xiàng)目目標(biāo)、自主規(guī)劃任務(wù)并調(diào)度工具,獨(dú)立推進(jìn)開發(fā)工作,實(shí)現(xiàn)從自然語言描述到可執(zhí)行產(chǎn)出的全流程。
- 開放智能體生態(tài):Trae 支持創(chuàng)建和分享自定義 AI 智能體。你可以像管理團(tuán)隊(duì)一樣,為不同的任務(wù)部署專屬的智能體協(xié)同工作。
工作原理
用戶請(qǐng)求 -> OpenClaw -> TraeClaw Plugin -> TraeClaw Gateway -> Trae IDE -> 執(zhí)行任務(wù) -> 返回結(jié)果
環(huán)境要求
| 項(xiàng)目 | 要求 |
|---|---|
| 操作系統(tǒng) | macOS 10.15+ / Windows 10+ |
| Trae 版本 | Trae CN(中文版) |
| Node.js | v18+ |
| OpenClaw | 最新版 |
| 端口 | 8787(Gateway) |
安裝步驟
Step 1: 安裝 Trae CN
- 訪問 Trae 官網(wǎng)下載:https://www.trae.cn
- 安裝到
/Applications/Trae CN.app
Step 2: 安裝 TraeClaw 插件
# 全局安裝 traeclaw npm 包 npm install -g traeclaw # 或使用 OpenClaw CLI 安裝 openclaw plugins install traeclaw
Step 3: 啟用插件
# 啟用 trae-ide 插件 openclaw plugins enable trae-ide # 驗(yàn)證插件狀態(tài) openclaw plugins list | grep -i trae
預(yù)期輸出:
│ TraeClaw │ trae-ide │ openclaw │ loaded │ ... │ 0.3.0 │
配置模式
提供兩種配置模式,根據(jù)你的使用場(chǎng)景選擇。
模式對(duì)比
| 特性 | 隔離模式 | 非隔離模式 |
|---|---|---|
| 配置復(fù)雜度 | 較高 | 低 |
| 用戶數(shù)據(jù)目錄 | ~/.traeclaw-isolated-profile | ~/Library/Application Support/Trae CN |
| 調(diào)試端口 | 9333 | 9222 |
| 獨(dú)立實(shí)例 | 是 | 否 |
| 推薦場(chǎng)景 | 自動(dòng)化測(cè)試、批量任務(wù) | 日常開發(fā)、簡(jiǎn)單集成 |
| 登錄狀態(tài) | 需要重新登錄 | 復(fù)用現(xiàn)有登錄 |
| 資源占用 | 較高(獨(dú)立進(jìn)程) | 較低(復(fù)用進(jìn)程) |
方式一:隔離模式配置
隔離模式創(chuàng)建獨(dú)立的 Trae 實(shí)例,不影響正在使用的 Trae 窗口。推薦用于自動(dòng)化測(cè)試和批量任務(wù)。
Step 4.1: 創(chuàng)建配置文件
# 定位 TraeClaw 配置目錄 TRAECLAW_DIR="$(npm root -g)/traeclaw/runtime/traeapi" # 創(chuàng)建隔離配置目錄 mkdir -p ~/.traeclaw-isolated-profile # 創(chuàng)建配置文件 cat > "$TRAECLAW_DIR/.env" << 'EOF' # Trae 應(yīng)用路徑 TRAE_BIN=/Applications/Trae CN.app # 調(diào)試端口配置 TRAE_REMOTE_DEBUGGING_PORT=9333 # 隔離模式配置(關(guān)鍵?。? TRAE_QUICKSTART_USE_ISOLATED_PROFILE=1 TRAE_QUICKSTART_USER_DATA_DIR=/Users/你的用戶名/.traeclaw-isolated-profile TRAE_QUICKSTART_REMOTE_DEBUGGING_PORT=9333 TRAE_QUICKSTART_OPEN_CHAT=1 # CDP 目標(biāo)匹配 TRAE_CDP_TARGET_TITLE_CONTAINS= TRAE_CDP_TARGET_URL_CONTAINS=trae # Gateway 配置 HOST=127.0.0.1 PORT=8787 EOF
Step 5.1: 啟動(dòng)服務(wù)(隔離模式)
# 步驟 1: 創(chuàng)建必要目錄 mkdir -p ~/.traeclaw-isolated-profile mkdir -p "$(npm root -g)/traeclaw/runtime/traeapi/.runtime/trae-project" # 步驟 2: 啟動(dòng) Trae(使用隔離配置) /Applications/Trae\ CN.app/Contents/MacOS/Electron \ --user-data-dir=~/.traeclaw-isolated-profile \ --remote-debugging-port=9333 \ "$(npm root -g)/traeclaw/runtime/traeapi/.runtime/trae-project" & # 步驟 3: 等待 Trae 啟動(dòng)(約 20 秒) sleep 20 # 步驟 4: 驗(yàn)證 Trae 已啟動(dòng) lsof -i :9333 # 應(yīng)顯示 Electron 在監(jiān)聽端口 9333 # 步驟 5: 啟動(dòng) Gateway TRAE_REMOTE_DEBUGGING_PORT=9333 TRAE_CDP_TARGET_URL_CONTAINS=trae \ node "$(npm root -g)/traeclaw/runtime/traeapi/scripts/start-gateway.js" & # 步驟 6: 等待 Gateway 就緒 sleep 5 # 步驟 7: 驗(yàn)證服務(wù) curl -s http://127.0.0.1:8787/status
隔離模式優(yōu)缺點(diǎn)
優(yōu)點(diǎn):
- ? 不影響正在使用的 Trae 窗口
- ? 獨(dú)立的用戶數(shù)據(jù)和擴(kuò)展配置
- ? 更安全,適合自動(dòng)化測(cè)試
- ? 可以同時(shí)運(yùn)行多個(gè)實(shí)例
缺點(diǎn):
- ? 需要額外創(chuàng)建配置目錄
- ? 首次啟動(dòng)需要重新登錄 Trae
- ? 占用更多系統(tǒng)資源
方式二:非隔離模式配置
非隔離模式復(fù)用現(xiàn)有的 Trae 實(shí)例,配置簡(jiǎn)單。推薦用于日常開發(fā)和簡(jiǎn)單集成。
Step 4.2: 創(chuàng)建配置文件
# 定位 TraeClaw 配置目錄 TRAECLAW_DIR="$(npm root -g)/traeclaw/runtime/traeapi" # 創(chuàng)建配置文件 cat > "$TRAECLAW_DIR/.env" << 'EOF' # Trae 應(yīng)用路徑 TRAE_BIN=/Applications/Trae CN.app # 調(diào)試端口(使用默認(rèn)端口) TRAE_REMOTE_DEBUGGING_PORT=9222 # 禁用隔離模式 TRAE_QUICKSTART_USE_ISOLATED_PROFILE=0 TRAE_QUICKSTART_OPEN_CHAT=1 # CDP 目標(biāo)匹配 TRAE_CDP_TARGET_TITLE_CONTAINS= TRAE_CDP_TARGET_URL_CONTAINS=trae # Gateway 配置 HOST=127.0.0.1 PORT=8787 EOF
Step 5.2: 啟動(dòng)服務(wù)(非隔離模式)
情況 A:Trae 已經(jīng)在運(yùn)行
# 直接啟動(dòng) Gateway,連接現(xiàn)有 Trae 實(shí)例 TRAE_REMOTE_DEBUGGING_PORT=9222 TRAE_CDP_TARGET_URL_CONTAINS=trae \ node "$(npm root -g)/traeclaw/runtime/traeapi/scripts/start-gateway.js" & # 等待就緒 sleep 5 # 驗(yàn)證 curl -s http://127.0.0.1:8787/status
情況 B:Trae 未運(yùn)行
# 步驟 1: 啟動(dòng) Trae /Applications/Trae\ CN.app/Contents/MacOS/Electron --remote-debugging-port=9222 & # 步驟 2: 等待 Trae 完全啟動(dòng)(約 30-60 秒) sleep 30 # 步驟 3: 驗(yàn)證端口 lsof -i :9222 # 步驟 4: 啟動(dòng) Gateway TRAE_REMOTE_DEBUGGING_PORT=9222 TRAE_CDP_TARGET_URL_CONTAINS=trae \ node "$(npm root -g)/traeclaw/runtime/traeapi/scripts/start-gateway.js" & # 步驟 5: 驗(yàn)證 sleep 5 curl -s http://127.0.0.1:8787/status
非隔離模式優(yōu)缺點(diǎn)
優(yōu)點(diǎn):
- ? 配置簡(jiǎn)單,無需額外目錄
- ? 復(fù)用現(xiàn)有登錄狀態(tài)
- ? 啟動(dòng)更快
- ? 資源占用低
缺點(diǎn):
- ? 可能影響正在使用的 Trae 窗口
- ? 自動(dòng)化操作會(huì)打斷手動(dòng)使用
- ? 共享用戶數(shù)據(jù)和擴(kuò)展
Step 6: 驗(yàn)證連接
在 OpenClaw 中檢查狀態(tài):
/trae_status
預(yù)期結(jié)果:
Gateway reachable: yes Automation ready: yes Health: ok Ready detail: cdp
使用方法
方式一:斜杠命令
在 OpenClaw 對(duì)話框中直接輸入:
/Trae <任務(wù)描述>
示例:
/Trae 分析當(dāng)前項(xiàng)目的代碼結(jié)構(gòu) /Trae 創(chuàng)建一個(gè) Python 腳本,實(shí)現(xiàn)文件批量重命名 /Trae process 實(shí)現(xiàn)用戶登錄功能(帶詳細(xì)過程)
方式二:工具調(diào)用
1. trae_status - 檢查狀態(tài)
無參數(shù),返回連接狀態(tài)。
2. trae_new_chat - 創(chuàng)建新會(huì)話
無參數(shù),清空對(duì)話上下文。
3. trae_delegate - 委托任務(wù)
參數(shù):
| 參數(shù) | 類型 | 必填 | 說明 |
|---|---|---|---|
| task | string | 是 | 任務(wù)描述 |
| projectPath | string | 否 | 項(xiàng)目路徑 |
示例:
{
"task": "創(chuàng)建一個(gè) Flask 應(yīng)用,包含用戶注冊(cè)和登錄 API",
"projectPath": "/Users/xxx/myproject"
}常見問題
Q1: 如何選擇隔離模式還是非隔離模式?
選擇隔離模式,如果:
- 需要運(yùn)行自動(dòng)化測(cè)試
- 不想影響正在使用的 Trae 窗口
- 需要獨(dú)立的配置環(huán)境
選擇非隔離模式,如果:
- 日常開發(fā)使用
- 想要簡(jiǎn)單配置
- 已經(jīng)有 Trae 在運(yùn)行
Q2: Gateway 無法啟動(dòng)
檢查清單:
# 1. 檢查端口是否被占用 lsof -i :8787 # 2. 檢查 Trae 是否在監(jiān)聽 lsof -i :9222 # 非隔離模式 lsof -i :9333 # 隔離模式 # 3. 檢查配置文件 cat "$(npm root -g)/traeclaw/runtime/traeapi/.env"
Q3: Automation 未就緒
癥狀:
Automation ready: no CDP_TARGET_NOT_FOUND
解決方案:
- 確保
TRAE_CDP_TARGET_URL_CONTAINS=trae - 確保端口配置正確
- 等待 Trae 完全啟動(dòng)
Q4: 隔離模式需要重新登錄?
這是正常行為。隔離模式使用獨(dú)立的用戶數(shù)據(jù)目錄,與主 Trae 實(shí)例隔離。
如需避免,使用非隔離模式。
Q5: 端口沖突
# 查看占用端口的進(jìn)程 lsof -i :9222 lsof -i :9333 # 終止進(jìn)程 kill -9 <PID>
配置文件參考
隔離模式完整配置
TRAE_BIN=/Applications/Trae CN.app TRAE_REMOTE_DEBUGGING_PORT=9333 TRAE_QUICKSTART_USE_ISOLATED_PROFILE=1 TRAE_QUICKSTART_USER_DATA_DIR=/Users/你的用戶名/.traeclaw-isolated-profile TRAE_QUICKSTART_REMOTE_DEBUGGING_PORT=9333 TRAE_QUICKSTART_OPEN_CHAT=1 TRAE_CDP_TARGET_TITLE_CONTAINS= TRAE_CDP_TARGET_URL_CONTAINS=trae HOST=127.0.0.1 PORT=8787
非隔離模式完整配置
TRAE_BIN=/Applications/Trae CN.app TRAE_REMOTE_DEBUGGING_PORT=9222 TRAE_QUICKSTART_USE_ISOLATED_PROFILE=0 TRAE_QUICKSTART_OPEN_CHAT=1 TRAE_CDP_TARGET_TITLE_CONTAINS= TRAE_CDP_TARGET_URL_CONTAINS=trae HOST=127.0.0.1 PORT=8787
快速啟動(dòng)腳本
隔離模式啟動(dòng)腳本
#!/bin/bash # 文件: ~/start-traeclaw-isolated.sh # 創(chuàng)建目錄 mkdir -p ~/.traeclaw-isolated-profile mkdir -p "$(npm root -g)/traeclaw/runtime/traeapi/.runtime/trae-project" # 啟動(dòng) Trae /Applications/Trae\ CN.app/Contents/MacOS/Electron \ --user-data-dir=~/.traeclaw-isolated-profile \ --remote-debugging-port=9333 \ "$(npm root -g)/traeclaw/runtime/traeapi/.runtime/trae-project" & sleep 20 # 啟動(dòng) Gateway TRAE_REMOTE_DEBUGGING_PORT=9333 TRAE_CDP_TARGET_URL_CONTAINS=trae \ node "$(npm root -g)/traeclaw/runtime/traeapi/scripts/start-gateway.js" & sleep 5 echo "TraeClaw (隔離模式) 已啟動(dòng)"
非隔離模式啟動(dòng)腳本
#!/bin/bash
# 文件: ~/start-traeclaw-shared.sh
# 檢查 Trae 是否運(yùn)行
if ! lsof -i :9222 > /dev/null 2>&1; then
echo "啟動(dòng) Trae..."
/Applications/Trae\ CN.app/Contents/MacOS/Electron --remote-debugging-port=9222 &
sleep 30
fi
# 啟動(dòng) Gateway
TRAE_REMOTE_DEBUGGING_PORT=9222 TRAE_CDP_TARGET_URL_CONTAINS=trae \
node "$(npm root -g)/traeclaw/runtime/traeapi/scripts/start-gateway.js" &
sleep 5
echo "TraeClaw (非隔離模式) 已啟動(dòng)"版本歷史
| 版本 | 日期 | 更新內(nèi)容 |
|---|---|---|
| 1.0.0 | 2026-04-12 | 初始版本 |
| 1.1.0 | 2026-04-12 | 添加隔離模式配置 |
| 1.2.0 | 2026-04-12 | 添加非隔離模式配置,兩種模式對(duì)比 |
?? 本文檔由 OpenClaw Agent 維護(hù),最后更新:2026-04-12
到此這篇關(guān)于OpenClaw集成Trae的配置和使用指南的文章就介紹到這了,更多相關(guān)OpenClaw Trae 集成配置內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!
相關(guān)文章

阿里云CentOS上如何使用Docker部署OpenClaw并接入百煉大模型
文章主要講述了作者在阿里云服務(wù)器上搭建OpenClaw的過程,選擇了阿里云百煉大模型并使用了免費(fèi)額度,文中詳細(xì)介紹了環(huán)境準(zhǔn)備步驟,包括安裝Docker和DockerCompose,以及配置Doc2026-04-15
openclaw使用llama.cpp本地大模型部署完整步驟
llama.cpp 是當(dāng)前開源大模型本地化部署領(lǐng)域最具代表性和實(shí)用價(jià)值的輕量級(jí)推理框架之一,其核心設(shè)計(jì)理念是極致精簡(jiǎn)、跨平臺(tái)兼容、零依賴運(yùn)行,這篇文章主要介紹了openclaw使2026-04-15
openclaw安裝gateway失敗及openclaw重裝的過程
本文提供了解決OpenClaw Gateway安裝過程中權(quán)限問題的三種方法,包括以管理員身份重新運(yùn)行、解決編碼問題查看真實(shí)錯(cuò)誤信息、徹底卸載重裝,關(guān)鍵在于以管理員身份運(yùn)行命令行以2026-04-15
openclaw的多agent搭建的實(shí)現(xiàn)步驟
本文主要介紹了如何部署OpenClaw并設(shè)置飛書機(jī)器人,包括創(chuàng)建應(yīng)用、添加機(jī)器人、設(shè)置事件和回調(diào)等,完成后再進(jìn)行權(quán)限管理等步驟,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)2026-04-15
本文詳細(xì)介紹了通過ROS2控制OpenClaw機(jī)器人的完整流程,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)2026-04-15
Windows部署OpenClaw并接入DeepSeek和飛書的詳細(xì)流程
本文詳細(xì)介紹了在Windows系統(tǒng)上安裝Git、Python、Node.js及OpenOpenOpenOpenOpenCl最新的OpenOpenOpenCl在內(nèi)的基礎(chǔ)軟件,接著配置了OpenOpenopenCl的基礎(chǔ)環(huán)境,文后還提供了2026-04-14
OpenClaw常用操作命令完整速查手冊(cè)(2026最新漢化版)
這份速查手冊(cè)詳細(xì)介紹了OpenClaw中文漢化版2026.4.1-zh.2及以上的命令使用方法,涵蓋了終端CLI操作、聊天斜杠指令、實(shí)用技巧與常見問題解決等內(nèi)容,幫助用戶高效操作和維護(hù)該2026-04-13
OpenClaw和AiPy怎么選?2026年OpenClaw和AiPy的功能實(shí)測(cè)對(duì)比和踩坑全記錄
先說結(jié)論,OpenClaw 比較適合需要精細(xì)控制 AI Agent 工作流的場(chǎng)景,AiPy 比較適合快速原型和輕量級(jí) AI 腳本開發(fā),兩者定位不同,不是誰替代誰的關(guān)系,下面小編就和大家詳細(xì)介2026-04-13
OpenClaw 配置文件 openclaw.json 完整參數(shù)說明
文章詳細(xì)介紹了OpenClaw配置文件openclaw.json的各項(xiàng)參數(shù)配置,包括系統(tǒng)版本信息、配置向?qū)в涗洝⒄J(rèn)證方式、模型服務(wù)配置、智能體默認(rèn)配置、工具集配置、命令權(quán)限、會(huì)話策略2026-04-13
openclaw github installation guide全解(全新 3.0版本)
文章介紹了OpenClaw(開發(fā)者社區(qū)昵稱“龍蝦”)全平臺(tái)私有化部署指南,涵蓋Windows、macOS、Linux三大操作系統(tǒng),提供基礎(chǔ)環(huán)境搭建、核心服務(wù)啟動(dòng)、反向代理配置、多租戶身份2026-04-13










