脚本之家 服务器常用软件
快捷导航
您的位置：主页 > AI > openclaw > OpenClaw Trae 集成配置

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

  发布时间：2026-04-16 11:36:22   作者：yuzhucu   我要评论
Trae是字节跳动推出的 AI IDE（集成开发环境），支持智能代码生成、重构、调试等功能,本文详细介绍了如何在OpenCl中配置和使用TraeIDE的自动化功能,感兴趣的朋友一起看看吧

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.jsv18+
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
调试端口93339222
独立实例是否
推荐场景自动化测试、批量任务日常开发、简单集成
登录状态需要重新登录复用现有登录
资源占用较高（独立进程）较低（复用进程）

方式一：隔离模式配置

隔离模式创建独立的 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 - 委托任务

参数：

参数类型必填说明
taskstring是任务描述
projectPathstring否项目路径

示例：

{
  "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.02026-04-12初始版本
1.1.02026-04-12添加隔离模式配置
1.2.02026-04-12添加非隔离模式配置，两种模式对比

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

到此这篇关于OpenClaw集成Trae的配置和使用指南的文章就介绍到这了,更多相关OpenClaw Trae 集成配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

相关文章

  • 阿里云CentOS上如何使用Docker部署OpenClaw并接入百炼大模型

    文章主要讲述了作者在阿里云服务器上搭建OpenClaw的过程,选择了阿里云百炼大模型并使用了免费额度,文中详细介绍了环境准备步骤,包括安装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搭建的实现步骤

    本文主要介绍了如何部署OpenClaw并设置飞书机器人,包括创建应用、添加机器人、设置事件和回调等,完成后再进行权限管理等步骤,文中通过示例代码介绍的非常详细，对大家的学
    2026-04-15

  • OpenClaw通过ROS控制机器人完整教程

    本文详细介绍了通过ROS2控制OpenClaw机器人的完整流程,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学
    2026-04-15

  • Windows部署OpenClaw并接入DeepSeek和飞书的详细流程

    本文详细介绍了在Windows系统上安装Git、Python、Node.js及OpenOpenOpenOpenOpenCl最新的OpenOpenOpenCl在内的基础软件,接着配置了OpenOpenopenCl的基础环境,文后还提供了
    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 脚本开发,两者定位不同，不是谁替代谁的关系,下面小编就和大家详细介
    2026-04-13

  • OpenClaw 配置文件 openclaw.json 完整参数说明

    文章详细介绍了OpenClaw配置文件openclaw.json的各项参数配置,包括系统版本信息、配置向导记录、认证方式、模型服务配置、智能体默认配置、工具集配置、命令权限、会话策略
    2026-04-13

  • openclaw github installation guide全解(全新 3.0版本)

    文章介绍了OpenClaw（开发者社区昵称“龙虾”）全平台私有化部署指南,涵盖Windows、macOS、Linux三大操作系统,提供基础环境搭建、核心服务启动、反向代理配置、多租户身份
    2026-04-13

最新评论

关注微信公众号

扫一扫