本指南汇总了 OpenClaw 各自动化模块Cron、Hooks、Webhooks、Polls的常见故障及排查步骤。遇到自动化任务异常时请按照以下分类逐步排查。通用诊断命令在深入排查之前先运行以下命令获取全局状态# 查看 Gateway 运行状态 openclaw status # 查看自动化模块总览 openclaw automation status # 查看最近的错误日志 openclaw logs --level error --limit 50 # 导出诊断报告 openclaw diagnose --output ~/openclaw-diag.jsonCron 任务不触发症状定时任务已配置但到达执行时间时没有运行。排查步骤1. 检查任务是否启用openclaw cron list确认目标任务的STATUS列为enabled。如果显示disabled重新启用openclaw cron enable --id job_id2. 检查时区设置时区是最常见的问题超过 50% 的 Cron 不触发 问题是时区配置错误导致的。# 查看 Gateway 系统时区 openclaw config get timezone # 查看任务配置的时区 openclaw cron info --id job_id确保timezone字段与你期望的一致。推荐显式设置openclaw cron edit --id job_id --timezone Asia/Shanghai3. 验证 Cron 表达式# 预览未来 5 次执行时间 openclaw cron preview --id job_id --count 5如果输出的时间不符合预期说明 Cron ExpressionCron 表达式有误。4. 检查 Gateway 是否在运行openclaw gateway statusCron 由 Gateway 管理Gateway 离线时所有 Cron 任务暂停。5. 查看运行日志openclaw cron runs --id job_id --limit 10检查是否有失败记录及错误原因。Hooks 不触发症状事件已发生但 Hook 处理函数没有被调用。排查步骤1. 确认 Hook 已被发现openclaw hooks list如果目标 Hook 不在列表中检查Hook 目录结构是否正确需包含HOOK.md和handler.ts放置路径是否正确Workspace:/hooks/Managed:~/.openclaw/hooks/2. 检查事件名称是否匹配openclaw hooks info hook-name确认HOOK.md中声明的events与实际触发的事件名完全匹配。常见拼写错误message:recieved❌ →message:received✅command:new_command❌ →command:new✅agent:init❌ →agent:bootstrap✅3. 检查 handler.ts 语法# 检查是否有 TypeScript 编译错误 openclaw hooks validate hook-name4. 查看 Hook 执行日志openclaw logs --source hooks --limit 205. 检查同名覆盖高优先级的 Hook 会覆盖低优先级同名 Hook。确认没有 Workspace Hook 意外覆盖 Managed Hook。Webhooks 返回错误症状外部系统调用 Webhook 端点返回 4xx 或 5xx 错误。排查步骤401 - 认证失败# 验证 Token 是否正确 openclaw config get webhooks.token # 测试请求 curl -v -X POST https://your-gateway.com/hooks/wake \ -H Authorization: Bearer YOUR_TOKEN \ -d {text: test}确认请求中的 Token 与配置一致。注意Token 前后不要有多余空格。400 - 请求格式错误检查Content-Type是否为application/json请求体是否为合法 JSON# 使用 jq 验证 JSON 格式 echo {text: test} | jq .429 - 速率限制# 查看当前速率限制配置 openclaw config get webhooks.rateLimit如果是合法流量适当调高限制{ webhooks: { rateLimit: { maxRequests: 200, windowMs: 60000 } } }500 - 服务器内部错误# 查看 Gateway 错误日志 openclaw logs --source gateway --level error --limit 10Polls 不运行症状轮询任务已配置但没有周期性检查数据源。排查步骤1. 确认 Polls 模块启用openclaw config get polls.enabled2. 检查具体 Poll 配置openclaw polls list确认目标 Poll 状态为enabled间隔配置合理。3. 测试数据源连通性# 手动执行一次轮询 openclaw polls run --name poll-name如果报网络错误检查数据源地址是否可访问防火墙/代理配置是否正确认证凭据是否有效4. 检查状态文件# 查看 Poll 状态 openclaw polls status --name poll-name如果状态文件损坏可重置openclaw polls reset --name poll-name日志分析技巧按模块过滤日志# Cron 日志 openclaw logs --source cron --limit 30 # Hooks 日志 openclaw logs --source hooks --limit 30 # Webhooks 日志 openclaw logs --source webhooks --limit 30 # Polls 日志 openclaw logs --source polls --limit 30按时间范围查看# 查看过去 1 小时的日志 openclaw logs --since 1h --level error # 查看特定时间段 openclaw logs --from 2026-03-05T08:00:00 --to 2026-03-05T09:00:00开启调试模式# 临时开启 Debug 级别日志 openclaw config set logLevel debug # 排查完成后恢复 openclaw config set logLevel info调试模式性能影响Debug 级别日志会显著增大日志文件体积并略微影响性能排查完成后请务必恢复为info级别。常见问题速查表问题可能原因快速解决所有自动化都不工作Gateway 未运行openclaw gateway startCron 时间偏移时区未设置添加timezone字段Hook 无输出handler 内部异常添加try/catch并查看日志Webhook 401Token 不匹配核对环境变量和请求头Poll 重复处理状态文件丢失检查存储路径权限OAuth Token 失效未启用自动刷新启用autoRefresh《AI提示工程必知必会》为读者提供了丰富的AI提示工程知识与实战技能。《AI提示工程必知必会》主要内容包括各类提示词的应用如问答式、指令式、状态类、建议式、安全类和感谢类提示词以及如何通过实战演练掌握提示词的使用技巧使用提示词进行文本摘要、改写重述、语法纠错、机器翻译等语言处理任务以及在数据挖掘、程序开发等领域的应用AI在绘画创作上的应用百度文心一言和阿里通义大模型这两大智能平台的特性与功能以及市场调研中提示词的实战应用。通过阅读《AI提示工程必知必会》读者可掌握如何有效利用AI提示工程提升工作效率创新工作流程并在职场中脱颖而出。