時間コンテキスト注入
エージェントのシステムプロンプトにリッチな時間ブロックを自動生成して注入 — 現在の日付、時刻、曜日、週番号、タイムゾーン — すべてのセッションが時間認識から始まります。
プラグイン OpenClaw エコシステム
Time Awareness
AI エージェントに本当の時間感覚を — 今日の日付、タスクの所要時間、コンテキスト圧縮前に何が起きたか
問題
LLM は時間的に盲目
言語モデルには内蔵クロックがありません。今日の日付を知らず、バックグラウンドジョブがどれくらい実行されているか判断できず、コンテキストウィンドウが圧縮された瞬間に全イベント履歴が消えます。Time Awareness は MCP 上で完全に公開された3層アーキテクチャでこの3つの問題をすべて解決します。
機能
主な機能
タスクライフサイクルトラッカー
バックグラウンドタスクを名前で登録し、スマートバックオフ間隔でステータスをポーリング、設定可能なタイムアウトでストールを検出し、完了をマーク — すべて MCP ツール呼び出しで。
時間イベントログ
重要なイベントはすべて精密なタイムスタンプ付きでディスク上の永続 JSONL タイムラインに追記。ログはコンテキスト圧縮、再起動、エージェントスワップ後も生き残り、不変の監査証跡を提供。
MCP 統合
10のツールすべてが localhost:18070/mcp の Model Context Protocol 経由で公開。claude_desktop_config.json に1エントリ追加するだけで、MCP 対応エージェントがネイティブに呼び出し可能。
スマートポーリング
組み込みの適応バックオフにより、低速なジョブを待つ間エージェントが API を連打するのを防止。ポーリング間隔は経過時間に応じて自動スケール、トークンと API クォータを節約。
コンテキスト圧縮からの生存
イベントタイムラインは LLM コンテキストウィンドウの外に存在。圧縮が短期メモリを消去した後でも、エージェントは query_timeline で何がいつ起きたかを正確に再構築できます。
アーキテクチャ
仕組み
3つの独立したレイヤー、それぞれが時間盲目性の異なる側面を解決。合わせてエージェントに完全な時間状況認識を提供。
01
時間コンテキスト注入
タスク実行前に TCS が構造化された時間ブロックを生成し、エージェントのシステムプロンプトに直接注入。エージェントは常に現在の日付、時刻、タイムゾーン、週番号を知っています — 幻覚の余地なし。
tcs context 02
タスクライフサイクルトラッカー
長時間実行のバックグラウンドジョブが名前で登録されます。TCS がその開始時間、最終ポーリング時間、予想所要時間を追跡。スマートポーリング間隔がビジーループを防ぎ、タイムアウト検出がストールしたジョブを検出。
tcs task start / poll / finish 03
時間イベントログ
注目すべきイベントはすべて精密なタイムスタンプ付きでディスク上の JSONL タイムラインに追記。ログは時間範囲、イベントタイプ、全文検索でクエリ可能 — コンテキスト圧縮後も完全に生存。
tcs log / timeline 10 個の MCP ツール
すべてのツールが http://localhost:18070/mcp で利用可能
get_temporal_context 現在の時間コンテキストを取得 — 日付、時刻、タイムゾーン、週番号 start_task ライフサイクル追跡のためにバックグラウンドタスクを登録 poll_task タスクをポーリングすべきか確認してチェックを記録 finish_task タスクを完了またはキャンセル済みとしてマーク list_tasks すべてのタスクを一覧、オプションでステータスでフィルタリング check_timeouts 実行中のすべてのタスクをスキャンしてストールまたはタイムアウトを検出 log_event 永続タイムラインにイベントを追記 query_timeline 時間範囲、タイプ、ソースでイベントをクエリ search_events イベントタイムライン上で全文検索 get_stats エージェントアクティビティの集計統計を取得 3
アーキテクチャレイヤー
10
MCP ツール
JSONL
永続タイムライン
Solved
時間盲目性
カバレッジ
追跡される対象
エージェントが必要とするが今まで持てなかった6カテゴリーの時間情報 — 今からは違います。
現在時刻 & 日付
精密なタイムスタンプ、曜日、週番号、タイムゾーンをすべてのエージェントコンテキストに注入
タスク所要時間
追跡された各タスクの開始から終了までの実時間
バックグラウンドジョブ
スマートポーリング間隔とタイムアウト閾値を持つ実行中タスク
イベント履歴
重要なエージェントイベントの永続 JSONL タイムライン
ポーリング間隔
結果を待つ間エージェントが API を連打するのを防ぐ適応バックオフ
タイムアウト検出
タスクが予想実行時間を超えた場合の自動アラート
クイックスタート
30秒で起動
MCP サーバーを起動し、任意の MCP 対応エージェントに接続します。
# Start the MCP server bash ~/projects/agent-time-awareness/start-mcp.sh # Add to claude_desktop_config.json { "mcpServers": { "tcs": { "url": "http://localhost:18070/mcp" } } }
もうすぐリリース
ウェイトリストに参加
このプラグインのリリース時に最初にお知らせします。