/로 시작하는 독립형 메시지로 전송된 명령을 처리합니다.
호스트 전용 bash 명령은 ! <cmd>을 사용합니다(/bash <cmd>은 별칭입니다).
대화가 ACP 세션에 바인딩되면 일반 텍스트는 ACP
하네스로 라우팅됩니다. Gateway 관리 명령은 로컬에 유지됩니다. /acp ...은 항상
OpenClaw 명령 처리기에 도달하며, 해당 화면에서 명령 처리가 활성화된 경우
/status 및 /unfocus도 로컬에 유지됩니다.
세 가지 명령 유형
명령
Gateway가 처리하는 독립형
/... 메시지입니다. 메시지의
유일한 콘텐츠로 전송해야 합니다.지시문
/think, /fast, /verbose, /trace, /reasoning, /elevated,
/exec, /model, /queue — 모델이 메시지를
보기 전에 제거됩니다. 단독으로 전송하면 세션 설정을 유지하고, 다른 텍스트와
함께 전송하면 인라인 힌트로 작동합니다.인라인 바로 가기
/help, /commands, /status, /whoami — 즉시 실행되며
모델이 나머지 텍스트를 보기 전에 제거됩니다. 승인된 발신자만 사용할 수 있습니다.지시문 동작 세부 정보
지시문 동작 세부 정보
- 지시문은 모델이 메시지를 보기 전에 제거됩니다.
- 지시문 전용 메시지(메시지에 지시문만 포함됨)에서는 세션에 유지되고 확인 응답을 반환합니다.
- 다른 텍스트가 포함된 일반 채팅 메시지에서는 인라인 힌트로 작동하며 세션 설정을 유지하지 않습니다.
- 지시문은 승인된 발신자에게만 적용됩니다.
commands.allowFrom이 설정되어 있으면 이것만 허용 목록으로 사용하며, 그렇지 않으면 채널 허용 목록/페어링 및commands.useAccessGroups에서 권한을 확인합니다. 승인되지 않은 발신자의 지시문은 일반 텍스트로 처리됩니다.
구성
boolean
기본값:"true"
채팅 메시지에서
/... 구문 분석을 활성화합니다. 네이티브 명령이 없는 화면
(WhatsApp, WebChat, Signal, iMessage, Google Chat, Microsoft Teams)에서는
false으로 설정해도 텍스트 명령이 작동합니다.boolean | "auto"
기본값:"\"auto\""
네이티브 명령을 등록합니다. 자동: Discord/Telegram에서는 켜지고, Slack에서는 꺼지며,
네이티브 지원이 없는 공급자에서는 무시됩니다. 채널별로
channels.<provider>.commands.native을 사용하여 재정의합니다. Discord에서 false은
슬래시 명령 등록을 건너뜁니다. 이전에 등록된 명령은 제거될 때까지 계속 표시될 수 있습니다.boolean | "auto"
기본값:"\"auto\""
지원되는 경우 Skills 명령을 네이티브로 등록합니다. 자동: Discord/Telegram에서는
켜지고 Slack에서는 꺼집니다.
channels.<provider>.commands.nativeSkills으로
재정의합니다.boolean
기본값:"false"
! <cmd>이 호스트 셸 명령을 실행하도록 활성화합니다(/bash <cmd> 별칭).
tools.elevated 허용 목록이 필요합니다.number
기본값:"2000"
bash가 백그라운드 모드로 전환하기 전에 대기하는 시간입니다(
0은
즉시 백그라운드로 전환합니다).boolean
기본값:"false"
/config을 활성화합니다(openclaw.json 읽기/쓰기). 소유자 전용입니다.boolean
기본값:"false"
/mcp을 활성화합니다(mcp.servers 아래의 OpenClaw 관리 MCP 구성 읽기/쓰기). 소유자 전용입니다.boolean
기본값:"false"
/plugins을 활성화합니다(Plugin 검색/상태 및 설치 + 활성화/비활성화). 쓰기는 소유자 전용입니다.boolean
기본값:"false"
/debug을 활성화합니다(런타임 전용 구성 재정의). 소유자 전용입니다.boolean
기본값:"true"
/restart 및 외부 SIGUSR1 재시작 요청을 활성화합니다.string[]
소유자 전용 명령 화면에 대한 명시적 소유자 허용 목록입니다.
commands.allowFrom 및 DM 페어링 액세스와는 별개입니다.boolean
기본값:"false"
채널별 설정: 소유자 전용 명령에 소유자 신원을 요구합니다.
true인 경우
발신자는 commands.ownerAllowFrom과 일치하거나 내부 operator.admin
범위를 보유해야 합니다. 와일드카드 allowFrom 항목만으로는 충분하지 않습니다."raw" | "hash"
시스템 프롬프트에 소유자 ID가 표시되는 방식을 제어합니다.
string
commands.ownerDisplay: "hash"일 때 사용하는 HMAC 비밀 값입니다.object
명령 권한 부여를 위한 공급자별 허용 목록입니다. 구성된 경우 명령과 지시문에 사용하는
유일한 권한 부여 소스입니다. 전역 기본값에는
"*"을 사용하며,
공급자별 키가 이를 재정의합니다.boolean
기본값:"true"
commands.allowFrom이 설정되지 않은 경우 명령에 허용 목록/정책을 적용합니다.명령 목록
명령은 세 가지 소스에서 제공됩니다.- 핵심 내장 명령:
src/auto-reply/commands-registry.shared.ts - 생성된 도크 명령:
src/auto-reply/commands-registry.data.ts - Plugin 명령: Plugin
registerCommand()호출
핵심 명령
세션 및 실행
세션 및 실행
명시적인
/export-session 경로는 작업 공간 내부의 기존 파일을
대체합니다. 충돌 방지 파일 이름을 생성하려면 경로를 생략하십시오.Control UI는 입력된
/new을 가로채 새 대시보드 세션을 생성하고
해당 세션으로 전환합니다. 단, session.dmScope: "main"이 구성되어 있고
현재 상위 세션이 에이전트의 기본 세션인 경우에는 /new이
기본 세션을 제자리에서 재설정합니다. 입력된 /reset은 여전히 Gateway의
제자리 재설정을 실행합니다. 고정된 세션 모델 선택을 지우려면
/model default을 사용하십시오.모델 및 실행 제어
모델 및 실행 제어
상세 출력 / 추적 / 빠른 모드 / 추론 안전
상세 출력 / 추적 / 빠른 모드 / 추론 안전
/verbose은 디버깅용입니다. 일반적으로 사용할 때는 끄십시오./trace은 Plugin이 소유한 추적/디버그 줄만 표시하며, 일반적인 상세 출력은 계속 꺼진 상태로 유지됩니다./fast auto|on|off은 세션 재정의를 유지합니다. 이를 지우려면 세션 UI의inherit옵션을 사용하십시오./fast은 공급자별로 다릅니다. OpenAI/Codex는 이를service_tier=priority에 매핑하고, Anthropic 직접 요청은service_tier=auto또는standard_only에 매핑합니다./reasoning,/verbose,/trace은 그룹 환경에서 위험합니다. 내부 추론이나 Plugin 진단 정보를 노출할 수 있으므로 그룹 채팅에서는 끄십시오.
모델 전환 세부 정보
모델 전환 세부 정보
/model은 새 모델을 즉시 세션에 유지합니다.- 에이전트가 유휴 상태이면 다음 실행부터 즉시 사용합니다.
- 실행이 활성 상태이면 전환을 보류 상태로 표시하고 다음 정상적인 재시도 시점에 적용합니다.
검색 및 상태
검색 및 상태
Skills, 허용 목록, 승인
Skills, 허용 목록, 승인
하위 에이전트와 ACP
하위 에이전트와 ACP
소유자 전용 쓰기 및 관리
소유자 전용 쓰기 및 관리
음성, TTS, 채널 제어
음성, TTS, 채널 제어
도킹 명령
도킹 명령은 활성 세션의 응답 경로를 연결된 다른 채널로 전환합니다. 설정 및 문제 해결 방법은 채널 도킹을 참조하십시오. 네이티브 명령을 지원하는 채널 Plugin에서 생성됩니다./dock-discord(별칭:/dock_discord)/dock-mattermost(별칭:/dock_mattermost)/dock-slack(별칭:/dock_slack)/dock-telegram(별칭:/dock_telegram)
session.identityLinks이(가) 필요합니다. 소스 발신자와 대상 피어는
동일한 ID 그룹에 있어야 합니다.
번들 Plugin 명령
QQBot 전용:
/bot-ping, /bot-version, /bot-help, /bot-upgrade, /bot-logs
Skill 명령
사용자가 호출할 수 있는 skill은 슬래시 명령으로 노출됩니다./skill <name> [input]은(는) 일반 진입점으로 항상 작동합니다.- Skills는 직접 명령으로 등록될 수 있습니다(예: OpenProse의
/prose). - 네이티브 skill 명령 등록은
commands.nativeSkills및channels.<provider>.commands.nativeSkills에 의해 제어됩니다. - 이름은
a-z0-9_형식으로 정리됩니다(최대 32자). 충돌이 발생하면 숫자 접미사가 붙습니다.
Skill 명령 디스패치
Skill 명령 디스패치
기본적으로 skill 명령은 일반 요청으로 모델에 라우팅됩니다.Skills는 도구로 직접 라우팅하도록
command-dispatch: tool을(를) 선언할 수 있습니다
(결정론적이며 모델이 관여하지 않음). 예: /prose (OpenProse Plugin)
— OpenProse를 참조하십시오.네이티브 명령 인수
네이티브 명령 인수
Discord는 필수 인수가 생략되면 동적 옵션에 자동 완성을 사용하고 버튼 메뉴를
사용합니다. Telegram과 Slack은 선택지가 있는 명령에 버튼 메뉴를 표시합니다.
동적 선택지는 대상 세션 모델을 기준으로 결정되므로
/think 수준과
같은 모델별 옵션은 세션의 /model 재정의를 따릅니다./tools: 에이전트가 지금 사용할 수 있는 항목
/tools은(는) 정적 구성 카탈로그가 아니라, 이 대화에서 이 에이전트가
지금 사용할 수 있는 항목이라는 런타임 질문에 답합니다.
/model: 모델 선택
/model 및 /models은(는) 제공자와
모델 드롭다운이 포함된 대화형 선택기를 엽니다. 선택기는
provider/* 항목을 포함하여 agents.defaults.models을(를) 준수합니다.
/config: 디스크 구성 쓰기
소유자 전용입니다. 기본적으로 비활성화되어 있습니다.
commands.config: true을(를) 사용하여 활성화하십시오./config
업데이트는 다시 시작한 후에도 유지됩니다.
/mcp: MCP 서버 구성
소유자 전용입니다. 기본적으로 비활성화되어 있습니다.
commands.mcp: true을(를) 사용하여 활성화하십시오./mcp은(는) 임베디드 에이전트 프로젝트 설정이 아닌 OpenClaw 구성에 구성을 저장합니다.
/mcp show은(는) 자격 증명이 포함된 필드, 인식된 자격 증명 플래그 값,
알려진 비밀 형식의 인수를 마스킹합니다. 그룹에서 실행하면 구성이
소유자에게 비공개로 전송됩니다. 사용할 수 있는 비공개 소유자 경로가 없으면
명령은 안전하게 실패하고 소유자에게 다이렉트 채팅에서 다시 시도하도록 요청합니다.
/debug: 런타임 전용 재정의
소유자 전용입니다. 기본적으로 비활성화되어 있습니다.
commands.debug: true을(를) 사용하여 활성화하십시오.
재정의는 새 구성 읽기에 즉시 적용되지만 디스크에는 쓰지 않습니다./plugins: Plugin 관리
쓰기는 소유자 전용입니다. 기본적으로 비활성화되어 있습니다.
commands.plugins: true을(를) 사용하여 활성화하십시오./plugins enable|disable은(는) Plugin 구성을 업데이트하고 새 에이전트 턴을 위해 Gateway
Plugin 런타임을 핫 리로드합니다. /plugins install은(는) Plugin 소스 모듈이 변경되었으므로
관리되는 Gateway를 자동으로 다시 시작합니다. 신뢰할 수 있는 ClawHub
및 공식 카탈로그 설치에는 추가 확인이 필요하지 않습니다. 임의의 npm,
git, 아카이브, npm-pack: 및 로컬 경로 소스에는 출처 경고가 표시되며,
소스를 검토한 후 끝에 --force을(를) 추가해야 합니다. 이 플래그는
소스를 확인하고 기존 설치의 교체를 허용하지만,
security.installPolicy 또는 설치 프로그램 보안 검사를 우회하지는 않습니다. 위험
경고가 있는 ClawHub 릴리스에는 여전히 별도의 셸 전용
--acknowledge-clawhub-risk 플래그가 필요합니다. 마켓플레이스, 링크 및 고정 설치도
셸 전용으로 유지됩니다.
/trace: Plugin 추적 출력
/trace은(는) 전체 상세 모드 없이 세션 범위의 Plugin 추적/디버그 줄을
표시합니다. 이는 /debug(런타임 재정의) 또는 /verbose(일반
도구 출력)을 대체하지 않습니다.
/btw: 부가 질문
/btw은(는) 현재 세션 컨텍스트에 관한 빠른 부가 질문입니다. 별칭: /side.
- 현재 세션을 배경 컨텍스트로 사용합니다.
- Codex 하네스 세션에서는 임시 Codex 부가 스레드로 실행됩니다.
- 향후 세션 컨텍스트를 변경하지 않습니다.
- 트랜스크립트 기록에 작성되지 않습니다.
화면 참고 사항
화면별 세션 범위
화면별 세션 범위
- 텍스트 명령: 일반 채팅 세션에서 실행됩니다(DM은
main을(를) 공유하고, 그룹에는 자체 세션이 있음). - 네이티브 Discord 명령:
agent:<agentId>:discord:slash:<userId> - 네이티브 Slack 명령:
agent:<agentId>:slack:slash:<userId>(접두사는channels.slack.slashCommand.sessionPrefix을(를) 통해 구성 가능) - 네이티브 Telegram 명령:
telegram:slash:<userId>(CommandTargetSessionKey을(를) 통해 채팅 세션을 대상으로 함) - **
/login codex**은(는) 비공개 채팅 또는 Web UI 응답 경로를 통해서만 기기 페어링 코드를 전송합니다. Telegram 그룹/토픽에서 호출하면 소유자에게 봇으로 DM을 보내도록 요청합니다. - **
/stop**은(는) 현재 실행을 중단하기 위해 활성 채팅 세션을 대상으로 합니다.
Slack 세부 사항
Slack 세부 사항
channels.slack.slashCommand은 단일 /openclaw 스타일 명령을 지원합니다.
commands.native: true을 사용하면 기본 제공 명령마다 Slack 슬래시 명령을 하나씩 생성합니다.
Slack에서 /status을 예약하므로 /status이 아닌 /agentstatus을 등록하십시오.
Slack 메시지에서는 텍스트 /status도 계속 작동합니다.빠른 경로 및 인라인 바로 가기
빠른 경로 및 인라인 바로 가기
- 허용 목록에 있는 발신자가 보낸 명령 전용 메시지는 즉시 처리됩니다(대기열 + 모델 우회).
- 인라인 바로 가기(
/help,/commands,/status,/whoami)도 일반 메시지에 삽입하여 사용할 수 있으며, 모델이 나머지 텍스트를 확인하기 전에 제거됩니다. - 권한이 없는 명령 전용 메시지는 알림 없이 무시되며, 인라인
/...토큰은 일반 텍스트로 처리됩니다.
인수 참고 사항
인수 참고 사항
- 명령과 인수 사이에 선택적
:을 사용할 수 있습니다(/think: high,/send: on). /new <model>은 모델 별칭,provider/model또는 제공자 이름(퍼지 일치)을 허용하며, 일치 항목이 없으면 해당 텍스트를 메시지 본문으로 처리합니다./allowlist add|remove에는commands.config: true이 필요하며 채널configWrites을 따릅니다.
제공자 사용량 및 상태
- 사용량 추적이 활성화되면 현재 모델 제공자의 제공자 사용량/할당량(예: “Claude 80% 남음”)이
/status에 표시됩니다. - 실시간 세션 스냅샷의 정보가 부족한 경우
/status의 토큰/캐시 줄은 최신 트랜스크립트 사용량 항목을 대신 사용할 수 있습니다. - 실행과 런타임:
/status은 유효한 샌드박스 경로를Execution으로 보고하고, 세션 실행 주체를Runtime으로 보고합니다. 실행 주체는OpenClaw Default,OpenAI Codex, CLI 백엔드 또는 ACP 백엔드입니다. - 응답별 토큰/비용:
/usage off|tokens|full으로 제어합니다. /model status은 사용량이 아니라 모델/인증/엔드포인트에 관한 것입니다.
관련 항목
Skills
Skills 슬래시 명령을 등록하고 제한하는 방법입니다.
Skills 만들기
자체 슬래시 명령을 등록하는 Skills를 만듭니다.
BTW
세션 컨텍스트를 변경하지 않고 부가적인 질문을 합니다.
조정
실행 도중
/steer으로 에이전트를 안내합니다.