插件不能成功部署在板子

通用
1

image
image2032×581 69.9 KB

插件为什么板子上部署不成功

2

两条报错是同一个校验失败：部署打包时要求 SKILL.md 头部的 name 与该技能所在文件夹名逐字符相同。截图里文件夹是 rdk-stt / rdk-tts，说明文件里的 name 不是这两个字符串（常见是写成了中文显示名“STT 语音转文字”，或大小写、连字符、后缀不同，比如 stt、rdk_stt、rdk-stt-main）。这一步在推送到板端之前就失败了，与板子环境和 TTS/STT 依赖无关。

按下面核对：

  1. 打开本机这两个技能的 SKILL.md，看头部前几行：
---
name: rdk-stt        # 必须与上级文件夹名完全一致，小写，连字符
description: ...
---
  1. 确认目录结构只有一层，不要多套一层或带下载后缀：
<技能目录>/rdk-stt/SKILL.md      ← 正确
<技能目录>/rdk-stt/rdk-stt/SKILL.md
<技能目录>/rdk-stt (1)/SKILL.md
  1. 改好后回到技能页点「更新」，再点「部署到设备」。若仍报同一行，把 SKILL.md 头部 5 行发我（可直接贴文本）。

字段定义可对照官方 技能文件怎么写：name 是技能唯一名，建议短英文；description 才是给人看的一句话说明。部署阶段的其它失败类型见 部署和卸载 · 部署失败的常见原因。

另外想确认一点：这两个技能是你自己建的，还是从 SkillHub 下载后改过名字/文件夹？如果是原样下载却报这个错，那就是包里自带的 name 与发布目录不一致，需要反馈给我们修包。

3

您好，可以试试先更新内置技能，自建技能则把 SKILL.md 的 name 改成与目录名完全一致（rdk-stt 或 rdk-tts ），确认板端 OpenClaw Agent 就绪后再部署