# 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、踩坑清单、回滚步骤 |
| 3 | `agent-创建规范与自动化-设计.md` | **待实现的设计**：新建 agent 的命名规范（id 用 ASCII / 展示层全中文）、每 agent 专属 MySQL 库与专用账号、中文模板四件套、每日备份改造（硬编码→动态发现）、技能强制性（档①）与决策记录 |
| 4 | `agent-创建规范-实现计划.md` | 上述设计的实现计划：任务切分（A 脚本+模板 / B skill / C 备份改造 / D 红线 / E 存量）、关键代码与验收标准 |
| 5 | `agent-juaner-卷儿-检查报告.md` | juaner（卷儿）检查报告与决策：基本档案、职责设定 vs 实际行为、权限边界、**4 项发现**（记账零数据 / 无定时提醒 / bash 中文变量名不可用 / DREAMS 语言无配置解）、**2026-09-16 安全放宽决策**、邮箱登记与未决待办 |
| 6 | `openclaw-API响应性能分析与优化.md` | **「API 响应很慢」的实测结论**：两天 419 次调用 / 69 段交互，deepseek-flash p50 **302ms** 而模型耗时仅占 **5.4%**（94.6% 花在串行工具循环）；new-api 慢 5 倍已移除；含瓶颈定位、P0/P1/P2 优化建议、验收指标与**未验证项声明**。配套脚本 `scripts/perf-analyze.py` |
| 7 | `bk02-dsh-openclaw-ACP集成.md` | **DSH × OpenClaw ACP 协同**：dsh 0.1.5-rc.1 安装与 `acp` profile、插件（`skillhub-plugin` / `superpowers-dsh`，含 **skillhub 污染 ACP stdout** 的坑与处置）、`~/.dsh/AGENTS.md` 全局中文指令、OpenClaw `@openclaw/acpx` 与 `dsh` harness/agent 注册（含 `Unknown agent id` 坑）、端到端验证证据（含「假成功」反例判据）、DSH Web（127.0.0.1:18787 + tailscale serve + token）、**微信/飞书/钉钉渠道 ACP 绑定能力实测**与 `delegate-to-dsh` 技能派发、排错清单与回滚。配套脚本 `dsh-acp-smoke.mjs`、`dsh-lang-check.mjs`，技能 `skills/delegate-to-dsh/` |

## 目录约定

1. **不含明文口令**：仅记录凭据的存放位置（见系统说明 §6）；备份包含凭据，勿外发。
2. **文档是快照**：版本、磁盘占用、插件清单等会变化，下判断前先用命令核对（首选 `openclaw doctor`）。
3. **改动后要推送**：本目录属于 `~/.openclaw` 这个 git 仓库（分支 `314`、remote 为 Gitea）。
   该仓库的 `auto-commit-config.sh` 在「无变更」时会**直接退出、不推送**，因此**手动提交后必须自己 `git push origin 314`**。
4. **新增文档**：按 `序号` 或明确主题命名，并登记到本文件。