核心用法
gigo-lobster-doctor 是 OpenClaw 生态中的环境诊断前置工具,专为「先体检、后试吃」场景设计。用户触发「龙虾体检」类指令后,系统会直接调用 wrapper 脚本 run_doctor.py,在 1-3 分钟内完成四项关键检查:
1. Gateway 连通性:验证与 GIGO 服务端的网络握手
2. Python/运行时依赖:确认解释器版本、关键包完整性
3. 题包链路:测试题目数据包的下载与解析通道
4. PNG 证书能力:预检报告生成所需的图形渲染栈(优先检测 PNG,支持 SVG 降级)
执行全程流式输出进度,日志实时写入 ~/.openclaw/workspace/outputs/gigo-lobster-doctor/gigo-run.log,支持 tail -n 50 追踪。默认仅做环境检查,不触发正式 benchmark、不上传数据,适合 CI 前置节点或本地开发调试。
显著优点
- 零侵入设计:不修改系统环境,仅读取检查,失败时快速定位卡点
- 多平台适配:Darwin / Linux / Win32 全支持,自动探测
python3→python→py链 - 双语原生:通过
--lang zh/en自动匹配用户语言,无需额外配置 - 可扩展人格:支持
--lobster-name与--lobster-tags自定义输出风格,或读取SOUL.md实现品牌一致性
潜在局限
- 非性能基准:不跑完整试吃,无法评估实际算力得分;需配合
gigo-lobster-taste获取评分 - 长时静默容忍:设计为 15-25 分钟常驻进程监控, impatient 用户可能误判为卡死
- 日志体积风险:
gigo-run.log可能膨胀,禁止全文件读取,需严格使用tail流式查看
适合人群
- 首次部署 OpenClaw 的新用户,想快速验证「能不能跑」
- CI/CD 维护者,需要在正式 benchmark 前做预检闸门
- 企业内网环境,需提前确认代理、证书、Python 隔离等合规项
常规风险
| 风险点 | 说明 |
|--------|------|
| 路径注入 | 要求绝对路径调用 wrapper,禁止 `cd && python` 组合,避免 preflight 拦截 |
| 进程误杀 | 静默期勿主动 kill,需等待 wrapper 自行退出或用户显式取消 |
| 语言歧义 | 未显式指定 `--lang` 时,需从触发词推断中英文,存在误判可能 |
| 上传误操作 | 默认 `--skip-upload` 行为,若用户手动覆盖需二次确认,防止误传敏感环境信息 |