チャットとツールが動いた次の一手は、N 分ごとの要約・キュー確認・軽いヘルス投稿など予測可能なリズムです。2026 年の OpenClaw ではそれが Heartbeat と HEARTBEAT.md に寄りがちです。本稿は無応答トラブルシュート記事と役割が違う点を明確にします:あちらは doctor とログで静かに失敗したときの順序、こちらは能動的な間隔自動化の境界・リスク・最小スケルトン、launchd との常駐連携、レンタル Mac のスリープ/環境差、VNC で Gateway UI を突き合わせるチェックです。10 本のエラー早見は別記事、TLS 公開はGateway 逆プロキシへ。
Heartbeat が向くユーザー
インストールと初回対話が済み、低頻度で冪等な確認(要約・深さ・合図)を自動化したい人向け。向かない例:無制限クロール、レビューなしの本番書き込み、高価モデルでの高頻度ポーリング。クラウド Mac ではスリープ、GUI 承認、localhost バインドを同時に考え、VNC で一気に可視化します。
痛み:境界・コスト・過信
- スコープ肥大:Heartbeat は定期エージェントターンであり OS cron の全代替ではない。
- thinking と無音:無応答記事と同様、可視テキストなしでコストだけ消えることがある。
- 環境差:対話シェルの export は
launchd子プロセスに自動継承されない。 - スリープ:ノードが眠ると Gateway も間隔も止まる。
- 観測性:「最後に成功した tick」が無いと設定不備をモデルせいにしがち。
判断表
| シナリオ | 土台 | Heartbeat の役割 | 主リスク |
|---|---|---|---|
| 個人ダイジェスト | 単一 Gateway | 低頻度要約 | コスト・チャネルノイズ |
| 小チーム監視 | launchd+ログ | 定期ヘルス | 権限ダイアログ(VNC 推奨) |
| マルチ案件 | ディレクトリ/ポート分離 | インスタンス別ファイル | 秘密の混線 |
| 外向き Webhook | 逆プロキシ+TLS | レート制限必須 | 露出面 |
キー名はリリースで変わるため、openclaw doctor と v2026.4.5 移行記事で突き合わせてください。
7 ステップ導入
# HEARTBEAT.md(例示 — 実運用は公式キーに置換) interval_minutes: 30 channel: <channel-id> on_tick: - summarize_inbox_depth fail_open: false
バージョンと canonical ルート固定
openclaw --version / doctor を記録。
最初は読み取りのみ
本番ミューテーションは後回し。
モデルルートを分ける
巡回は安価モデル、人間トリガーに高性能を。
失敗を可視化
heartbeat_failed など短い理由を同チャネルへ。
launchd で Gateway 監督
launchd チェックリストに沿う。
VNC でコンソール照合
bind とブラウザ到達性を確認。
週次の極小オペログ
時刻・間隔・outbound 成否・設定版。
引用できる事実
関連記事
無応答トラブルシュート、launchd 安定運用、Gateway 逆プロキシ、よくあるエラー 10 解。
VNC 検証と FAQ
- ローカルブラウザでコントロール URL を開けるか
- プライバシー/キーチェーンの未処理ダイアログがないか
- 電源・ロック設定がプロバイダ規約と整合するか
- マルチインスタンスのポートとディレクトリが一致するか
FAQ は head の JSON-LD を参照。
まとめ
Windows や汎用 Linux だけでは macOS 固有の承認と GUI 検証が抜けがちです。実機 macOS デスクトップ上で OpenClaw を動かし VNC で突き合わせると Heartbeat が黒箱になりにくい。短期検証でハードを買わないなら VNCMac の VNC 対応 Mac レンタル と本サイトの launchd/無応答/Gateway 記事の組み合わせが試行錯誤時間を減らしやすいです。