RK3588 OpenClaw 定时任务踩坑与守护进程方案

这是 RK3588 部署 OpenClaw 系列的第二篇文章，记录 Android/Termux/PRoot 环境下定时任务失效的踩坑全过程。

系列文章目录：

• 第一章 RK3588 部署 OpenClaw 完整记录
• 第二章 RK3588 OpenClaw 定时任务踩坑与守护进程方案（本文）

相关资源：

• 📦Skill 仓库：openclaw-android-scheduler

前言

在上一篇文章中，我们成功在 RK3588 Android 开发板上部署了 OpenClaw AI 网关，并接入了飞书机器人。然而在实际使用过程中，我遇到了一个棘手的问题：定时任务无法触发。

本文详细记录从问题发现、原理分析到最终解决方案的完整过程。涉及 PRoot 容器环境限制、Linux 定时机制差异、Python 守护进程开发等核心知识点。

一、问题现象：定时任务石沉大海

1.1 业务场景

我希望 OpenClaw 能够每天自动推送股票报告：

• 早盘报告：工作日 9:00 推送
• 收盘报告：工作日 15:10 推送

1.2 尝试方案一：OpenClaw 内置 Cron

根据官方文档，OpenClaw 提供了内置的 cron 功能。我创建了/root/.openclaw/cron/jobs.json：

{"version":1,"jobs":[{"id":"stock-morning-report","name":"股票早盘报告","schedule":{"kind":"cron","expr":"0 9 * * 1-5","tz":"Asia/Shanghai"},"channel":"feishu","to":"oc_xxxxxxxxxx","enabled":true}]}

预期：工作日 9:00 自动触发，推送报告到飞书群
实际：到了 9:00，没有任何消息推送

1.3 尝试方案二：系统级 Cron

我尝试在/etc/cron.d/添加定时任务：

# /etc/cron.d/openclaw-stock-report59* *1-5 root python3 /path/to/report.py

结果：同样没有执行，没有任何日志

二、原理分析：为什么定时任务失效

2.1 PRoot 环境架构回顾

回顾我们的部署架构：

Android OS (RK3588) └── Termux 应用 └── Proot Debian 容器 ← OpenClaw 运行在这里

2.2 核心问题：容器环境的限制

踩坑点 1：OpenClaw 内置 Cron 依赖 Systemd

OpenClaw 的 cron 功能设计运行在标准 Linux 环境，需要 systemd 来管理服务。但在 PRoot 容器中：

systemctl statuscron# Failed to connect to bus: No such file or directory

根本原因：PRoot 是用户空间实现的 chroot，没有 PID 1 的 init 系统，systemd 无法运行。

踩坑点 2：系统 Cron 服务未运行

标准 Linux 的 cron 服务（crond）同样依赖 init 系统启动：

servicecronstatus# cron: unrecognized servicesystemctl statuscron# System has not been booted with systemd as init system

结论：在 PRoot 容器中，传统的 cron 机制完全不可用。

踩坑点 3：Heartbeat 机制的不确定性

我尝试使用 OpenClaw 的 Heartbeat 机制，在HEARTBEAT.md中添加检查脚本。但发现：

• Heartbeat 触发频率由服务端控制
• 不一定能在设定的时间窗口内触发
• 无法满足精确到分钟级的定时需求

2.3 环境限制总结

三、解决方案：Python 守护进程

3.1 架构设计

既然外部定时机制都不可用，那就自己实现一个：

┌─────────────────────────────────────────────────────────────┐ │ Python 守护进程 │ │ ┌───────────────────────────────────────────────────────┐ │ │ │ • 自主运行，不依赖 systemd/cron │ │ │ │ • 每分钟检查一次时间 │ │ │ │ • 北京时间（UTC+8）时区处理 │ │ │ │ • JSON 状态文件防止重复执行 │ │ │ └───────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────┘

3.2 核心实现

时区处理（关键！）

RK3588 系统时间是 UTC，但定时任务需要北京时间：

fromdatetimeimportdatetime,timezone,timedelta# 必须显式指定北京时间BEIJING_TZ=timezone(timedelta(hours=8))defget_beijing_now():"""获取当前北京时间"""returndatetime.now(BEIJING_TZ)

踩坑点 4：时区错误导致任务不触发

最初使用datetime.now()获取的是 UTC 时间（北京时间 - 8 小时），导致任务在错误的时间点检查，永远触发不了。

时间窗口设计

使用 5 分钟窗口避免重复执行：

