astrbot 中文文档 下载 App

唤醒方式与常用指令:让机器人在正确的时机开口

很多「机器人不回话」的工单其实是误解:群聊里它故意不每条都回。这一页把唤醒机制讲透,再给一份高频指令速查。

为什么群聊不是有问必答

群聊场景下为了防止消息泛滥,框架默认不响应每一条监听到的消息。想让它接话,三种方式:

  1. @ 机器人:最直接,@ 完说事
  2. 唤醒前缀:默认是 /,如发 /你好 就会触发一次对话
  3. 私聊:私聊消息默认直接对话,不需要任何前缀

唤醒前缀可以在配置文件「平台与消息」区改——有的群改成bot名字,有的群改成自定义符号,按群文化定。

高频指令速查

指令干什么权限
/help列出可用指令所有人
/reset重置当前会话上下文,开始新对话所有人
/sid查看当前会话/用户的 ID所有人(结果很有用)
/persona切换人格管理员
/provider切换模型提供商管理员
/model切换模型管理员
/plugin插件管理管理员
/op /deop授予/撤销管理员管理员
/name改机器人名字管理员
/dashboard_update更新管理面板管理员
/llm大模型相关操作管理员
/groupnew会话/群相关管理管理员

/sid 的妙用

它返回的 ID 是给管理员权限名单用的原料:想把自己加成管理员,先在群里发 /sid 拿到自己的 ID,再填进配置文件「访问控制 → 管理员 → 管理员 ID」。

/reset 的时机

会话上下文机制决定了模型只记得当前会话的历史,[重置等于失忆重启]。长期记忆需求走插件或知识库,不要指望 /reset 之后它还记得你。

指令找不到或没反应