编程部落

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

Written by

风君子

in

文章目录
  • 本文档详细说明如何在 OpenClaw 中配置和使用 Trae IDE 自动化功能
    • 目录
    • OpenClaw + Trae 集成配置指南
      • 概述
        • 什么是 Trae？
        • 什么是 TraeClaw？
        • 核心特点
        • 工作原理
      • 环境要求
        • 安装步骤
          • Step 1: 安装 Trae CN
          • Step 2: 安装 TraeClaw 插件
          • Step 3: 启用插件
        • 配置模式
          • 模式对比
          • 方式一：隔离模式配置
          • Step 4.1: 创建配置文件
          • Step 5.1: 启动服务（隔离模式）
          • 方式二：非隔离模式配置
          • Step 4.2: 创建配置文件
          • Step 5.2: 启动服务（非隔离模式）
          • Step 6: 验证连接
        • 使用方法
          • 方式一：斜杠命令
          • 方式二：工具调用
        • 常见问题
          • Q1: 如何选择隔离模式还是非隔离模式？
          • Q2: Gateway 无法启动
          • Q3: Automation 未就绪
          • Q4: 隔离模式需要重新登录？
          • Q5: 端口冲突
        • 配置文件参考
          • 隔离模式完整配置
          • 非隔离模式完整配置
        • 快速启动脚本
          • 隔离模式启动脚本
          • 非隔离模式启动脚本
        • 版本历史

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

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

        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）

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

        # 全局安装 traeclaw npm 包
npm install -g traeclaw
# 或使用 OpenClaw CLI 安装
openclaw plugins install traeclaw

        # 启用 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 窗口。推荐用于自动化测试和批量任务。

        # 定位 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

        # 步骤 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 实例，配置简单。推荐用于日常开发和简单集成。

        # 定位 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

        情况 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 窗口
        • ❌ 自动化操作会打断手动使用
        • ❌ 共享用户数据和扩展

        在 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"
}

        选择隔离模式，如果：

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

        选择非隔离模式，如果：

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

        检查清单：

        # 1. 检查端口是否被占用
lsof -i :8787
# 2. 检查 Trae 是否在监听
lsof -i :9222  # 非隔离模式
lsof -i :9333  # 隔离模式
# 3. 检查配置文件
cat "$(npm root -g)/traeclaw/runtime/traeapi/.env"

        症状：

        Automation ready: no
CDP_TARGET_NOT_FOUND

        解决方案：

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

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

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

        # 查看占用端口的进程
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 集成配置内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！

        More posts

        站内搜索

        标签云

        iphone 三星 信用卡 信贷 华为 小米 微软 快科技 手机 投资理财 支付宝 特斯拉 理财知识 电脑 科技 程序 股票 芯片 苹果 贷款 路由器 银行 银行卡 额度

        热门文章

        友情链接