配置错误主因是智能体与插件设备支持范围不匹配，需对齐“支持平台”、确认插件状态为“已启用”、核对插件id完全一致。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
安装后提示配置错误，大概率是智能体与插件的设备支持范围不匹配，不是安装失败，而是运行环境没对齐。
检查智能体和插件的设备配置是否一致
这是最常见的原因。Muse智能体和它要加载的端插件，各自在后台有“支持设备”选项（比如仅限 Android、或同时支持 iOS 和 Web）。如果两者不重叠，添加时就会报配置错误，鼠标悬停在“添加”按钮上通常会直接提示“设备类型不一致”。
- 进入智能体管理页，找到对应智能体的「基础设置」或「发布配置」，查看“支持平台”或“目标设备”选项
- 打开插件详情页，在「插件配置」或「能力声明」区域，确认它的“适用终端”设置
- 把二者设为完全相同的组合，例如都勾选 Android + Web，或都只选 iOS
确认插件已发布且状态为“已启用”
插件创建完成≠可被调用。未发布、审核中、或手动停用的插件，智能体无法识别其能力。
- 在插件控制台中，核对插件右上角的状态标签，必须是绿色“已启用”
- 如果显示“待发布”或“审核中”，需先提交发布流程并等待通过
- 部分平台要求插件至少有一个版本标记为“正式版”，而非“测试版”
验证插件 ID 与智能体调用声明是否匹配
智能体在调用插件前，需要在自身配置中显式声明插件 ID。ID 写错、大小写不符、多空格或用了旧版本 ID，都会导致加载失败。
- 复制插件详情页顶部显示的完整插件 ID（通常是类似 muse-plugin-xxxxx 的字符串）
- 在智能体的「插件集成」或「能力接入」设置里，粘贴该 ID，并保存
- 避免从历史记录或聊天窗口复制——可能带隐藏字符；建议手动输入末尾几位校验
配置错误本质是契约没对上，不是代码缺陷。对齐设备类型、确认启用状态、核对 ID 三步做完，90% 的情况就能恢复正常。
