OpenClawのHeartbeat設定入門｜Cronと運用の基本

OpenClawのHeartbeatは、標準では30分ごとにHEARTBEAT.mdを確認し、必要なチェックやタスクを動かすための仕組みです。OpenClawの初期設定を進める中で、Cronとの違いや設定ファイルの書き方が見えにくくて、ここで手が止まる人は多いかなと思います。

特に、HEARTBEAT.md、SOUL.md設定、検索設定、性格設定まで一緒に触り始めると、どこまで自動化してよいのか少し不安になりますよね。設定変更は環境によって差が出るため、まずは役割を分けて、小さく安全に動かす前提で見ていくのが現実的です。

OpenClawのHeartbeat設定の基本

OpenClawのHeartbeatは、エージェントを一定間隔で起こして、ワークスペース内の指示を確認させるための仕組みです。ざっくり言うと、あなたが毎回声をかけなくても、OpenClaw側が「今見るべきことはあるかな」と定期的に確認する動きですね。

ただし、何でも自動化すれば便利になるわけではありません。Heartbeatは、HEARTBEAT.mdや設定ファイルの書き方次第で通知が増えたり、余計なLLM呼び出しにつながったりします。まずは、何を任せる機能なのか、Cronとどう違うのか、どこを設定すればよいのかを順番に押さえていきます。

Heartbeatでできること

Heartbeatは、OpenClawのエージェントに定期的な確認タイミングを持たせる機能です。調べた範囲では、標準的な考え方としては30分ごとに起動し、ワークスペース内のHEARTBEAT.mdを読み、そこに書かれたチェック内容を実行する流れです。正確な仕様や最新の設定値は変わる可能性があるため、正確な情報は公式サイトをご確認ください。

たとえば、未確認のタスクを見直す、直近のメモを整理する、異常があれば知らせる、改善ログに1件だけ追記する、といった使い方に向いています。大事なのは、Heartbeatを長い作業の実行役にしすぎないことです。定期チェックや軽い整理に寄せた方が、運用は安定しやすいですよ。

Heartbeatで任せやすいこと

何も報告することがない場合は、HEARTBEAT_OKのような短い応答で終える設計にしておくと、通知のうるささを減らしやすくなります。ここを曖昧にすると、30分ごとに似たようなメッセージが届いて、使う側が疲れてしまうかもしれません。

私なら、最初は「1回のHeartbeatで1つだけ確認する」くらいに絞ります。OpenClawのHeartbeat設定は、便利さよりも先に暴走しないこと、通知を増やしすぎないこと、勝手に設定変更しないことを優先した方が扱いやすいです。

Cronとの使い分け

HeartbeatとCronはどちらも定期実行に関わりますが、役割はかなり違います。Heartbeatは「だいたい一定間隔で様子を見る」ための仕組みで、Cronは「決まった日時に決まった処理を走らせる」ための仕組み、と考えると分かりやすいです。

たとえば、30分おきにタスク状況を軽く確認するならHeartbeatが向いています。一方で、毎朝8時にレポートを送る、毎週月曜9時に分析する、20分後にリマインドする、といった時刻が重要な処理はCronの方が合います。

HeartbeatとCronの違い

Cronで登録したジョブでも、実行結果が必ずSlackやDiscord、DMに届くとは限りません。通知が必要な場合は、ジョブ側で「誰に、どの形で送るか」を明確にしておくのが大事です。OpenClawの設定では、deliveryのような配信設定も確認対象になります。

一方、Heartbeatは「何かあったら知らせる」くらいの温度感が合います。毎回レポートを出すよりも、問題がないときは黙って終わる、必要なときだけ短く知らせる、という運用の方が続けやすいです。

迷ったら、時刻が重要ならCron、状態確認が目的ならHeartbeatで分けるとシンプルです。最初から全部をHeartbeatに寄せるより、役割を分けておく方が後から見直しやすいですよ。

初期設定で見る項目

OpenClawのHeartbeat設定を始める前に、まず見るべきなのは設定ファイル、ワークスペース、エージェントの役割です。設定ファイルだけを触っても、HEARTBEAT.mdが空だったり、対象エージェントが違っていたりすると、期待した動きになりません。

よく出てくる設定場所は、~/.openclaw/openclaw.jsonのようなOpenClawの設定ファイルです。記事データで確認した範囲ではJSON5形式の例もあり、agents.defaults.heartbeatに共通設定を書く方法や、agents.listの特定エージェントだけにheartbeatを書く方法が紹介されています。

初期設定で確認したい項目

