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。
3.1 KiB
3.1 KiB
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。 - 新增文档:按
序号或明确主题命名,并登记到本文件。