本文说明:OpenClaw 的自动化能力远不止 cron 定时任务和 webhook 事件触发。本文深度解析更高级的自动化命令:polls(轮询监控)、broadcast groups(广播群组)、channel routing(频道路由)、auth monitoring(认证监控)、Gmail PubSub(邮件实时推送)等,覆盖让 AI 真正 7×24 小时无人值守的全部核心命令。
一、OpenClaw自动化体系全景(六大机制)
💡 自动化核心原则:Push优于Pull
cron 和 polls 是「主动检查」(Pull模式),消耗资源;webhook、Gmail PubSub 是「被动接收」(Push模式),更高效实时。优先选择 Push 模式;当目标服务不支持 Webhook 时,才用 polls 轮询。
二、openclaw polls 命令完整解析
openclaw polls [list|add|remove|status|run]
轮询管理
Q:polls和cron有什么核心区别?什么时候该用polls?
cron 是固定时间执行任务(无论有无变化);polls 是定期检查某个来源是否有变化,只有检测到变化时才触发AI处理。适合polls的场景:监控网站价格变化、检测RSS更新、轮询API状态、监控文件夹新文件出现。
Q:如何通过CLI添加一个HTTP URL轮询任务?
通过聊天指令告诉OpenClaw需求,AI会自动创建poll任务。CLI方式:openclaw polls add --name "价格监控" --url "https://api.example.com/price" --interval 30m --condition "price lt 100" --notify telegram。参数说明:--interval 支持 5m/30m/1h/6h 等格式。
Q:polls list 显示哪些信息?如何识别异常任务?
显示:任务名称、轮询目标、间隔时间、上次运行时间、上次状态(变化/无变化)、连续失败次数。连续失败3次以上的轮询会标红,运行 openclaw polls run <id> 手动触发一次查看详细错误。
Q:polls status 和 polls list 有什么区别?
polls list 显示所有任务配置列表;polls status <id> 显示特定任务实时运行状态:当前是否轮询中、上次检测值、历史变化记录(时间线)、下次运行倒计时。排查单个任务必用 status。
⚠️ Q:polls轮询频繁超时,怎么解决?
常见原因:轮询目标是海外URL(如GitHub API),国内访问不稳定。解决:1) 让OpenClaw通过VPN07代理出口;2) 增加 --timeout 30s 参数;3) 调低轮询频率(延长间隔减少超时概率);4) 改用 webhook 替代polls(如果目标支持)。
三、broadcast广播群组配置与问答
channels.broadcastGroups 配置
多平台广播
Q:broadcast群组是什么?典型使用场景有哪些?
广播群组是预定义的「推送目标集合」,让AI一次发送消息到多个平台和频道。典型场景:每日简报同时推送到Telegram私聊+WhatsApp群+Slack频道;监控告警同时发到运维群+工程师手机;产品公告同时到达所有渠道。
Q:如何在openclaw.json中配置一个广播群组?
在配置文件 channels.broadcastGroups 中定义群组名称和目标列表,例如定义名为"daily-report"的群组,包含telegram chatId、slack channelId、feishu chatId。AI使用broadcast工具调用该群组名称即可同时发送到所有目标平台。
Q:广播消息失败了某个平台,会影响其他平台发送吗?
不会。OpenClaw 对广播群组中的每个目标独立发送,某个平台发送失败(如Slack超时)不会阻止其他平台(Telegram/WhatsApp)正常接收。失败的目标会记录在日志中,可运行 openclaw logs --filter broadcast 查看详情。
四、channel routing频道路由命令详解
channels.routing 路由规则配置
消息路由
Q:channel routing是什么?为什么需要它?
当OpenClaw同时接入多个平台时,routing决定不同来源的消息如何分发到不同的Agent处理。例如:WhatsApp消息路由到"个人助手Agent"(轻松随意);飞书消息路由到"工作Agent"(严格专业);运维监控消息路由到"告警Agent"(紧急优先)。
Q:路由规则支持哪些匹配条件?
支持的匹配条件:channel(来源平台)、sender(发送人ID/手机号)、group(群聊ID)、keyword(消息包含关键词)、time(时间段,如工作时间)。多条件支持AND/OR组合。
Q:channel routing如何与multi-agent结合实现负载均衡?
设置多个同类型Agent(agent-1/agent-2/agent-3),在routing配置中使用 targetAgent: "round-robin" 或 targetAgent: "least-loaded" 策略,OpenClaw会自动将消息分发到负载最低的Agent,避免高峰期单个Agent过载。
五、auth monitoring认证监控命令详解
openclaw security [auth|monitor|alerts]
认证监控
Q:auth monitoring是监控什么的?
Auth Monitoring(认证监控)追踪所有用户向OpenClaw发起的认证尝试,包括:新设备登录尝试、pairing配对请求、token鉴权失败次数。当检测到异常(如短时间内多次失败尝试),自动触发告警并可配置自动封锁来源IP。
Q:如何配置Auth监控的告警阈值?
在配置文件设置 security.authMonitor.maxFailedAttempts: 5(5次失败后告警)、security.authMonitor.windowSeconds: 300(5分钟内计数)、security.authMonitor.alertTo: "telegram"(告警发到哪个频道)。
Q:security命令如何查看当前认证令牌状态?
openclaw security list-tokens:列出所有有效的API令牌及其最后使用时间;openclaw security revoke-token <id>:立即撤销指定令牌;openclaw security rotate-token:轮换Gateway主令牌(提高安全性)。
六、Gmail PubSub邮件实时推送命令详解
Gmail PubSub + Google Cloud Pub/Sub 集成
邮件自动化
Q:Gmail PubSub和普通邮件轮询有什么区别?
传统邮件轮询(polls):每隔X分钟检查收件箱,有延迟且消耗资源。Gmail PubSub:通过Google Cloud Pub/Sub订阅Gmail变更推送,邮件到达后实时(秒级)通知OpenClaw——真正的即时响应,无需频繁轮询。
Q:配置Gmail PubSub需要哪些步骤?
配置步骤:1) 在Google Cloud Console启用Gmail API和Cloud Pub/Sub API;2) 创建Pub/Sub Topic和Subscription;3) 在Gmail账号设置"监视"(watch)指向该Topic;4) 在OpenClaw配置 automation.gmail.pubsubSubscription 填入Subscription名称;5) 告诉AI需要自动处理的邮件规则。全程需要VPN07确保访问Google API稳定。
Q:Gmail watch会过期吗?如何自动续期?
是的,Gmail watch 默认7天过期(Google限制)。OpenClaw 通过 cron 任务自动每6天续期一次(openclaw cron list 可看到)。如果续期失败(常见于网络不稳定),PubSub会停止推送,运行 openclaw logs --filter gmail 排查。
七、自动化故障排查命令汇总
openclaw polls list / status / run检查轮询任务是否正常运行,手动触发验证配置
openclaw hooks list / test验证webhook端点是否配置正确并可接收事件
openclaw logs --filter automation过滤自动化相关日志,快速定位失败原因
openclaw doctor --check automation运行专项自动化诊断,检查全部自动化组件状态