OpenClaw + Trae 集成配置指南

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

目录

概述

什么是 Trae？

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

什么是 TraeClaw？

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

工作原理

用户请求 -> 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

  1. 访问 Trae 官网下载：https://www.trae.cn
  2. 安装到 /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

解决方案：

  1. 确保 TRAE_CDP_TARGET_URL_CONTAINS=trae
  2. 确保端口配置正确
  3. 等待 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

Logo
EazyDevelop社区

一站式 AI 云服务平台

更多推荐

cover

Ollama v0.20.5+OpenClaw：本地 AI 智能体搭建实操（零代码上手）

avatar EazyDevelop社区
cover

2026 最新 OpenClaw AI 零代码生成 HTML5 企业网站教程

avatar EazyDevelop社区
cover

AI超级全景图（100+工具版）

avatar EazyDevelop社区