OpenClaw CLI 命令与自动化

本章汇总 OpenClaw 的 CLI 命令、Dashboard 控制台,以及它最具特色的自治运行能力——Heartbeat 心跳、Webhook 与 Cron。


CLI 命令速查

命令作用
openclaw onboard --install-daemon引导配置并安装常驻守护进程
openclaw gateway status查看网关运行状态
openclaw gateway --port 18789指定端口启动网关
openclaw dashboard打开本地 Web 控制台
openclaw --help查看当前版本的完整命令

命令随版本演进,以 openclaw --help 与官方仓库为准。


Dashboard 控制台

openclaw dashboard
# 浏览器访问
http://127.0.0.1:18789/

Dashboard 让你在浏览器里:直接对话、查看会话、管理通道与技能、调整工具策略等。

控制平面通过 WebSocket 监听 :18789。再次强调:仅绑定本地、勿暴露公网,并保持版本更新(见 安全章节)。

此外,OpenClaw 还可通过 CLI、macOS 桌面 App、iOS/Android 节点等多种方式访问。


Heartbeat:让智能体自主运行

这是 OpenClaw 的招牌能力。Heartbeat(心跳)调度器按可配置的间隔"唤醒"智能体,让它无需你提问也能自行工作

心跳触发(默认每 30 分钟)
   → 智能体读取工作区的 HEARTBEAT.md 清单
   → 判断"现在需要做点什么吗?"
   → 需要:执行任务并汇报
     不需要:回应 HEARTBEAT_OK(什么都不做)
  • 默认间隔约 30 分钟;使用 Anthropic OAuth 时约每小时一次
  • HEARTBEAT.md 是你写给智能体的"周期性检查清单"

一个 HEARTBEAT.md 示例

# 每次心跳检查
- 是否有新的高优先级邮件?有则汇总并提醒我
- GitHub 仓库是否有新的 PR 待审?有则通知
- 现在是否到了早上 8 点?是则推送今日待办
# 若以上都无需行动,回应 HEARTBEAT_OK

其他触发方式:Webhook 与 Cron

除了心跳,OpenClaw 的 Agent 循环还能被外部事件触发:

触发源场景
Heartbeat周期性自检与例行任务
Webhook外部系统事件(如 CI 完成、表单提交)实时触发
Cron精确定时任务(如每天 9:00 生成日报)
队友消息聊天平台来消息时触发
Webhook(事件来了)─┐
Cron(到点了)     ─┼─→ Agent 主循环 → 执行 → 通过聊天平台汇报
Heartbeat(心跳)  ─┘

成本与频率的平衡

自主运行很强大,但心跳越频繁、模型越贵,账单增长越快

间隔短 + 贵模型 → 账单飙升(极端情况下可达数千/月)
间隔合理 + 混合模型 + 回退链 → 成本可控

建议:

  • 根据任务实际需要设置心跳间隔,别盲目调到很短
  • 例行轻任务用便宜/本地模型,复杂时再回退强模型(见 配置模型
  • Provider 侧设置消费告警,及时发现异常增长

实践建议

  • HEARTBEAT.md 把"需要被惦记的事"清晰列出,少而精
  • 实时性强的触发用 Webhook,固定时刻用 Cron,例行自检用 Heartbeat
  • 自治任务同样受工具策略约束——高风险动作仍需审批,避免"无人值守时闯祸"
  • 上线自治前,先在 Dashboard 手动跑通整个流程

下一步