traeclawinstall

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 文件系统执行