OpenClaw技能包推荐:路径先分宿主机和服务用户怎么查

时间:2026-06-12 18:02:48 来源:互联网

OpenClaw 技能包安装后看不见,很多人第一反应是重装。更快的排法是按路径、元数据、依赖、agent 可见性这条线查。OpenClaw技能包推荐与安装配置放在一起看,才能判断一个包到底是没装对、没加载,还是被配置过滤掉了。

OpenClaw技能包推荐与安装配置:常见路径和加载顺序说明 文章场景配图

先确认装到哪里

技能可以放在 workspace 目录,也可以放在共享目录。workspace 技能更适合项目专用,全局技能适合多个工作区复用。问题在于:你以为装到全局,实际写进当前 workspace;你以为所有 agent 都能看见,实际只有某个工作区会加载。

检查时不要凭目录名猜。用列表命令看 OpenClaw 识别到哪些 Skills,再对照磁盘路径。只要列表里没有出现,优先查目录结构和 SKILL.md 文件是否存在,而不是改 agent 配置。

SKILL.md 元数据不能缺

每个 Skill 都应该有自己的目录和 SKILL.md。文件开头的名称、描述和必要元数据,会影响它是否能被识别、何时触发、哪些环境可用。迁移旧技能或手写技能时,最常见的问题就是 frontmatter 不合规,目录存在,运行时却不可见。

判断方式很具体:列表命令能否看到它,info 或 check 输出是否指出缺字段,描述是否能让 agent 明白何时使用。描述太宽泛会导致误触发,描述缺失可能直接不加载。

依赖和环境变量会过滤技能

有些 Skills 要求特定二进制、系统平台、环境变量或 API key。缺这些条件时,技能可能被过滤,或者运行到一半失败。配置里写了 env,不代表沙箱里的进程一定能看到;API key 写错作用域,也会表现成工具不可用。

  • 看 list:确认技能是否被发现。

  • 看 info:确认描述、路径和要求。

  • 看 check:确认依赖、环境和配置问题。

  • 看 agent 配置:确认 allowlist 是否挡住它。

agent allowlist 是另一道门

多 agent 场景里,技能被加载不等于每个 agent 都能用。默认技能列表、单个 agent 的 skills 配置、空数组禁用策略,都会影响可见性。一个很典型的现象是:主 agent 能用,工作 agent 看不见;或者某个 agent 配了专属列表后,不再继承默认列表。

排查顺序建议固定下来:磁盘路径、SKILL.md、依赖、全局或 workspace 作用域、agent allowlist。每一步都有证据,不要跳着改。能按这条线走完,大多数“装了没反应”的问题都能定位到具体原因。

还有一种常见误判:技能被发现了,却因为触发描述太宽或太窄而“不好用”。描述太宽会抢任务,描述太窄会从不触发。可以用三条真实指令测试:明确要求它做、模糊提到相关任务、完全无关任务。前两种表现合理,第三种不抢活,才算描述写得合适。

配置改动也要一次只改一处。路径、依赖、allowlist 混着改,问题消失了也不知道哪一步起作用。