docs(ops): add oclaw and netx ops expert introduction guide

Introduce the ops specialist, netx integration, automation flows, and WhatsApp channel usage with Mermaid diagrams. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-09 00:40:45 +08:00 · 2026-07-14 17:18:08 +08:00 · 2026-07-14 17:18:08 +08:00 · 4c85dedf33
commit 4c85dedf33
parent ad1b95d0bc
1 changed files with 648 additions and 0 deletions
--- a/docs/presentations/oclaw-netx-ops-expert.md
+++ b/docs/presentations/oclaw-netx-ops-expert.md
@ -0,0 +1,648 @@
+# Oclaw 智能运维 — Oclaw + netx 运维专家介绍
+
+> 证据驱动 · 告警闭环 · 多渠道触达 · 可编排自动化
+
+---
+
+## 1. 整体定位
+
+**Oclaw** 是自托管的多专家 AI Agent 平台，提供 Admin、Chat 以及微信/WhatsApp 等渠道接入。
+
+**netx** 是告警-centric 的网络运维平台，负责 UME 告警同步、网元纳管与只读 CLI 执行。
+
+**运维专家（ops specialist）** 是 Oclaw 中的网络运维角色，对外 persona 为「**oclaw智能运维**」。它与 netx 深度集成，形成「数据面 + 推理面」的完整运维闭环。
+
+| 项目 | 角色 | 核心职责 |
+|------|------|----------|
+| Oclaw | AI 交互与编排层 | Agent 推理、工具调用、Skills、渠道回复 |
+| netx | 数据与设备执行层 | 告警采集/查询、网元纳管、安全 CLI |
+| 运维专家 | Oclaw 中的 ops 专家 | 查告警、诊断网元、生成报告、触发自动化 |
+
+```mermaid
+flowchart LR
+  subgraph User["用户与渠道"]
+    Chat[Chat / Admin]
+    WA[WhatsApp 值班群]
+  end
+
+  subgraph Oclaw["Oclaw"]
+    GW[Gateway / 路由]
+    Ops[运维专家 Agent]
+    Skills[Skills + MCP]
+  end
+
+  subgraph netx["netx"]
+    API[FastAPI :8890]
+    PG[(PostgreSQL)]
+    UME[ZTE UME]
+  end
+
+  Chat --> GW
+  WA --> GW
+  GW --> Ops
+  Ops --> Skills
+  Skills -->|MCP 13 工具| API
+  API --> PG
+  UME --> API
+  API -->|AI 分析 / 告警推送| Oclaw
+```
+
+---
+
+## 2. Oclaw 平台概览
+
+### 2.1 用户入口
+
+- **Admin**：`http://127.0.0.1:8787/admin` — 配置 MCP、专家、渠道、模型
+- **Chat**：`http://127.0.0.1:8787/chat` — 与专家对话
+- **渠道**：微信、WhatsApp、企微等，可绑定默认专家
+
+### 2.2 专家体系
+
+| specialist | 说明 |
+|------------|------|
+| **ops** | 网络运维专家（本文重点） |
+| generalist | 通用任务 |
+| memory | 知识/记忆 |
+| image / video / stock | 专项能力 |
+
+### 2.3 交互模式
+
+- **expert**：用户直连某一专家（如 ops）
+- **comprehensive**：经理 Agent 编排，按任务委派给 ops 等专家
+
+### 2.4 分层架构
+
+```
+runtime/        Agent 循环、路由、Skills、调度
+interfaces/     HTTP/WS、Admin UI、Gateway
+platform/       配置、持久化、LLM 传输
+tools/          专家工具、公共工具、MCP 适配
+skills/         可安装技能包（SKILL.md）
+```
+
+### 2.5 消息处理流程
+
+```mermaid
+flowchart TD
+  A[入站消息] --> B{渠道路由}
+  B -->|specialist=ops| C[NetworkOpsAgent]
+  B -->|comprehensive| D[Manager Agent]
+  D -->|委派网络任务| C
+  C --> E[加载 ROLE_SYSTEM + Skills]
+  E --> F[工具集: network_ops + memory + MCP]
+  F --> G{Agent 循环}
+  G -->|调工具拿证据| H[netx / 文件 / 调度等]
+  H --> G
+  G -->|生成结论| I[文本 / 附件 / 定时任务]
+  I --> J[Chat / 渠道回复]
+```
+
+---
+
+## 3. 运维专家（Ops Expert）
+
+### 3.1 身份与实现
+
+| 项 | 值 |
+|----|-----|
+| specialist ID | `ops` |
+| 对外名称 | oclaw智能运维 |
+| 工具包 | `network_ops+memory` |
+| Agent 类 | `NetworkOpsAgent` |
+| 角色定义 | `runtime/workspaces/ops/ROLE_SYSTEM.md` |
+
+### 3.2 核心原则
+
+1. **证据优先** — 先用工具查日志、状态、配置，再下结论
+2. **变更安全** — 破坏性操作需明确影响范围与回滚方案
+3. **可验证输出** — 结论 → 证据 → 最小修复步骤
+4. **网元展示** — 一律以 `host_name` 为主键，禁止对用户展示 UUID `ne_id`
+
+### 3.3 工具来源
+
+```mermaid
+flowchart TB
+  Ops[运维专家 Agent]
+  Ops --> EN[Expert 工具\nnetwork_ops + memory]
+  Ops --> PU[Public 工具\nread_file / schedule_create 等]
+  Ops --> MCP[MCP 工具\nmcp__netx__*]
+
+  EN --> NT[netx_tools.py\n可选 legacy inline]
+  MCP --> NX[netx MCP Server\n13 个工具]
+```
+
+---
+
+## 4. netx 平台概览
+
+### 4.1 定位与技术栈
+
+netx 是面向 ZTE UME 环境的网络运维平台（v0.2），提供 Web UI、REST API 与 MCP 接入。
+
+| 组件 | 技术 |
+|------|------|
+| 后端 | Python 3.11+ / FastAPI / PostgreSQL / Netmiko |
+| 前端 | React 19 + Vite |
+| 默认端口 | API `:8890`，Web UI `:5173` |
+
+### 4.2 数据来源
+
+- **主路径**：UME RESTCONF + WSS 实时订阅（当前告警、网元清单）
+- **兼容路径**：ZTE Alarm Monitor Excel 导入
+
+### 4.3 核心模块
+
+| 模块 | 路径 | 能力 |
+|------|------|------|
+| UME 同步 | `netx_api/ume_sync_service.py` | 告警/网元定时与实时同步 |
+| 只读 CLI | `netx_api/ne_exec.py` | 安全的 show/display/ping 执行 |
+| 纳管网元 | `netx_api/managed_ne_router.py` | SSH/Telnet 设备 CRUD、跳板机 |
+| MCP 代理 | `packages/netx-mcp/` | stdio → HTTP，不直连数据库 |
+| Oclaw 桥接 | `netx_api/ap_client.py` | AI 分析回调 |
+| 告警推送 | `netx_api/oclaw_alarm_forwarder.py` | 关键告警 WebSocket 转发 |
+
+### 4.4 netx 内部架构
+
+```mermaid
+flowchart TB
+  subgraph Sources["数据源"]
+    UME[ZTE UME RESTCONF + WSS]
+    Excel[Alarm Monitor Excel]
+  end
+
+  subgraph Backend["netx_api"]
+    Main[main.py FastAPI]
+    Sync[ume_sync_service]
+    Exec[ne_exec.py]
+    AP[ap_client → Oclaw]
+    FWD[oclaw_alarm_forwarder]
+  end
+
+  subgraph Storage["存储"]
+    PG[(PostgreSQL)]
+  end
+
+  subgraph Access["访问层"]
+    Web[React Web UI :5173]
+    MCP[netx-mcp :8890 API]
+  end
+
+  UME --> Sync
+  Excel --> Main
+  Sync --> PG
+  Main --> PG
+  Exec --> PG
+  Web --> Main
+  MCP --> Main
+  AP --> Oclaw[Oclaw analyze-sync]
+  FWD --> Oclaw
+```
+
+---
+
+## 5. Oclaw ↔ netx 双向集成
+
+### 5.1 三个集成方向
+
+| 方向 | 机制 | 用途 |
+|------|------|------|
+| Oclaw → netx | MCP（13 工具） | 运维专家查告警、网元、执行 CLI |
+| netx → Oclaw | `POST /v1/ap/analyze` | Web UI 一键 AI 告警分析 |
+| netx → Oclaw | WebSocket 告警推送 | 关键告警即时通知到渠道 |
+
+### 5.2 集成时序
+
+```mermaid
+sequenceDiagram
+  participant U as 用户 / 渠道
+  participant O as Oclaw 运维专家
+  participant M as netx MCP
+  participant N as netx API
+  participant E as UME / 设备
+
+  U->>O: 查当前 Critical 告警 Top 10
+  O->>M: mcp__netx__aggregateUmeAlarms
+  M->>N: GET /v1/ume/alarms/aggregate
+  N->>E: 读 PG（已同步数据）
+  N-->>O: 按 host_name 聚合结果
+  O-->>U: 结论 + 证据 + 建议步骤
+
+  Note over N,O: 反向：netx Web UI 触发 AI 分析
+  N->>O: POST analyze-sync（带告警上下文）
+  O-->>N: AI 分析结论
+
+  Note over N,O: 反向：关键告警推送
+  E->>N: WSS 新告警
+  N->>O: WebSocket netx-bridge
+  O->>U: WhatsApp / 微信通知
+```
+
+### 5.3 认证与环境变量
+
+| 用途 | netx | Oclaw |
+|------|------|-------|
+| AI 分析桥 | `NETX_OCLAW_ANALYZE_TOKEN` | `OCLAW_OPS_AI_SHARED_TOKEN` |
+| 告警 WS | `NETX_OCLAW_ALARM_WS_URL` | `ws://127.0.0.1:8787/ws/netx-bridge` |
+| MCP 地址 | — | MCP env `NETX_API_URL=http://127.0.0.1:8890` |
+
+详细说明见 [`docs/NETX_MCP_INTEGRATION.md`](../NETX_MCP_INTEGRATION.md)。
+
+---
+
+## 6. MCP 工具一览
+
+在 Oclaw Admin 安装 MCP（`server_id=netx`）并绑定到 ops 专家后，工具以 `mcp__netx__<toolName>` 形式注入。
+
+### UME 告警
+
+| 工具 | 说明 |
+|------|------|
+| `queryUmeAlarms` | 分页查询当前告警 |
+| `aggregateUmeAlarms` | 按维度聚合统计 |
+| `runUmeDiagnostics` | 运行诊断规则 |
+
+### UME 网元
+
+| 工具 | 说明 |
+|------|------|
+| `queryUmeNeInventory` | 网元清单查询 |
+| `getUmeNe` | 单个网元详情 |
+
+### 深查分析
+
+| 工具 | 说明 |
+|------|------|
+| `queryUmeAlarmsRaw` | 原始字段查询 |
+| `aggregateUmeAlarmsRaw` | 原始字段聚合 |
+| `listUmeAlarmFields` | 可用字段列表 |
+| `sqlQueryUme` | 只读 SQL 查询 |
+
+### 纳管网元 CLI
+
+| 工具 | 说明 |
+|------|------|
+| `listManagedNe` | 列出纳管设备 |
+| `getManagedNe` | 设备详情 |
+| `execManagedNe` | 执行只读 CLI |
+| `listCliTargets` | 可用 CLI 目标 |
+
+---
+
+## 7. 只读 CLI 安全模型
+
+`ne_exec.py` 是 netx 设备自动化的安全核心，对应 MCP 工具 `execManagedNe`。
+
+```mermaid
+flowchart TD
+  A[execManagedNe 请求] --> B{命令校验}
+  B -->|show/display/ping| C[解析目标设备]
+  B -->|configure/reload/delete 等| X[拒绝]
+  C --> D{目标类型}
+  D -->|纳管网元| E[SSH/Telnet + Netmiko]
+  D -->|UME 网元| F[Lazy CLI Profile]
+  E --> G[执行 ≤5 条命令]
+  F --> G
+  G --> H[输出 ≤32KB]
+  H --> I[结构化返回]
+```
+
+**约束摘要：**
+
+- 允许前缀：`show`、`display`、`ping`、`ping6`
+- 禁止：`configure terminal`、`reload`、`commit`、`delete` 等
+- 单次最多 5 条命令，输出上限 32KB
+- 凭证 Fernet 加密，需 `NETX_CREDENTIAL_SECRET_KEY`
+
+---
+
+## 8. Ops 专属 Playbook（Skills）
+
+运维专家处理 netx 相关任务时，须加载对应技能：
+
+| Skill | 路径 | 场景 |
+|-------|------|------|
+| `ops-netx-ume-playbook` | `skills/_workspace/ops/ops-netx-ume-playbook/` | UME 告警查询/聚合/诊断、网元清单 |
+| `ops-netx-managed-ne-playbook` | `skills/_workspace/ops/ops-netx-managed-ne-playbook/` | 纳管设备 SSH/Telnet 只读巡检 |
+
+所有专家也可使用的公共技能：
+
+| Skill | 场景 |
+|-------|------|
+| `scheduled-workflows` | 周期性多步运维任务（告警周报 → PDF → 发群） |
+| `channel-file-delivery` | CSV/PDF 报告通过渠道附件发送 |
+
+Ops 私有技能安装目录：`skills/_workspace/ops/<name>/`（`public=false`）。
+
+---
+
+## 9. 自动化场景
+
+### 9.1 定时告警周报
+
+```mermaid
+flowchart LR
+  A[用户描述需求] --> B[schedule_propose\n生成 recipe 草案]
+  B --> C[用户确认]
+  C --> D[schedule_create]
+  D --> E[Scheduler Worker]
+  E --> F[ops 身份执行]
+  F --> G[查 netx 告警]
+  G --> H[生成 PDF]
+  H --> I[WhatsApp 群发附件]
+```
+
+示例：「每周一 9:00 汇总上周值班告警，生成 PDF，发到 WhatsApp 群」
+
+Recipe 自包含，worker 执行时不依赖原始聊天上下文；创建者专家（ops）的工具上下文会被继承。
+
+### 9.2 关键告警实时推送
+
+netx 匹配到关键告警后，经 WebSocket 推送到 Oclaw，再投递到已绑定的 **WhatsApp 告警群**（详见 [§10 WhatsApp 渠道应用](#10-whatsapp-渠道应用)）。
+
+### 9.3 Web UI AI 分析
+
+netx 前端 Workbench 可调用 `/v1/ap/analyze`，将告警上下文发给 Oclaw 运维专家做智能分析。
+
+---
+
+## 10. WhatsApp 渠道应用
+
+WhatsApp 是运维场景中最常用的**移动端触达渠道**：值班人员可在群里直接问告警、收周报、收关键告警推送，无需打开 Admin 或 netx Web UI。
+
+### 10.1 技术架构
+
+当前默认链路为 **Baileys sidecar**（WhatsApp Web 协议），不依赖外部 openclaw 服务：
+
+```mermaid
+flowchart TB
+  subgraph Mobile["移动端"]
+    Phone[WhatsApp 手机端]
+    Group[运维值班群]
+  end
+
+  subgraph Sidecar["WhatsApp Sidecar"]
+    Baileys[Baileys Runner\nruntime/operations/whatsapp_bridge/]
+    Auth[state/auth 登录态]
+  end
+
+  subgraph Oclaw["Oclaw Gateway :8787"]
+    Inbound[POST /inbound/whatsapp]
+    Route[渠道路由\nspecialist=ops]
+    Ops[运维专家 Agent]
+    OutQ[出站消息队列]
+    Bridge[WS /ws/netx-bridge]
+  end
+
+  subgraph netx["netx"]
+    Alarm[关键告警规则]
+  end
+
+  Phone <-->|扫码关联设备| Baileys
+  Baileys --> Auth
+  Group -->|群消息 / 私聊| Baileys
+  Baileys -->|转发入站| Inbound
+  Inbound --> Route --> Ops
+  Ops -->|replies + 附件| OutQ
+  OutQ -->|轮询 pending| Baileys
+  Baileys -->|回发| Group
+
+  Alarm -->|WebSocket netx.alarm| Bridge
+  Bridge --> OutQ
+```
+
+**关键路径：**
+
+| 环节 | 端点 / 脚本 |
+|------|-------------|
+| 入站 | sidecar → `POST /inbound/whatsapp` → 返回 `replies[]` |
+| 出站 | sidecar 轮询 `GET /whatsapp/outbound/pending` 并发送 |
+| 登录态 | `data/channel_sidecar/whatsapp/state/auth/` |
+| 扩展实现 | `runtime/extensions/whatsapp/` |
+
+### 10.2 安装与设备绑定
+
+```powershell
+# 仓库根目录
+powershell -ExecutionPolicy Bypass -File .\runtime\operations\scripts\whatsapp_install.ps1
+powershell -ExecutionPolicy Bypass -File .\runtime\operations\scripts\whatsapp_login.ps1   # 控制台打印二维码
+powershell -ExecutionPolicy Bypass -File .\runtime\operations\scripts\whatsapp_start.ps1
+powershell -ExecutionPolicy Bypass -File .\runtime\operations\scripts\whatsapp_status.ps1
+```
+
+| 操作 | 说明 |
+|------|------|
+| 首次登录 | 手机 WhatsApp → 设置 → 已关联的设备 → 扫码 |
+| 重启 sidecar | 一般无需重复扫码（登录态落盘） |
+| 换号 / 解除关联 | 先 `whatsapp_stop.ps1 -Force`，删除 `state/auth`，再 `whatsapp_login.ps1` |
+| 随全栈启动 | `scripts/start_all.ps1`（未安装 sidecar 时自动跳过并告警） |
+
+### 10.3 路由到运维专家
+
+在 Admin 将 WhatsApp 消息路由到 ops 专家，有两种配置入口：
+
+| 配置位置 | 操作 |
+|----------|------|
+| **Stack 页面** | `WhatsApp dispatch` 控制卡 → 选「绑定专家」→ specialist 选 `ops` |
+| **用户/渠道绑定** | `channel=whatsapp` → 按账号配置专家与模式 |
+
+**交互模式：**
+
+- **绑定专家（expert）**：所有消息直连 ops 运维专家（推荐运维群场景）
+- **综合（comprehensive）**：经理 Agent 编排，网络任务委派给 ops
+
+**优先级**：账号级配置 > 通道全局配置 > 默认（`expert + generalist`）
+
+**用户归属绑定**（设备已连、需把联系人归属到团队用户）：
+
+1. Admin → 用户/渠道绑定 → 渠道选 `whatsapp`
+2. 生成绑定码，用户向机器人发送：`bind <绑定码>`
+
+### 10.4 群聊触发策略
+
+WhatsApp 群聊默认**不会响应每条消息**，避免群内噪声触发 Agent：
+
+| 规则 | 默认值 | 环境变量 |
+|------|--------|----------|
+| 需要 @ 机器人 | 开启 | `AIA_WHATSAPP_GROUP_REQUIRE_MENTION=1` |
+| 文本触发词 | `/oclaw`、`|oclaw` | `AIA_WHATSAPP_GROUP_TRIGGERS` |
+| 会话作用域 | 按群隔离 | `AIA_WHATSAPP_GROUP_SESSION_SCOPE` |
+
+```mermaid
+flowchart TD
+  A[群消息入站] --> B{是否 @ 了机器人?}
+  B -->|是| C[进入运维专家处理]
+  B -->|否| D{含触发词\n/oclaw 或 |oclaw?}
+  D -->|是| C
+  D -->|否| E[静默跳过]
+  C --> F[查 netx / 生成报告 / 回复]
+```
+
+私聊消息不受 @ 限制，直接路由到绑定专家。
+
+### 10.5 运维应用场景
+
+#### 场景一：群内交互式运维
+
+值班人员在 WhatsApp 群 @ 机器人提问，运维专家通过 netx MCP 查告警、聚合统计、执行只读 CLI：
+
+```text
+用户（群内）：@oclaw 查当前 Critical 告警 Top 5，按 host_name 排名
+
+运维专家：
+  1. 加载 ops-netx-ume-playbook
+  2. mcp__netx__aggregateUmeAlarms(severity=critical, group_by=alarm_host_name)
+  3. 返回结论 + 证据表格
+```
+
+#### 场景二：关键告警推送到值班群
+
+netx 配置关键告警规则后，匹配到的告警实时推到 WhatsApp 群，无需人工刷新：
+
+```mermaid
+sequenceDiagram
+  participant UME as UME WSS
+  participant N as netx
+  participant WS as Oclaw netx-bridge
+  participant Q as 出站队列
+  participant SC as WhatsApp Sidecar
+  participant G as 值班群
+
+  UME->>N: 新告警事件
+  N->>N: key_alert_matcher 规则匹配
+  N->>WS: WebSocket event: netx.alarm
+  WS->>WS: 查 whatsapp_alert_binding
+  WS->>Q: enqueue_channel_outbound_message
+  SC->>Q: GET /whatsapp/outbound/pending
+  SC->>G: 发送告警文本
+```
+
+**告警消息格式示例：**
+
+```text
+[UME Alarm Raised] Fan
+Device: LPG-BKM-AN1-ZM3SP (114.0.24.178)
+Object: ME{abc},FAN={/module=0}
+Severity: major
+Cause: Fan The fan speed level is abnormally high
+Time: 2026-06-22T19:29:41.086+07:00
+notificationId: 1680996323029
+```
+
+**Admin 配置告警群：**
+
+1. 打开 Admin → WhatsApp 相关页面（或调用 API）
+2. `GET /admin/api/whatsapp/groups` — 列出已知群（需 sidecar 运行且群内有消息）
+3. `POST /admin/api/whatsapp/alert-binding` — 绑定 `group_jid` 并启用
+4. `POST /admin/api/whatsapp/alert-binding/test` — 发送测试消息验证
+
+#### 场景三：定时周报发到 WhatsApp 群
+
+结合 `scheduled-workflows` + `channel-file-delivery` 技能：
+
+```text
+用户（群内）：每周一 9 点把上周告警汇总成 PDF 发到这个群
+
+流程：
+  1. schedule_propose → 生成自包含 recipe（含 netx 查询口径、PDF 路径、投递步骤）
+  2. 用户确认 preview_markdown
+  3. schedule_create(recipe=..., output.need_attachments=true)
+  4. 到点 worker 以 ops 身份执行 → 查 netx → 生成 PDF
+  5. save_deliverable_attachment → 投递到创建任务时的 WhatsApp 群
+```
+
+Recipe 中 `goal` 示例：
+
+> 每周一 09:00 汇总上一自然周值班告警，生成 PDF 发到当前 WhatsApp 群并 @值班人
+
+#### 场景四：附件报告投递
+
+运维专家生成的 CSV / Excel / PDF 不会自动发出，须调用 `save_deliverable_attachment`：
+
+```mermaid
+flowchart LR
+  A[write_file / run_command\n生成 report.xlsx] --> B[save_deliverable_attachment\npath=...]
+  B --> C[Agent 文字回复摘要]
+  C --> D[出站携带附件]
+  D --> E[WhatsApp Sidecar 发送文件]
+```
+
+限制：每轮回复通常只发**第一个** deliverable 附件（约 8MB 上限）。
+
+### 10.6 访问控制
+
+Admin 可配置 WhatsApp 联系人白名单/黑名单（`GET /admin/api/whatsapp/access`），控制哪些号码可与机器人交互。未绑定用户的消息按访问策略处理。
+
+### 10.7 相关环境变量
+
+| 变量 | 说明 |
+|------|------|
+| `AIA_WHATSAPP_ACCOUNT_ID` | 账号 ID，默认 `wa-default` |
+| `AIA_WHATSAPP_GROUP_REQUIRE_MENTION` | 群聊是否要求 @ 机器人 |
+| `AIA_WHATSAPP_GROUP_TRIGGERS` | 群聊文本触发词 |
+| `OCLAW_OPS_AI_SHARED_TOKEN` | netx-bridge 认证（告警推送） |
+| `NETX_OCLAW_ALARM_WS_URL` | netx 侧告警 WS 地址 |
+
+---
+
+## 11. 部署与启用
+
+```mermaid
+flowchart TD
+  S1[1. 启动 Oclaw Gateway\nscripts/start_gateway.ps1] --> S2[2. 启动 netx\nscripts/start_netx.ps1]
+  S2 --> S3[3. 配置 PostgreSQL + UME 连接\n.env]
+  S3 --> S4[4. Admin 安装 netx MCP\nserver_id=netx]
+  S4 --> S5[5. Health Check + Sync Tools]
+  S5 --> S6[6. 绑定 MCP 到 ops 专家]
+  S6 --> S7[7. 配置双向 Token]
+  S7 --> S8[8. Chat 选择运维专家验证]
+  S8 --> S9[9. 可选：WhatsApp sidecar\n安装 + 扫码 + 路由 ops]
+  S9 --> S10[10. 绑定告警群 + 测试推送]
+```
+
+| 步骤 | 命令/配置 |
+|------|-----------|
+| Oclaw | `powershell -File scripts/start_gateway.ps1 -Background` |
+| netx | `powershell -File scripts/start_netx.ps1` |
+| MCP | Admin → MCP Servers → 粘贴 `netx/mcp.json` |
+| Token | `OCLAW_OPS_AI_SHARED_TOKEN` ↔ `NETX_OCLAW_ANALYZE_TOKEN` |
+| 验证 | Chat 选 ops → 「查当前 UME Critical 告警 Top 5」 |
+| WhatsApp | `whatsapp_install.ps1` → `whatsapp_login.ps1` → `whatsapp_start.ps1` |
+| 路由 ops | Admin Stack → WhatsApp dispatch → 绑定专家 `ops` |
+| 告警群 | Admin → 绑定 `group_jid` → `alert-binding/test` |
+
+一键运维栈：`scripts/start_ops.ps1`（Oclaw + netx）；全栈含渠道：`scripts/start_all.ps1`。
+
+---
+
+## 12. 总结
+
+| 维度 | 要点 |
+|------|------|
+| Oclaw | 多专家 AI 平台，提供交互、编排、渠道 |
+| netx | 告警数据面 + 安全设备 CLI 执行 |
+| 运维专家 | 证据驱动、netx 深度集成、结构化 Playbook |
+| 集成契约 | MCP 13 工具 + 双向 API（分析 / 告警推送） |
+| 自动化 | 定时工作流 + 渠道附件 + 实时告警通知 |
+| WhatsApp | 移动端运维入口：交互查询、告警推送、周报投递 |
+
+**访问地址：**
+
+- Oclaw Admin：`http://127.0.0.1:8787/admin`
+- Oclaw Chat：`http://127.0.0.1:8787/chat`
+- netx Web UI：`http://127.0.0.1:5173`
+- netx API：`http://127.0.0.1:8890`
+
+---
+
+## 相关文档
+
+- [`README.md`](../../README.md) — Oclaw 快速开始
+- [`docs/NETX_MCP_INTEGRATION.md`](../NETX_MCP_INTEGRATION.md) — netx MCP 集成
+- [`docs/ARCHITECTURE_OVERVIEW.md`](../ARCHITECTURE_OVERVIEW.md) — Oclaw 架构
+- [`docs/RUNBOOK.md`](../RUNBOOK.md) — 部署与渠道配置（§4.2 WhatsApp）
+- [`runtime/extensions/whatsapp/README.md`](../../runtime/extensions/whatsapp/README.md) — WhatsApp 扩展说明
+- [`skills/_workspace/public/channel-file-delivery/SKILL.md`](../../skills/_workspace/public/channel-file-delivery/SKILL.md) — 渠道附件发送
+- [`skills/_workspace/public/scheduled-workflows/SKILL.md`](../../skills/_workspace/public/scheduled-workflows/SKILL.md) — 定时工作流
+- [`netx/README.md`](../../../netx/README.md) — netx 项目说明
+- [`netx/docs/MCP.md`](../../../netx/docs/MCP.md) — netx MCP 工具文档