定时任务配置

macOS LaunchAgent（推荐）

macOS 上 crontab 受 SIP 限制，推荐使用 LaunchAgent。

安装脚本会自动生成 plist 到 ~/.openclaw/launchagents-ready/（路径已正确替换）。

如果安装脚本因沙箱权限无法自动复制，请手动执行：

bash

复制已准备好的 plist（路径已替换，无需手动修改）

加载所有服务

验证

服务说明：

管理命令：

bash

停止服务

重启服务

查看日志

Linux crontab

Linux 上可以使用 crontab：

bash
crontab -e

添加以下内容：

bash

OpenClaw 自救套件定时任务

每分钟检查网关（看门狗）

• * /bin/bash $HOME/.openclaw/scripts/gateway-watchdog.sh >> $HOME/.openclaw/logs/cron.log 2>&1

每小时健康检查

每天凌晨3点日志清理

每天凌晨2:30 Git 基线版本

安全配置修改

使用 safe-config-modify.sh 进行配置修改，自动处理通知、备份、验证、回滚：

bash

安全修改配置

查看当前操作状态

重启后恢复检查（watchdog 自动调用）

安全流程：

1. 1. 先发送通知给用户
2. Git 快照备份
3. 记录操作状态（用于重启后恢复）
4. 原子写入配置（先写临时文件，验证 JSON 后替换）
5. 验证配置合法性
6. 重启网关
7. 验证网关运行
8. 失败则自动回滚

配置修改公约（必须遵守）

修改 openclaw.json 前必须按以下流程操作：

1. 1. 备份 → bash ~/.openclaw/scripts/git-tag.sh save-working
2. 检查 → bash ~/.openclaw/scripts/core.sh（确认网关正常）
3. 修改 → 编辑配置文件
4. 验证 → openclaw gateway status
5. 成功 → bash ~/.openclaw/scripts/git-tag.sh save-safe
6. 失败 → bash ~/.openclaw/scripts/git-tag.sh quick-rollback

获取飞书 Webhook

1. 1. 在飞书群聊中，点击右上角「设置」→「群机器人」→「添加机器人」→「自定义机器人」
2. 输入机器人名称（如：OpenClaw 告警）
3. 复制生成的 Webhook URL
4. 填入 ~/.openclaw/notify.conf

告警通知配置

编辑 ~/.openclaw/notify.conf，填入至少一个 Webhook：

bash

飞书机器人 Webhook

Telegram（可选）

TELEGRAMBOTTOKEN=yourbottoken

TELEGRAMCHATID=yourchatid

企业微信（可选）

WECHATWEBHOOKURL=yourwebhookurl

钉钉（可选）

DINGTALKWEBHOOKURL