适用于 Openclaw 的 Openclaw Scheduler

一个持久化的、基于 SQLite 的编排运行时，用于调度带自动重试和人工审批的多步骤 Shell 命令与 AI Agent 工作流。

amittell

v1.0.0

2026年6月1日

安装

基本信息

Skill.md

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。


                  npx clawhub@latest install durable-scheduler

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式

~/.openclaw/skills/

工作区

<project>/skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。


                  请帮我使用 Clawhub 安装 durable-scheduler。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

更倾向于下载？

获取包含原生技能文件的ZIP压缩包。

什么是 Openclaw Scheduler？

Openclaw Scheduler 是一款先进的企业级编排运行时，专为需要稳健、可审计工作流调度的开发者和运维人员设计。它作为一个基于 SQLite 的独立守护进程 (ai.openclaw.scheduler) 运行，确保任务在网关重启或系统故障后依然能持续运行。通过将复杂自动化从基础内置调度器中解耦，它实现了标准 Shell 命令和智能 Agent 任务的无缝执行。

作为 Openclaw Skills 生态的重要补充，该调度器在执行多步骤流水线方面表现出色。它能安全地管理依赖关系，妥善处理重试，支持人工参与的审批门控，并维护完整、持久的执行历史。它是生产级自动化理想的工具，能够满足对绝对可见性、可靠性和细粒度控制的需求。

Openclaw Scheduler 应用场景

弹性任务调度：需要完整的运行历史记录和审计追踪，而不是在标准系统日志中检索。
多步骤事件响应：工作流需要执行 Shell 命令、将输出馈送至 AI 诊断 Agent，并在应用修复命令前暂停等待人工操作员审批。
持久化网关独立执行：确保关键后台检查即使在中心服务器宕机或重启时也能运行。
隔离的 Agent 操作：用于执行自动化报告任务，而不会干扰活跃的交互式工作区聊天。

Openclaw Scheduler 工作原理

服务初始化：调度器使用 Node.js 22+ 作为独立服务守护进程 (ai.openclaw.scheduler) 持久运行，并使用轻量级 SQLite 数据库来维护状态。
任务定义：用户通过命令行界面定义基于 cron 或按需触发的任务以及多步骤工作流。
执行与排队：触发时，调度器会评估网关状态。如果调度了 Agent 步骤但网关离线，它将执行稳健的 waitForGateway 循环，将任务安全保留在队列中，直到恢复通信。
工作流链式执行：多步骤工作流按顺序执行，将之前的 Shell 命令输出馈送到后续的 AI Agent 中。
状态与审批检查：对于需要人工审查的步骤，执行将暂停，通知指定操作员，并等待通过 CLI 发出的手动审批/拒绝指令。
日志与持久化：每次运行的 stdout、stderr 以及步骤转换都会被捕获并存储在本地数据库中，以实现完整的审计能力。

Openclaw Scheduler 配置指南

请遵循以下步骤在系统上初始化并运行调度器：

使用 npm 全局安装该包：

npm install -g openclaw-scheduler

初始化数据库和配置文件，创建 SQLite 数据库并启动 Agent 配置：

openclaw-scheduler init

使用 launchd (macOS/Unix 环境) 引导服务：

launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/ai.openclaw.scheduler.plist

验证调度器是否已启动、正在运行并与数据库通信：

openclaw-scheduler jobs list

定义一个已调度的 Agent 任务：

openclaw-scheduler jobs add \
  --name "weekly digest" \
  --cron "0 9 * * 1" \
  --kind agent \
  --to "@channel-id" \
  --prompt "Summarize last week's incidents and post to #digest"

Openclaw Scheduler 数据架构与分类体系

调度运行时在本地存储状态、任务定义和运行日志。其数据架构结构如下：

位置	文件 / 资源	描述
`~/.openclaw/scheduler/`	目录	包含所有配置、任务和执行数据的根文件夹。
`~/.openclaw/scheduler/scheduler.db`	SQLite Database	存储配置、工作流定义、状态、重试和步骤转换记录。
`~/Library/LaunchAgents/ai.openclaw.scheduler.plist`	launchd Service Plist	映射到 Node.js 22+ 运行时的服务守护进程配置。

运行历史分类

每次执行的任务都会保留标准操作详情，包括运行持续时间、步骤索引、转换时间戳以及明确的 stdout/stderr 输出，以便通过命令行界面进行开发者调试。

Openclaw Scheduler 高级特性

多步骤工作流链式执行：设计序列，让步骤将输出馈送至后续步骤，实现诸如 shell:check -> agent:diagnose -> approval -> shell:remediate 的复杂模式。
智能网关重连：使用自定义的 waitForGateway(timeoutMs, intervalMs) 逻辑，允许已调度的任务在网关重启后存活，而不会静默失败。
人工审批步骤：定义带有可配置超时时间 (--timeout 30m) 的人工参与门控，以及用于审批或拒绝转换的自定义触发器。
故障处理与重试：内置的弹性重试机制确保间歇性的网络问题不会中断关键的自动化流程。
共存与混合模式：可以与基础 cron 工具并排运行，或完全取代内置工具以处理关键的 Openclaw Skills 任务。