OpenClaw 是一个开源的 AI 助手框架,支持 Telegram、Discord、Slack 等多平台接入。本文整理了在 Telegram 中可用的全部指令,方便日常查阅。
所有指令以 / 开头,作为独立消息发送。部分指令支持内联使用(嵌入普通消息中)。
会话控制
| 指令 |
说明 |
/new [model] |
新建会话,可选指定模型 |
/reset |
重置当前会话(同 /new) |
/stop |
终止当前正在运行的回复 |
/restart |
重启 Gateway |
/compact [instructions] |
压缩上下文,可附带指示 |
模型与推理
| 指令 |
说明 |
/model |
显示模型列表(编号选择) |
/model <name> |
切换模型(支持别名、provider/model 格式) |
/model list |
列出可用模型 |
/model status |
查看模型详细状态(端点、API 模式) |
/think <level> |
设置思考深度:off / minimal / low / medium / high / xhigh |
信息查询
| 指令 |
说明 |
/help |
显示帮助信息 |
/commands |
列出所有可用指令 |
/status |
查看当前状态(含模型用量/配额) |
/whoami |
显示你的 sender ID(别名 /id) |
/context [list\|detail\|json] |
查看上下文构成和大小 |
输出控制
| 指令 |
说明 |
/verbose on\|full\|off |
详细输出(调试用,日常建议关闭) |
/reasoning on\|off\|stream |
显示推理过程(stream 仅 Telegram 支持) |
/usage off\|tokens\|full\|cost |
控制每条回复的用量显示 |
/tts off\|always\|inbound\|tagged\|status |
文字转语音控制 |
执行与权限
| 指令 |
说明 |
/elevated on\|off\|ask\|full |
提权模式(full 跳过审批) |
/exec |
查看当前执行环境设置 |
/exec host=<sandbox\|gateway\|node> |
设置执行主机 |
/bash <command> |
在宿主机执行命令(需启用) |
! <command> |
同 /bash(纯文本指令) |
!poll |
查看 bash 任务输出 |
!stop |
停止正在运行的 bash 任务 |
/approve <id> allow-once\|allow-always\|deny |
处理执行审批 |
Sub-Agent 管理
| 指令 |
说明 |
/subagents list |
列出当前会话的子代理 |
/subagents kill |
终止子代理 |
/subagents steer |
引导子代理方向 |
/kill <id\|#\|all> |
立即终止子代理 |
/steer <id\|#> <message> |
给子代理发送新指令 |
/tell <id\|#> <message> |
同 /steer |
ACP(Agent Control Protocol)
| 指令 |
说明 |
/acp spawn |
启动 ACP 会话 |
/acp status |
查看 ACP 状态 |
/acp steer |
引导 ACP 会话 |
/acp cancel |
取消 ACP 任务 |
/acp close |
关闭 ACP 会话 |
/acp model |
设置 ACP 模型 |
/acp doctor |
ACP 诊断 |
/acp sessions |
列出 ACP 会话 |
群组与激活
| 指令 |
说明 |
/activation mention |
群组中需要 @提及 才响应 |
/activation always |
群组中始终响应 |
/allowlist |
查看/管理白名单 |
/send on\|off\|inherit |
控制消息发送权限 |
队列与调度
| 指令 |
说明 |
/queue |
查看当前队列设置 |
/queue <mode> |
设置队列模式(支持 debounce / cap / drop 参数) |
会话导出与技能
| 指令 |
说明 |
/export-session [path] |
导出当前会话为 HTML |
/skill <name> [input] |
按名称运行技能 |
/agents |
列出当前会话绑定的代理 |
跨平台切换
| 指令 |
说明 |
/dock-telegram |
切换回复到 Telegram |
/dock-discord |
切换回复到 Discord |
/dock-slack |
切换回复到 Slack |
配置管理(需启用)
| 指令 |
说明 |
/config show |
查看当前配置 |
/config get <key> |
获取配置值 |
/config set <key>=<value> |
写入配置(持久化) |
/config unset <key> |
删除配置项 |
/debug show |
查看运行时覆盖 |
/debug set <key>=<value> |
设置运行时覆盖(不写盘) |
/debug reset |
清除所有运行时覆盖 |
Directive(指令修饰符)
以下指令可嵌入普通消息中作为修饰符使用,不会被模型看到:
/think <level> — 单次设置思考深度
/verbose on|off — 单次开启详细输出
/reasoning on|off — 单次显示推理
/elevated on|off — 单次提权
/exec host=... — 单次指定执行环境
/model <name> — 单次指定模型
/queue <mode> — 单次队列设置
注意:嵌入消息中的 Directive 只对当次生效;单独发送则持久化到会话。
使用提示
- 权限:大部分指令需要授权身份(通过 pairing 或 allowFrom 配置)
- 群组:指令消息不需要 @提及 即可触发
- 内联快捷:
/help、/commands、/status、/whoami 可嵌入普通消息,会被自动剥离执行
- 指令分隔:支持冒号分隔,如
/think: high、/model: gpt-5
- 模型别名:
/model 支持编号选择、别名、provider/model 全名
基于 OpenClaw 2026.3.2 整理 · 项目地址:github.com/nicepkg/openclaw · 文档:docs.openclaw.ai