OpenClaw Problem Solver自动修复小龙虾
v3.0一种专门用于诊断和解决OpenClaw问题或漏洞的技能。它优先搜索官方文档(docs.openclaw.ai),然...
运行时依赖
安装命令
点击复制技能文档
OpenClaw 问题解决器(v3.0) 该技能作为 OpenClaw 框架本身的专用诊断、解决和验证引擎,用于解决任何与 OpenClaw 相关的问题或 bug 报告。它超越了简单的搜索,通过必要的执行来验证解决方案。 何时使用此技能 当用户: 询问“为什么 [功能] 在 OpenClaw 中不工作?” 报告特定的 bug(例如“网关工具出现错误 X”) 需要指导如何使用 OpenClaw 的架构或工具实现特定的功能 想要知道 OpenClaw 生态系统中某项任务的最佳实践,但需要验证 核心工作流:6 步解决循环(v3.0) 当触发此技能时,必须按顺序执行以下步骤: 步骤 0:预检查和上下文收集 - NEW! 操作:在搜索之前,检查上下文以量身定制方法并设置安全参数 检查:会话状态:阅读 ~/proactivity/session-state.md 以获取最后一个显式目标或活动阻塞决策 用户首选项:检查 USER.md 和 IDENTITY.md(例如,首选文档来源,常见项目上下文) 初始分类和安全扫描:确定查询是否关于已知任务/bug 关键安全检查:扫描用户提问,判断是否包含敏感信息(API Key,Secret Token 等)。如果包含,则标记为 [RISK: HIGH]。 步骤 1:主要搜索 - 官方文档(docs.openclaw.ai) 操作:使用 tavily_search 以用户的问题描述为焦点搜索官方文档 查询焦点:用户的问题描述,可能由预检查上下文改进 参数:query:[用户的问题描述] include_answer:true(获取直接答案) search_depth: “高级” 目标:找到直接答案或相关文档页面的链接 步骤 2:回退搜索 - GitHub 问题(github.com/openclaw/openclaw/issues) 操作:如果步骤 1 没有产生满意的结果,则使用 tavily_search 再次搜索,目标是 GitHub 问题 查询焦点:用户的问题描述,通常以“OpenClaw 问题:[问题]”为前缀 参数:query: “[用户的问题描述] OpenClaw 问题” include_answer:true(获取最佳匹配问题的摘要) search_depth: “高级” 目标:找到现有的、已报告的 bug 或讨论线程,反映用户的问题 步骤 3:综合和决策(核心逻辑) 一旦从步骤 1 和/或步骤 2 收集结果,执行批判性思维以选择最佳路径 决策标准: 明确答案:文档提供了明确的解决方案 → 转到验证(步骤 4A) 变通方法:GitHub 问题提供了快速解决方案 → 提出变通方法并建议官方解决方案 → 转到验证(步骤 4B) 模糊/缺失:两者都很弱或相互矛盾 → 根据上下文制定询问 → 转到上下文询问(步骤 5C) 步骤 4:验证和操作(执行层)- NEW! 此步骤执行步骤 3 中选择的路径 A)直接答案:如果综合是明确的,则立即呈现解决方案并结束 B)代码/配置验证(MRE):如果问题与代码或配置相关,则主动调用 exec 以从搜索结果中派生出最小测试用例 C)上下文询问:如果需要更多数据,则根据上下文制定精确的问题(例如“请问您是在哪个项目目录下运行的?”或“能否提供一下报错时的完整日志文件?”) 步骤 5:最终化和内存更新(总结)- NEW! 在解决方案呈现或询问之后,此步骤确保连续性 操作:在结束之前,根据结果更新内存: 记住事实:存储核心问题/解决方案对(mem.remember(...)) 学习经验:如果需要复杂的变通方法,则将其记录为学习经验(mem.learn(...)) 更新状态:更新 ~/proactivity/session-state.md 以显示解决状态和下一步操作 如何帮助用户解决问题(流程总结) 用户提出问题 → 执行步骤 0(预检查) → 执行步骤 1 → 步骤 2(搜索链) → 执行步骤 3(综合和决策) → 执行步骤 4(验证/操作)基于步骤 3 的决策 → 执行步骤 5(最终化和内存更新) 示例交互流程(增强) 用户:“我发现用 exec 命令跑一个需要 TTY 的 CLI 时,它总是卡在等待输入界面。” 代理操作序列: 步骤 0(预检查):检查状态 → 看到没有活动目标,但注意到用户专注于“Tooling/Exec” 步骤 1 搜索(文档):tavily_search(...) → 返回摘要:“使用 pty=true” 步骤 2 搜索(GitHub 问题):tavily_search(...) → 返回摘要:“问题 #456 确认这是一个已知行为,建议增加 yieldMs” 步骤 3 综合:决策:文档提供了理想的解决方案(pty=true),但 GitHub 提供了即时的变通方法(yieldMs)。最佳路径是提出两者并通过代码验证 → 转到验证(步骤 4B) 步骤 4 验证(...)