100 lines
2.8 KiB
Markdown
100 lines
2.8 KiB
Markdown
---
|
||
name: TraeClawInstall
|
||
description: 统一执行 Traeclaw 仓库的 OpenClaw 安装、启动、验收与排障流程；当用户希望在本仓库一站式完成部署或检查时调用。
|
||
---
|
||
|
||
# OpenClaw 仓库一体化技能
|
||
|
||
## 技能目标
|
||
|
||
将本仓库视为一个整体，统一完成 OpenClaw 的平台识别、安装、启动、验收与排障，不再拆分多个独立技能。
|
||
|
||
## 适用场景（何时调用）
|
||
|
||
- 用户要求“在本地部署openclaw”
|
||
- 用户要求“按这个仓库整体流程执行”
|
||
- 用户希望在 Trae IDE 内一站式完成部署和验证
|
||
- 用户未明确平台细节，但希望直接得到可执行路径
|
||
- 用户出现安装/启动异常，需要按仓库标准流程排障
|
||
|
||
## 输入前提
|
||
|
||
- 当前工作目录为仓库根目录
|
||
- 可使用终端执行命令
|
||
- 可访问仓库文档与脚本
|
||
|
||
## 决策路由
|
||
|
||
1. 识别平台：
|
||
- Windows：优先 WSL2，走 `scripts/windows/wsl/*.sh`
|
||
- macOS：走 `scripts/macos/*.sh`
|
||
- Linux：走 `scripts/linux/*.sh`
|
||
2. 校验基线：
|
||
- `node --version` 主版本需 `>=22`
|
||
- `npm --version` 可用
|
||
- `openclaw --version` 若不存在则由 setup 安装
|
||
3. 执行标准三步：
|
||
- `setup -> start -> check`
|
||
4. 执行最小验收：
|
||
- `openclaw doctor`
|
||
- `openclaw status`
|
||
- `openclaw dashboard`
|
||
5. 任一步失败则进入统一排障流程
|
||
|
||
## 标准执行步骤（SOP）
|
||
|
||
### Step 0：读取关键入口
|
||
|
||
- `README.md`
|
||
- `docs/common/trae-ide-guide.md`
|
||
- `docs/common/acceptance.md`
|
||
- `docs/common/troubleshooting.md`
|
||
- `docs/common/install-config-checklist.md`
|
||
- 对应平台 `docs/platforms/<platform>/README.md`
|
||
|
||
### Step 1：按平台脚本执行
|
||
|
||
- Windows（WSL2）：
|
||
- `bash scripts/windows/wsl/setup.sh`
|
||
- `bash scripts/windows/wsl/start.sh`
|
||
- `bash scripts/windows/wsl/check.sh`
|
||
- macOS：
|
||
- `bash scripts/macos/setup.sh`
|
||
- `bash scripts/macos/start.sh`
|
||
- `bash scripts/macos/check.sh`
|
||
- Linux：
|
||
- `bash scripts/linux/setup.sh`
|
||
- `bash scripts/linux/start.sh`
|
||
- `bash scripts/linux/check.sh`
|
||
|
||
如需 dashboard，可在 check 步骤追加 `--dashboard`。
|
||
|
||
### Step 2：验收判定
|
||
|
||
- 必须完成 `doctor/status/dashboard` 三项检查
|
||
- 结论分为：通过 / 失败待修复
|
||
|
||
### Step 3：失败分诊
|
||
|
||
1. 保存首次报错行
|
||
2. 重跑：
|
||
- `openclaw doctor`
|
||
- `openclaw status`
|
||
3. 核对：
|
||
- `which node || true`
|
||
- `which openclaw || true`
|
||
- `node --version || true`
|
||
- `openclaw --version || true`
|
||
4. 按 `docs/common/troubleshooting.md` 对应章节修复
|
||
5. 每次只改一个变量并复验
|
||
|
||
## 输出约定
|
||
|
||
- 成功：给出平台、执行步骤、验收结果与可访问状态
|
||
- 失败：给出首个错误、已验证动作、下一步修复建议
|
||
|
||
## 约束
|
||
|
||
- 优先复用仓库现有文档和脚本，不创建平行流程
|
||
- 不写入真实密钥，仅使用示例配置
|
||
- Windows 场景优先在 WSL2 Linux 文件系统执行 |