Gateway Restart Profiler

OpenClaw Gateway 重启性能分析工具。分析 Gateway 重启速度、排查启动慢的原因、生成性能报告、诊断启动问题。支持 Windows (PowerShell) 和 Linux (Bash) 平台。触发场景包括：分析 gateway 重启、检查启动时间、gateway 太慢了、生成性能报告、诊断 gateway 启动问题、Gateway 启动优化、OpenClaw 性能分析。

分析 OpenClaw Gateway 重启时的各阶段耗时，生成性能报告并给出优化建议。

支持平台

• Windows: PowerShell 5.0+
• Linux: Bash 4.0+, 需安装 bc 计算器

使用方法

Windows

powershell -ExecutionPolicy Bypass -File <skill>/scripts/gateway-profile.ps1

Linux

bash <skill>/scripts/gateway-profile.sh

代理调用方式

当用户要求分析 Gateway 重启性能时，OpenClaw 代理应使用以下方式调用：

Windows：

exec(command="powershell -ExecutionPolicy Bypass -File <skill>/scripts/gateway-profile.ps1", elevated=true)

Linux：

exec(command="bash <skill>/scripts/gateway-profile.sh", elevated=true)

其中 <skill> 应替换为实际路径，例如：

• Linux: /home/tstj/.openclaw/workspace/skills/gateway-restart-profiler
• Windows: C:\Users\<user>\.openclaw\workspace\skills\gateway-restart-profiler

代理调用时会自动重启 Gateway（先 stop 再 start），监听日志解析各阶段耗时，生成 HTML 可视化报告和文本摘要。

输出内容

1. 实时日志监控 - 高亮显示各启动阶段
2. HTML 可视化报告 - Chart.js 图表（柱状图 + 饼图）
3. 详细数据表 - 含耗时百分比和可视化进度条
4. 优化建议 - 自动识别超过30秒的阶段并给出建议
5. 文本摘要 - 保存到 temp 目录

分析的阶段

阶段	说明
配置加载	读取 openclaw.json
身份验证	连接认证服务
HTTP服务	启动 Web 服务
Canvas	Canvas 挂载
MCP服务	MCP 协议服务
心跳服务	心跳监控
模型加载	加载 AI 模型
频道启动	启动 QQ/Telegram 等频道
插件系统	加载插件

优化建议解读

阶段耗时	可能原因
配置加载 > 30s	配置文件过大或损坏
身份验证 > 30s	网络问题或认证服务故障
模型加载 > 30s	Ollama 响应慢，建议换用 API 模式
频道启动 > 30s	QQ/Telegram 连接异常
插件系统 > 30s	npm 依赖缺失，需重新安装

日志文件位置

• Windows: C:\Users\<user>\AppData\Local\Temp\openclaw\
• Linux: ~/.openclaw/logs/

示例输出

HTML 报告（用浏览器打开）包含：

• 📊 耗时分布饼图 - 各阶段占总耗时比例
• 📈 横向柱状图 - 按耗时排序，一目了然
• 📋 详细数据表 - 毫秒/秒/占比/可视化进度条
• 💡 优化建议 - 超过30秒的阶段高亮提示

控制台同时输出：

阶段耗时明细 (按耗时降序):
  频道启动           45000ms (45s)   ########################
  模型加载           32000ms (32s)   ################
  配置加载           12000ms (12s)   #########

优化建议:
  - [频道启动] 检查QQ/Telegram连接是否正常
  - [模型加载] Ollama响应慢，考虑换用API模式

[HTML图表报告已保存: ~/.openclaw/logs/gateway-profile-2026-04-12.html]
  → 用浏览器打开 HTML 文件查看可视化图表！