Hanori花织 · 使用文档
使用指南

Telegram 命令参考

按访问范围整理当前共享命令目录,以及每条命令的常用用法。

Bot 会从共享命令目录和运行时注册表生成帮助与 Telegram 命令菜单,因此 /help 是当前实例可用性的最终依据。下面列的是产品目录中的命令;某些命令可能因为 Bot 配置、聊天类型、角色或功能开关而隐藏。

基础和对话

命令作用常见范围
/start显示欢迎信息。公开
/help显示当前可用命令。公开
/panel打开已启用的 Bot 帮助或管理面板。公开
/md2tg把 Markdown 转成 Telegram 富文本。公开
/clear清除当前聊天的对话历史。按聊天类型
/privacy查看或切换个人化模式,或发起个人数据删除。公开

AI 和运行控制

命令作用
/provider查看、切换或重置当前聊天的 Provider。
/model查看、切换或重置当前聊天的模型。
/replymode切换回复模式。
/richtext切换 AI 富文本增强。
/stop / /resume停止或恢复 AI 回复。
/quota查看 AI 与图片用量。
/summary总结群聊消息,支持最近条数、小时、今天或昨天。

图片和媒体

命令作用
/imagegen切换群组图片生成权限。
/image查看图片预设、任务或取消任务。
/draw按图片预设发起生成。

管理和集成

命令作用备注
/status查看 Bot 运行状态。管理员
/restart重启 Bot。管理员
/backup创建数据库备份。管理员
/clearreceived清理收到的文件缓存。管理员
/timers查看或管理活跃定时器。管理员
/mcp查看或管理 MCP 服务器。管理员
/apikey在私聊中更新 Web 或图片工具 API Key。管理员;参数会脱敏
/cosinside从管理员私聊向配置的群发送消息。管理员;内容属于副作用操作

参数示例

/provider
/provider reset
/model 1
/model reset
/summary 6h
/summary 200
/privacy status
/privacy forget
/privacy forget confirm

不要把 API Key、Token 或私密消息作为命令参数发到群里。/apikey 和 /cosinside 只应在 Bot 明确提示的私聊场景中使用;即使命令目录标记为管理员,服务端仍会再次校验权限。

命令不显示时

先发送 /help,再检查:

  1. 当前聊天是否符合命令的访问范围。
  2. Bot 是否启用了对应能力,例如图片、MCP 或总结。
  3. 当前用户是否为管理员或被授予 Mini App/治理范围。
  4. Bot 是否在最近重启后完成了注册和配置同步。

命令菜单只表达元数据和当前注册结果,不代表外部 Provider 或 Telegram API 一定可用。

本页内容