SKILL.md
OpenClaw 自动化诊断
诊断流程
遇到 OpenClaw 问题，按以下流程自动诊断：
1. 运行诊断脚本 → 2. 根据结果修复 → 3. 验证结果Step 1: 执行诊断
# 一键诊断（检查所有关键指标）
powershell -ExecutionPolicy Bypass -File <SKILL_PATH>\scripts\check_gateway_status.ps1诊断项目：
- 进程状态（node 进程是否存在）
- 端口 18789（是否被占用、是否监听）
- 健康检查端点（Gateway 是否响应）
- Watchdog 计划任务（是否配置、运行状态）
- Bonjour/mDNS 配置（是否禁用）
Step 2: 根据结果修复
| 诊断结果 | 执行脚本 |
|---|---|
| Bonjour 导致启动慢 | disable_bonjour.ps1 |
| 进程未运行/崩溃 | restart_gateway.ps1 |
| 端口被占用 | restart_gateway.ps1 -Force |
| 需要查看详细日志 | checkgatewaylogs.ps1 -Lines 100 |
Step 3: 验证结果
修复后重新运行诊断脚本确认问题解决。
脚本索引
| 脚本 | 用途 |
|---|---|
checkgatewaystatus.ps1 |
一键诊断 Gateway 状态 |
checkgatewaylogs.ps1 |
查看 Gateway 日志 |
restart_gateway.ps1 |
干净重启 Gateway |
disable_bonjour.ps1 |
禁用 Bonjour（解决启动慢） |
常见问题速查
Gateway 启动很慢（>1分钟）
根因: Bonjour/mDNS 在 Windows 卡在 announcing 状态 诊断: 检查 discovery.mdns.mode 是否为 off 修复: disable_bonjour.ps1
Gateway 无法访问
诊断: 检查端口 18789 和健康端点 修复: restart_gateway.ps1
端口 18789 被占用
根因: 旧 Gateway 实例未完全退出 修复: restart_gateway.ps1 -Force
进程似乎在运行但 UI 打不开
诊断: checkgatewaylogs.ps1 查看最新错误 常见错误: ERRORELEVATIONREQUIRED（权限问题）、端口冲突
关键路径（需根据实际安装位置修改）
- Gateway 配置:
%USERPROFILE%\.openclaw\openclaw.json - Gateway 启动脚本:
%USERPROFILE%\.openclaw\gateway.cmd - Gateway 日志目录:
%USERPROFILE%\.openclaw\logs - Watchdog 计划任务:
OpenClawGatewayWatchdog