Zenn Dev Akasara Articles 52dc506100f7ad
OpenClawで「自己強化エージェント」を構築する手順書 ─ Heartbeat × 監督役エージェントで運用が勝手に改善される仕組み
- URL: https://zenn.dev/akasara/articles/52dc506100f7ad
- 日付: 2026-06-26
- Tier: Tier 3
- 要旨: OpenClawのHeartbeat機能と監督役エージェント(ops/coach)を組み合わせ、使えば使うほど運用が自動改善される「自己強化ループ」を構築する手順書。実務担当(main)は実行・報告のみ、監督役(ops/coach)はHeartbeatで定期評価・改善提案・ログ記録のみと責務を完全分離し、1回のHeartbeatで改善ログへの追記は最大1件に制限するのが核心となる設計方針。人間が提案→レビュー→適用→検証の4段階ゲートキーパーとして機能し続けることで安全性を担保する仕組みになっている。SOUL.md・HEARTBEAT.md・memory/improvements.mdのテンプレート一式とOpenClawへのプロンプトをそのまま使える形で提供している。
詳細
- アーキテクチャ: main(実行・事実報告のみ)→ handshake.md → ops/coach(Heartbeatで評価・1件追記)→ improvements.md → 人間レビュー → decisions.md
- SOUL.md: 全体の憲法。最小権限・設定変更禁止・秘密情報記録禁止・短く報告。短く固定し月1回程度のみ変更
- HEARTBEAT.md: ops/coachチェックリスト。繰り返す摩擦(同じエラー2回・前提不足・不明確プロンプト・過剰出力)を検出し、1件のみimprovements.mdに追記またはHEARTBEAT_OKを返す
- improvements.mdのエントリ形式: Symptom/Root cause(config/prompt/procedure/permission/tool/external 6分類)/Fix(最小変更)/Preventive check(1行)/Expected impact/Risk & rollback/Status
- Heartbeat設定: ~/.openclaw/openclaw.json にevery(“30m”)・target(“last”)・activeHours(09:00〜23:00)を設定。coachエージェントだけに適用
- ベストプラクティス7箇条: 1Heartbeat=1改善、提案と適用の分離、SOUL.mdを短く固定、mainは反省しない、改善ログに再発防止チェック1行必須、activeHoursで夜中の動作を防ぐ、テンプレートは自作・レビュー前提
- セキュリティ: config.apply/patchは人間承認フロー、secrets/tokensはメモリファイルに書かない、improvements.mdはappend-only
- サプライチェーンリスク: HEARTBEAT.mdやskillsの外部配布は攻撃面になり得るため、外部テンプレートは必ず中身を確認してから使う