特に注意したいのは、agents.defaults.heartbeatに設定すると、複数エージェントへまとめて適用される可能性がある点です。実務担当のmainまで自律的に動いてしまうと、役割が混ざることがあります。安全寄りにするなら、監督役のops/coachだけにHeartbeatを持たせる設計が分かりやすいです。

また、OpenClawの初期設定ではWeb検索、ファイル操作、ブラウザ操作、メモリ検索なども関係してきます。Heartbeatから検索やファイル確認をさせたい場合は、必要なツールが有効か、APIキーや権限が正しいかも見ておきましょう。ただし、外部送信や投稿につながる操作は、勝手に実行させない方が安全です。

最初の設定では、便利機能を一気に入れるよりも、動く範囲を狭くしてログを見ながら広げるのがおすすめです。いきなり複雑な自動化にすると、どの設定が原因で動いたのか追いにくくなります。

HEARTBEAT.mdの作り方

HEARTBEAT.mdは、Heartbeatが起動したときにエージェントへ読ませるチェックリストのようなファイルです。ここに何を書くかで、OpenClawのHeartbeat設定の使い勝手がかなり変わります。長く書きすぎると毎回の判断が重くなり、短すぎると何をすればいいか曖昧になります。

基本は、やること、やらないこと、出力形式を短く決めることです。たとえば「何もなければHEARTBEAT_OKだけ返す」「タスク実行はしない」「改善ログは1回1件だけ」といったルールを先に置くと、通知や作業の膨らみを抑えやすくなります。

HEARTBEAT.mdに入れたい要素

改善ログを扱う場合は、memory/improvements.mdのようなファイルを用意し、追記専用にしておくと管理しやすいです。項目は、症状、原因分類、最小の修正案、再発防止チェック、リスクと戻し方、ステータスくらいに絞ると見返しやすくなります。

ここで大事なのは、Heartbeatに「改善案を出すこと」と「設定を適用すること」を同時に任せないことです。提案はしてよいけれど、configを書き換える、ツールを有効化する、外部連携を増やす、といった操作は人間の確認を挟む方が安心です。これは仕事で使うAI活用でもかなり重要な線引きかなと思います。

✅ 最初に入れると扱いやすいルール

• ✅ 何もなければHEARTBEAT_OKだけ返す
• ✅ 1回のHeartbeatで改善は最大1件
• ✅ 設定変更や外部送信は提案だけにする
• ✅ 秘密情報やトークンをログに残さない
• ✅ ログは追記専用にして履歴を消さない

設定ファイルの書き方

OpenClawのHeartbeat設定は、主にOpenClawの設定ファイル側で「いつ、どのエージェントが、どの対象を見るか」を決めます。よく使う考え方は、everyで間隔、targetで対象、activeHoursで稼働時間を指定する形です。

たとえば、everyは30mのように間隔を表し、targetはlastのように直近セッションを対象にする指定として紹介されています。activeHoursは、09:00から23:00のように稼働時間を絞るための設定です。夜間にレビューできないのに自律処理だけ動くと不安なので、ここは入れておきたい項目です。

⚙️ Heartbeat設定でよく見る項目

設定を書く場所は、全エージェント共通にするか、特定エージェントだけにするかで意味が変わります。調べた範囲では、既にagents.defaults.heartbeatがある場合、意図しないエージェントにもHeartbeatが走る可能性があるため、監督役だけに限定する案が安全寄りです。

️ 設定前の確認リスト

• ✅ 既存のagents.defaults.heartbeatがあるか見る
• ✅ mainにHeartbeatを付ける必要があるか考える
• ✅ ops/coachのような監督役だけにできるか確認する
• ✅ activeHoursで稼働時間を絞る
• ✅ 変更前の設定を戻せる形で控える

設定反映にはGatewayの再起動やOpenClaw側の設定反映コマンドが関係する場合があります。ただし、設定変更は環境によって影響が出るため、いきなり本番運用に入れず、まずは小さなワークスペースや少ないエージェントで確認するのが無難です。

OpenClawのHeartbeat設定は、書き方そのものよりもどのエージェントに、どこまで権限を持たせるかが本質です。最初は「coachだけが定期確認する」「mainは実務だけ」「設定変更は人間が確認する」という形にしておくと、後からCronや検索設定を足すときも整理しやすいですよ。

OpenClawのHeartbeat設定と運用

OpenClawのHeartbeat設定は、ファイルを書いて終わりではなく、SOUL.mdや検索設定、通知、コスト、安全ルールまで含めて考えると運用しやすくなります。特に仕事や副業の情報収集、タスク整理に使うなら、便利さと安全性のバランスがかなり大事です。

ここでは、OpenClawを長く使う前提で見ておきたい運用面を整理します。最初から完璧に作り込むより、小さく動かして、ログを見ながら調整するくらいの進め方が現実的ですよ。

