docs: 增补 bk02 openclaw 系统说明与文档索引（新会话接手入口）

2026-09-16 10:49:29 +08:00
parent ebc140e2d1
commit c91b00b26e
2 changed files with 347 additions and 0 deletions
@@ -0,0 +1,17 @@
+# bk02 openclaw 文档目录
+
+> 本目录存放**本机 OpenClaw 系统**的运维文档。
+> **新会话 / 新人接手请先读第 1 份**，无需依赖任何历史对话。
+
+| # | 文档 | 内容 |
+|---|---|---|
+| 1 | `bk02-openclaw-系统说明.md` | **接手入口**：主机与访问、架构、关键路径速查、服务与运维命令、存储结论（SQLite-only）、配置与凭据位置、插件、备份/回滚/Git 仓库、**排查手册**、已知边界与坑 |
+| 2 | `openclaw-升级与维护.md` | 2026-09-16 升级实测记录：Node 22.23.1→26.8.2、OpenClaw 2026.8.1→2026.9.4、清理 4.6G、踩坑清单、回滚步骤 |
+
+## 目录约定
+
+1. **不含明文口令**：仅记录凭据的存放位置（见系统说明 §6）；备份包含凭据，勿外发。
+2. **文档是快照**：版本、磁盘占用、插件清单等会变化，下判断前先用命令核对（首选 `openclaw doctor`）。
+3. **改动后要推送**：本目录属于 `~/.openclaw` 这个 git 仓库（分支 `314`、remote 为 Gitea）。
+   该仓库的 `auto-commit-config.sh` 在「无变更」时会**直接退出、不推送**，因此**手动提交后必须自己 `git push origin 314`**。
+4. **新增文档**：按 `序号` 或明确主题命名，并登记到本文件。