OpenClaw集成Trae的配置和使用指南

發(fā)布時間：2026-04-16 11:36:22 作者：yuzhucu

Trae是字節(jié)跳動推出的 AI IDE（集成開發(fā)環(huán)境），支持智能代碼生成、重構、調試等功能,本文詳細介紹了如何在OpenCl中配置和使用TraeIDE的自動化功能,感興趣的朋友一起看看吧

OpenClaw + Trae 集成配置指南

本文檔詳細說明如何在 OpenClaw 中配置和使用 Trae IDE 自動化功能

概述

什么是 Trae？

Trae 是由字節(jié)跳動推出的“AI 原生”集成開發(fā)環(huán)境（IDE），定位是一名“真正的 AI 工程師”。它致力于深度融入軟件開發(fā)的整個生命周期，而不僅僅是作為一個輔助工具，旨在通過 AI 提升從項目構思到部署上線的全流程效率。

什么是 TraeClaw？

TraeClaw 是 OpenClaw 的插件，作為 OpenClaw 和 Trae 之間的橋接層，讓 OpenClaw 能夠通過 CDP 協(xié)議控制 Trae 執(zhí)行開發(fā)任務。

核心特點

AI 原生：Trae 從底層就將 AI 能力與開發(fā)流程深度融合，與在傳統(tǒng) IDE 上添加 AI 插件的模式不同。
模型集成：Trae 根據不同市場集成了強大的大語言模型。
- 國際版（trae.ai）集成了 Claude 3.5/3.7 Sonnet、GPT-4o 等模型。
- 國內版（trae.com.cn）集成了 豆包 (Doubao-1.5-pro)、DeepSeek R1/V3 等模型。
雙重協(xié)作模式：Trae 提供兩種工作模式，允許開發(fā)者根據場景自由切換。
IDE 模式：保持傳統(tǒng)集成開發(fā)環(huán)境的工作流，提供 AI 智能問答、代碼自動補全等輔助功能-。
SOLO 模式：以 AI 為主導，它能理解項目目標、自主規(guī)劃任務并調度工具，獨立推進開發(fā)工作，實現(xiàn)從自然語言描述到可執(zhí)行產出的全流程。
開放智能體生態(tài)：Trae 支持創(chuàng)建和分享自定義 AI 智能體。你可以像管理團隊一樣，為不同的任務部署專屬的智能體協(xié)同工作。

工作原理

用戶請求 -> OpenClaw -> TraeClaw Plugin -> TraeClaw Gateway -> Trae IDE -> 執(zhí)行任務 -> 返回結果

環(huán)境要求

項目	要求
操作系統(tǒng)	macOS 10.15+ / Windows 10+
Trae 版本	Trae CN（中文版）
Node.js	v18+
OpenClaw	最新版
端口	8787（Gateway）

安裝步驟

Step 1: 安裝 Trae CN

訪問 Trae 官網下載：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
# 驗證插件狀態(tài)
openclaw plugins list | grep -i trae

預期輸出：

│ TraeClaw │ trae-ide │ openclaw │ loaded │ ... │ 0.3.0 │

配置模式

提供兩種配置模式，根據你的使用場景選擇。

模式對比

特性	隔離模式	非隔離模式
配置復雜度	較高	低
用戶數據目錄	`~/.traeclaw-isolated-profile`	`~/Library/Application Support/Trae CN`
調試端口	9333	9222
獨立實例	是	否
推薦場景	自動化測試、批量任務	日常開發(fā)、簡單集成
登錄狀態(tài)	需要重新登錄	復用現(xiàn)有登錄
資源占用	較高（獨立進程）	較低（復用進程）

方式一：隔離模式配置

隔離模式創(chuàng)建獨立的 Trae 實例，不影響正在使用的 Trae 窗口。推薦用于自動化測試和批量任務。

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 應用路徑
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
# CDP 目標匹配
TRAE_CDP_TARGET_TITLE_CONTAINS=
TRAE_CDP_TARGET_URL_CONTAINS=trae
# Gateway 配置
HOST=127.0.0.1
PORT=8787
EOF

Step 5.1: 啟動服務（隔離模式）

# 步驟 1: 創(chuàng)建必要目錄
mkdir -p ~/.traeclaw-isolated-profile
mkdir -p "$(npm root -g)/traeclaw/runtime/traeapi/.runtime/trae-project"
# 步驟 2: 啟動 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 啟動（約 20 秒）
sleep 20
# 步驟 4: 驗證 Trae 已啟動
lsof -i :9333
# 應顯示 Electron 在監(jiān)聽端口 9333
# 步驟 5: 啟動 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: 驗證服務
curl -s http://127.0.0.1:8787/status

隔離模式優(yōu)缺點

優(yōu)點：

? 不影響正在使用的 Trae 窗口
? 獨立的用戶數據和擴展配置
? 更安全，適合自動化測試
? 可以同時運行多個實例

缺點：

? 需要額外創(chuàng)建配置目錄
? 首次啟動需要重新登錄 Trae
? 占用更多系統(tǒng)資源

方式二：非隔離模式配置

非隔離模式復用現(xiàn)有的 Trae 實例，配置簡單。推薦用于日常開發(fā)和簡單集成。

Step 4.2: 創(chuàng)建配置文件

