yangxuan
ae7ca0c005
- 根因: 入口 openclaw.mjs 是 #!/usr/bin/env node，非交互 shell 的 PATH 不含 nvm 目录，node 落到系统 /usr/bin/node = v22.23.1，报 node:sqlite NUL 错误拒绝运行 - 方案: scripts/bin/openclaw 用绝对路径固定 node v26.8.2；实测 models list / doctor 均正常（此前 models list 直接报错） - 未选方案: 删 /usr/bin/node 会破坏 Debian 包依赖（dpkg -S nodejs 拥有）； 删 nvm 会让 gateway 服务无法启动（ExecStart 指向 nvm 26 路径）
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。 - 新增文档：按
序号或明确主题命名，并登记到本文件。