必须使用launchd配置：launchagent适用于用户登录后定时任务，launchdaemon可实现合盖唤醒与无人值守运行，二者均需正确编写plist文件并加载服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 macOS 上让 OpenClaw 按固定时间自动执行任务（比如每天早8点抓取邮件、每小时同步一次笔记），必须绕过其默认的 Heartbeat 机制，直接对接系统级调度框架 launchd——否则合盖睡眠后任务必然中断，且无法保证精确触发。
配置 LaunchAgent 实现用户登录态定时唤醒
此方式适用于你本人登录 macOS 后长期保持账户活跃的场景，任务随用户会话启动，无需 root 权限，适合日常办公自动化。
打开终端，进入用户服务目录：cd ~/Library/LaunchAgents
创建任务配置文件：nano com.openclaw.daily-report.plist
粘贴以下内容（【务必把 /Users/yourname/.openclaw 中的 yourname 替换为你真实的用户名】）：
保存退出：Control+O → 回车 → Control+X。
加载服务：launchctl load ~/Library/LaunchAgents/com.openclaw.daily-report.plist
立即测试执行：launchctl start com.openclaw.daily-report
启用 LaunchDaemon 实现合盖唤醒与无人值守运行
当你需要 OpenClaw 在电脑合盖、休眠甚至未登录状态下仍准时执行关键任务（如凌晨备份数据、定时上传日志），必须使用系统级守护进程 LaunchDaemon。它由 root 权限管理，可响应电源状态变化并唤醒系统。
完整备份 OpenClaw 配置目录 (.openclaw) 到同名带时间戳的目录，包括所有文件和隐藏文件。当用户需要备份 OpenClaw 配置、数据或创建配置快照时使用。
第一步：将 OpenClaw 的 CLI 工具路径加入系统 PATH。编辑 /etc/paths.d/openclaw，写入：/usr/local/bin（若你用 brew 安装）或 /opt/homebrew/bin（Apple Silicon 默认路径）。
第二步：创建系统级配置文件：sudo nano /Library/LaunchDaemons/com.openclaw.backup.plist
第三步：填入以下内容（注意 【Key 和 ProgramArguments 必须严格对齐缩进，任意空格错位会导致 launchctl load 失败】）：
第四步：赋予读权限：sudo chmod 644 /Library/LaunchDaemons/com.openclaw.backup.plist
第五步：加载并启动：sudo launchctl load /Library/LaunchDaemons/com.openclaw.backup.plist → sudo launchctl start com.openclaw.backup
验证与故障排查
检查任务是否注册成功：launchctl list | grep openclaw。若返回空行，说明 plist 文件未被识别，重点检查文件路径、命名是否含非法字符、XML 格式是否闭合。
查看最近一次执行日志：tail -20 /var/log/openclaw-backup.log。如果日志为空但 launchctl list 显示 PID，说明 OpenClaw CLI 未正确安装或未加入 PATH。
强制触发一次（仅限 LaunchAgent）：launchctl kickstart -k user/$(id -u)/com.openclaw.daily-report。LaunchDaemon 不支持 kickstart，需用 start 命令。
若任务在睡眠后未唤醒，确认系统设置中已开启「唤醒以供网络访问」和「电源适配器供电时允许唤醒」：前往「系统设置」→「电池」→「电源适配器」→ 勾选对应选项。