# 定位 TraeClaw 配置目錄
TRAECLAW_DIR="$(npm root -g)/traeclaw/runtime/traeapi"
# 創(chuàng)建配置文件
cat > "$TRAECLAW_DIR/.env" << 'EOF'
# Trae 應用路徑
TRAE_BIN=/Applications/Trae CN.app
# 調試端口（使用默認端口）
TRAE_REMOTE_DEBUGGING_PORT=9222
# 禁用隔離模式
TRAE_QUICKSTART_USE_ISOLATED_PROFILE=0
TRAE_QUICKSTART_OPEN_CHAT=1
# CDP 目標匹配
TRAE_CDP_TARGET_TITLE_CONTAINS=
TRAE_CDP_TARGET_URL_CONTAINS=trae
# Gateway 配置
HOST=127.0.0.1
PORT=8787
EOF

Step 5.2: 啟動服務（非隔離模式）

情況 A：Trae 已經在運行

# 直接啟動 Gateway，連接現(xiàn)有 Trae 實例
TRAE_REMOTE_DEBUGGING_PORT=9222 TRAE_CDP_TARGET_URL_CONTAINS=trae \
  node "$(npm root -g)/traeclaw/runtime/traeapi/scripts/start-gateway.js" &
# 等待就緒
sleep 5
# 驗證
curl -s http://127.0.0.1:8787/status

情況 B：Trae 未運行

# 步驟 1: 啟動 Trae
/Applications/Trae\ CN.app/Contents/MacOS/Electron --remote-debugging-port=9222 &
# 步驟 2: 等待 Trae 完全啟動（約 30-60 秒）
sleep 30
# 步驟 3: 驗證端口
lsof -i :9222
# 步驟 4: 啟動 Gateway
TRAE_REMOTE_DEBUGGING_PORT=9222 TRAE_CDP_TARGET_URL_CONTAINS=trae \
  node "$(npm root -g)/traeclaw/runtime/traeapi/scripts/start-gateway.js" &
# 步驟 5: 驗證
sleep 5
curl -s http://127.0.0.1:8787/status

非隔離模式優(yōu)缺點

優(yōu)點：

? 配置簡單，無需額外目錄
? 復用現(xiàn)有登錄狀態(tài)
? 啟動更快
? 資源占用低

缺點：

? 可能影響正在使用的 Trae 窗口
? 自動化操作會打斷手動使用
? 共享用戶數據和擴展

Step 6: 驗證連接

在 OpenClaw 中檢查狀態(tài)：

/trae_status

預期結果：

Gateway reachable: yes
Automation ready: yes
Health: ok
Ready detail: cdp

使用方法

方式一：斜杠命令

在 OpenClaw 對話框中直接輸入：

/Trae <任務描述>

示例：

/Trae 分析當前項目的代碼結構
/Trae 創(chuàng)建一個 Python 腳本，實現(xiàn)文件批量重命名
/Trae process 實現(xiàn)用戶登錄功能（帶詳細過程）

方式二：工具調用

1. trae_status - 檢查狀態(tài)

無參數，返回連接狀態(tài)。

2. trae_new_chat - 創(chuàng)建新會話

無參數，清空對話上下文。

3. trae_delegate - 委托任務

參數：

參數	類型	必填	說明
task	string	是	任務描述
projectPath	string	否	項目路徑

示例：

{
  "task": "創(chuàng)建一個 Flask 應用，包含用戶注冊和登錄 API",
  "projectPath": "/Users/xxx/myproject"
}

常見問題

Q1: 如何選擇隔離模式還是非隔離模式？

選擇隔離模式，如果：

需要運行自動化測試
不想影響正在使用的 Trae 窗口
需要獨立的配置環(huán)境

選擇非隔離模式，如果：

日常開發(fā)使用
想要簡單配置
已經有 Trae 在運行

Q2: Gateway 無法啟動

檢查清單：

# 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 完全啟動

Q4: 隔離模式需要重新登錄？

這是正常行為。隔離模式使用獨立的用戶數據目錄，與主 Trae 實例隔離。

如需避免，使用非隔離模式。

Q5: 端口沖突

# 查看占用端口的進程
lsof -i :9222
lsof -i :9333
# 終止進程
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

快速啟動腳本

隔離模式啟動腳本

#!/bin/bash
# 文件: ~/start-traeclaw-isolated.sh
# 創(chuàng)建目錄
mkdir -p ~/.traeclaw-isolated-profile
mkdir -p "$(npm root -g)/traeclaw/runtime/traeapi/.runtime/trae-project"
# 啟動 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
# 啟動 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 (隔離模式) 已啟動"

非隔離模式啟動腳本

#!/bin/bash
# 文件: ~/start-traeclaw-shared.sh
# 檢查 Trae 是否運行
if ! lsof -i :9222 > /dev/null 2>&1; then
    echo "啟動 Trae..."
    /Applications/Trae\ CN.app/Contents/MacOS/Electron --remote-debugging-port=9222 &
    sleep 30
fi
# 啟動 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 (非隔離模式) 已啟動"

版本歷史

版本	日期	更新內容
1.0.0	2026-04-12	初始版本
1.1.0	2026-04-12	添加隔離模式配置
1.2.0	2026-04-12	添加非隔離模式配置，兩種模式對比

?? 本文檔由 OpenClaw Agent 維護，最后更新：2026-04-12

到此這篇關于OpenClaw集成Trae的配置和使用指南的文章就介紹到這了,更多相關OpenClaw Trae 集成配置內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章，希望大家以后多多支持腳本之家！

Tag：OpenClaw Trae

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