对齐文件规范

docs/05-07-openclaw应用部署.md

@@ -3,6 +3,14 @@
 > 本文采用 **Docker 独立部署 + K3s Traefik 反向代理** 的方式集成 OpenClaw：  
 > OpenClaw Gateway 本身运行在一台 x86 主机上，K3s 只负责入口统一转发，并不直接在集群内以 Pod 形式运行 OpenClaw。
 
+
+## TL;DR
+
+- **自动化验收**：`./scripts/verify.sh run 05-07`
+- **关键前置**：按本文「前置条件」准备环境变量/Secret/入口 IP
+- **成功判据**：达到本文「预期」且 playbook 断言通过
+- **排障**：见本文「排障」
+
 ## 前置条件
 
 - 已完成基础集群安装：`01-01`、`01-02`
@@ -43,12 +51,12 @@ docker compose run --rm openclaw-cli dashboard --no-open
 
 ## 在 K3s 中做静态转发
 
-**唯一真源**：[`ansible/files/05-07-openclaw/openclaw-proxy.yaml`](../ansible/files/05-07-openclaw/openclaw-proxy.yaml)（按实际 IP、端口、`host` 修改）。
+**唯一真源**：[`ansible/files/05-07/openclaw-proxy.yaml`](../ansible/files/05-07/openclaw-proxy.yaml)（按实际 IP、端口、`host` 修改）。
 
 ## 部署命令
 
 ```bash
-kubectl apply -f ansible/files/05-07-openclaw/openclaw-proxy.yaml
+kubectl apply -f ansible/files/05-07/openclaw-proxy.yaml
 ```
 
 ## 验证命令
@@ -68,4 +76,8 @@ curl -I --max-time 3 http://openclaw.example.com/
 - 如需为 OpenClaw 容器挂载额外挂载目录或持久化 `/home/node`，请参考官方 Docker 文档中的 `OPENCLAW_EXTRA_MOUNTS` 与 `OPENCLAW_HOME_VOLUME` 说明。
 - 返回 `00-00-构建总览.md`，按导航继续阅读其它应用部署文档。
 
+## 排障
 
+- **先看 playbook 输出**：失败时先定位是 deploy/wait/http_check 哪一步。
+- **集群侧总览**：`kubectl get nodes -o wide`、`kubectl -n kube-system get pods -o wide`。
+- **事件与日志**：`kubectl -n <ns> describe ...`、`kubectl -n <ns> logs ... --tail=200`。