defshould_run_morning():"""早盘报告检查 (9:00-9:05)"""now=get_beijing_now()current_time=now.time()# 9:00-9:05 窗口returndt_time(9,0)<=current_time<=dt_time(9,5)

状态追踪

防止同一天多次执行：

defcheck_already_executed(task_id):"""检查今天是否已执行过"""state=load_state()today=get_beijing_now().strftime('%Y-%m-%d')returnstate.get(task_id,{}).get('last_executed')==today

3.3 完整代码

完整实现已封装为 OpenClaw Skill，仓库地址：

📦github.com/kirk-haodong/openclaw-android-scheduler

使用方法：

# 1. 复制模板cpscripts/daemon_template.py /root/.openclaw/workspace/scripts/stock_scheduler.py# 2. 编辑配置vimstock_scheduler.py# 修改 TASKS 字典配置你的任务# 3. 启动守护进程python3 stock_scheduler.py start# 4. 验证psaux|grepstock_scheduler|grep-vgrepcat/tmp/stock_scheduler.log

四、调试经验与验证

4.1 调试过程记录

第一轮测试：17:00 测试任务

配置：

"test-1700":{"hour":17,"minute":0,"command":"echo 'Test at 17:00'"}

结果：没有收到推送

排查：

# 检查系统时间date# Wed Mar 18 09:00:00 UTC 2026# 检查北京时间TZ=Asia/Shanghaidate# Wed Mar 18 17:00:00 CST 2026

发现：守护进程使用datetime.now()获取的是 UTC 9:00，而非北京时间 17:00！

第二轮测试：修复时区后

修复代码，强制使用 UTC+8：

BEIJING_TZ=timezone(timedelta(hours=8))beijing_now=datetime.now(BEIJING_TZ)

重新测试，成功收到推送！

第三轮测试：18:00 验证

为了确保稳定性，再次设置 18:00 测试：

# 北京时间 18:00[18:00测试]✅ 北京时间18:00测试成功！守护进程正常工作

验证通过！

4.2 守护进程管理命令

# 查看状态psaux|grepstock_scheduler|grep-vgrepcat/tmp/stock_scheduler.log# 重启python3 stock_scheduler.py restart# 停止python3 stock_scheduler.py stop# 手动测试python3 stock_scheduler.py once

4.3 日志样例

[2026-03-18 18:04:33 (UTC 10:04:33)] 守护进程启动 [2026-03-18 18:04:33 (UTC 10:04:33)] 当前北京时间: 2026-03-18 18:04:33 [2026-03-18 18:04:33 (UTC 10:04:33)] 当前UTC时间: 2026-03-18 10:04:33 [2026-03-18 09:00:15 (UTC 01:00:15)] 🚀 执行早盘报告... [2026-03-18 09:00:45 (UTC 01:00:45)] ✅ 早盘报告执行成功

五、踩坑点汇总与解决方案

六、最佳实践

6.1 定时任务配置速查

TASKS={"morning-report":{"hour":9,# 北京时间 9:00"minute":0,"window_minutes":5,# 9:00-9:05 窗口"days":[0,1,2,3,4],# 周一到周五"command":"python3 /path/to/morning.py"},"closing-report":{"hour":15,"minute":10,# 15:10（A股收盘后）"window_minutes":5,"days":[0,1,2,3,4],"command":"python3 /path/to/closing.py"}}

6.2 部署检查清单

• 复制 daemon_template.py 到工作目录
• 配置 TASKS 字典（注意北京时间）
• 启动守护进程：python3 xxx.py start
• 验证进程在运行：ps aux | grep xxx
• 查看日志确认无错误：cat /tmp/xxx.log
• 设置开机自启（可选）：添加到.bashrc

6.3 相关资源

• Skill 仓库：github.com/kirk-haodong/openclaw-android-scheduler
• OpenClaw 官方文档：docs.openclaw.ai
• Termux 文档：termux.dev

总结

在 RK3588 Android 开发板上部署定时任务，最大的坑在于PRoot 容器缺乏 systemd/init 系统，导致所有传统 cron 机制都不可用。

最终的解决方案是自主实现 Python 守护进程：

1. 独立运行，不依赖外部服务
2. 显式处理北京时间（UTC+8）
3. JSON 状态文件防止重复执行
4. PID 文件管理进程生命周期

希望这份踩坑指南能帮助到同样在嵌入式 Android 设备上需要定时任务的开发者。

系列文章：

• 第一章：RK3588 部署 OpenClaw 完整记录
• 第二章：本文

参考资料：

• OpenClaw Android Scheduler
• OpenClaw Documentation
• Python Daemon Pattern