Files
openclaw-config/docs
yangxuan 0865090a2b fix(tools): 清除 36 条无法注册的飞书工具声明,未注册告警 20→0
根因(实测两层):
- tools.alsoAllow 声明 37 个 feishu_* 工具,仅 feishu_chat 能注册
- 其余 36 个由 @larksuite/openclaw-lark 提供,而该插件无法加载:
  require("openclaw/plugin-sdk") 在 openclaw 2026.9.4 的 exports 中不存在
  (只有 ./plugin-sdk/core 等子路径);插件版本 2026.6.10 落后一个大版本

关键对照: @openclaw/feishu 2026.9.4 已装且 loaded,提供 14 个飞书工具
(doc/wiki/drive/perm/bitable),能力无损失 —— 无需依赖 lark 插件

处置:
- tools.alsoAllow: 37 条 -> 1 条(feishu_chat)
- plugins.entries.openclaw-lark.enabled 保持 false(曾置 true 验证失败后回退)
- 重启验证: 未注册告警 0、插件加载失败 0、feishu 14 工具全在、飞书渠道正常
- 文档补充"渠道层 vs 工具层"辨析:这也解释了为何手机飞书交互一直正常
2026-09-16 16:36:40 +08:00
..

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

目录约定

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