SOUL.mdの役割と設定

SOUL.mdは、OpenClawにとって全体方針を決める「憲法」のようなファイルです。Heartbeatが定期的に動く場合でも、エージェント全体の優先順位や禁止事項がブレないように、短く強いルールを書いておく場所と考えると分かりやすいです。

書く内容は、長い説明よりも安全、正確性、簡潔さ、役割分担を中心にするのが向いています。たとえば、勝手に設定変更しない、秘密情報をログに残さない、外部ツールを自動で入れない、事実と推測を分ける、といったルールです。

SOUL.mdに入れたい基本要素

SOUL.mdを長くしすぎると、毎回読み込む情報が増えてノイズになりやすいです。OpenClawの性格や方針を細かく書きたくなる気持ちは分かりますが、Heartbeat運用では短く固定するくらいがちょうどいいかなと思います。

変更した場合は、どこを変えたか分かるようにGitなどで履歴を残しておくと安心です。特にワークスペース内のルールやメモリは、運用中に変わる可能性があるため、後から戻せる状態にしておきましょう。

性格設定との関係

OpenClawの性格設定は、IDENTITY.mdやSOUL.mdなどのブートストラップファイルと関係します。話し方、キャラクター、応答姿勢、ユーザーへの接し方を調整できる一方で、Heartbeatのような自律実行に影響する部分は慎重に分けて考えたいところです。

性格設定は、やわらかい口調にする、報告を短くする、専門用語をかみ砕く、といったコミュニケーション面に使うと便利です。一方で、権限、外部連携、設定変更、ログ保存のような運用ルールは、雰囲気ではなく明確な制約として書く方が安全です。

性格設定と運用ルールの分け方

たとえば、性格設定で「積極的に助ける」と書くのは悪くありません。ただし、それが「勝手にツールを入れる」「勝手に設定を変える」方向に解釈されると困ります。自律性を上げるほど、やってよいこととダメなことを分ける必要があります。

私なら、性格は読みやすさの調整、SOUL.mdは安全方針、HEARTBEAT.mdは定期実行の手順、という形で役割を分けます。これなら、OpenClawの使い勝手を上げつつ、運用ルールはぶれにくくなります。

検索設定とWeb連携

HeartbeatでWeb検索やページ取得を使いたい場合は、OpenClaw側の検索設定も確認が必要です。記事データでは、Brave SearchやWeb Fetch、Agent Browserなどの機能が紹介されており、目的によって使い分ける形になります。

Web検索は、最新情報やニュース、ドキュメントを確認したいときに便利です。ただし、検索APIの仕様、無料枠、料金、利用条件は変わる可能性があります。検索機能を有効にする場合は、正確な情報は公式サイトをご確認ください。

Web連携で確認したい機能

検索設定をHeartbeatに組み込む場合は、毎回検索させるのではなく、必要な条件を絞るのが大事です。たとえば「緊急度が高いメールだけ」「前回から変化があるページだけ」「指定URLだけ」のように範囲を決めると、無駄な呼び出しを減らせます。

外部サイトから取得した情報は、変動する可能性があります。OpenClawに要約や整理を任せる場合でも、重要な判断をする前には公式情報を確認する流れにしておくと安心です。

通知を減らす設定

Heartbeatは便利ですが、設定を雑にすると通知が増えがちです。特に30分ごとに動く設計にしている場合、毎回「問題ありません」と送られてくるだけでも、だんだん見なくなってしまいます。これ、地味に大事です。

通知を減らす基本は、何もなければHEARTBEAT_OKだけで終わるようにすることです。さらに、通知設定側でOKメッセージを表示しない、アラートだけ出す、インジケーターだけにする、といった設計も考えられます。

通知を減らすための整理

HEARTBEAT.md側にも、出力形式を明確に書いておきましょう。「改善を記録したら短く報告」「何もなければHEARTBEAT_OK」「長文で反省しない」くらいにしておくと、毎回の通知がかなり整理されます。

通知は多いほど安心、というわけではありません。仕事で使うなら、本当に見るべき通知だけが届く状態を作る方が大事です。最初は少し静かすぎるくらいにして、必要に応じて増やす方が運用しやすいですよ。

コストを抑える考え方

OpenClawのHeartbeatは、設定次第でLLM呼び出しや検索APIの利用回数が増える可能性があります。費用はモデル、API、検索サービス、実行頻度によって変わるため、金額を固定して考えるのではなく、呼び出し回数と入力トークンを減らす方向で設計するのが基本です。

