OpenClaw 自动化配置完全指南:从零搭建高效 AI 工作流
前言
OpenClaw 是一个强大的 AI 助手框架,但要发挥最大效能,需要一套可靠的自动化配置。本文将手把手教你如何配置 OpenClaw 的核心自动化功能,包括:
- 定时模型检查(避免模型失效导致意外)
- 自动化任务推送(到飞书/Telegram/Discord)
- 模型配置健康监控脚本
- 常见问题与解决方案
一、OpenClaw 模型配置详解
OpenClaw 的模型配置文件位于 ~/.openclaw/config.yaml,这是你选择 AI 模型的核心配置。
1.1 基础配置结构
1 | default_model: openrouter/auto |
1.2 模型选择策略
openrouter/auto:自动路由,优先使用可用免费模型中最高性能的hunter-alpha:适合复杂推理、长文档分析(1M context)healer-alpha:支持视觉理解,适合图片+文本混合任务step-3.5-flash:StepFun 旗舰,综合性能最强,免费且稳定
配置建议:
- 至少包含
openrouter/auto作为 fallback - 保留 3-5 个高性能模型,OpenClaw 会自动负载均衡
- 定期检查模型可用性(见下文脚本)
二、定时任务配置(Crontab)
OpenClaw 支持通过系统 crontab 定时执行任务并推送通知。但需要注意环境变量问题。
2.1 常见坑:cron 找不到 node
如果你直接用 openclaw message send 作为 cron 命令,会失败,因为 cron 环境不包含 NVM 的 node 路径。
错误示例:
1 | 0 * * * * openclaw message send ... # ❌ 会静默失败 |
正确做法: 用 bash -l -c 包装,加载完整用户环境
1 | 0 * * * * /bin/bash -l -c "openclaw message send --channel feishu --target <chat_id> --message '内容'" 2>&1 | logger -t tag |
2.2 我的 crontab 配置示例
1 | # 每小时模型检查(已改为每天12:00) |
关键点:
- 使用绝对路径:
/bin/bash -l -c "命令" 2>&1 | logger -t tag将输出重定向到系统日志,便于排查- 测试时先用
openclaw message send手动运行确认成功,再加到 crontab
三、模型维护自动化脚本
我写了一个 model-maintenance.sh 脚本,定期检查 config.yaml 中配置的模型是否在最新的免费模型列表中,并推送报告。
3.1 脚本位置
/Users/zhaojingzhou/.openclaw/workspace/scripts/model-maintenance.sh
3.2 脚本逻辑
- 读取
config.yaml中的模型列表 - 与已知的 28 个 OpenRouter 免费模型对比
- 识别可能失效或过时的模型
- 生成健康报告并推送
- 记录日志
3.3 核心代码片段
1 |
|
3.4 使用方式
1 | # 手动执行 |
四、实际排查案例:cron 任务不执行
问题现象
- crontab 有配置,但从未收到推送消息
- 手动执行命令正常
排查过程
检查 crontab 列表:
1
crontab -l
确认任务存在且时间正确。
检查系统日志:
1
sudo log show --predicate 'eventMessage contains "model-check"' --last 1h
查看 logger 是否有输出。
核心发现:
cron 运行时没有 NVM 环境,openclaw依赖的node不在 PATH 中。解决方案:
将命令改为:1
0 * * * * /bin/bash -l -c "openclaw message send ..." 2>&1 | logger -t model-check
-l表示 login shell,会加载~/.bash_profile或~/.zprofile,从而引入 NVM 的路径。
五、完整自动化架构建议
1 | ┌─────────────────────────────────────────────┐ |
六、最佳实践与提醒
永远用
bash -l -c包装 openclaw 命令- 避免环境变量问题
- 确保 NVM node 可用
测试顺序:
- 手动执行成功 → 加入 crontab → 观察日志 → 验证推送
日志管理:
- 任务输出重定向到
logger - 脚本内部用
tee -a记录本地日志
- 任务输出重定向到
推送内容:
- 简洁、具体、可操作
- 避免空洞的”进展:进行中”
- 包含量化指标和下一步计划
配置管理:
- 修改
config.yaml后立即更新 MEMORY.md 记录 - 模型列表 Keeping 与最新公开数据同步(每月一次)
- 修改
结语
自动化是 OpenClaw 高效运转的基石。正确配置 cron 环境、编写健壮的维护脚本、建立监控体系,能让你的 AI 助手 24/7 稳定运行,及时发现问题并推送告警。
如果遇到类似 “cron 任务不执行” 的问题,优先检查环境变量和 PATH,用 bash -l -c 包装命令几乎总能解决。
附录:我的 crontab 当前配置(2026-03-14)
1 | 0 12 * * * /bin/bash -l -c "/Users/zhaojingzhou/.nvm/versions/node/v22.22.0/bin/openclaw message send --channel feishu --target ou_985eeb07a18725cf9b5d5d9ae63a324d --message '🕐 每日模型检查(12:00):当前所有28个免费模型正常,stepfun/step-3.5-flash:free 仍为 #1。使用量: 1.26T tokens。'" 2>&1 | logger -t model-check |
本文基于真实部署经验整理,转载请注明出处。

















