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