核心用法
gigo-lobster-doctor 是 GIGO 生态的环境体检模式,专为"正式试吃"前的配置验证设计。用户触发后(如"龙虾体检"或"lobster doctor"),系统直接执行指定目录下的 run_doctor.py 包装器,完成四项关键检查:
1. Gateway 连通性:验证与 GIGO 服务端的网络通道
2. Python 运行时依赖:检测 python3/python/py 可用性及必要库
3. 题包链路:确认任务分发的数据通道正常
4. PNG 证书能力:验证结果凭证的图像生成环境(支持 SVG fallback,可用 --require-png-cert 强制 PNG)
执行时优先使用绝对路径直接调用,禁止 cd && python 组合(OpenClaw 预检会拦截)。语言参数 --lang zh/en 自动根据用户输入追加。
显著优点
- 零副作用:默认仅检查不跑分、不上传,适合 CI/CD 前置步骤
- 快速反馈:流式输出进度,用户可实时感知阻塞点
- 灵活配置:支持自定义龙虾人设(
--lobster-name/tags)、输出目录与上传行为覆盖 - 长时友好:体检流程通常短暂,但代码已适配 15-25 分钟的长跑监控模式,日志实时 tail 不占用内存
潜在局限
- 非完整基准:不执行实际推理负载,无法验证 GPU/性能瓶颈
- 依赖外部 Python:要求系统预装
python3/python/py之一,纯容器环境需提前准备 - 证书降级风险:若环境缺 PNG 库且未显式
--require-png-cert,会自动降级 SVG,可能不符合某些审计要求
适合人群
- 首次部署 GIGO Lobster 的新用户,想确认"我的环境能跑吗"
- CI/CD 管理员,需在正式 benchmark 前做健康检查
- 多机群运维,快速筛查网关或证书配置漂移
常规风险
- 路径注入:需确保
run_doctor.py路径可信,避免用户可控输入拼接绝对路径 - 日志泄露:
gigo-run.log含环境信息,共享输出时建议审查敏感字段 - 进程误判:长时体检中 stdout 静默属于正常,自动化 kill 逻辑会误伤任务
---
> 技术来源:OpenClaw 官方技能仓库 gigo-lobster-doctor,属于 GIGO 基准测试生态的配套诊断工具。