まず見直したいのは、HEARTBEAT.mdの長さです。毎回読み込む指示が長いと、それだけ処理が重くなりやすいです。SOUL.mdも同じで、運用に必要な原則だけに絞ると、判断も軽くなります。

コストを抑えるチェック表

また、軽い確認は軽量モデル、深い分析は高性能モデル、という使い分けも考えられます。ただし、モデル名や料金は変わる可能性があるため、実際の設定や費用は利用中のサービスで確認してください。

コスト削減だけを優先しすぎると、必要な確認が抜けることもあります。私なら、まずは通知と実行回数を減らし、次にファイルの長さを見直し、それでも重い場合にモデルやCron分離を検討します。

安全に運用する注意点

OpenClawのHeartbeat設定で一番気をつけたいのは、自律実行の範囲を広げすぎないことです。AIが定期的に動く仕組みは便利ですが、設定変更、外部送信、ツール追加、秘密情報の取り扱いまで任せると、管理が難しくなります。

基本は、提案と適用を分けることです。ops/coachのような監督役には改善案を出させるだけにして、設定変更や外部連携の有効化は人間が確認する。これだけでも事故の可能性をかなり減らせます。

️ 安全運用のチェックポイント

特にAPIキー、トークン、認証情報は、メモリファイルや改善ログに残さないようにしましょう。もしログに出そうな場合は、伏せ字にする、保存しない、そもそも読み込ませない、といった対応が必要です。

会社やチームで使う場合、権限設計や情報管理はより慎重に見た方がいいです。機密情報や社内システムに関わる運用では、最終的な判断は専門家にご相談ください。

OpenClawのHeartbeat設定まとめ

OpenClawのHeartbeat設定は、定期実行そのものよりも、何を任せて、何を任せないかを決めることが大切です。便利な機能を一気に詰め込むより、最初は小さく、安全に、見直しやすい形で始めるのが現実的です。

特に、HEARTBEAT.md、SOUL.md、Cron、検索設定、通知設定はつながっています。どれか1つだけを見るのではなく、全体の役割分担として整理すると、あとから設定を広げやすくなります。

1. ✅ Heartbeatは、ゆるい定期確認や軽い改善ログに向いています
2. ✅ 正確な時刻指定が必要な処理は、Cronで分けると整理しやすいです
3. ✅ SOUL.mdは短く固定し、安全方針や禁止事項を明確にします
4. ✅ 性格設定は口調、運用ルールは権限や制約として分けます
5. ✅ 検索設定やWeb連携は、必要な範囲に絞って使うのが無難です
6. ✅ 通知は多くするより、必要なときだけ届く設計が大事です
7. ✅ コストは実行回数、指示ファイルの長さ、検索回数で変わります
8. ✅ 設定変更や外部送信は、自動適用せず人間が確認する流れにします

OpenClawを仕事や情報収集に使うなら、Heartbeatはかなり便利な仕組みです。ただし、便利さだけで広げると、通知、費用、権限管理が重くなることもあります。

まずは、coachだけにHeartbeatを持たせる、何もなければHEARTBEAT_OKで終わる、改善は1回1件にする。このあたりから始めると、OpenClawのHeartbeat設定を無理なく運用に乗せやすいかなと思います。

記事作成にあたり参考にさせて頂いたサイト

• OpenClawで「自己強化エージェント」を構築する手順書 ─ Heartbeat × 監督役エージェントで運用が勝手に改善される仕組み
• Reddit – Please wait for verification
• OpenClaw Heartbeat Model Configurationの完全ガイド：自律型AIの未来
• OpenClaw パーソナルAIアシスタント 応用編 — インストール後にやるべき全機能セットアップ – 協栄情報ブログ
• openclawの設定について
• ai:openclaw:cron [HYPERでんち]
• Reddit – Please wait for verification
• OpenClaw に魂を与え、制御をする｜Ryo | AI と経営とエンジニアリング
• x.comの記事
• openclaw 設定メモ – Qiita

当サイトについて

当サイトでは、インターネット上に散らばるさまざまな情報を収集し、AIを活用しながら要約・編集を行い、独自の切り口で見解を交えながらわかりやすい形でお届けしています。 情報の整理・編集にあたっては、読者やオリジナル記事の筆者へご迷惑をおかけしないよう、細心の注意を払って運営しておりますが、万が一、掲載内容に問題がある場合や修正・削除のご要望がございましたら、どうぞお気軽にお問い合わせください。 迅速に対応をさせていただきます。 その際には、該当記事の URLやタイトルをあわせてお知らせいただけますと、より速やかに対応 することができますのでそちらもご協力いただけますと大変幸いでございます。 今後とも当サイトをよろしくお願いいたします。