# trae-controller

**Repository Path**: ffedu/trae-controller

## Basic Information

- **Project Name**: trae-controller
- **Description**: trae-controller for OpenClaw to controller via OpenCLI
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-29
- **Last Updated**: 2026-04-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Trae IDE Controller - OpenClaw × OpenCLI

让 OpenClaw 云端助手控制你本地的 Trae IDE，实现 AI 协同开发。

## 架构特性

- **基于 opencli 的 Electron CDP 控制**: 通过自定义 opencli adapter 直接控制 Trae IDE 内部 DOM 与逻辑。
- **FastAPI 封装 HTTP 与 WebSocket 接口**: 提供完整的 RESTful API 以及基于 WebSocket 的 MCP (Model Context Protocol) 双向通信（v2.0+）。
- **丰富的 Trae 控制能力**: 支持读取对话列表、获取最新消息、发送指令、读取集成终端、获取截图、获取 Git 状态等。
- **Trae Skills 集成**: 提供位于 `.trae/skills/` 的各类能力定义供 OpenClaw 直接调用。
- **一键服务管理**: 提供脚本快捷启动/停止 FastAPI 与 Trae 调试端口，以及 ngrok 内网穿透服务。

## 快速开始

### 1. 安装依赖

```bash
# 安装 opencli
npm install -g @jackwener/opencli

# 安装 Python 依赖
pip install -r requirements.txt
```

### 2. 同步并配置 OpenCLI

将本项目的 opencli 脚本注入到你的环境中：

```bash
./sync-opencli.sh
```

### 3. 配置 ngrok（可选，用于云端访问）

```bash
ngrok config add-authtoken <your-auth-token>
```

### 4. 启动服务

提供了一键脚本管理服务（Trae IDE CDP 端口 9226 和 FastAPI 服务端口 8000）：

```bash
# 启动基础服务（FastAPI + Trae CDP 挂载提示）
./start-services.sh

# 启动 ngrok 暴露公网地址
./start-ngrok.sh

# 停止基础服务
./stop-services.sh
```

获取 ngrok 公网地址，配置到 OpenClaw 端即可使用。

## HTTP 接口

| 接口 | 方法 | 描述 |
|------|------|------|
| `/api/status` | GET | 健康检查与 opencli 版本检测 |
| `/api/chat/list` | GET | 获取当前 Trae 会话的所有对话记录 |
| `/api/chat/latest` | GET | 获取当前 Trae 会话的最新一条消息 |
| `/api/chat/send` | POST | 发送指令到 Trae（需传入 `content`） |
| `/api/screenshot` | GET | 截取 Trae 界面截图 |
| `/api/terminal/read` | GET | 读取 Trae 集成终端的可见内容 |
| `/api/git/status` | GET | 获取当前工作区的 Git 变更列表 |

## MCP (Model Context Protocol) 接口

服务支持通过 WebSocket 连接 `/ws/mcp` 实现 MCP 通信：
- 提供 `trae_status`, `trae_chat_list`, `trae_chat_latest`, `trae_chat_send`, `trae_terminal_read`, `trae_screenshot`, `trae_git_status` 等 MCP Tools 供大模型直接调用。

## 文档

更多详细的设计与开发文档，请查看 [docs/](./docs/) 目录：
- `1-需求梳理.md`
- `2-方案设计.md`
- `3-程序开发.md`
- `4-部署方法.md`
- `API.md` 等

## 许可证

Apache-2.0