跳到主要内容

OpenClaw 定时任务教程

开始前请先完成 使用前准备 目录下的 [01-外设硬件配置]、[02-openclaw Ajetson-KEY配置]、[03-openclaw切换模型]、[04-AI语音交互配置]、[05-三种对话方案配置测试]。如果当前只使用 TUI / 飞书，可以先跳过 04。本文默认基础环境已经准备完成，只展开“固定时间自动执行脚本”这部分内容。

1. 教程目标​

本文通过“AI 生成脚本 + Linux 定时执行”的方式，展示 OpenClaw 如何从即时对话进一步升级为自动化外设应用。完成本教程后，读者可以：

  • 了解 OpenClaw 定时任务的基本实现思路

  • 区分 HEARTBEAT 和 cron 各自适合的场景

  • 通过飞书、TUI、语音代码三种方式描述自动化需求

2. 硬件准备​

  • OpenClaw 主控板

  • DHT 温湿度传感器

  • OLED 显示屏

  • RGB 灯带 / RGB 灯珠模块

  • [可选] CSI 摄像头

  • [可选] AI语音模块 + 扬声器

说明：

  • 本教程的核心是“定时执行”，不是强制要求全部外设同时接入

  • 你想做哪一类自动化任务，就先接好对应硬件

3. 测试定时任务基础能力​

开始当前项目之前，请先完成一次 openclaw tui 基础对话自检；如果还没做，先看 [05-三种对话方案配置测试]。通过后，再进入定时任务专项测试。

建议按下面顺序测试：

  1. 先进入 OpenClaw TUI

  2. 让 OpenClaw 生成一个简单脚本

  3. 在终端手动运行脚本，确认功能正常

终端输入：

openclaw tui

建议先尝试下面这类需求：

  • 帮我写一个脚本，把当前温湿度显示到 OLED，保存到桌面

  • 生成一个每次运行时都读取温湿度并打印结果的脚本

  • 写个脚本让 RGB 亮绿灯 3 秒后熄灭

脚本生成后，先手动运行，例如：

xxxxxxxxxx python3 /home/jetson/Desktop/your_script.py

4. 和 OpenClaw 对话的三种方案​

方案适合场景优点建议定位
飞书远程描述自动化需求适合先说清楚“想定时做什么”用来生成脚本和确认需求
TUI本地创建与调试定时任务最容易联调脚本和 cron首选落地方案
语音代码语音描述自动化场景更贴近桌面助手体验适合展示“说一句话生成自动化”

如果选配了AI语音模块+扬声器，飞书对话、tui、whatsapp对话需要播报openclaw回复的内容，可以终端运行下面的程序，ai语音模块对话不需要重复运行

  • 修改是否打开播报参数

xxxxxxxxxx /home/jetson/voice_to_openclaw/.env xxxxxxxxxx ENABLE_TTS = true #这个参数就是控制是否播报，修改完保存，终端运行下面程序

  • 终端输入

xxxxxxxxxx cd ~/ voice_to_openclaw source . venv / bin / activate python \- m src . openclaw_session_tts

image-20260529194211404

4.1 飞书方案​

飞书接入步骤请直接参考 [05-三种对话方案配置测试]。本节更适合用来描述需求，例如：

  • 帮我做一个定时任务：每一分钟让 RGB 亮红灯提醒之后关灯

image-20260428191042352

4.2 TUI 方案​

如果已经完成第 0 篇中的 TUI 自检，直接进入终端文字对话：

xxxxxxxxxx openclaw tui

然后可以直接输入项目相关指令，例如：

  • 帮我做一个定时任务：每分钟读取温湿度并显示到oled上

image-20260428191030929

4.3 语音代码方案​

xxxxxxxxxx 需要选配 ai 语音交互模块 + 扬声器

语音模块安装、环境配置和基础唤醒流程请直接参考 [04-AI语音交互配置]。唤醒之后，可以直接说出控制内容，例如：

  • 帮我做一个定时任务：每分钟读取温湿度并显示到oled上

image-20260529194236118

  • 如果想关闭定时任务，可以和当前对话的会话里说帮我停止当前的定时任务

image-20260511194439572

  • 可以用指令 cron list 查看当前的定时任务

image-20260511194516325

5. 项目实现​

注意：下面都是在 openclaw tui 方式进行对话演示，你也可以自己选择飞书或语音方式来完成。

5.1 场景一：每小时温湿度采样​

实验目标​

让设备每小时自动读取一次温湿度，并记录结果或同步到屏幕。

效果说明​

这是最基础也最常见的定时任务场景，后续可以继续扩展成日志、仪表盘、环境告警或植物看护项目。

示例指令​

  • 帮我做一个定时任务：每分钟读取温湿度并显示到oled上

5.2 场景二：定时状态提醒​

实验目标​

在固定时间用 RGB 或 OLED 做一次明确提醒。

效果说明​

这类任务适合做喝水提醒、上课提醒、巡检提醒、状态切换提醒。它不强调持续运行，而强调在某个时间点触发一个清晰动作。

示例指令​

  • 帮我做一个定时任务：每一分钟让 RGB 亮红灯提醒之后关灯

5.3 场景三：定时巡检脚本​

实验目标​

把多个外设动作串起来，形成一个可周期执行的小型自动化任务。

效果说明​

例如每小时读取一次温湿度，如果状态异常就亮灯提醒，并把结果显示到 OLED。这类任务已经接近一个完整的小项目，也是“AI 生成脚本”与“定时执行”结合最明显的地方。

示例指令​

  • 帮我做一个定时任务：每分钟读取一次温湿度，异常时亮红灯，并在 OLED 上提示