踩坑记录 - OpenClaw安装配置

记录我们遇到的各种坑，避免重复踩坑

2026-02-26 飞书插件配置

坑1：插件没安装就配置JSON

现象：

• 在JSON里配置了 memory-lancedb-pro
• 但实际没安装这个插件
• Gateway启动失败：plugin not found

解决方案：

• 删除JSON里的插件配置
• 或者先安装插件再配置

坑2：旧配置残留

现象：

• 每次修改JSON后，Gateway还是报旧错误
• 原来修改没成功生效

解决方案：

• 直接删除配置文件重新配置
• Remove-Item "C:\Users\xxx\.openclaw\openclaw.json" -Force

坑3：环境变量引用

现象：

• JSON里引用 ${JINA_API_KEY}
• 但这个环境变量不存在
• 报错：Missing env var "JINA_API_KEY"

解决方案：

• 删掉这个插件配置
• 或者设置环境变量

教训

1. 先测试插件，再配置JSON
2. 修改后要确认生效
3. 引用环境变量前先检查

记录时间：2026-02-26

2026-02-27 补充：记忆增强方法论

核心原则

1. 有技术细节 + 方法论相互配合 - 技术细节解决具体问题，方法论指导未来决策

记忆管理策略

记录什么？

• 踩坑记录：现象 → 原因 → 解决方案
• 方法论：最佳实践、设计模式、架构原则
• 配置经验：环境设置、参数调优

何时记录？

• 遇到报错/踩坑 → 立即记录
• 学到新技能 → 马上存入
• 配置变更 → 详细记录步骤

何时检索？

• 新会话开始 → 主动检索项目背景
• 遇到相似问题 → 先查历史解决方案
• 执行操作前 → 查询已知坑点

认知纪律

• "调用任何工具失败或报错后，先搜索经验再重试"
• 失败 → 搜索 → 重试（不要直接硬试）
• 逻辑改动后必须测试
• 多Agent交叉审查

2026-03-11 工具参数坑点

坑：write工具参数名错误

现象：

• 调用 write 工具时使用了 path 参数
• 报错：Missing required parameter: path (path or file_path)
• 连续3次失败

原因：

• write 工具的正确参数名是 file_path
• 不是 path

解决方案：

• 使用 file_path 作为参数名
• 注意：read 和 edit 工具可以用 path 或 file_path
• 但 write 必须用 file_path

记忆口诀：

write用file_path，read/edit两者皆可

记录时间：2026-03-11

项目隔离

• 医疗旅游 → memory/医疗旅游_xxx.md
• 龙康劲 → memory/龙康劲_xxx.md
• 通用 → MEMORY.md