从入门到24/7无人值守:openclaw-runbook的OpenClaw长期稳定运行进阶路线图

原创2026-10-15 06:07:131,935 阅读

从入门到24/7无人值守:openclaw-runbook的OpenClaw长期稳定运行进阶路线图

想让 OpenClaw 从"能跑的聊天机器人"进化成"能跑好几周不宕机"的长期稳定运行系统?开源项目 openclaw-runbook 正是为此而生的非官方运维手册(runbook)。它基于作者踩过的坑,给出一套可预测的 OpenClaw 进阶路线图:私有化访问、显式模型路由、原生任务与记忆系统、安全护栏,最终实现 24/7 无人值守运行。本文将按"入门 → 加固 → 自动化 → 无人值守"四阶段带你走完这条路 🛤️

第1步:正确入门,3条命令完成 OpenClaw 初始化

很多不稳定的根源在起步阶段就没埋好。官方推荐用当前的 onboarding 流程一键装好守护进程:

openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard

几个新手容易踩的坑(详见 guide.md):

  • 当前文档推荐 Node 24(Node 22.19+ 仍受支持),版本不对后面全是泪;
  • 建议用稳定版安装,而不是自己 checkout 源码——源码安装会多出一堆"活动部件";
  • 从源码运行时,把个人配置放在 ~/.openclaw/openclaw.json、工作区放在 ~/.openclaw/workspace,这样更新不会覆盖你的提示词、记忆和 skill 成果。

💡 记住一句话:把 OpenClaw 当基础设施运维,而不是当聊天机器人用。这是整个 runbook 的灵魂。

第2步:建立私有访问边界——Tailscale 优先,永远别裸奔 Gateway

这是 runbook 最强调的一点:Gateway 保持 loopback 绑定 + token 认证,远程访问走 Tailscale。不要用公开端口、不要随意暴露到局域网。

推荐配置骨架(完整可参考 examples/vps-setup.md 的完整清单):

{
  "gateway": {
    "mode": "local",
    "bind": "loopback",
    "auth": { "mode": "token" },
    "tailscale": { "mode": "serve", "resetOnExit": true }
  }
}

关键操作顺序(VPS 场景):

  1. 本地和 VPS 都装好 Tailscale;
  2. 先验证 Tailscale SSH 可用,再封掉公网 22 端口——顺序反了你就把自己锁在外面了;
  3. 用 lsof -nP -iTCP:18789 -sTCP:LISTEN 确认监听在 loopback 而不是 0.0.0.0。

不想用 Tailscale?那就保持 Gateway 本地化,用 Telegram 等消息渠道做远程交互,而不是"顺手开个公网端口"。安全基线和审计流程见 examples/security-hardening.md。

第3步:显式模型路由,从源头控制成本

新手最常犯的错:把一个默认 agent 当成"全能超级助理",聊天、研究、编码、监控全压给最强的模型。结果 token 烧得飞快,成本没法算。

runbook 推荐的模式是显式路由 + 协调者/工人分工(参考 examples/sanitized-config.json):

  • agents.defaults.models 是模型目录/白名单,保持小到你看得懂;
  • agents.defaults.model.primary 是默认跑的主模型,fallbacks 是有顺序的故障转移列表;
  • 后台任务、心跳检查交给廉价模型,复杂推理才用强模型;
  • 不要先买 Mac mini / GPU 盒子跑本地模型——先用真实用量数据证明本地推理能省钱,再买硬件。

showcases 目录把模型分成了 cheap / balanced / strong / local 四档,做任务前先对号入座,参考 showcases/README.md 里的选型表。

第4步:用原生记忆与任务系统,让长期运行"看得见"

24/7 运行的前提是状态可查。OpenClaw 的记忆就是文件,不是魔法:

  • MEMORY.md:持久事实、偏好、决策(保持高信号密度);
  • memory/YYYY-MM-DD.md:每日笔记和工作上下文;
  • 压缩上下文前会默认触发一次 memory flush,把重要状态写进记忆文件。

