核心用法
Quick Test 是一款专为 OpenClaw 生态设计的轻量级系统诊断工具，通过执行基础 Python 脚本快速验证运行环境的完整性与可用性。用户仅需一条命令 python3 scripts/run_tests.py 即可触发全量检测，涵盖 Python 版本确认、工作目录权限、文件系统访问及自定义命令执行等核心环节。
显著优点
1. 零依赖设计：仅依赖 Python 标准库（sys、os、subprocess、datetime、json、pathlib），无需 pip 安装任何第三方包，确保在隔离环境或受限网络中仍可立即使用
2. 即时反馈机制：采用 Pass/Fail 明确标识，输出格式清晰可读，支持 --quiet 静默模式，便于集成到 CI/CD 流水线
3. 灵活扩展性：支持 --test 指定单项测试（date/files/command）及 --command 执行任意自定义命令，满足从基础验证到深度调试的多元场景
4. 双语文档支持：完整提供英文与葡萄牙语说明，降低非英语用户的使用门槛
潜在局限
- 权限敏感：需确保用户对目标目录具备读/执行权限，受限账户可能导致测试误报失败
- 跨平台差异：Linux/macOS/Windows 的行为表现可能存在细微差别，脚本未针对各平台做深度适配
- 功能边界明确：定位为"诊断工具"而非"性能基准测试"，不提供 CPU/内存/IO 压力测试能力
适合人群
- OpenClaw 新手用户：首次部署后快速验证环境完整性
- 技能开发者：开发前后执行回归测试，确保系统状态一致
- 运维人员：排查命令执行异常、路径配置错误等基础环境问题
常规风险
- 命令注入风险：
--command参数直接透传至subprocess，若接受外部输入需严格校验，避免执行恶意指令 - 信息泄露：默认输出包含用户名、工作目录路径等系统信息，在共享日志环境中需评估隐私影响