AgentPulse と agent-otel: AI coding ops 個人環境メモ

Codex/Claude Codeの複数セッション運用を、OpenClawでどう薄く盗むか。

Generated: 2026-05-17T20:12:00+09:00

Lane: 開発ネタ発掘

Why this is useful: 健人くんの OpenClaw/ひめの運用は、今まさに「複数agent/sessionが何をしているか」「止まった時に何を再開するか」「ログをどう評価へ変えるか」がボトルネック。AgentPulse と agent-otel はその周辺をそれぞれ dashboard/control-plane と trace substrate に切っていて、OpenClaw側で盗める設計単位がある。

What I made/changed: read-only web patrolで、Codex/Claude Code両対応のセッション監視・orchestration dashboard と、agentが自分のtraceを query できる OTel ルータ/CLI を比較メモに圧縮した。外部インストールやhook変更はしていない。

Sources/Evidence:

AgentPulse: https://github.com/jstuart0/agentpulse
agent-otel: https://github.com/mirkokiefer/agent-otel
OpenAI Codex best practices: https://developers.openai.com/codex/learn/best-practices

Next safe action: いきなり導入せず、OpenClaw内ではまず session_id -> task/intention/status/last_safe_next_action の小さいlocal indexを作る。次に、既存JSONL/heartbeat artifactから「stuck/risky/complete_candidate」を判定する read-only dashboard/View を試すのが安全。

Notify: yes — source-backedで、健人くんのagent運用改善に直接使える設計メモだから。

何が新しい/面白いか

AgentPulse は「Claude Code + Codex CLI の複数セッションを、terminal tabではなく command center として見る」方向。live dashboard、session detail、projectごとのdigest、inbox、HITL approvals、stuck/risky session warnings、Ask経由のlaunch/resume/stop/archive approvalなどを1つのlocal appに寄せている。

agent-otel はもう少し下の層で、OpenInference/OTel spanを複数sinkへルーティングし、PII masking、replay、cost-aware rules、そして scry CLI/MCPでagent自身がtraceを調べられる形にしている。Phoenix/Braintrust/Langfuseのような人間向け可視化に加えて、agentが「自分の失敗traceを読む」面が強い。

健人くんが気にする理由

OpenClaw/ひめのは既に heartbeat guard、task ledger、memory、View、agent observability audit を持っている。次の伸びしろは「ログがある」ではなく、以下の3つをつなぐこと。

sessionが何をしているか: cwd / prompt / task / status / last event
次にどうするか: continue / ask / report / stop / wait / needs_human
なぜそう判断したか: trace / artifact / test / approval state

AgentPulseはこの3点をUI/運用面でまとめ、agent-otelはtrace基盤としてまとめている。どちらも丸ごと入れるより、OpenClawではまず inbox + session health + next safe action の薄い版を作るのが合う。

盗める実装パターン

Operator inbox を task ledger の上に薄く作る

HITL、stuck session、recent failures、approval待ちを1画面に寄せる。Telegram通知は inbox の中でも phone-useful なものだけに絞る。

Session watcher を LLM任せにしない

まず deterministic classifier で healthy / blocked / stuck / risky / complete_candidate を付ける。LLMはその理由と次アクションの圧縮に使う。

agent-readable traces を目標にする

人間向けdashboardだけでなく、agentが last 20 ERROR spans や root -> failed tool call を読めるローカルquery面を用意する。これは heartbeat の「同じ失敗を繰り返さない」に直結する。

注意

どちらもhook、session transcript、approval、場合によってはtoken/cookie周辺に触れる領域。今のルール通り、install scriptやpluginとして即導入はしない。やるなら manifest/source/install script/network/secret handling を先に読む。