슬래시 명령어

Gateway는 /로 시작하는 독립 메시지로 전송된 명령을 처리합니다. 호스트 전용 bash 명령은 ! <cmd>를 사용합니다(/bash <cmd>는 별칭).

대화가 ACP 세션에 바인딩되어 있으면 일반 텍스트는 ACP 하네스로 라우팅됩니다. Gateway 관리 명령은 로컬에 남습니다. /acp ...는 항상 OpenClaw 명령 핸들러에 도달하며, 표면에서 명령 처리가 활성화된 경우 /status와 /unfocus도 로컬에 남습니다.

세 가지 명령 유형

구성

{  commands: {    native: "auto",    nativeSkills: "auto",    text: true,    bash: false,    bashForegroundMs: 2000,    config: false,    mcp: false,    plugins: false,    debug: false,    restart: true,    ownerAllowFrom: ["discord:123456789012345678"],    ownerDisplay: "raw",    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",    allowFrom: {      "*": ["user1"],      discord: ["user:123"],    },    useAccessGroups: true,  },}

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImNoYW5uZWxzLjxjaGFubmVs .commands.enforceOwnerForCommands" type="boolean" default="false"> 채널별: 소유자 전용 명령에 소유자 ID를 요구합니다. true이면 발신자는 commands.ownerAllowFrom과 일치하거나 내부 operator.admin 범위를 보유해야 합니다. 와일드카드 allowFrom 항목만으로는 충분하지 않습니다.

명령 목록

명령은 세 가지 소스에서 옵니다.

• 코어 기본 제공: src/auto-reply/commands-registry.shared.ts
• 생성된 dock 명령: src/auto-reply/commands-registry.data.ts
• Plugin 명령: plugin registerCommand() 호출

사용 가능 여부는 구성 플래그, 채널 표면, 설치/활성화된 plugins에 따라 달라집니다.

코어 명령

도킹 명령

도킹 명령은 활성 세션의 응답 경로를 연결된 다른 채널로 전환합니다. 설정 및 문제 해결은 채널 도킹을 참조하세요.

네이티브 명령 지원이 있는 채널 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 명령

사용자가 호출할 수 있는 Skills는 슬래시 명령으로 노출됩니다:

• /skill <name> [input]은 항상 일반 진입점으로 작동합니다.
• Skills는 직접 명령으로 등록될 수 있습니다(예: OpenProse의 /prose).
• 네이티브 Skill 명령 등록은 commands.nativeSkills 및 channels.<provider>.commands.nativeSkills로 제어됩니다.
• 이름은 a-z0-9_로 정리됩니다(최대 32자). 충돌이 발생하면 숫자 접미사가 붙습니다.

/tools — 에이전트가 지금 사용할 수 있는 것

/tools는 런타임 질문에 답합니다: 이 대화에서 이 에이전트가 지금 사용할 수 있는 것은 무엇인가 — 정적 구성 카탈로그가 아닙니다.

/tools         # compact view/tools verbose # with short descriptions

결과는 세션 범위입니다. 에이전트, 채널, 스레드, 발신자 권한 부여 또는 모델을 변경하면 출력이 바뀔 수 있습니다. 프로필 및 재정의 편집에는 Control UI Tools 패널 또는 구성 표면을 사용하세요.

/model — 모델 선택

/model             # show model picker/model list        # same/model 3           # select by number from picker/model openai/gpt-5.4/model opus@anthropic:default/model default     # clear the session model selection/model status      # detailed view with endpoint and API mode

Discord에서 /model과 /models는 제공자 및 모델 드롭다운이 있는 대화형 선택기를 엽니다. 선택기는 provider/* 항목을 포함하여 agents.defaults.models를 존중합니다.

/config — 디스크 구성 쓰기

/config show/config show messages.responsePrefix/config get messages.responsePrefix/config set messages.responsePrefix="[openclaw]"/config unset messages.responsePrefix

구성은 쓰기 전에 검증됩니다. 잘못된 변경은 거부됩니다. /config 업데이트는 재시작 후에도 유지됩니다.

/mcp — MCP 서버 구성

/mcp show/mcp show context7/mcp set context7={"command":"uvx","args":["context7-mcp"]}/mcp unset context7

/mcp는 구성을 임베디드 에이전트 프로젝트 설정이 아니라 OpenClaw 구성에 저장합니다.

/debug — 런타임 전용 재정의

/debug show/debug set messages.responsePrefix="[openclaw]"/debug set channels.whatsapp.allowFrom=["+1555","+4477"]/debug unset messages.responsePrefix/debug reset

/plugins — Plugin 관리

/plugins/plugins list/plugin show context7/plugins enable context7/plugins disable context7/plugins install ./path/to/plugin

/plugins enable|disable은 Plugin 구성을 업데이트하고 새 에이전트 턴에 대해 Gateway Plugin 런타임을 핫 리로드합니다. /plugins install은 Plugin 소스 모듈이 변경되었기 때문에 관리되는 Gateway를 자동으로 다시 시작합니다.

/trace — Plugin 추적 출력

/trace          # show current trace state/trace on/trace off

/trace는 전체 verbose 모드 없이 세션 범위 Plugin 추적/디버그 라인을 드러냅니다. 이는 /debug(런타임 재정의) 또는 /verbose(일반 도구 출력)를 대체하지 않습니다.

/btw — 부가 질문

/btw는 현재 세션 컨텍스트에 대한 빠른 부가 질문입니다. 별칭: /side.

/btw what are we doing right now?/side what changed while the main run continued?

일반 메시지와 달리:

• 현재 세션을 배경 컨텍스트로 사용합니다.
• Codex 하네스 세션에서는 임시 Codex 사이드 스레드로 실행됩니다.
• 이후 세션 컨텍스트를 변경하지 않습니다.
• transcript 기록에 쓰이지 않습니다.

전체 동작은 BTW 부가 질문을 참조하세요.

표면 참고 사항

제공자 사용량 및 상태

• 제공자 사용량/할당량(예: "Claude 80% left")은 사용량 추적이 활성화된 경우 현재 모델 제공자에 대해 /status에 표시됩니다.
• 토큰/캐시 라인은 live 세션 스냅샷이 희소할 때 최신 transcript 사용량 항목으로 폴백할 수 있습니다.
• 실행 vs 런타임: /status는 유효한 샌드박스 경로에 대해 Execution을, 세션을 실행하는 주체에 대해 Runtime을 보고합니다: OpenClaw Default, OpenAI Codex, CLI 백엔드 또는 ACP 백엔드.
• 응답별 토큰/비용: /usage off|tokens|full로 제어됩니다.
• /model status는 사용량이 아니라 모델/인증/엔드포인트에 관한 것입니다.

관련 항목