Scheduled Tasks | 定时任务

Scheduled Tasks 技能 | 定时任务技能

OpenClaw + 飞书定时任务解决方案 Version | 版本: 2.1.7 Author | 作者: 9527 License | 许可证: MIT

Overview | 概述

This 技能 helps you 创建, manage, and troubleshoot scheduled tasks in OpenClaw. It supports two 应用roaches: OpenClaw Cron API (recommended for 代理 tasks) and 系统 Crontab (for shell scripts).

本技能帮助您创建、管理和调试 OpenClaw 定时任务。支持两种方式：OpenClaw Cron API（推荐用于 代理 任务）和系统 Crontab（适用于 Shell 脚本）。

When to Use | 使用场景 Scenario Use OpenClaw Cron Use 系统 Crontab One-time reminder (X minutes later) ✅ --at ❌ Scheduled 代理 task with reply ✅ --announce ⚠️ Complex Scheduled shell script execution ⚠️ Possible ✅ Direct Requires 代理 thinking/工具s ✅ ✅ via OpenClaw 代理 Multiple 代理s ✅ --代理 ✅ --代理 模型/thinking override ✅ --模型 --thinking ❌ Auto-retry on 失败 ✅ Built-in ❌ Manual 场景 用 OpenClaw Cron 用系统 Crontab 一次性提醒（X 分钟后） ✅ --at ❌ 定时让 代理 执行任务并回复 ✅ --announce ⚠️ 复杂 定时执行 Shell 脚本 ⚠️ 可以 ✅ 更直接 需要 代理 思考和工具调用 ✅ ✅ 通过 OpenClaw 代理 需要指定不同 代理 ✅ --代理 ✅ --代理 需要模型/思考级别覆盖 ✅ --模型 --thinking ❌ 任务失败自动重试 ✅ 内置 ❌ 需自行处理

Principle | 原则: Prefer OpenClaw Cron unless the task is essentially 运行ning a script without 代理 involvement. 优先使用 OpenClaw Cron，除非任务本质是运行脚本且不需要 代理 参与。

Quick 启动 | 快速开始 One-Time Reminder | 一次性提醒 # Remind in 20 minutes | 20 分钟后提醒 OpenClaw cron 添加 \ --name "Water Reminder | 喝水提醒" \ --at "20m" \ --会话 mAIn \ --系统-event "Time to drink water! 💧 | 主人，该喝水了 💧" \ --wake now \ --删除-after-运行

DAIly Scheduled Task | 每日定时任务 # DAIly news briefing at 08:00 | 每天 08:00 新闻播报 OpenClaw cron 添加 \ --name "DAIly News | 每日新闻" \ --cron "0 8 " \ --tz "Asia/ShanghAI" \ --会话 isolated \ --代理 <代理-id> \ --message "搜索 today's news and 发送 to user | 搜索今日新闻并推送" \ --announce \ --channel feishu \ --to "user:"

Method 1: OpenClaw Cron API (Recommended) | 方式一：OpenClaw Cron API（推荐） Basic Commands | 基础命令 # 列出 all tasks | 查看所有任务 OpenClaw cron 列出

# 运行 task manually | 手动触发任务 OpenClaw cron 运行

# View 运行 历史 | 查看运行历史 OpenClaw cron 运行s --id

# Edit task | 编辑任务 OpenClaw cron edit --message "New message | 新消息"

# Disable task | 禁用任务 OpenClaw cron edit --enabled false

# 移除 task | 删除任务 OpenClaw cron 移除

Common Patterns | 常见模式 Pattern 1: One-Time Reminder | 一次性提醒 OpenClaw cron 添加 \ --name "Meeting Reminder | 会议提醒" \ --at "2026-03-27T09:00:00+08:00" \ --会话 mAIn \ --系统-event "Meeting at 9 AM! | 9 点有会议，请准备" \ --wake now \ --删除-after-运行

Pattern 2: DAIly 代理 Task | 每日 代理 任务 OpenClaw cron 添加 \ --name "DAIly News | 每日新闻" \ --cron "0 16 " \ --tz "Asia/ShanghAI" \ --会话 isolated \ --代理 <代理-id> \ --message "搜索 today's news | 搜索今日新闻" \ --announce \ --channel feishu \ --to "user:"

Pattern 3: Weekday 报告 | 工作日报告 OpenClaw cron 添加 \ --name "DAIly Work 报告 | 今日工作简报" \ --cron "55 22 1-5" \ --tz "Asia/ShanghAI" \ --会话 isolated \ --message "Summarize today's work | 整理今天完成的工作" \ --announce \ --channel feishu \ --to "user:"

Method 2: 系统 Crontab + OpenClaw 代理 | 方式二：系统 Crontab + OpenClaw 代理 Script Template | 脚本模板

创建 script at scripts/dAIly-task.sh:

#!/bin/bash # DAIly scheduled task script | 定时任务脚本 # Cron: 0 16 (DAIly at 16:00 | 每天 16:00)

设置 -e

导出 PATH="/usr/local/bin:/usr/bin:/bin:$PATH" SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

echo "[$(date '+%Y-%m-%d %H:%M:%S')] Task 启动ed | 任务开始..."

OpenClaw 代理 \ --代理 <代理-id> \ --deliver \ --reply-account \ --reply-to "user:" \ -m "Your task message | 你的任务指令"

echo "[$(date '+%Y-%m-%d %H:%M:%S')] Task completed | 任务完成"

添加 to Crontab | 添加到 Crontab # Edit crontab | 编辑 crontab crontab -e

# 添加 line (dAIly at 16:00 | 每天 16:00) 0 16 /path/to/scripts/dAIly-task.sh >> /tmp/task-name.记录 2>&1

Cron Expression Reference | Cron 表达式速查 ┌───────── Minute (0-59) | 分 │ ┌─────── Hour (0-23) | 时 │ │ ┌───── Day of month (1-31) | 日 │ │ │ ┌─── Month (1-12) | 月 │ │ │ │ ┌─ Day of week (0-7, 0&7=Sunday) | 周 │ │ │ │ │

0 9 DAIly at 09:00 | 每天 09:00 0 9 1-5 Weekdays at 09:00 | 工作日 09:00 /30 Every 30 minutes | 每 30 分钟 0 9,16 DAIly at 09:00 and 16:00 | 每天 09:00 和 16:00 0 0 1 First day of month | 每月第一天

Common Pitfalls & Solutions | 常见陷阱与解决方案 ⚠️ Pitfall 1: Missing Delivery Tar获取 | 缺少投递目标 # ❌ WRONG | 错误 OpenClaw 代理 --代理 x --deliver -m "message" # Error: "Delivering to Feishu requires tar获取"

# ✅ CORRECT | 正确 OpenClaw 代理 --代理 x --deliver \ --reply-account \ --reply-to "user:" \ -m "message"

⚠️ Pitfall 2: Message Position | Message 位置错误 # ❌ WRONG | 错误 OpenClaw 代理 --代理 x --deliver "message"

# ✅ CORRECT | 正确 OpenClaw 代理 --代理 x --deliver -m "message"

⚠️ Pitfall 3: Timezone Missing | 缺少时区 # ❌ WRONG (defaults to UTC) | 错