OpenClaw技能包推荐：安装前要核对的配置、依赖和加载范围

很多 OpenClaw 技能问题不是技能本身坏了，而是安装前没核对配置。装完列表里没有、列表里有却不能跑、重开会话又消失，通常都和 skills 配置、依赖、加载范围有关。做 OpenClaw技能包推荐，安装检查要摆在推荐清单前面。

先看技能会装到哪里

技能可能来自工作区、全局目录或额外目录。工作区适合项目专用能力，全局适合个人长期使用的基础能力。extraDirs 指向的目录要确认路径存在、权限可读、里面确实有 SKILL.md。路径写错时，界面不一定给出醒目提醒，日志和已加载列表才是证据。

如果团队多人共用配置，别把试验技能直接放全局。先放工作区，确认没有误触和依赖冲突，再决定是否共享。

依赖命令和环境变量逐项验

技能格式会声明需要的命令、环境变量或系统条件。检查时别靠记忆，直接在运行环境里执行版本命令，确认 API key 只对当前任务生效。容器环境尤其要看系统包来源，某些依赖在宿主机有，容器里未必有。

• 命令依赖：记录命令路径和版本，升级后能对照。
• 环境变量：用最小权限 key 试跑，失败日志不要外传。
• 系统条件：确认操作系统、包管理器、容器镜像是否匹配。

agent 可见范围决定能否调用

技能装好不等于所有代理都能看见。agents.defaults.skills 和单个 agent 的技能配置会影响可见范围。排查时让目标代理列出可用技能，比只看安装目录更可靠。某个代理看不到，另一个代理能看到，说明问题多半在 allowlist 或 agent 覆盖配置。

会话快照也要算进去。新装或修改 SKILL.md 后，旧会话可能仍沿用启动时的技能集合。重开会话再测一次，是区分配置错误和快照延迟的低成本办法。

检查结果要能指导下一步

配置检查不是为了列一堆项目，而是要能告诉你下一步做什么。依赖缺失就补包或换技能，环境变量缺失就补最小权限 key，agent 看不到技能就改 allowlist 或工作区配置。每个失败项都要对应一个动作。

如果多个技能一起失败，优先查共同依赖和加载范围。比如同一批技能都不出现，多半不是每个 SKILL.md 都错，而是目录、权限或 agent 配置出了问题。把排查顺序写清，后续成员接手时不会重复试错。

检查清单完成后，建议跑一个固定用例。用同一条测试指令验证技能是否出现、能否调用、输出是否可复现。固定用例像尺子，环境升级、技能更新后都能拿来对照。

加载范围检查还要覆盖子代理。很多人只验证主代理，真正执行任务时却交给另一个 agent，结果技能不可见。安装前把目标 agent 列出来，逐个确认可见技能和权限范围，能避免任务流转时突然断掉。

配置文件修改后，建议保存一份变更前后的差异。哪一行新增了 entries，哪一行改了 allowlist，哪个目录加入 extraDirs，都写进记录。下次技能消失时，先看这些差异，比盲目重装更快。

取舍标准可以写得更硬一点：能用最小权限完成任务，就不开放高权限；能在测试工作区验证，就不进常用环境；能留下原始证据，就不只保存代理回答。这个口径适合放进团队或个人的安装记录里，后面扩展技能时也能沿用。