yangxuan
cb9c8f24e8
经实测澄清（此前表述不够精确）: - 场景① 非交互 ssh 裸调 → openclaw: command not found（nvm 未加载则 openclaw 不在 PATH） - 场景② PATH 有 openclaw 但 Node 是 22 → 报 node:sqlite 准入错误并拒跑 - 场景③ 交互式 shell（PATH 含 v26）→ 正常 - 关键机制: openclaw 入口自带运行时准入+自动重试，PATH 里存在合格 Node (24.16+/26.1+) 时会自动改用其重跑，仅在 PATH 无合格 Node 时才拒跑 - 补充: 交互式用 ~/.local/bin/openclaw 包装脚本；非交互场景不加载 ~/.profile 故包装脚本不生效，须显式 source nvm.sh 或用绝对路径
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 |
目录约定
- 不含明文口令：仅记录凭据的存放位置（见系统说明 §6）；备份包含凭据，勿外发。
- 文档是快照：版本、磁盘占用、插件清单等会变化，下判断前先用命令核对（首选
openclaw doctor）。 - 改动后要推送：本目录属于
~/.openclaw这个 git 仓库（分支314、remote 为 Gitea）。 该仓库的auto-commit-config.sh在「无变更」时会直接退出、不推送，因此手动提交后必须自己git push origin 314。 - 新增文档：按
序号或明确主题命名，并登记到本文件。