自动化

刚接触自动化？有关实践操作和分步教程，请查看我们的 自动化教程。此页面是涵盖所有自动化特性和配置选项的综合参考。

OpenClaw 通过 Webhook、Cron 任务和钩子提供强大的自动化能力。这些特性允许你创建自动化的工作流，根据事件触发操作，并与外部服务集成。

Webhooks 允许外部服务触发 OpenClaw 操作：

• 接收事件 - 接受来自外部服务的 Webhook 调用
• 触发操作 - 根据 Webhook 有载荷执行 Agent 任务
• 集成服务 - 与 GitHub、Sentry、监控工具等连接。

Webhook 配置

AutomationPage.webhooks.configDesc

{
  "webhooks": {
    "enabled": true,
    "entries": {
      "github-alerts": {
        "provider": "github",
        "secret": "YOUR_WEBHOOK_SECRET"
      }
    }
  }
}

使用场景

• PR 审查和问题管理的 GitHub Webhooks
• 错误监控和自动修复的 Sentry Webhooks
• 自定义 API 集成
• 事件驱动的自动化

Cron 任务允许自动运行计划任务：

• 计划任务 - 按计划运行任务 (每天、每周等)
• 后台处理 - 执行长时间运行的任务
• 定期检查 - 监控系统、检查状态等。

Cron 任务配置

使用 CLI 添加 Cron 任务：

# Daily briefing
openclaw cron add --name "Morning brief" --cron "0 9 * * *" --session isolated --message "Daily briefing"

# Status check
openclaw cron add --name "Status check" --cron "*/30 * * * *" --session main --system-event "check-status" --wake now

Cron 与 Heartbeat

OpenClaw 支持两种调度机制：

• Cron 任务: 计划任务的传统 Cron 语法
• Heartbeat: 具有可配置间隔的持续监控

对于特定的时间基准任务使用 Cron，对于持续监控使用 Heartbeat。

钩子允许你拦截并修改事件：

• 消息钩子 - 在 Agent 处理前后处理消息
• 事件钩子 - 响应系统事件
• 转录钩子 - 处理语音提示和音频

Gmail Pub/Sub 钩子

OpenClaw 可以通过 Pub/Sub 与 Gmail 集成：

• 接收实时电子邮件通知
• 自动处理电子邮件
• 根据电子邮件内容触发操作
• 管理收件箱和回复

在你的工作区配置 Gmail Pub/Sub 以实现电子邮件自动化。

每日简报

安排总结你一天的每日简报：

openclaw cron add \
  --name "Daily Briefing" \
  --cron "0 9 * * *" \
  --session isolated \
  --message "Create my daily briefing" \
  --deliver \
  --channel last

错误监控

设置 Webhook 以自动修复来自 Sentry 的错误：

• 通过 Webhook 接收错误通知
• Agent 分析错误
• 自动创建修复或打开 PR
• 在解决时通知你

GitHub 自动化

自动化 GitHub 工作流：

• 自动审查 PR
• 在提交期间运行测试
• 管理问题和标签
• 在成功构建时部署

• 1
  从简单开始在进行复杂的 Webhook 之前，先从基础的 Cron 任务开始。
• 2
  彻底测试先在安全的环境中测试自动化。
• 3
  监控日志留意自动化的执行日志。
• 4
  错误处理确保自动化能够优雅地处理故障。
• 5
  速率限制留意 API 速率限制。
• 6
  安全使用身份验证保护 Webhook 端点。