内置指令
AstrBot 的指令通过插件机制注册。为了保持主程序轻量，当前只有少量基础指令随 AstrBot 主程序内置加载；更多管理类、扩展类指令已经迁移到独立插件中维护。
使用 /help 可以查看当前已经启用的指令。
NOTE
/help、/set、/unset默认不会显示在/help输出的指令清单中，但这些指令仍然可用。- 如果您修改了唤醒前缀，去掉了默认的
/，那么指令也需要使用新的唤醒前缀触发。例如将唤醒前缀改为!后，应使用!help、!reset，而不是/help、/reset。
主程序内置指令
以下指令由 AstrBot 主程序自带，默认随 AstrBot 加载：
/help：查看当前启用的指令和 AstrBot 版本信息。/sid：查看当前消息来源信息，包括 UMO、用户 ID、平台 ID、消息类型和会话 ID。常用于配置管理员、白名单或路由规则。/reset：重置当前会话的 LLM 上下文。/stop：停止当前会话中正在运行的 Agent 任务。/new：创建并切换到一个新对话。/dashboard_update：更新 AstrBot WebUI。该指令需要管理员权限。/set：设置当前会话变量，常用于 Dify、Coze、DashScope 等 Agent 执行器的输入变量。/unset：移除当前会话变量。
核心指令详解
/sid
/sid 用于查看当前消息来源信息，主要输出：
UMO：当前消息来源的统一标识。它通常用于白名单、配置文件路由等按会话生效的配置。UID：当前发送者的用户 ID。它通常用于添加 AstrBot 管理员。Bot ID：当前机器人所在平台实例的 ID。Message Type：消息类型，例如私聊或群聊。Session ID：平台侧会话 ID。
在群聊中，如果开启了 unique_session（会话隔离），/sid 还会额外提示当前群 ID。这个群 ID 可用于把整个群加入白名单。
常见用途：
- 添加管理员：先发送
/sid获取UID，再在 WebUI 的配置 -> 其他配置 -> 管理员 ID中添加。 - 配置白名单：使用
UMO或群 ID 控制哪些会话可以使用机器人。 - 配置路由规则：使用
UMO区分不同平台、群聊或私聊来源。
/reset
/reset 用于重置当前会话的 LLM 上下文。
对于 AstrBot 内置 Agent Runner，它会：
- 停止当前会话中正在运行的任务。
- 清空当前对话的上下文消息。
- 通知长期记忆会话清理当前上下文状态。
对于第三方 Agent Runner，例如 dify、coze、dashscope、deerflow，它会：
- 停止当前会话中正在运行的任务。
- 删除当前会话保存的第三方会话 ID，让下一轮对话重新开始。
权限说明：
- 私聊中默认普通用户可使用。
- 群聊开启会话隔离时，默认普通用户可使用。
- 群聊未开启会话隔离时，默认需要管理员权限。
- 如果管理员修改过指令权限配置，则以实际配置为准。
/stop
/stop 用于停止当前会话中正在运行的 Agent 任务。
它不会清空对话历史，也不会创建新对话。它只对当前会话正在执行的任务发出停止请求。
对于内置 Agent Runner，/stop 会请求 Agent Runner 停止当前任务。
对于第三方 Agent Runner，例如 dify、coze、dashscope、deerflow，/stop 会直接停止当前会话中登记的运行任务。
如果当前会话没有正在运行的任务，AstrBot 会提示当前会话没有运行中的任务。
内置指令扩展
除上述基础指令外，其他原本随主程序提供的内置指令已经迁移到独立插件：
可直接在插件市场搜索安装。
该插件提供插件管理、Provider 管理、模型切换、Persona 管理、对话列表管理等扩展指令，例如：
/plugin：查看、启用、停用或安装插件。/op、/deop：添加或移除管理员。/provider：查看或切换 LLM Provider。/model：查看或切换模型。/history：查看当前对话历史。/ls：查看对话列表。/groupnew：为指定群聊创建新对话。/switch：切换到指定对话。/rename：重命名当前对话。/del：删除当前对话。/persona：查看或切换 Persona。/llm：开启或关闭 LLM 聊天功能。
如果你需要这些扩展指令，请安装或启用 builtin_commands_extension 插件。
权限说明
部分指令需要 AstrBot 管理员权限，例如 /dashboard_update、/op、/deop、/provider、/model、/persona 等。
可以通过 /sid 获取用户 ID，然后在 WebUI 的 配置 -> 其他配置 -> 管理员 ID 中添加管理员。