常见问题

这里整理的是普通用户最常遇到的问题。如果找不到答案，也可以在 Koishi 日志或项目 GitHub Issues 里继续排查。

为什么机器人不回复？

按顺序检查：

1. “允许响应的频道”是否包含当前频道。
2. 群聊是否把频道 assignee 设置为当前 Bot。
3. “聊天模型”是否选择了已安装模型服务插件里的模型。
4. 模型 API Key 是否有效。
5. 当前规则是否把该场景设为“不回复”。

群聊普通消息不回复

这是默认行为：group: wait 表示普通群聊消息只会被记录，不会交给模型。

如果希望机器人自然参与群聊，推荐安装 Will 策略插件，并使用 willingness 引擎。这样机器人会看到普通消息、积累意愿，并按关键词、引用和图片判断是否回复。

YAML表单预览

配置改完不生效

重启 Koishi 后，新的模型、插件和主要配置会生效。如果只做了临时调试，注意它不会自动保存到配置文件。

models.json 覆盖被忽略

模型 ID 必须与模型服务插件里注册的 ID 完全一致。写错的覆盖项会被忽略，并在日志里给出提示。

图片没有发送给模型

• 确认模型服务插件使用的模型支持图片。
• 确认图片输入没有被关闭。
• 确认机器人在回复前通过图片读取能力获得了这张图片。

v3 配置能迁移吗？

不能自动迁移。v3 的 modelService、agentBehavior、capabilities 已重写，请参考从 v3 升级。