Ops Framework

核心用法

Ops Framework 是专为 OpenClaw 设计的零 Token 运维自动化技能，由 ops-monitor.py 监控脚本与声明式 ops-jobs.json 配置组成。用户通过 JSON 定义任务类型（长时读任务、一次性读任务、一次性写任务）、风险等级与执行策略，脚本则负责任务状态轮询、断点续跑、进度上报及 Telegram 告警。

典型工作流：
1. 配置任务到 ops-jobs.json，指定 kind、risk、commands（start/status/stop）
2. 状态命令必须输出 JSON，包含 running、completed 等字段
3. 通过系统定时器（cron/systemd/launchd）高频调用 ops-monitor.py tick
4. 脚本根据策略自动决策：长时读任务可自动续跑，一次性读任务按需触发，写任务强制阻断待人工审批

显著优点：

• 零 Token 设计：长任务脱离模型持续跟踪，避免上下文消耗
• 安全优先：写操作默认阻断，强制审批+验证链
• 断点续跑：支持崩溃恢复与卡死检测（stall detection）
• 多通道通知：优先使用 openclaw message send，降级至 Telegram Bot API

潜在局限：

• 仅支持 Python 3.10+ 网关主机
• 写任务审批链为 MVP 占位，完整实现需额外开发
• 状态命令需严格遵循 JSON 输出契约，集成成本较高
• 无内置 Web UI，纯 CLI/配置文件驱动

适合人群：OpenClaw 高级用户、自托管网关管理员、需要将大规模扫描/同步任务自动化的开发者

常规风险：状态脚本权限过高可能导致信息泄露；Telegram Bot Token 存储于 openclaw.json 需妥善保管；长任务 PID 监控依赖主机进程表，容器环境需额外适配

核心用法

Ops Framework 是一个专为 OpenClaw 设计的零 Token 作业调度与监控框架，由纯 Python 标准库实现。核心组件包括 ops-monitor.py 监控脚本和声明式的 ops-jobs.json 配置文件。

主要能力：

• 长任务管理：支持 long_running_read 类任务的暂停/恢复（checkpoint/resume），内置卡死检测（stall detection）
• 一次性任务：one_shot_read 用于健康检查，one_shot_write 用于变更操作
• 进度汇报：通过 Telegram Bot 发送定期进度报告和即时异常告警
• 安全控制：写入类任务默认被阻断，必须显式审批并链式执行只读验证任务

使用模式：

# 配置验证
python3 ops-monitor.py validate-config --config-file ~/.openclaw/net/config/ops-jobs.json

# 单次状态检查（不发送消息）
python3 ops-monitor.py tick --print-only

# 通过系统调度器（cron/systemd/launchd）定期执行

显著优点

1. 零 Token 架构：长任务完全在本地 Python 环境执行，模型仅需在异常时介入，大幅降低 API 调用成本
2. 安全优先设计：write_external/write_local 任务默认禁止自动执行，形成"人工审批+自动验证"的双层保护
3. 无依赖部署：纯 Python 3.10+ 标准库，零第三方包，彻底规避供应链攻击
4. 状态持久化：自动维护 ops-monitor.json 状态文件，支持跨进程/跨重启的任务续跑
5. 灵活通知：优先使用 openclaw message send，无缝降级至 Telegram HTTP API

潜在局限

• 仅限监控场景：核心解决"跑任务+看状态"，非通用工作流引擎，不支持复杂依赖编排
• 单机限制：设计为网关主机本地运行，无分布式多节点协调能力
• T3 来源风险：个人开发者维护，无企业/基金会背书，长期维护可持续性待观察
• 配置即信任：subprocess.run() 直接执行配置中的命令，配置被篡改即等同于代码执行
• 有限审计能力：本地状态文件可被手动修改，缺乏防篡改的加密签名机制

适合人群

• 个人开发者/小团队运行 OpenClaw 网关，需要低成本托管长时任务
• 对安全性有基础要求、能接受"显式审批"流程的运维场景
• 偏好极简依赖、可完全本地审计代码的用户

常规风险

| 风险类别 | 说明 | 缓解措施 |

|---------|------|---------|

| 配置注入 | `ops-jobs.json` 被篡改可执行任意命令 | 文件权限控制 + 配置变更审计 |

| 状态投毒 | `ops-monitor.json` 被伪造可绕过卡死检测 | 定期校验状态文件完整性 |

| 凭证泄露 | Telegram Bot Token 存储于 `openclaw.json` | 限制配置文件读取权限 |

| 网络嗅探 | 监控数据通过 Telegram 传输 | 内容仅含作业状态元数据，无敏感业务数据 |

总体评估

该框架在"成本-安全-功能"三角中做出了明确取舍：用显式人工审批换取写入安全，用本地脚本执行换取零 Token 成本，用声明式配置换取可审计性。适合作为 OpenClaw 的"外挂"监控层，但不建议替代企业级调度系统（如 Airflow、Temporal）。