核心用法
gigo-lobster-doctor 是 OpenClaw 生态中的环境预检工具,专为 GIGO 龙虾 benchmark 设计。它执行"体检模式"(doctor mode),在不启动完整试跑的前提下,验证四项关键能力:
1. Gateway 连通性 — 确认与 GIGO 服务端的网络通道
2. Python/运行时依赖 — 检查 Python 版本及必要包
3. 题包链路 — 验证任务包(task-bundle)的可访问性
4. PNG 证书能力 — 确认结果可视化与证书生成环境
执行方式直接调用 wrapper 脚本:python3 /path/to/run_doctor.py --lang zh/en,无需切换目录。工具内置流式进度反馈,日志写入 ~/.openclaw/workspace/outputs/gigo-lobster-doctor/gigo-run.log。
显著优点
- 零侵入诊断:不触发正式 benchmark,不消耗算力配额,不上传结果
- 快速定位故障:将环境常见问题(网络、依赖、权限、格式支持)前置暴露
- 双语原生支持:通过
--lang参数无缝切换中英文输出 - 可定制身份:支持
--lobster-name与环境变量配置个性化龙虾 persona - 与 OpenClaw 深度集成:自动识别预检限制,避免
cd && python等被拦截的写法
潜在局限
- 非功能测试:仅验证环境"能否跑",不验证"跑得对不对"
- 依赖本地 Python:需预装 python3/python/py,不自带运行时
- PNG/SVG 证书二选一:默认允许 SVG 回退,严格 PNG 需显式
--require-png-cert - 长耗时仍可能:虽轻量于完整 benchmark,但网络与依赖检查在慢速环境仍需数分钟
适合人群
- 首次配置 GIGO 龙虾的用户:在正式跑分前排除环境雷区
- CI/CD 维护者:作为前置 gate,防止环境不合规的 benchmark 进入队列
- 多机/多账号管理者:批量验证不同节点的 Python 与网络配置一致性
常规风险
- 日志膨胀:
gigo-run.log可能随多次运行累积,监控时应使用tail -n 50而非全量读取 - 进程误判:doctor 模式运行时间可能超出直觉,需避免"静默即卡死"的过早中断
- 覆盖链复杂:身份配置涉及 CLI 参数 → 环境变量 →
SOUL.md→ 默认值的四级回退,调试时需逐层排查