# OpenClaw / Hermes / NemoTron 佈建布局與協作報告

> 日期：2026-06-11（台北時間）
> 狀態：只讀布局與治理頁接線完成，runtime 佈署尚未授權。
> 權威資料：`docs/evaluations/ai_agent_deployment_layout_2026-06-11.json`
> Schema：`docs/schemas/ai_agent_deployment_layout_v1.schema.json`
> API：`GET /api/v1/agents/agent-deployment-layout`

## 1. 結論

目前已把 OpenClaw、Hermes、NemoTron 依各自專長安排到主機、套件、工具、服務、專案、網站前後台、學習協作與 Telegram 告警布局中。

本波完成的是「可驗證佈建布局」，不是直接把 Agent 遠端安裝到所有主機；因此不會碰 Secret、不送 Telegram、不改主機、不裝 SDK、不呼叫付費 API、不進 shadow/canary、不改 production route。

## 2. 完成度

| 範圍 | 完成度 | 狀態 |
|---|---:|---|
| 三 Agent 佈建布局合約 | 100% | Schema、snapshot、loader、API、測試已建立 |
| 佈建布局資料覆蓋 | 100% | 42 個 target 已納入 |
| 治理頁只讀顯示 | 100% | 自動化盤點 tab 已接 API 與繁中顯示 |
| Runtime 實際部署 | 0% | 需要逐項 gate / approval / deploy |
| Telegram Gateway 整合布局 | 70% | 既有 Gateway / ADR-035 可承接；本波不直接送訊息 |
| 主動學習與協作布局 | 45% | 已定義 AgentSession / Redis Streams / KM / replay 回饋；runtime loop 需後續落地 |

## 3. Agent 分工

| Agent | 專長 | 主要佈建 lane | 可主動做 | 必須交給誰 |
|---|---|---|---|---|
| OpenClaw | 生產仲裁、HITL、執行風險、Telegram action-required | production decision core | 只讀診斷、風險分級、批准包審查、批准後執行仲裁 | Hermes 彙整治理；NemoTron 做離線模型評估 |
| Hermes | 治理、知識、文件、套件/供應鏈、降噪、跨專案盤點 | governance / knowledge / reporting | 盤點、報告、runbook、依賴漂移、降噪提案、批准包草稿 | OpenClaw 仲裁生產與 Telegram；NemoTron 評估模型能力 |
| NemoTron | 離線專家、模型比較、工具呼叫、NIM / NVIDIA replay | offline evaluator | sanitized smoke、replay 評分、輸出合約檢查、模型能力矩陣 | OpenClaw 仲裁 shadow/canary/production；Hermes 彙整來源與報告 |

## 4. 覆蓋範圍

| Domain | Target 數 | 主要 owner |
|---|---:|---|
| 主機 | 6 | OpenClaw |
| 套件與建置 | 3 | Hermes |
| 工具 | 8 | Hermes / OpenClaw |
| 服務 | 8 | OpenClaw / Hermes |
| 專案 | 8 | Hermes / OpenClaw |
| 網站前後台 | 5 | Hermes / OpenClaw |
| 學習與協作 | 4 | OpenClaw / Hermes / NemoTron |

合計：42 個 target。

## 5. 主機佈建策略

| 主機 | 角色 | 主 Agent | 狀態 | Telegram |
|---|---|---|---|---|
| 110 | DevOps / runner / monitoring | OpenClaw | active_governed | action_required |
| 188 | AI / Web / DB / Redis / SigNoz | OpenClaw | active_governed | action_required |
| 111 | Ollama fallback | OpenClaw | read_only_layout | failure_only |
| 120 | K3s blocked recovery | OpenClaw | blocked_by_gate | action_required |
| 121 | K3s peer | OpenClaw | active_governed | failure_only |
| 112 | Kali / security evidence | Hermes | read_only_layout | no_direct_notify |

120 仍維持 blocked，不安排自動修復；必須等 console / SSH / K3s evidence 回來。

## 6. Telegram 策略

所有 Agent 都不得直接持有 token 或直接送訊息；統一經 `apps/api/src/services/telegram_gateway.py` 與 ADR-035 的部署後 E2E 驗證鏈路。

通知等級：

| 類型 | 策略 |
|---|---|
| critical failure | 立即告警 |
| operator action required | 立即告警 |
| approval required | Telegram approval card |
| success / healthy | 壓低或每日摘要 |
| watch-only no-op | 靜默 |

訊息不得包含 Secret、token、cookie、private key、原始 payload、操作對話原文或 Agent 私有推理。

## 7. 主動學習與互相溝通

協作路徑：

1. Prometheus / Sentry / SigNoz / backup / runtime snapshot 產生事件。
2. Hermes 先彙整只讀證據與 runbook / dependency / market context。
3. OpenClaw 仲裁風險、HITL、Telegram action-required 與是否能進 dry-run。
4. NemoTron 只處理 sanitized smoke / replay / model comparison。
5. 結果回寫 AgentSession、Timeline、KM、Playbook trust 與 market scorecard。

學習來源：

- incident timeline
- approval outcome
- alert operation log
- service health snapshot
- backup / DR evidence
- dependency drift snapshot
- agent market watch
- NemoTron smoke / replay result

## 8. 優先順序

| 優先級 | 任務 | 狀態 | 下一步 |
|---|---|---|---|
| P1-401 | 建立三 Agent 佈建布局 schema / snapshot / API | 完成 | 進入 Telegram / 協作 runtime gate |
| P1-402 | 治理後台顯示佈建布局 | 完成 | 已顯示 target、owner、Telegram policy、批准/阻擋狀態 |
| P1-403 | Telegram Gateway 對三 Agent lane 做 E2E smoke 包 | 待辦 | 不直接發送，先做批准包 |
| P2-401 | AgentSession / Redis Streams 協作資料面落地 | 待辦 | 需要 migration / worker gate |
| P2-402 | Playbook trust / KM / operator feedback loop 補強 | 待辦 | 先做只讀報表 |
| P3-401 | NemoTron 3 Ultra source refresh + 5-record smoke | 待辦 | 需要 cost/data approval 後才能跑 |

## 9. 紅線

- 不把布局當成 runtime 授權。
- 不把 AwoooP work item 當成生產批准。
- 不把 IwoooS UI 可見當成安全授權。
- 不讓 NemoTron 在 smoke/replay gate 前進 shadow/canary。
- 不讓 Hermes 直接發 Telegram 或修改生產。
- 不讓任何 Agent 顯示操作對話原文或私有推理到前端。