任务侧则用原生 task ledger,别再外接黑盒:

openclaw tasks list
openclaw tasks show <lookup>
openclaw tasks audit

cron 执行、子代理派生都会产生任务记录,这比"从聊天回复里猜 agent 在干嘛"可靠得多。完整说明见 examples/task-tracking-prompt.md。

第5步:配置 Heartbeat 与 cron,双引擎驱动周期性自动化

这是无人值守的核心引擎。两者的分工很明确:

机制 用途 特点
Heartbeat 近似周期的感知(收邮件、看日历、轻监控) 默认 30m 一次,HEARTBEAT_OK 可抑制空转回复
Cron 精确时间的一次性提醒 / 定时报表 每次都产生后台任务记录

低成本心跳的推荐组合是 lightContext: true + isolatedSession: true + skipWhenBusy: true——不塞整个对话历史、忙时自动让路。多个检查项可以用 HEARTBEAT.md 里的 tasks: 块各自设间隔,而不是每次都全跑一遍,模板见 examples/heartbeat-example.md。

一个 cron 例子(每日晨报):

openclaw cron add \
  --name "Daily brief" \
  --cron "0 7 * * *" \
  --session isolated \
  --message "Prepare my daily brief from weather, calendar, and active tasks."

第6步:安全与成本护栏,为 24/7 上"保险"

让 agent 无人值守之前,先做三件事:

① 定期跑安全审计(每次改完配置都要再跑一次):

openclaw doctor --fix
openclaw security audit --deep

② 防提示注入要分层:如果你的 OpenClaw 会读网页、邮件、issue 等外部内容,就默认提示注入迟早会来——限制谁能跟机器人说话、限制每个渠道能用哪些工具、文件系统访问收窄、不可信内容只当数据不当指令。规则示例见 examples/security-patterns.md。

③ 盯住账单:在各 provider 后台设置硬性支出上限;仓库里还附了配额检查辅助脚本 examples/check-quotas.sh(用法见 examples/check-quotas-README.md),记得"provider 后台的限额才是真正的账单刹车"。

第7步:先稳定,再 24/7——渐进式上线节奏

runbook 的忠告很直白:别一开始就搞全量 always-on。

推荐节奏是:

  1. 先让本地或 Tailscale 环境稳定跑起来,观察几天日志、成本、任务记录;
  2. 然后一次只加一块:先加 cron,再加 heartbeat,再逐步放更宽的工具权限;
  3. 每次改动前后各提交一次配置备份(git 管理 ~/.openclaw,但别提交凭据),出问题可秒回滚。

当你确认它的失败模式都摸清了,就可以参考社区贡献的自愈合模式 showcases/autonomous-operation.md:主会话保持"薄"、派生监控子代理用廉价模型每 5 分钟体检、cron 兜底自动重启,实现 7 小时以上无人干预运行。更多可改造的自动化场景见 showcases/daily-brief.md、showcases/idea-pipeline.md 等。

进阶路线资料清单 📚

阶段 文档 作用
总览 guide.md 主指南:接入、路由、记忆、安全全覆盖
配置 examples/sanitized-config.json 脱敏后的真实可用配置参考
配置解读 examples/config-example-guide.md 逐节讲解配置含义
安全 examples/security-quickstart.md 快速应用基础护栏
远程 examples/vps-setup.md VPS + Tailscale 完整清单
自动化 examples/spawning-patterns.md 子代理派生最佳模式
技能 examples/skill-builder-prompt.md 自建本地 skill 而非盲装第三方
排错 examples/model-delegation-troubleshooting.md 模型委托问题排查

⚠️ 最后一句提醒:examples/ 里的配置是参考而非模板,provider、模型、渠道、skill 条目都要按你自己的环境改;第三方 skill 保持"看源码 → 本地重建"的姿势,比点安装按钮慢,但安全得多。

按这份路线图走完,你的 OpenClaw 就不再是一个会炸的演示玩具,而是可以托付一整夜、甚至一整周的长期稳定运行基础设施了 🚀

登录后查看全文
openclaw-runbook