常见问题¶
机器人没有响应¶
按顺序排查，多数情况落在前两条：
- 漏了斜杠。 指令必须以
/开头，help不会触发，/help才会。 - 群聊未 @ 机器人。 QQ 官方机器人在群内通常需要先 @，或让指令带上
/前缀； 不同客户端的行为略有差异。 - 指令拼写有误。 到 指令总览 检索确切写法，注意部分指令是中文名。
- 插件未启用。 插件停用后，其指令不会响应，也不会报错。
- 确实出错了。 若机器人返回了错误信息，通常会写明原因。
为什么有些功能不在指令表里¶
面板与本站的指令表只收录注册进指令表的指令。另有一类插件不依赖这套机制： 它们直接监听消息内容，自行判断是否响应，典型如 B 站链接解析、王者荣耀战绩、世界计划查询与舞萌查分。
这类功能的用法写在各插件页中，标记为「关键词触发用法」。因此「指令表里没有」并不等于「不能用」。
群聊与私聊的差异¶
这是刻意设计的结果：
- 森空岛签到：群聊
/skd显示所有群成员的签到状态，私聊只显示自己。 - 明日方舟猜猜乐：私聊为个人局，群聊为群内共享同一道题。
- 猜卡面：题库与排行榜可能按群、按私聊分别记录。
绑定账号失败¶
先确认以下几点：
- 绑定类指令请私聊使用，群聊中可能被平台限制，或暴露给其他成员。
- 手机号登录需要能接收短信验证码，验证码通常 5 分钟内有效。
- token 与 Cookie 会过期，有效期从数周到数月不等，过期后需重新获取。
- 签到类接口在游戏维护期间会失败，等维护结束后再试。
数据与隐私¶
- 绑定信息（token、Cookie）保存在机器人服务器的本地数据目录，不会公开。
- 本站只包含指令说明，不涉及任何账号、密钥或聊天记录。
- 如果你曾在群聊中发送过 token，建议立即解绑并重新获取。
响应较慢或卡住¶
- 涉及图片渲染的指令（查分图、抽卡图、猜图）通常需要数秒到十余秒，属正常范围。
- 生成式回答依赖模型服务，网络波动时响应会变慢。
- 若长时间无响应，可发送
/stop中断当前任务，或用/new开启新对话。
文档与实际不一致¶
本站内容每日从 AstrBot 面板同步一次，通常不会有明显偏差。若确实不一致：
- 以机器人实际行为为准；
- 也可能是插件刚更新、文档尚未同步，等下一次同步即可（见 关于本站）。
邀请机器人加入其它群¶
需要机器人管理员在 AstrBot 面板中配置平台侧的群权限。加入后请遵守群规， 签到与绑定一类操作建议引导成员私聊完成。