yangxuan
43cd42a563
- openclaw.json
- plugins.allow 放行 acpx（限制性白名单，缺了后端不会加载）
- 新增 acp 策略段：enabled/dispatch、backend=acpx、defaultAgent=dsh、
allowedAgents=[dsh]、stream.deliveryMode=live
- 新增 plugins.entries.acpx.config：permissionMode=approve-all、
timeoutSeconds=900、cwd、agents.dsh = dsh --profile acp（绝对路径）
- 新增 OpenClaw agent dsh（runtime.type=acp → harness dsh），否则
sessions_spawn 会报 dispatch_failed: Unknown agent id "dsh"
- workspace-dsh/：该 agent 的身份文件（AGENTS/SOUL/IDENTITY/USER/BOOTSTRAP.md）。
其中的空 .git 由 `openclaw agents add` 的标准 provisioning 生成（非任何 agent 自建），
会让父仓库把它当 gitlink，已移除后纳入版本控制
- docs/bk02-dsh-openclaw-ACP集成.md：部署/配置/验证证据/排错/回滚全文
- docs/dsh-acp-smoke.mjs：ACP 独立冒烟（initialize→session/new→prompt→close）
- docs/dsh-lang-check.mjs：全局中文指令验证（英文提问看是否回中文）
- skills/delegate-to-dsh：让「交给 dsh」稳定走 ACP 派发；缺此技能时模型会
静默 fallback 到内嵌 subagent（已复现「假成功」并写入判据）
- agents/main/agent/workshop-skills/acp-backend-triage：ACP 后端排查技能
- plugin-skills/acp-router：acpx 插件自带技能（symlink，与既有渠道一致）
- .gitignore：workspace-dsh 沿用 workspace/ 白名单（只版本化顶层 *.md）；
新增忽略 acpx/ 插件运行产物
验证：ACP 三条途径均通过（独立冒烟、显式 sessions_spawn、自然语言「转给 dsh」），
DSH 侧会话留痕与产物落地见 docs 文档 §5 与 §7。
23 lines
3.1 KiB
Markdown
23 lines
3.1 KiB
Markdown
# 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. **新增文档**：按 `序号` 或明确主题命名，并登记到本文件。
|