乐于分享
好东西不私藏

小龙虾(openclaw)找不到新安装的技能(skill)怎么办

小龙虾(openclaw)找不到新安装的技能(skill)怎么办

我们在给小龙虾(openclaw)安装skill(技能)时,可能会遇到技能安装好了,通过“openclaw skill list”命令也能看到,但是OpenClaw agent就是识别不到已安装的技能。这通常是由以下几个原因导致的,这就像给龙虾配好了工具,但需明确告诉它“可以用”且“知道怎么用”。下面是一些可能的检查点,大家可以按顺序逐步排查。
首先,确认基础的文件和目录存在且正确,因为openclaw是按照固定目录去寻找技能的。

· 在终端运行 openclaw skills list,或在 Web 控制台查看已安装的技能列表。确保 exec 和 目标技能的安装状态为 “已启用 (enabled)” 或 “就绪 (ready)”。

· exec 是内置基础工具 (Tool),通常无需额外安装,重点确认它已在配置中被启用。

· 技能文件存放位置决定其优先级:

工作区 skills 目录 (~/.openclaw/workspace/skills/) > 用户全局目录 (~/.openclaw/skills/)。

· 若技能目录缺失核心的 skill.md 文件,OpenClaw 会静默跳过,导致技能“消失”。需手动检查技能文件夹下面文件完整性。

接下来,确保tools已经启用,尤其是“exec”能力启用了。

Skills 是“大脑”,Tools 是“手”。必须为 Agent 开启相应权限,技能才能生效。

· 启用 exec:在 OpenClaw 主配置文件中(如 openclaw.json)找到 tools 项,确保 exec 为启用状态。

· 注意:有些技能(如需要发邮件的)可能依赖多个底层工具,需根据技能文档全部开启。

也可以直接修改配置文件openclaw.json:

"tools": {    "profile": "full",    "allow": [      "exec","browser"    ],    "sessions": {      "visibility": "all"    },    "exec": {      "security": "full",      "ask": "off"    },    "web": {      "search": {        "enabled": true      },      "fetch": {        "enabled": true      }    },    "alsoAllow": [],    "agentToAgent": {      "enabled": true    }  }

重启gateway后(命令:openclaw gateway restart)

验证exec工具是否能正常使用(执行本地命令,这个是各个技能的基础):

第三,检查目标技能的配置项是否正确,比如百度搜索需要BAIDU_API_KEY,feishu-docx需要FEISHU_APP_ID 和 FEISHU_APP_SECRET等,还要看技能应用需要的其他权限(比如飞书机器人需要的相应的功能权限)是否配置好了。

第四,排查技能可见性配置。有时候技能被安全机制“隐藏”了,我们需要手动为 Agent 配置“可见技能白名单”。

```json{  "agents": {    "defaults": {      "skills": ["exec""feishu-docx""baidu-search"]#所有你需要的技能    },    "list": [      {        "id""main",        "skills": ["exec""feishu-docx""baidu-search"]#所有你需要的技能      }    ]  }}```

最后,检查和小龙虾Agent交流时的技能触发方式。即使一切就绪,Agent 也需“听懂”你的指令。建议按以下方式测试:

  • 使用自然语言直接请求(最推荐):直接告诉 Agent 你的目标,如“搜索***”或“在飞书文档中创建一个新页面”。

  • 使用斜杠命令“/” (或“@”符号)(更精准):部分技能支持“/”命令,可快速调用。

  • 要求小龙虾执行技能并把详细的调用过程反馈,比如“搜索***,并把工具或技能的详细调用过程反馈给我”。

这样,经过这些检查和确认,特别是tools相关能力的开启和安全配置的正确,小龙虾应该就可以找到安装的能力并用起来了。