本文说明：OpenClaw 最强大的特性是「主动性」——它不只是被动回答问题，还能定时执行任务（cron）、响应外部事件（hooks/webhooks）、主动发消息（message）、打电话（voicecall）。本文深度解析所有自动化相关命令，让你的 AI 助手真正实现 24/7 自动工作。
一、OpenClaw自动化体系概览
二、openclaw cron 命令详解
openclaw cron [list|add|remove|enable|disable|run]
定时任务
Q：openclaw cron add 如何添加定时任务？格式是什么？
格式：openclaw cron add --schedule "0 9 * * *" --message "早报总结" --target +86138xxxxxxxx
# 每天早9点发送日报
openclaw cron add --schedule "0 9 * * *" --message "生成今日日报" --target main
# 每小时检查一次服务状态
openclaw cron add --schedule "0 * * * *" --message "检查服务是否正常" --target main
# 每周一提醒
openclaw cron add --schedule "0 10 * * 1" --message "本周工作计划" --target main
Q：cron 任务的时区是哪里？如何设置？
默认使用服务器本地时区。通过配置文件中的 timezone 字段设置，例如 "timezone": "Asia/Shanghai"。也可在 cron add 时加 --timezone Asia/Shanghai 参数。
Q：cron 和 Heartbeat 有什么区别？
cron 是精确时间触发（Cron表达式控制）；Heartbeat 是 OpenClaw 按固定间隔（如每2小时）主动联系你，不需要精确时间，更像「AI的主动签到」。cron 适合定时任务，heartbeat 适合让 AI 保持活跃存在感。
Q：cron run <id> 有什么用？
立即手动触发一个定时任务（不等待计划时间），常用于测试 cron 任务是否配置正确。类似「提前执行」。
Q：cron 任务定时执行失败，没有收到消息怎么排查？
排查步骤：① openclaw cron list（确认任务状态是 enabled）→ ② openclaw cron run <id>（手动触发测试）→ ③ openclaw logs --level error（查看执行日志）→ ④ 检查网络是否能访问 AI API（cron 执行也需要 AI 网络）。
三、openclaw hooks 命令详解
openclaw hooks [list|add|remove|test]
事件触发器
Q：hooks 能响应哪些事件类型？
OpenClaw hooks 可以监听多种内部事件：message.received（收到新消息）、agent.started/stopped（代理启停）、session.created（会话创建）、tool.executed（工具执行完毕）、error.occurred（发生错误）等。用 openclaw hooks list --events 查看全部可用事件。
Q：hooks 如何配置错误发生时自动通知我？
# 错误发生时发送Telegram通知
openclaw hooks add \
--event error.occurred \
--action notify \
--target telegram:main
# Agent停止时记录日志
openclaw hooks add \
--event agent.stopped \
--action log
Q：hooks test <id> 是干什么的？
用模拟数据立即触发指定 hook，验证 hook 配置是否正确（不需要等待真实事件发生）。配置新 hook 后先用 test 验证，再投入使用。
四、Webhook 配置详解
Webhook接入：POST https://your-host:18789/webhook/<token>
外部触发
Q：OpenClaw 的 Webhook 如何配置？能接收哪些服务的推送？
OpenClaw Gateway 内置 Webhook 端点，第三方服务（GitHub、Stripe、Sentry、Gmail PubSub等）可以直接 POST 到这个地址触发 AI 处理。在 openclaw.json 中配置：
{
"webhooks": {
"github": {
"secret": "your-secret",
"message": "GitHub收到新PR：{{payload.title}}"
}
}
}
Q：Webhook 接收到推送但 AI 没有响应，怎么排查？
常见原因：① Gateway 端口（18789）未对外开放——检查防火墙/路由器端口映射；② Secret 不匹配——检查配置的 secret 和第三方配置的是否一致；③ 网络不通——推荐用 Tailscale 或 ngrok 建立安全隧道，避免直接暴露端口。
Q：Gmail PubSub webhook 如何配置让 AI 实时处理邮件？
OpenClaw 有专门的 Gmail PubSub 集成（docs.openclaw.ai/automation/gmail-pubsub）：在 Google Cloud Console 配置 PubSub 订阅，推送到 OpenClaw Webhook 端点。新邮件到达时 AI 自动收到通知并处理。
五、openclaw message 命令详解
openclaw message send --target <目标> --message <内容>
主动发消息
Q：message send 可以发到哪些目标？格式是什么？
--target +15555550123
发送到电话号码（WhatsApp）
--target telegram:@username
发送到 Telegram 用户
--target discord:channelId
发送到 Discord 频道
--target main
发送到主会话（默认频道）
Q：message send 和 AI 主动发消息是一回事吗？
CLI 的 openclaw message send 是由脚本/人工触发，直接发送内容；AI 主动发消息通常通过 cron + 内置工具实现（AI 执行完任务后用工具发消息）。两种方式互补：CLI 适合外部脚本集成，AI 工具适合任务完成后自动通知。
六、openclaw channels 命令详解
openclaw channels [list|login|logout|status|test]
频道管理
Q：channels login 如何连接 WhatsApp/Telegram？
WhatsApp：执行 openclaw channels login --provider whatsapp，会显示 QR 码，用手机 WhatsApp 扫码配对。Telegram：执行 openclaw channels login --provider telegram，输入 Bot Token（从 @BotFather 获取）。Discord：输入 Discord Bot Token 和服务器 ID。
Q：channels status 能看到什么？
显示所有已配置频道的连接状态：已连接（connected）/断连（disconnected）/认证过期（auth_expired）/等待配对（waiting_pair）。断连的频道不会收发消息，需要重新 login。
Q：WhatsApp 频道频繁断开怎么解决？
WhatsApp Web 连接对网络稳定性要求高。断连通常由以下原因导致：① 手机端 WhatsApp 退出登录；② 网络波动导致 WebSocket 断开；③ WhatsApp 检测到长时间无活动。建议确保 Gateway 所在机器有稳定的 1000Mbps 千兆网络，减少连接中断。
Q：channels test 命令怎么用？
向指定频道发送测试消息：openclaw channels test --provider telegram。收到测试消息说明频道连接正常；没收到则用 openclaw logs 查看发送错误。
七、openclaw voicecall 命令详解
openclaw voicecall [make|status|hangup]
语音通话
Q：OpenClaw 的语音通话功能是什么？怎么用？
OpenClaw 可以主动给你打电话（通过 ElevenLabs 等 TTS + 电话 API）！openclaw voicecall make --target +8613800000000 --message "提醒您会议即将开始"，AI 会用语音播报消息。通话结束后 voicecall hangup <call-id> 挂断。
Q：voicecall 需要配置哪些第三方服务？
需要：① TTS 服务（ElevenLabs/OpenAI TTS）用于语音合成；② 电话服务商（Twilio/Vonage）用于实际拨号。在 openclaw.json 中配置各自的 API Key。需要稳定网络保证 TTS API 和电话服务可靠访问。
八、openclaw plugins 命令详解
openclaw plugins [list|install|uninstall|update]
插件管理
Q：plugins 和 skills 有什么区别？
Skills：AI 执行的「工作流脚本」，定义 AI 能做什么任务（如「查天气」「写日报」）；Plugins：扩展 Gateway 功能的「系统级插件」，添加新的频道支持（如 Mattermost 插件添加 Mattermost 频道）或系统级能力。Skills 在对话层，Plugins 在基础架构层。
Q：openclaw plugins install 如何安装社区插件？
执行 openclaw plugins list --available 查看可安装的社区插件；openclaw plugins install mattermost 安装指定插件；安装后重启 Gateway 生效。安装过程需要访问 npm registry（需稳定网络）。
九、自动化任务24/7运行，网络稳定是基础
⏰ 自动化任务失败的常见网络原因
🏆 VPN07 — 自动化任务的最佳网络伴侣
VPN07 提供 1000Mbps 千兆带宽和十年稳定运营经验，70+ 国家节点覆盖所有 AI API 服务器。无论是深夜 cron 任务、实时 webhook 处理还是 24/7 频道维持，VPN07 都能确保网络不掉线，让自动化任务100%可靠执行。