OpenClaw 系统架构详解

第9部分：Cron Jobs & Nodes

⏰ Cron Jobs (定时任务) - 自动化调度

职责

• 定期执行任务
• 发送提醒
• 自动化维护

任务类型

systemEvent

• 注入系统事件到会话
• 用于主会话（sessionTarget="main"）
• 示例：定期检查、提醒通知

agentTurn

• 运行代理任务
• 用于隔离会话（sessionTarget="isolated"）
• 示例：数据处理、报告生成

会话目标

• main - 主会话（需要 payload.kind="systemEvent"）
• isolated - 临时隔离会话（需要 payload.kind="agentTurn"）
• current - 绑定到当前会话
• session: - 持久化命名会话

调度类型

at (一次性)

{
  "kind": "at",
  "at": "2026-04-07T10:00:00Z"
}

every (间隔)

{
  "kind": "every",
  "everyMs": 3600000,
  "anchorMs": 0
}

cron (Cron 表达式)

{
  "kind": "cron",
  "expr": "0 9 * * *",
  "tz": "Asia/Shanghai"
}

Cron 操作

cron status          # 检查调度器状态
cron list            # 列出任务
cron add             # 创建任务
cron update          # 修改任务
cron remove          # 删除任务
cron run             # 立即运行任务
cron runs            # 查看运行历史
cron wake            # 发送唤醒事件

📱 Nodes (节点) - 移动设备集成

职责

• 连接 iOS/Android 设备
• 提供设备能力（相机、屏幕、位置）
• 支持 Canvas 交互

节点功能

• camera_snap - 拍照
• screen_record - 屏幕录制
• location_get - 获取位置
• notifications_list - 通知列表
• canvas - Canvas 交互

节点连接

• 通过 WebSocket 连接到 Gateway
• 声明 role: "node"
• 提供设备身份和功能
• 需要配对批准

节点配对

1. 在移动设备上安装 OpenClaw 应用
2. 扫描配对二维码
3. 批准配对请求
4. 建立安全连接

节点使用场景

• 拍照识别物体
• 屏幕录制演示
• 获取当前位置
• 查看通知
• Canvas 交互