AI > openclaw >

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

2026-04-16 11:36:22 yuzhucu

OpenClaw + Trae 集成配置指南

本文档详细说明如何在 OpenClaw 中配置和使用 Trae IDE 自动化功能

概述

什么是 Trae？

Trae 是由字节跳动推出的“AI 原生”集成开发环境（IDE），定位是一名“真正的 AI 工程师”。它致力于深度融入软件开发的整个生命周期，而不仅仅是作为一个辅助工具，旨在通过 AI 提升从项目构思到部署上线的全流程效率。

什么是 TraeClaw？

TraeClaw 是 OpenClaw 的插件，作为 OpenClaw 和 Trae 之间的桥接层，让 OpenClaw 能够通过 CDP 协议控制 Trae 执行开发任务。

核心特点

AI 原生：Trae 从底层就将 AI 能力与开发流程深度融合，与在传统 IDE 上添加 AI 插件的模式不同。
模型集成：Trae 根据不同市场集成了强大的大语言模型。
- 国际版（trae.ai）集成了 Claude 3.5/3.7 Sonnet、GPT-4o 等模型。
- 国内版（trae.com.cn）集成了 豆包 (Doubao-1.5-pro)、DeepSeek R1/V3 等模型。
双重协作模式：Trae 提供两种工作模式，允许开发者根据场景自由切换。
IDE 模式：保持传统集成开发环境的工作流，提供 AI 智能问答、代码自动补全等辅助功能-。
SOLO 模式：以 AI 为主导，它能理解项目目标、自主规划任务并调度工具，独立推进开发工作，实现从自然语言描述到可执行产出的全流程。
开放智能体生态：Trae 支持创建和分享自定义 AI 智能体。你可以像管理团队一样，为不同的任务部署专属的智能体协同工作。

工作原理

用户请求 -> OpenClaw -> TraeClaw Plugin -> TraeClaw Gateway -> Trae IDE -> 执行任务 -> 返回结果

环境要求

项目	要求
操作系统	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
# 验证插件状态
openclaw plugins list | grep -i trae

预期输出：

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

配置模式

提供两种配置模式，根据你的使用场景选择。

模式对比

特性	隔离模式	非隔离模式
配置复杂度	较高	低
用户数据目录	`~/.traeclaw-isolated-profile`	`~/Library/Application Support/Trae CN`
调试端口	9333	9222
独立实例	是	否
推荐场景	自动化测试、批量任务	日常开发、简单集成
登录状态	需要重新登录	复用现有登录
资源占用	较高（独立进程）	较低（复用进程）

方式一：隔离模式配置

隔离模式创建独立的 Trae 实例，不影响正在使用的 Trae 窗口。推荐用于自动化测试和批量任务。

Step 4.1: 创建配置文件

# 定位 TraeClaw 配置目录
TRAECLAW_DIR="$(npm root -g)/traeclaw/runtime/traeapi"
# 创建隔离配置目录
mkdir -p ~/.traeclaw-isolated-profile
# 创建配置文件
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: 创建必要目录
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 在监听端口 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

隔离模式优缺点

优点：

✅ 不影响正在使用的 Trae 窗口
✅ 独立的用户数据和扩展配置
✅ 更安全，适合自动化测试
✅ 可以同时运行多个实例

缺点：

❌ 需要额外创建配置目录
❌ 首次启动需要重新登录 Trae
❌ 占用更多系统资源

方式二：非隔离模式配置

非隔离模式复用现有的 Trae 实例，配置简单。推荐用于日常开发和简单集成。

Step 4.2: 创建配置文件

# 定位 TraeClaw 配置目录
TRAECLAW_DIR="$(npm root -g)/traeclaw/runtime/traeapi"
# 创建配置文件
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，连接现有 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

非隔离模式优缺点

优点：

✅ 配置简单，无需额外目录
✅ 复用现有登录状态
✅ 启动更快
✅ 资源占用低

缺点：

❌ 可能影响正在使用的 Trae 窗口
❌ 自动化操作会打断手动使用
❌ 共享用户数据和扩展

Step 6: 验证连接

在 OpenClaw 中检查状态：

/trae_status

预期结果：

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

使用方法

方式一：斜杠命令

在 OpenClaw 对话框中直接输入：

/Trae <任务描述>

示例：

/Trae 分析当前项目的代码结构
/Trae 创建一个 Python 脚本，实现文件批量重命名
/Trae process 实现用户登录功能（带详细过程）

方式二：工具调用

1. trae_status - 检查状态

无参数，返回连接状态。

2. trae_new_chat - 创建新会话

无参数，清空对话上下文。

3. trae_delegate - 委托任务

参数：

参数	类型	必填	说明
task	string	是	任务描述
projectPath	string	否	项目路径

示例：

{
  "task": "创建一个 Flask 应用，包含用户注册和登录 API",
  "projectPath": "/Users/xxx/myproject"
}

常见问题

Q1: 如何选择隔离模式还是非隔离模式？

选择隔离模式，如果：

需要运行自动化测试
不想影响正在使用的 Trae 窗口
需要独立的配置环境

选择非隔离模式，如果：

日常开发使用
想要简单配置
已经有 Trae 在运行

Q2: Gateway 无法启动

检查清单：

# 1. 检查端口是否被占用
lsof -i :8787
# 2. 检查 Trae 是否在监听
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
# 创建目录
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 集成配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！