Read Policy 是一个专为 OpenClaw 系统设计的轻量级命令行工具,用于从本地 Supabase Docker 环境中读取策略配置。该工具通过连接运行在 `supabase-db` 容器内的 PostgreSQL 数据库,直接访问 `public.openclaw_policies` 表,实现对关键策略键的快速查询与审计。其设计初衷并非用于生产环境修改,而是作为开发、测试和运维过程中的辅助检查手段,帮助团队快速验证策略是否按预期加载。通过简单的脚本调用,用户可以在不登录数据库管理工具的情况下,实时获取如 `auto_approve`、`priority_routing` 等核心配置项的当前值,极大提升了调试效率。整个流程完全本地化,无需依赖外部服务或网络请求,确保了操作的安全性和可重复性。
核心功能特点
- 支持通过命令行读取单个策略键值(如 auto_approve)
- 提供批量列出所有可用策略键的功能
- 直接连接本地 Supabase Docker 栈中的 PostgreSQL 数据库
- 仅用于策略数据的查看与检查,不具备写入权限
- 基于 shell 脚本实现,易于集成到自动化流程中
适用场景
Read Policy 工具特别适用于需要频繁验证策略配置正确性的开发场景。例如,在本地开发 OpenClaw 功能模块时,开发者可能希望确认某个新添加的策略键是否已成功写入数据库,或检查优先级路由规则是否生效。此时,无需启动完整的前端界面或使用复杂的 SQL 客户端,只需执行一条命令即可快速获取结果,显著缩短反馈周期。对于运维人员而言,该工具也极具价值——当线上出现异常行为而怀疑是策略配置错误导致时,可通过本地环境模拟查询,快速定位问题根源,避免盲目排查。此外,在 CI/CD 流水线中,也可将其集成为轻量级校验步骤,确保部署前策略状态符合预期。由于其仅具备只读能力且依赖本地 Docker 环境,因此非常适合在隔离的测试环境中使用,既保障了数据安全性,又提升了操作便捷性。
