OpenClaw + Trae 集成配置指南

OpenClaw + Trae 集成配置指南

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

目录

• 概述
• 环境要求
• 安装步骤
• 配置模式
• 使用方法
• 常见问题

概述

什么是 Trae？

Trae 是字节跳动推出的 AI IDE（集成开发环境），支持智能代码生成、重构、调试等功能。

什么是 TraeClaw？

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

工作原理

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

环境要求

安装步骤

Step 1: 安装 Trae CN

1. 访问 Trae 官网下载：https://www.trae.cn
2. 安装到/Applications/Trae CN.app

Step 2: 安装 TraeClaw 插件

# 全局安装 traeclaw npm 包npminstall-gtraeclaw# 或使用 OpenClaw CLI 安装openclaw pluginsinstalltraeclaw

Step 3: 启用插件

# 启用 trae-ide 插件openclaw pluginsenabletrae-ide# 验证插件状态openclaw plugins list|grep-itrae

预期输出：

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

配置模式

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

模式对比

方式一：隔离模式配置

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

Step 4.1: 创建配置文件

# 定位 TraeClaw 配置目录TRAECLAW_DIR="$(npmroot-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-profilemkdir-p"$(npmroot-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\"$(npmroot-g)/traeclaw/runtime/traeapi/.runtime/trae-project"&# 步骤 3: 等待 Trae 启动（约 20 秒）sleep20# 步骤 4: 验证 Trae 已启动lsof-i:9333# 应显示 Electron 在监听端口 9333# 步骤 5: 启动 GatewayTRAE_REMOTE_DEBUGGING_PORT=9333TRAE_CDP_TARGET_URL_CONTAINS=trae\node"$(npmroot-g)/traeclaw/runtime/traeapi/scripts/start-gateway.js"&# 步骤 6: 等待 Gateway 就绪sleep5# 步骤 7: 验证服务curl-shttp://127.0.0.1:8787/status

隔离模式优缺点

优点：

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

缺点：

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

方式二：非隔离模式配置

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

Step 4.2: 创建配置文件

# 定位 TraeClaw 配置目录TRAECLAW_DIR="$(npmroot-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=9222TRAE_CDP_TARGET_URL_CONTAINS=trae\node"$(npmroot-g)/traeclaw/runtime/traeapi/scripts/start-gateway.js"&# 等待就绪sleep5# 验证curl-shttp://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 秒）sleep30# 步骤 3: 验证端口lsof-i:9222# 步骤 4: 启动 GatewayTRAE_REMOTE_DEBUGGING_PORT=9222TRAE_CDP_TARGET_URL_CONTAINS=trae\node"$(npmroot-g)/traeclaw/runtime/traeapi/scripts/start-gateway.js"&# 步骤 5: 验证sleep5curl-shttp://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":"创建一个 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"$(npmroot-g)/traeclaw/runtime/traeapi/.env"

Q3: Automation 未就绪

症状：

Automation ready: no CDP_TARGET_NOT_FOUND

解决方案：

1. 确保TRAE_CDP_TARGET_URL_CONTAINS=trae
2. 确保端口配置正确
3. 等待 Trae 完全启动

Q4: 隔离模式需要重新登录？

这是正常行为。隔离模式使用独立的用户数据目录，与主 Trae 实例隔离。

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

Q5: 端口冲突

# 查看占用端口的进程lsof-i:9222lsof-i:9333# 终止进程kill-9<PID>

配置文件参考

隔离模式完整配置

TRAE_BIN=/Applications/Trae CN.appTRAE_REMOTE_DEBUGGING_PORT=9333TRAE_QUICKSTART_USE_ISOLATED_PROFILE=1TRAE_QUICKSTART_USER_DATA_DIR=/Users/你的用户名/.traeclaw-isolated-profileTRAE_QUICKSTART_REMOTE_DEBUGGING_PORT=9333TRAE_QUICKSTART_OPEN_CHAT=1TRAE_CDP_TARGET_TITLE_CONTAINS=TRAE_CDP_TARGET_URL_CONTAINS=traeHOST=127.0.0.1PORT=8787

非隔离模式完整配置

TRAE_BIN=/Applications/Trae CN.appTRAE_REMOTE_DEBUGGING_PORT=9222TRAE_QUICKSTART_USE_ISOLATED_PROFILE=0TRAE_QUICKSTART_OPEN_CHAT=1TRAE_CDP_TARGET_TITLE_CONTAINS=TRAE_CDP_TARGET_URL_CONTAINS=traeHOST=127.0.0.1PORT=8787

快速启动脚本

隔离模式启动脚本

#!/bin/bash# 文件: ~/start-traeclaw-isolated.sh# 创建目录mkdir-p~/.traeclaw-isolated-profilemkdir-p"$(npmroot-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\"$(npmroot-g)/traeclaw/runtime/traeapi/.runtime/trae-project"&sleep20# 启动 GatewayTRAE_REMOTE_DEBUGGING_PORT=9333TRAE_CDP_TARGET_URL_CONTAINS=trae\node"$(npmroot-g)/traeclaw/runtime/traeapi/scripts/start-gateway.js"&sleep5echo"TraeClaw (隔离模式) 已启动"

非隔离模式启动脚本

#!/bin/bash# 文件: ~/start-traeclaw-shared.sh# 检查 Trae 是否运行if!lsof-i:9222>/dev/null2>&1;thenecho"启动 Trae..."/Applications/Trae\CN.app/Contents/MacOS/Electron --remote-debugging-port=9222&sleep30fi# 启动 GatewayTRAE_REMOTE_DEBUGGING_PORT=9222TRAE_CDP_TARGET_URL_CONTAINS=trae\node"$(npmroot-g)/traeclaw/runtime/traeapi/scripts/start-gateway.js"&sleep5echo"TraeClaw (非隔离模式) 已启动"

版本历史

📝 本文档由 OpenClaw Agent 维护，最后更新：2026-04-12