wooo/awoooi
1
1
Fork 0
Code Issues 2 Pull Requests 1 Actions 3 Packages Projects Releases Wiki Activity

chore: services export + meetings 文檔格式化

Browse Source 
- services/__init__.py: 導出 IncidentApprovalService (ADR-027)
- meetings docs: 格式化更新

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
OG T
2026-03-26 19:10:48 +08:00
parent 00e2c94a8e
commit dd42e6b75b
4 changed files with 61 additions and 53 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
apps/api/src/services/__init__.py
View File

@@ -52,6 +52,11 @@ from .model_registry import (
get_model_registry,
reset_model_registry,
)
# ADR-027: Incident-Approval 同步架構 (2026-03-26)
from .incident_approval_service import (
IncidentApprovalService,
IncidentApprovalSyncError,
)
from .trust_engine import (
RiskAdjustment,
RiskLevel,
@@ -114,4 +119,7 @@ __all__ = [
"get_model",
"get_model_by_complexity",
"reset_model_registry",
# Incident-Approval Sync (ADR-027)
"IncidentApprovalService",
"IncidentApprovalSyncError",
]

72
docs/meetings/2026-03-19_FRONTEND_RESTRUCTURE_STRATEGY.md
View File

@@ -33,14 +33,14 @@
### 戰略起源
CEO 與 Gemini 進行初步討論，確定「Agent-Centric UI/UX」方向，將 WOOO AIOps 從傳統儀表板升級為以 ClawBot AI 代理為核心的指揮艙。
CEO 與 Gemini 進行初步討論，確定「Agent-Centric UI/UX」方向，將 WOOO AIOps 從傳統儀表板升級為以 OpenClaw AI 代理為核心的指揮艙。
### 核心理念
| 概念 | 說明 |
|------|------|
| **主角替換** | UI 焦點從「折線圖」轉為「ClawBot 狀態與思考軌跡」 |
| **人機協作 (HITL)** | 高風險任務需人類批准，ClawBot 推送「待授權卡片」 |
| **主角替換** | UI 焦點從「折線圖」轉為「OpenClaw 狀態與思考軌跡」 |
| **人機協作 (HITL)** | 高風險任務需人類批准，OpenClaw 推送「待授權卡片」 |
| **賽博維運風格** | 深空灰底色 + 霓虹點綴 |
| **活性 UX** | 背景微動、打字機事件流、狀態呼吸燈 |
@@ -68,8 +68,8 @@ CEO 與 Gemini 進行初步討論，確定「Agent-Centric UI/UX」方向，將
| 服務 | 位置 | 說明 |
|------|------|------|
| **wooo-aiops API** | `src/api/` | FastAPI, 48+ 路由模組 |
| **ClawBot** | `~/clawbot-v5/` | AI 代理核心，含語意快取、知識庫 |
| **ClawBot 核心模組** | 22 個 .py | semantic_cache, knowledge_base, escalation_service 等 |
| **OpenClaw** | `~/clawbot-v5/` | AI 代理核心，含語意快取、知識庫 |
| **OpenClaw 核心模組** | 22 個 .py | semantic_cache, knowledge_base, escalation_service 等 |
#### 四主機架構
@@ -82,7 +82,7 @@ CEO 與 Gemini 進行初步討論，確定「Agent-Centric UI/UX」方向，將
│ │ 192.168.0.110│ │192.168.0.112│ │ 192.168.0.188 │ │
│ │ DevOps │ │ Kali │ │ AI + Web │ │
│ │ 金庫 │ │ Security │ │ ┌─────────────┐ │ │
│ │ ┌─────────┐ │ │ ┌─────────┐ │ │ │ ClawBot │ │ │
│ │ ┌─────────┐ │ │ ┌─────────┐ │ │ │ OpenClaw │ │ │
│ │ │ Harbor │ │ │ │Scanner │ │ │ │ :8088 │ │ │
│ │ │ Gitea │ │ │ │ API:8080│ │ │ └─────────────┘ │ │
│ │ │GH Runner│ │ │ └─────────┘ │ │ ┌─────────────┐ │ │
@@ -113,7 +113,7 @@ wooo-aiops/
│ ├── src/
│ │ ├── app/ # Next.js App Router
│ │ ├── components/
│ │ │ ├── agent/ # ClawBot 專屬組件
│ │ │ ├── agent/ # OpenClaw 專屬組件
│ │ │ │ ├── StatusOrb.tsx # 狀態呼吸燈
│ │ │ │ ├── ThinkingStream.tsx # 思考流動畫
│ │ │ │ ├── ApprovalCard.tsx # HITL 授權卡片
@@ -121,7 +121,7 @@ wooo-aiops/
│ │ │ ├── cyber/ # 賽博風格組件
│ │ │ └── shared/ # 可複用組件 (從 web/ 遷移)
│ │ ├── stores/
│ │ │ ├── agent.ts # ClawBot 狀態 (Zustand)
│ │ │ ├── agent.ts # OpenClaw 狀態 (Zustand)
│ │ │ └── approvals.ts # 待授權佇列
│ │ └── hooks/
│ │ └── use-agent-stream.ts # Agent WebSocket
@@ -135,7 +135,7 @@ wooo-aiops/
- 共享套件 (`packages/ui`) 避免重複造輪子
- 可獨立部署到不同域名 (例如 `command.aiops.wooo.work`)
#### 2.2 ClawBot WebSocket 新頻道
#### 2.2 OpenClaw WebSocket 新頻道
現有 WebSocket 已支援 `metrics | alerts | deployments | security | tickets` 頻道。
@@ -143,7 +143,7 @@ wooo-aiops/
| 頻道 | 用途 | 消息類型 |
|------|------|---------|
| `agent_status` | ClawBot 狀態變更 | `{state: 'patrolling'|'analyzing'|'executing'|'awaiting_approval'}` |
| `agent_status` | OpenClaw 狀態變更 | `{state: 'patrolling'|'analyzing'|'executing'|'awaiting_approval'}` |
| `agent_stream` | 思考過程串流 | `{thinking: "正在分析...", step: 1, total: 5}` |
| `approvals` | 待授權任務 | `{action: 'scale_up', risk: 'medium', requires: ['CTO']}` |
@@ -185,7 +185,7 @@ wooo-aiops/
│ │ │
│ ↓ │
│ ┌────────────────────┐ │
│ │ ClawBot │ │
│ │ OpenClaw │ │
│ │ 192.168.0.188:8088 │ │
│ └────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
@@ -199,9 +199,9 @@ wooo-aiops/
| **wooo-agent-hub** | **wooo-aiops-uat** | **2** | **0.3** | **384Mi** |
| wooo-api | wooo-aiops-uat | 2 | 0.5 | 512Mi |
#### 3.3 ClawBot API 代理建議
#### 3.3 OpenClaw API 代理建議
目前 ClawBot 直接暴露在 188:8088。建議透過 K8s Ingress 統一入口：
目前 OpenClaw 直接暴露在 188:8088。建議透過 K8s Ingress 統一入口：
```yaml
# infrastructure/kubernetes/overlays/uat/ingress-clawbot.yaml
@@ -230,15 +230,15 @@ spec:
|------|------|-------------------|
| `agent_hub_load_time_p95` | 前端 RUM | 新增 Panel |
| `agent_stream_latency_ms` | WebSocket | aiops-brain.json |
| `approval_queue_depth` | ClawBot | 新增 Panel |
| `hitl_response_time_seconds` | ClawBot | 新增 Panel (人類回應時間) |
| `approval_queue_depth` | OpenClaw | 新增 Panel |
| `hitl_response_time_seconds` | OpenClaw | 新增 Panel (人類回應時間) |
#### 3.5 風險評估
| 風險 | 等級 | 緩解措施 |
|------|------|---------|
| 新舊網站資源競爭 | 🟡 中 | 設定 Resource Quota |
| ClawBot 單點故障 | 🟠 高 | 暫時不動，Phase 10 考慮 HA |
| OpenClaw 單點故障 | 🟠 高 | 暫時不動，Phase 10 考慮 HA |
| WebSocket 連線暴增 | 🟡 中 | 連線池限制 + Rate Limiting |
---
@@ -262,13 +262,13 @@ spec:
│ Agent Hub 使用者旅程 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 1. 登入 → 看到 ClawBot 當前狀態 (巡邏中/分析中/等待批准) │
│ 1. 登入 → 看到 OpenClaw 當前狀態 (巡邏中/分析中/等待批准) │
│ ↓ │
│ 2. ClawBot 發現異常 → 推送「待授權卡片」到佇列 │
│ 2. OpenClaw 發現異常 → 推送「待授權卡片」到佇列 │
│ ↓ │
│ 3. 決策者審閱 → 一鍵批准/拒絕/要求更多資訊 │
│ ↓ │
│ 4. ClawBot 執行 → 即時顯示執行進度與結果 │
│ 4. OpenClaw 執行 → 即時顯示執行進度與結果 │
│ ↓ │
│ 5. 完成 → 自動產生報告，沉澱到知識庫 │
│ │
@@ -281,7 +281,7 @@ spec:
|------|------|--------------|------|
| **深空灰** | `#0A0A12` | `--cyber-void` | 主背景 |
| **星雲灰** | `#1A1A2E` | `--cyber-nebula` | 卡片背景 |
| **ClawBot 螢光綠** | `#00FF88` | `--cyber-claw` | Agent 正常狀態、成功 |
| **OpenClaw 螢光綠** | `#00FF88` | `--cyber-claw` | Agent 正常狀態、成功 |
| **數據電藍** | `#00BFFF` | `--cyber-data` | 資料流、連線 |
| **能量橙** | `#FF6B35` | `--cyber-energy` | 警告、待處理 |
| **殲滅紅** | `#FF3366` | `--cyber-destroy` | 錯誤、危險 |
@@ -300,8 +300,8 @@ spec:
| 頁面 | 路由 | 核心功能 | 優先級 |
|------|------|---------|--------|
| **指揮艙** | `/` | ClawBot 狀態 + 待授權佇列 + 快速統計 | P0 |
| **思考流** | `/thinking` | ClawBot 分析過程視覺化 | P1 |
| **指揮艙** | `/` | OpenClaw 狀態 + 待授權佇列 + 快速統計 | P0 |
| **思考流** | `/thinking` | OpenClaw 分析過程視覺化 | P1 |
| **授權中心** | `/approvals` | 待批准任務列表 + 風險評估 | P0 |
| **行動日誌** | `/actions` | 已執行行動時間軸 | P1 |
| **知識殿堂** | `/knowledge` | AI 學習成果 + 知識庫瀏覽 | P2 |
@@ -310,7 +310,7 @@ spec:
| 優先級 | 功能 | 說明 | 負責人 |
|--------|------|------|--------|
| **P0** | ClawBot 狀態顯示 | 呼吸燈 + 文字狀態 | CPO |
| **P0** | OpenClaw 狀態顯示 | 呼吸燈 + 文字狀態 | CPO |
| **P0** | 待授權卡片 | HITL 核心功能 | CPO + CTO |
| **P1** | 思考流串流 | 打字機效果 | CTO |
| **P1** | 行動時間軸 | 最近 10 個行動 | CPO |
@@ -348,8 +348,8 @@ spec:
| 1 | 建立 `agent-hub/` 目錄結構 | CTO | 2h |
| 2 | 配置 Tailwind 賽博色彩 | CPO + CTO | 4h |
| 3 | 建立 `stores/agent.ts` (Zustand) | CTO | 2h |
| 4 | 新增 ClawBot WebSocket 頻道 (`agent_status`) | CIO | 4h |
| 5 | 實作 `<ClawBotStatusOrb />` 組件 | CPO | 4h |
| 4 | 新增 OpenClaw WebSocket 頻道 (`agent_status`) | CIO | 4h |
| 5 | 實作 `<OpenClawStatusOrb />` 組件 | CPO | 4h |
| 6 | 部署到 `command.aiops.wooo.work` | CIO | 2h |
---
@@ -415,7 +415,7 @@ brand: {
}
```
### C. ClawBot 核心模組清單
### C. OpenClaw 核心模組清單
| 模組 | 檔案 | 說明 |
|------|------|------|
@@ -455,7 +455,7 @@ brand: {
| 類別 | 積木數量 | 核心介面 | 舉例 |
|------|---------|---------|------|
| **🧱 INPUT** | 10+ | `TriggerPlugin` | Prometheus, Webhook, Email, Cron |
| **🧠 BRAIN** | 6+ | `AgentProvider` | ClawBot, OpenAI, Anthropic, MCP |
| **🧠 BRAIN** | 6+ | `AgentProvider` | OpenClaw, OpenAI, Anthropic, MCP |
| **📢 OUTPUT** | 12+ | `NotificationChannel` | TG, Slack, LINE, Email, Discord |
| **🔧 ACTION** | 12+ | `ActionExecutor` | SSH, K8s, Docker, AWS/GCP SDK |
| **📊 DATA** | 8+ | `DataAdapter` | Postgres, Redis, S3, Vector DB |
@@ -568,7 +568,7 @@ brand: {
### 方案 B: 吉祥物整合
- ClawBot 龍蝦雙螯形成 A 的形狀
- OpenClaw 龍蝦雙螯形成 A 的形狀
- 尾巴延伸成 I
- WOOO 在中間，龍蝦「抱住」品牌
@@ -638,7 +638,7 @@ awoooi/ # 或 wooo-awoooi
│ │ ├── src/
│ │ │ ├── app/ # App Router
│ │ │ ├── components/
│ │ │ │ ├── agent/ # ClawBot 專屬
│ │ │ │ ├── agent/ # OpenClaw 專屬
│ │ │ │ ├── widgets/ # UI 積木
│ │ │ │ └── shared/ # 共用
│ │ │ ├── stores/ # Zustand
@@ -733,7 +733,7 @@ awoooi/ # 或 wooo-awoooi
AWOOOI (母品牌)
├── NemoClaw (視覺符號) - Logo、UI 狀態
├── leWOOOgo (技術引擎) - Plugin、API
└── ClawBot (AI 人格) - Q版龍蝦、對話
└── OpenClaw (AI 人格) - Q版龍蝦、對話
```
### 動畫技術規格
@@ -875,7 +875,7 @@ export default class MyPlugin extends NotificationPlugin {
| Must Have (P0) | Should Have (P1) | Could Have (P2) |
|----------------|------------------|-----------------|
| ClawBot 狀態顯示 | 思考流視覺化 | 3D 服務拓撲 |
| OpenClaw 狀態顯示 | 思考流視覺化 | 3D 服務拓撲 |
| HITL 待授權卡片 | 行動時間軸 | 知識庫瀏覽 |
| Telegram 通知 | Slack 通知 | Discord/Email |
| Prometheus 觸發 | Webhook 觸發 | CloudWatch |
@@ -893,8 +893,8 @@ export default class MyPlugin extends NotificationPlugin {
| 層級 | 價格 | 核心差異 |
|------|------|---------|
| Community | 免費 | 1 ClawBot, 7 天歷史 |
| Pro | $29/月 | 5 ClawBot, 90 天歷史, SLA |
| Community | 免費 | 1 OpenClaw, 7 天歷史 |
| Pro | $29/月 | 5 OpenClaw, 90 天歷史, SLA |
| Enterprise | 聯繫 | 無限, 私有部署, SSO |
### 遷移策略
@@ -1005,7 +1005,7 @@ Edge Layer (邊緣): Cloudflare → Nginx → K8s Ingress
↓
Application Layer (應用): Frontend → BFF → Plugins
↓ (NetworkPolicy 隔離)
AI & Action Layer (AI): ClawBot → Ollama → Executors
AI & Action Layer (AI): OpenClaw → Ollama → Executors
↓ (最小權限)
Data Layer (資料): PostgreSQL, Redis, Prometheus, SigNoz
```
@@ -1031,7 +1031,7 @@ Monitor Plugins (可插拔)
↓
Unified Metric Bus
↓
ClawBot (AI 分析)
OpenClaw (AI 分析)
```
---
@@ -1384,7 +1384,7 @@ AI 核心: LLM Router + GraphRAG + 智能貼標 + Trust Engine
| 任務 | 負責人 |
|------|--------|
| BFF Gateway | CTO |
| ClawBot 介面 | CTO |
| OpenClaw 介面 | CTO |
| Frontend 骨架 | CPO |
| Data Pincer | CPO |
| SigNoz 整合 | CIO |

18
docs/meetings/2026-03-20_PHOENIX_RISING_STRATEGY.md
View File

@@ -15,7 +15,7 @@
|------|------|------|
| CEO | ✅ | 戰略佈達、最終決策 |
| 資深顧問 (Gemini) | ✅ | 架構諮詢、風險評估 |
| CTO | ✅ | 技術架構、API 契約、ClawBot |
| CTO | ✅ | 技術架構、API 契約、OpenClaw |
| CIO | ✅ | 基礎設施、網路隔離、K8s |
| CPO | ✅ | 產品體驗、視覺設計、前端團隊 |
| CISO | ✅ | 安全架構、合規、RBAC |
@@ -69,7 +69,7 @@ Internet → Cloudflare → 192.168.0.188 (Nginx SSL Gateway)
aiops.wooo.work awoooi.wooo.work
→ :31235 (Frontend) → :32235 (Frontend)
→ :31234 (API) → :32234 (API)
→ :8088 (ClawBot) → :8089 (ClawBot)
→ :8088 (OpenClaw) → :8089 (OpenClaw)
```
### Port 分配表
@@ -78,12 +78,12 @@ Internet → Cloudflare → 192.168.0.188 (Nginx SSL Gateway)
|------|------|---------|------|
| Legacy | Frontend | 31235 | 凍結 |
| Legacy | API | 31234 | 凍結 |
| Legacy | ClawBot | 8088 | 共用核心 |
| Legacy | OpenClaw | 8088 | 共用核心 |
| AWOOOI UAT | Frontend | 32235 | 🆕 |
| AWOOOI UAT | API | 32234 | 🆕 |
| AWOOOI Prod | Frontend | 32335 | 🆕 |
| AWOOOI Prod | API | 32334 | 🆕 |
| AWOOOI | ClawBot | 8089 | 🆕 新 API 層 |
| AWOOOI | OpenClaw | 8089 | 🆕 新 API 層 |
### K8s Namespace 規劃
@@ -115,12 +115,12 @@ Internet → Cloudflare → 192.168.0.188 (Nginx SSL Gateway)
| **Prometheus** | 🟢 低 | Job Label 區分 |
| **SigNoz** | 🟢 低 | service.name 標籤 |
### ClawBot 共用策略
### OpenClaw 共用策略
**決議**: 選項 C - 共用核心，API 層分離
```
ClawBot Core (共用)
OpenClaw Core (共用)
├── semantic_cache.py ← 共用
├── knowledge_base.py ← 共用
├── trust_engine.py ← 共用
@@ -261,7 +261,7 @@ colors: {
| 任務 | 負責人 | 產出 |
|------|--------|------|
| 四主機可視化 | CPO + CTO | 戰情室首頁 |
| ClawBot API 分離 | CTO | `:8089` 新端點 |
| OpenClaw API 分離 | CTO | `:8089` 新端點 |
| Nothing.tech 視覺落地 | CPO | 組件庫 |
| i18n 框架整合 | CPO | `zh-TW.json`, `en.json` |
| RBAC 遷移 | CISO | 認證模組 |
@@ -314,7 +314,7 @@ colors: {
1. **產品定位**: AWOOOI 為 100% 獨立重構的 SaaS 產品，完全取代舊版
2. **視覺風格**: Nothing.tech 純白極簡工業風，全站貫徹
3. **網路隔離**: 新舊系統完全分離，透過 Nginx + NetworkPolicy 實現
4. **共用策略**: Ollama/SigNoz/Redis 共用但隔離，ClawBot 共用核心但 API 分離
4. **共用策略**: Ollama/SigNoz/Redis 共用但隔離，OpenClaw 共用核心但 API 分離
5. **開發紀律**: API 契約優先，CI/CD 強制檢查
6. **團隊規模**: 總計 14 人
@@ -538,7 +538,7 @@ Ollama (本地) → Gemini API → Claude API → 靜態回應
| 主機 | 服務 | 部署方式 |
|------|------|---------|
| 192.168.0.188 | Nginx, PostgreSQL | **Host 直裝** |
| 192.168.0.188 | Ollama, ClawBot, Redis, SigNoz | **Docker** |
| 192.168.0.188 | Ollama, OpenClaw, Redis, SigNoz | **Docker** |
| 192.168.0.110 | Harbor, GH Runner | **Docker** |
| 192.168.0.112 | Kali Scanner | **Docker** |
| 192.168.0.120/121 | awoooi-web, awoooi-api | **K3s** |

16
docs/meetings/2026-03-21_OPENCLAW_STRATEGY.md
View File

@@ -15,7 +15,7 @@ AWOOOI 2.0 - OpenClaw 實體化升級藍圖 (Phase 5)
| 目標 | 說明 |
|------|------|
| **全面正名** | ClawBot → OpenClaw，對齊開源社群 |
| **全面正名** | OpenClaw → OpenClaw，對齊開源社群 |
| **財務獨立** | Ollama-First 零 API 成本策略 |
| **行動決策** | Telegram Gateway 行動簽核通道 |
| **硬核防禦** | executor.py 封裝為 OpenClaw Skill |
@@ -63,7 +63,7 @@ AWOOOI 2.0 - OpenClaw 實體化升級藍圖 (Phase 5)
2. 成本儀表板 UI (P2)
3. OpenClaw 品牌視覺更新 (P2)
**鐵律提醒**: UI 中所有 "ClawBot" 必須透過 i18n 更新
**鐵律提醒**: UI 中所有 "OpenClaw" 必須透過 i18n 更新
### 2.3 CISO 安全評估
@@ -100,7 +100,7 @@ AWOOOI 2.0 - OpenClaw 實體化升級藍圖 (Phase 5)
| 決議項目 | CTO | CPO | CISO | 結論 |
|----------|-----|-----|------|------|
| ClawBot → OpenClaw 正名 | ✅ | ✅ | ✅ | **通過** |
| OpenClaw → OpenClaw 正名 | ✅ | ✅ | ✅ | **通過** |
| Ollama-First 零成本策略 | ✅ | ✅ | ✅ | **通過** |
| Telegram Gateway 整合 | ✅ | ✅ | ⚠️ | **附安全條件通過** |
| executor.py Skill 封裝 | ✅ | N/A | ✅ | **通過** |
@@ -111,7 +111,7 @@ AWOOOI 2.0 - OpenClaw 實體化升級藍圖 (Phase 5)
| Phase | 任務 | 負責 | 預估 | 前置條件 |
|-------|------|------|------|----------|
| 5.1 | 全專案正名 ClawBot → OpenClaw | CTO | 2h | 無 |
| 5.1 | 全專案正名 OpenClaw → OpenClaw | CTO | 2h | 無 |
| 5.2 | agent.md 靈魂定義 + capabilities.json | CTO | 1h | 5.1 |
| 5.3 | models.json AI 路由設定 | CTO | 1h | 5.1 |
| 5.4 | ContextGatherer 告警上下文收集 | CTO | 2h | Phase 5 架構 |
@@ -151,7 +151,7 @@ AWOOOI 2.0 - OpenClaw 實體化升級藍圖 (Phase 5)
**預期交付**:
1. 所有 ClawBot 字串替換為 OpenClaw
1. 所有 OpenClaw 字串替換為 OpenClaw
2. agent.md 身份定義檔案
3. Git status 報告
@@ -243,13 +243,13 @@ Phase 5 OpenClaw 升級計畫已整合至：
```typescript
// 前端 (index.ts)
export { OpenClawPanel as ClawBotPanel } from './openclaw-panel'
export { OpenClawStateMachine as ClawBotStateMachine } from './openclaw-state-machine'
export { OpenClawPanel as OpenClawPanel } from './openclaw-panel'
export { OpenClawStateMachine as OpenClawStateMachine } from './openclaw-state-machine'
```
```python
# 後端 (openclaw.py)
ClawBotService = OpenClawService
OpenClawService = OpenClawService
get_clawbot = get_openclaw
```