Files
awoooi/docs/ai/AI_AGENT_DEPLOYMENT_LAYOUT_2026-06-11.md
Your Name e427af3cb2
All checks were successful
CD Pipeline / tests (push) Successful in 1m24s
Code Review / ai-code-review (push) Successful in 15s
CD Pipeline / build-and-deploy (push) Successful in 6m5s
CD Pipeline / post-deploy-checks (push) Successful in 1m37s
feat(governance): 接入三 Agent 佈建布局
2026-06-11 11:27:50 +08:00

5.5 KiB
Raw Blame History

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

日期2026-06-11台北時間 狀態只讀布局與治理頁接線完成runtime 佈署尚未授權。 權威資料:docs/evaluations/ai_agent_deployment_layout_2026-06-11.json Schemadocs/schemas/ai_agent_deployment_layout_v1.schema.json APIGET /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 仲裁生產與 TelegramNemoTron 評估模型能力
NemoTron 離線專家、模型比較、工具呼叫、NIM / NVIDIA replay offline evaluator sanitized smoke、replay 評分、輸出合約檢查、模型能力矩陣 OpenClaw 仲裁 shadow/canary/productionHermes 彙整來源與報告

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 顯示操作對話原文或私有推理到前端。