RandyChen1985 OpenClaw Buddy 开发规范与技巧 (Development Skills)
1. 快速启动与隔离测试
本项目使用隔离目录 temp-dev-test/ 进行开发测试，该目录已被 Git 忽略，确保不会污染源代码。
启动/重启 (隔离模式)
在根目录下运行：
./dev.sh
脚本逻辑：
- 自动停止并清理旧的隔离目录和进程。
- 重新创建
temp-dev-test/及其子目录（logs, data, backups）。 - 编译前端并同步产物。
- 将二进制文件和
env配置生成到隔离目录中，并从该目录下启动服务。
停止并清理
当你完成测试后，可以通过以下命令停止进程并彻底删除测试产物：
./dev.sh stop
2. 开发注意事项
- 路径隔离: 所有巡检日志、数据库记录、配置备份现在都位于
temp-dev-test/下，不会出现在根目录。 - Token 认证: 隔离环境的 Token 默认已更新为
openclaw-buddy-2026。 - 静态资源: 每次前端代码修改，都必须通过
./dev.sh触发重新编译。 - 实时日志: 推荐使用
tail -f temp-dev-test/logs/guardian.log观察运行状态。
3. 自动化全量回归测试 (Regression Testing)
在修改核心逻辑（如 API、配置解析或自愈算法）后，必须运行全量测试以确保没有引入 Regression（回归错误）。
运行全量测试
./tests/run_tests.sh
测试特性：
- 沙箱隔离: 自动创建随机命名的临时目录作为工作区，绝对不触碰本地
~/.openclaw或生产配置。 - Mock 模拟: 自动编译并使用 Mock 二进制文件接管
openclaw命令调用，无需安装或启动真实的 OpenClaw 环境。 - 全量覆盖: 覆盖从登录鉴权、资产管理（Bots/Models）、专家市场模板、自愈策略配置到系统硬件监控的所有核心接口。
测试维护建议
- 更新 Mock: 如果您修改了
internal/process中调用的openclaw子命令或预期输出，请同步更新tests/mock_openclaw/main.go。 - 新增用例: 凡是涉及新功能接口的开发，建议在
tests/api_integration_test.go中追加对应的t.Run测试分支。