自动化
Clawdbot 提供多种自动化触发机制,让您的代理可以主动执行任务,而不仅仅是响应消息。
自动化方式
定时任务 (Cron)
网关内置的调度器,支持:
- 一次性提醒(指定时间触发)
- 周期性任务(每天、每周等)
- 标准 cron 表达式
Webhooks
HTTP 端点用于外部触发:
- 接收外部服务通知
- 集成第三方应用
- 自定义工作流
Gmail 集成
通过 Google Pub/Sub 实现邮件触发:
- 新邮件通知
- 自动处理邮件
- 邮件分类和回复
心跳 (Heartbeat)
定期检查和主动任务:
- 定时检查任务列表
- 主动执行待办事项
- 系统健康监控
Cron vs Heartbeat
| 特性 | Cron | Heartbeat |
|---|---|---|
| 触发方式 | 精确时间点 | 固定间隔 |
| 上下文 | 隔离会话或主会话 | 主会话 |
| 适用场景 | 定时报告、提醒 | 持续监控、任务检查 |
| 输出投递 | 可配置投递到聊天 | 通过主会话回复 |
快速示例
每日早间摘要
clawdbot cron add \
--name "Morning summary" \
--cron "0 7 * * *" \
--tz "Asia/Shanghai" \
--session isolated \
--message "总结今日日程和待办事项" \
--deliver \
--channel whatsapp \
--to "+8613800138000"20 分钟后提醒
clawdbot cron add \
--name "Quick reminder" \
--at "20m" \
--session main \
--system-event "提醒:检查邮件回复" \
--wake now \
--delete-after-run