English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Skills

슬래시 명령어

명령은 Gateway가 처리합니다. 대부분의 명령은 /로 시작하는 독립 메시지로 보내야 합니다. 호스트 전용 bash 채팅 명령은 ! <cmd>를 사용합니다(/bash <cmd>는 별칭).

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

관련 시스템은 두 가지입니다:

명령

독립형 /... 메시지입니다.

지시어

/think, /fast, /verbose, /trace, /reasoning, /elevated, /exec, /model, /queue.

  • 지시어는 모델이 보기 전에 메시지에서 제거됩니다.
  • 일반 채팅 메시지(지시어만 있는 메시지가 아닌 경우)에서는 "인라인 힌트"로 처리되며 세션 설정에 유지되지 않습니다.
  • 지시어만 있는 메시지(메시지에 지시어만 포함된 경우)에서는 세션에 유지되고 확인 응답을 보냅니다.
  • 지시어는 인증된 발신자에게만 적용됩니다. commands.allowFrom이 설정되어 있으면 이것이 사용되는 유일한 허용 목록입니다. 그렇지 않으면 채널 허용 목록/페어링과 commands.useAccessGroups에서 인증을 가져옵니다. 인증되지 않은 발신자의 지시어는 일반 텍스트로 처리됩니다.
인라인 단축키

허용 목록에 있거나 인증된 발신자만: /help, /commands, /status, /whoami(/id).

즉시 실행되고, 모델이 메시지를 보기 전에 제거되며, 남은 텍스트는 일반 흐름을 계속 따릅니다.

설정

{
  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,
  },
}
commands.textboolean

채팅 메시지에서 /... 구문 분석을 활성화합니다. 네이티브 명령이 없는 표면(WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams)에서는 이를 false로 설정해도 텍스트 명령이 계속 작동합니다.

commands.nativeboolean | "auto"

네이티브 명령을 등록합니다. 자동: Discord/Telegram에서는 켜짐, Slack에서는 꺼짐(슬래시 명령을 추가할 때까지), 네이티브 지원이 없는 제공자에서는 무시됩니다. 제공자별로 재정의하려면 channels.discord.commands.native, channels.telegram.commands.native 또는 channels.slack.commands.native를 설정하세요(bool 또는 "auto"). Discord에서 false는 시작 중 슬래시 명령 등록과 정리를 건너뜁니다. 이전에 등록된 명령은 Discord 앱에서 제거할 때까지 계속 표시될 수 있습니다. Slack 명령은 Slack 앱에서 관리되며 자동으로 제거되지 않습니다.

Discord에서 네이티브 명령 사양은 descriptionLocalizations를 포함할 수 있으며, OpenClaw는 이를 Discord description_localizations로 게시하고 조정 비교에 포함합니다.

commands.nativeSkillsboolean | "auto"

지원되는 경우 Skills 명령을 네이티브로 등록합니다. 자동: Discord/Telegram에서는 켜짐, Slack에서는 꺼짐(Slack은 Skills마다 슬래시 명령을 생성해야 함). 제공자별로 재정의하려면 channels.discord.commands.nativeSkills, channels.telegram.commands.nativeSkills 또는 channels.slack.commands.nativeSkills를 설정하세요(bool 또는 "auto").

commands.bashboolean

! <cmd>가 호스트 셸 명령을 실행하도록 활성화합니다(/bash <cmd>는 별칭이며, tools.elevated 허용 목록이 필요함).

commands.bashForegroundMsnumber

bash가 백그라운드 모드로 전환하기 전에 기다리는 시간을 제어합니다(0은 즉시 백그라운드로 전환).

commands.configboolean

/config를 활성화합니다(openclaw.json 읽기/쓰기).

commands.mcpboolean

/mcp를 활성화합니다(mcp.servers 아래의 OpenClaw 관리 MCP 설정 읽기/쓰기).

commands.pluginsboolean

/plugins를 활성화합니다(Plugin 검색/상태와 설치 및 활성화/비활성화 제어).

commands.debugboolean

/debug를 활성화합니다(런타임 전용 재정의).

commands.restartboolean

/restart와 Gateway 재시작 도구 작업을 활성화합니다.

commands.ownerAllowFromstring[]

소유자 전용 명령/도구 표면에 대한 명시적 소유자 허용 목록을 설정합니다. 이는 위험한 작업을 승인하고 /diagnostics, /export-trajectory, /config 같은 명령을 실행할 수 있는 사람 운영자 계정입니다. commands.allowFrom 및 DM 페어링 접근과는 별개입니다.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImNoYW5uZWxzLjxjaGFubmVs .commands.enforceOwnerForCommands" type="boolean" default="false"> 채널별: 해당 표면에서 소유자 전용 명령을 실행하려면 소유자 신원이 필요하게 합니다. true이면 발신자는 확인된 소유자 후보(예: commands.ownerAllowFrom의 항목 또는 제공자 네이티브 소유자 메타데이터)와 일치하거나 내부 메시지 채널에서 내부 operator.admin 범위를 보유해야 합니다. 채널 allowFrom의 와일드카드 항목이나 비어 있거나 확인되지 않은 소유자 후보 목록만으로는 충분하지 않습니다. 소유자 전용 명령은 해당 채널에서 닫힌 방식으로 실패합니다. 소유자 전용 명령을 ownerAllowFrom과 표준 명령 허용 목록만으로 제한하려면 이를 꺼두세요.

commands.ownerDisplay"raw" | "hash"

시스템 프롬프트에 소유자 ID가 표시되는 방식을 제어합니다.

commands.ownerDisplaySecretstring

선택적으로 commands.ownerDisplay="hash"일 때 사용되는 HMAC 시크릿을 설정합니다.

commands.allowFromobject

명령 인증을 위한 제공자별 허용 목록입니다. 설정된 경우 명령과 지시어의 유일한 인증 소스가 됩니다(채널 허용 목록/페어링 및 commands.useAccessGroups는 무시됨). 전역 기본값에는 "*"를 사용하세요. 제공자별 키가 이를 재정의합니다.

commands.useAccessGroupsboolean

commands.allowFrom이 설정되지 않은 경우 명령에 대해 허용 목록/정책을 적용합니다.

명령 목록

현재 단일 진실 공급원:

  • core 기본 제공 명령은 src/auto-reply/commands-registry.shared.ts에서 제공됩니다.
  • 생성된 dock 명령은 src/auto-reply/commands-registry.data.ts에서 제공됩니다.
  • Plugin 명령은 Plugin registerCommand() 호출에서 제공됩니다.
  • 게이트웨이에서의 실제 가용성은 여전히 설정 플래그, 채널 표면, 설치/활성화된 Plugin에 따라 달라집니다.

Core 기본 제공 명령

세션 및 실행
  • /new [model]은 새 세션을 시작합니다. /reset은 재설정 별칭입니다.
  • Control UI는 입력된 /new를 가로채 새 대시보드 세션을 만들고 해당 세션으로 전환합니다. 입력된 /reset은 여전히 Gateway의 제자리 재설정을 실행합니다.
  • /reset soft [message]는 현재 transcript를 유지하고, 재사용된 CLI 백엔드 세션 ID를 삭제하며, 시작/시스템 프롬프트 로드를 제자리에서 다시 실행합니다.
  • /compact [instructions]는 세션 컨텍스트를 Compaction합니다. Compaction을 참조하세요.
  • /stop은 현재 실행을 중단합니다.
  • /session idle <duration|off> 및 /session max-age <duration|off>는 스레드 바인딩 만료를 관리합니다.
  • /export-session [path]는 현재 세션을 HTML로 내보냅니다. 별칭: /export.
  • /export-trajectory [path]는 exec 승인을 요청한 다음 현재 세션의 JSONL trajectory bundle을 내보냅니다. 하나의 OpenClaw 세션에 대한 프롬프트, 도구, transcript 타임라인이 필요할 때 사용하세요. 그룹 채팅에서는 승인 프롬프트와 내보내기 결과가 소유자에게 비공개로 전달됩니다. 별칭: /trajectory.
모델 및 실행 제어
  • /think <level>은 사고 수준을 설정합니다. 옵션은 활성 모델의 제공자 프로필에서 가져옵니다. 일반적인 수준은 off, minimal, low, medium, high이며, xhigh, adaptive, max 같은 사용자 지정 수준이나 이진 on은 지원되는 경우에만 사용할 수 있습니다. 별칭: /thinking, /t.
  • /verbose on|off|full은 자세한 출력을 전환합니다. 별칭: /v.
  • /trace on|off는 현재 세션의 Plugin 추적 출력을 전환합니다.
  • /fast [status|on|off]는 fast 모드를 표시하거나 설정합니다.
  • /reasoning [on|off|stream]은 reasoning 표시 여부를 전환합니다. 별칭: /reason.
  • /elevated [on|off|ask|full]는 elevated 모드를 전환합니다. 별칭: /elev.
  • /exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>는 exec 기본값을 표시하거나 설정합니다.
  • /model [name|#|status]는 모델을 표시하거나 설정합니다.
  • /models [provider] [page] [limit=<n>|size=<n>|all]는 설정되었거나 인증 사용 가능한 제공자 또는 특정 제공자의 모델을 나열합니다. 해당 제공자의 전체 카탈로그를 탐색하려면 all을 추가하세요.
  • /queue <mode>는 큐 동작(steer, 레거시 queue, followup, collect, steer-backlog, interrupt)과 debounce:0.5s cap:25 drop:summarize 같은 옵션을 관리합니다. /queue default 또는 /queue reset은 세션 재정의를 지웁니다. 명령 큐 및 Steering 큐를 참조하세요.
  • /steer <message>는 /queue 모드와 무관하게 현재 세션의 활성 실행에 안내를 주입합니다. 세션이 유휴 상태일 때는 새 실행을 시작하지 않습니다. 별칭: /tell. Steer를 참조하세요.
검색 및 상태
  • /help는 짧은 도움말 요약을 표시합니다.
  • /commands는 생성된 명령 카탈로그를 표시합니다.
  • /tools [compact|verbose]는 현재 에이전트가 지금 사용할 수 있는 항목을 표시합니다.
  • /status는 실행/런타임 상태, Gateway 및 시스템 가동 시간, 가능한 경우 제공자 사용량/할당량을 표시합니다.
  • /diagnostics [note]는 Gateway 버그와 Codex 하니스 실행을 위한 소유자 전용 지원 보고 흐름입니다. openclaw gateway diagnostics export --json을 실행하기 전에 매번 명시적 exec 승인을 요청합니다. allow-all 규칙으로 diagnostics를 승인하지 마세요. 승인 후에는 로컬 번들 경로, 매니페스트 요약, 개인정보 보호 참고 사항, 관련 세션 ID가 포함된 붙여넣기 가능한 보고서를 보냅니다. 그룹 채팅에서는 승인 프롬프트와 보고서가 소유자에게 비공개로 전달됩니다. 활성 세션이 OpenAI Codex 하니스를 사용하는 경우 동일한 승인으로 관련 Codex 피드백도 OpenAI 서버에 전송되며, 완료된 응답에는 OpenClaw 세션 ID, Codex 스레드 ID, codex resume <thread-id> 명령이 나열됩니다. Diagnostics Export를 참조하세요.
  • /crestodian <request>는 소유자 DM에서 Crestodian 설정 및 복구 도우미를 실행합니다.
  • /tasks는 현재 세션의 활성/최근 백그라운드 작업을 나열합니다.
  • /context [list|detail|json]는 컨텍스트가 조립되는 방식을 설명합니다.
  • /whoami는 발신자 ID를 표시합니다. 별칭: /id.
  • /usage off|tokens|full|cost는 응답별 사용량 바닥글을 제어하거나 로컬 비용 요약을 출력합니다.
Skills, 허용 목록, 승인
  • /skill <name> [input]은 이름으로 Skills를 실행합니다.
  • /allowlist [list|add|remove] ...는 허용 목록 항목을 관리합니다. 텍스트 전용입니다.
  • /approve <id> <decision>은 exec 승인 프롬프트를 해결합니다.
  • /btw <question>은 향후 세션 컨텍스트를 변경하지 않고 부가 질문을 합니다. 별칭: /side. BTW를 참조하세요.
Subagents and ACP
  • /subagents list|kill|log|info|send|steer|spawn은 현재 세션의 하위 에이전트 실행을 관리합니다.
  • /acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help는 ACP 세션과 런타임 옵션을 관리합니다.
  • /focus <target>은 현재 Discord 스레드 또는 Telegram 주제/대화를 세션 대상으로 바인딩합니다.
  • /unfocus는 현재 바인딩을 제거합니다.
  • /agents는 현재 세션의 스레드 바인딩 에이전트를 나열합니다.
  • /kill <id|#|all>은 실행 중인 하위 에이전트 하나 또는 모두를 중단합니다.
  • /subagents steer <id|#> <message>는 실행 중인 하위 에이전트에 조정 메시지를 보냅니다. Steer를 참고하세요.
Owner-only writes and admin
  • /config show|get|set|unset은 openclaw.json을 읽거나 씁니다. 소유자 전용입니다. commands.config: true가 필요합니다.
  • /mcp show|get|set|unset은 mcp.servers 아래의 OpenClaw 관리 MCP 서버 구성을 읽거나 씁니다. 소유자 전용입니다. commands.mcp: true가 필요합니다.
  • /plugins list|inspect|show|get|install|enable|disable은 Plugin 상태를 검사하거나 변경합니다. /plugin은 별칭입니다. 쓰기는 소유자 전용입니다. commands.plugins: true가 필요합니다.
  • /debug show|set|unset|reset은 런타임 전용 구성 재정의를 관리합니다. 소유자 전용입니다. commands.debug: true가 필요합니다.
  • /restart는 활성화된 경우 OpenClaw를 다시 시작합니다. 기본값: 활성화됨. 비활성화하려면 commands.restart: false를 설정하세요.
  • /send on|off|inherit는 전송 정책을 설정합니다. 소유자 전용입니다.
Voice, TTS, channel control
  • /tts on|off|status|chat|latest|provider|limit|summary|audio|help는 TTS를 제어합니다. TTS를 참고하세요.
  • /activation mention|always는 그룹 활성화 모드를 설정합니다.
  • /bash <command>는 호스트 셸 명령을 실행합니다. 텍스트 전용입니다. 별칭: ! <command>. commands.bash: true와 tools.elevated 허용 목록이 필요합니다.
  • !poll [sessionId]는 백그라운드 bash 작업을 확인합니다.
  • !stop [sessionId]는 백그라운드 bash 작업을 중지합니다.

생성된 도킹 명령어

도킹 명령어는 현재 세션의 응답 경로를 다른 연결된 채널로 전환합니다. 설정, 예시, 문제 해결은 채널 도킹을 참고하세요.

도킹 명령어는 네이티브 명령어 지원이 있는 채널 Plugin에서 생성됩니다. 현재 번들 세트:

  • /dock-discord (별칭: /dock_discord)
  • /dock-mattermost (별칭: /dock_mattermost)
  • /dock-slack (별칭: /dock_slack)
  • /dock-telegram (별칭: /dock_telegram)

직접 채팅에서 도킹 명령어를 사용해 현재 세션의 응답 경로를 다른 연결된 채널로 전환하세요. 에이전트는 같은 세션 컨텍스트를 유지하지만, 해당 세션의 이후 응답은 선택한 채널 피어로 전달됩니다.

도킹 명령어에는 session.identityLinks가 필요합니다. 소스 발신자와 대상 피어는 같은 ID 그룹에 있어야 합니다. 예: ["telegram:123", "discord:456"]. ID가 123인 Telegram 사용자가 /dock_discord를 보내면 OpenClaw는 활성 세션에 lastChannel: "discord" 및 lastTo: "456"을 저장합니다. 발신자가 Discord 피어에 연결되어 있지 않으면, 명령은 일반 채팅으로 넘어가지 않고 설정 힌트로 응답합니다.

도킹은 활성 세션 경로만 변경합니다. 채널 계정을 만들거나, 접근 권한을 부여하거나, 채널 허용 목록을 우회하거나, 대화 기록을 다른 세션으로 이동하지 않습니다. 경로를 다시 전환하려면 /dock-telegram, /dock-slack, /dock-mattermost 또는 다른 생성된 도킹 명령어를 사용하세요.

번들 Plugin 명령어

번들 Plugin은 더 많은 슬래시 명령어를 추가할 수 있습니다. 이 저장소의 현재 번들 명령어:

  • /dreaming [on|off|status|help]는 메모리 Dreaming을 전환합니다. Dreaming을 참고하세요.
  • /pair [qr|status|pending|approve|cleanup|notify]는 기기 페어링/설정 흐름을 관리합니다. 페어링을 참고하세요.
  • /phone status|arm <camera|screen|writes|all> [duration]|disarm는 고위험 전화 Node 명령어를 일시적으로 무장합니다.
  • /voice status|list [limit]|set <voiceId|name>는 Talk 음성 구성을 관리합니다. Discord에서는 네이티브 명령어 이름이 /talkvoice입니다.
  • /card ...는 LINE 리치 카드 프리셋을 보냅니다. LINE을 참고하세요.
  • /codex status|models|threads|resume|compact|review|diagnostics|account|mcp|skills는 번들 Codex 앱 서버 하니스를 검사하고 제어합니다. Codex 하니스를 참고하세요.
  • QQBot 전용 명령어:
    • /bot-ping
    • /bot-version
    • /bot-help
    • /bot-upgrade
    • /bot-logs

동적 skill 명령어

사용자가 호출할 수 있는 skills도 슬래시 명령어로 노출됩니다.

  • /skill <name> [input]은 일반 진입점으로 항상 작동합니다.
  • skill/Plugin이 등록한 경우 skills가 /prose 같은 직접 명령어로도 나타날 수 있습니다.
  • 네이티브 skill 명령어 등록은 commands.nativeSkills 및 channels.<provider>.commands.nativeSkills로 제어됩니다.
  • 명령어 사양은 Discord를 포함해 현지화된 설명을 지원하는 네이티브 표면을 위해 descriptionLocalizations를 제공할 수 있습니다.
Argument and parser notes
  • 명령어는 명령어와 인수 사이에 선택적 :를 허용합니다(예: /think: high, /send: on, /help:).
  • /new <model>은 모델 별칭, provider/model 또는 공급자 이름(퍼지 매칭)을 허용합니다. 일치 항목이 없으면 텍스트는 메시지 본문으로 처리됩니다.
  • 전체 공급자 사용량 분석은 openclaw status --usage를 사용하세요.
  • /allowlist add|remove에는 commands.config=true가 필요하며 채널 configWrites를 따릅니다.
  • 다중 계정 채널에서는 구성 대상 /allowlist --account <id> 및 /config set channels.<provider>.accounts.<id>...도 대상 계정의 configWrites를 따릅니다.
  • /usage는 응답별 사용량 바닥글을 제어합니다. /usage cost는 OpenClaw 세션 로그에서 로컬 비용 요약을 출력합니다.
  • /restart는 기본적으로 활성화되어 있습니다. 비활성화하려면 commands.restart: false를 설정하세요.
  • /plugins install <spec>은 openclaw plugins install과 같은 Plugin 사양을 허용합니다. 로컬 경로/아카이브, npm 패키지, git:<repo> 또는 clawhub:<pkg>를 사용할 수 있으며, 이후 Plugin 소스 모듈이 변경되었으므로 Gateway 재시작을 요청합니다.
  • /plugins enable|disable은 Plugin 구성을 업데이트하고 새 에이전트 턴을 위해 Gateway Plugin 다시 로드를 트리거합니다.
Channel-specific behavior
  • Discord 전용 네이티브 명령어: /vc join|leave|status는 음성 채널을 제어합니다(텍스트로는 사용할 수 없음). join에는 길드와 선택된 음성/스테이지 채널이 필요합니다. channels.discord.voice 및 네이티브 명령어가 필요합니다.
  • Discord 스레드 바인딩 명령어(/focus, /unfocus, /agents, /session idle, /session max-age)는 유효한 스레드 바인딩이 활성화되어 있어야 합니다(session.threadBindings.enabled 및/또는 channels.discord.threadBindings.enabled).
  • ACP 명령어 참조 및 런타임 동작: ACP 에이전트.
Verbose / trace / fast / reasoning safety
  • /verbose는 디버깅과 추가 가시성을 위한 것입니다. 일반 사용에서는 끄세요.
  • /trace는 /verbose보다 범위가 좁습니다. Plugin 소유 trace/debug 줄만 표시하고 일반 verbose 도구 잡담은 꺼 둡니다.
  • /fast on|off는 세션 재정의를 유지합니다. 지우고 구성 기본값으로 돌아가려면 Sessions UI의 inherit 옵션을 사용하세요.
  • /fast는 공급자별로 동작합니다. OpenAI/OpenAI Codex는 네이티브 Responses 엔드포인트에서 이를 service_tier=priority로 매핑하고, OAuth 인증 트래픽을 포함해 api.anthropic.com으로 전송되는 직접 공개 Anthropic 요청은 이를 service_tier=auto 또는 standard_only로 매핑합니다. OpenAI 및 Anthropic을 참고하세요.
  • 도구 실패 요약은 관련이 있을 때 계속 표시되지만, 자세한 실패 텍스트는 /verbose가 on 또는 full일 때만 포함됩니다.
  • /reasoning, /verbose, /trace는 그룹 환경에서 위험합니다. 노출할 의도가 없었던 내부 reasoning, 도구 출력 또는 Plugin 진단을 드러낼 수 있습니다. 특히 그룹 채팅에서는 꺼 두는 것이 좋습니다.
Model switching
  • /model은 새 세션 모델을 즉시 유지합니다.
  • 에이전트가 유휴 상태이면 다음 실행에서 바로 사용됩니다.
  • 실행이 이미 활성 상태이면 OpenClaw는 라이브 전환을 대기 중으로 표시하고, 깔끔한 재시도 지점에서만 새 모델로 다시 시작합니다.
  • 도구 활동이나 응답 출력이 이미 시작된 경우 대기 중인 전환은 나중의 재시도 기회 또는 다음 사용자 턴까지 대기열에 남아 있을 수 있습니다.
  • 로컬 TUI에서 /crestodian [request]는 일반 에이전트 TUI에서 Crestodian으로 돌아갑니다. 이는 메시지 채널 구조 모드와 별개이며 원격 구성 권한을 부여하지 않습니다.
Fast path and inline shortcuts
  • 빠른 경로: 허용 목록에 있는 발신자의 명령어 전용 메시지는 즉시 처리됩니다(대기열 + 모델 우회).
  • 그룹 멘션 게이팅: 허용 목록에 있는 발신자의 명령어 전용 메시지는 멘션 요구 사항을 우회합니다.
  • 인라인 단축키(허용 목록 발신자만): 특정 명령어는 일반 메시지에 포함되어 있어도 작동하며, 모델이 나머지 텍스트를 보기 전에 제거됩니다.
    • 예: hey /status는 상태 응답을 트리거하고, 나머지 텍스트는 일반 흐름을 계속 탑니다.
  • 현재: /help, /commands, /status, /whoami (/id).
  • 승인되지 않은 명령어 전용 메시지는 조용히 무시되며, 인라인 /... 토큰은 일반 텍스트로 처리됩니다.
Skill commands and native arguments
  • Skill 명령어: user-invocable skills는 슬래시 명령어로 노출됩니다. 이름은 a-z0-9_로 정리됩니다(최대 32자). 충돌하면 숫자 접미사가 붙습니다(예: _2).
    • /skill <name> [input]은 이름으로 skill을 실행합니다(skill별 명령어가 네이티브 명령어 제한에 걸릴 때 유용).
    • 기본적으로 skill 명령어는 일반 요청으로 모델에 전달됩니다.
    • Skills는 선택적으로 command-dispatch: tool을 선언해 명령어를 도구로 직접 라우팅할 수 있습니다(결정적, 모델 없음).
    • 예: /prose (OpenProse Plugin) — OpenProse를 참고하세요.
  • 네이티브 명령어 인수: Discord는 동적 옵션에 자동 완성을 사용합니다(필수 인수를 생략하면 버튼 메뉴 사용). Telegram 및 Slack은 명령어가 선택지를 지원하고 인수를 생략하면 버튼 메뉴를 표시합니다. 동적 선택지는 대상 세션 모델을 기준으로 확인되므로, /think 수준 같은 모델별 옵션은 해당 세션의 /model 재정의를 따릅니다.

/tools

/tools는 구성 질문이 아니라 런타임 질문에 답합니다. 즉, 이 에이전트가 이 대화에서 지금 사용할 수 있는 것입니다.

  • 기본 /tools는 간결하며 빠른 훑어보기에 최적화되어 있습니다.
  • /tools verbose는 짧은 설명을 추가합니다.
  • 인수를 지원하는 네이티브 명령어 표면은 compact|verbose와 같은 모드 전환을 노출합니다.
  • 결과는 세션 범위이므로 에이전트, 채널, 스레드, 발신자 권한 또는 모델을 변경하면 출력이 바뀔 수 있습니다.
  • /tools에는 core 도구, 연결된 Plugin 도구, 채널 소유 도구를 포함해 런타임에서 실제로 도달 가능한 도구가 포함됩니다.

프로필 및 재정의 편집에는 /tools를 정적 카탈로그로 취급하는 대신 Control UI 도구 패널이나 구성/카탈로그 표면을 사용하세요.

사용량 표면(어디에 무엇이 표시되는지)

  • 제공자 사용량/할당량(예: "Claude 80% 남음)은 사용량 추적이 활성화된 경우 현재 모델 제공자의 /status에 표시됩니다. OpenClaw는 제공자 기간을 % left로 정규화합니다. MiniMax의 경우 남은 비율 전용 필드는 표시 전에 반전되며, model_remains 응답은 채팅 모델 항목과 모델 태그가 붙은 플랜 레이블을 우선 사용합니다.
  • /status의 토큰/캐시 라인은 라이브 세션 스냅샷이 부족할 때 최신 transcript 사용량 항목으로 폴백할 수 있습니다. 기존의 0이 아닌 라이브 값이 계속 우선하며, 저장된 합계가 없거나 더 작을 때 transcript 폴백은 활성 런타임 모델 레이블과 더 큰 프롬프트 중심 합계도 복구할 수 있습니다.
  • 실행 vs 런타임: /status는 유효한 sandbox 경로에 대해 Execution을 보고하고, 실제로 세션을 실행하는 주체에 대해 Runtime을 보고합니다: OpenClaw Pi Default, OpenAI Codex, CLI 백엔드 또는 ACP 백엔드.
  • 응답별 토큰/비용은 /usage off|tokens|full로 제어됩니다(일반 응답에 추가됨).
  • /model status는 사용량이 아니라 모델/인증/엔드포인트에 관한 것입니다.

모델 선택(/model)

/model은 지시문으로 구현됩니다.

예:

/model
/model list
/model 3
/model openai/gpt-5.4
/model opus@anthropic:default
/model status

참고:

  • /model 및 /model list는 간결한 번호 매기기 선택기(모델 패밀리 + 사용 가능한 제공자)를 표시합니다.
  • Discord에서는 /model 및 /models가 제공자 및 모델 드롭다운과 Submit 단계가 포함된 대화형 선택기를 엽니다.
  • /model <#>는 해당 선택기에서 선택합니다(가능한 경우 현재 제공자를 우선 사용).
  • /model status는 구성된 제공자 엔드포인트(baseUrl)와 API 모드(api)가 있을 경우 이를 포함한 상세 보기를 표시합니다.

디버그 재정의

/debug를 사용하면 런타임 전용 구성 재정의(메모리, 디스크 아님)를 설정할 수 있습니다. 소유자 전용입니다. 기본적으로 비활성화되어 있으며 commands.debug: true로 활성화합니다.

예:

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

Plugin 추적 출력

/trace를 사용하면 전체 상세 모드를 켜지 않고도 세션 범위 Plugin 추적/디버그 라인을 전환할 수 있습니다.

예:

/trace
/trace on
/trace off

참고:

  • 인수 없이 /trace를 사용하면 현재 세션 추적 상태를 표시합니다.
  • /trace on은 현재 세션에 대해 Plugin 추적 라인을 활성화합니다.
  • /trace off는 이를 다시 비활성화합니다.
  • Plugin 추적 라인은 /status에 표시되거나 일반 assistant 응답 뒤의 후속 진단 메시지로 나타날 수 있습니다.
  • /trace는 /debug를 대체하지 않습니다. /debug는 계속 런타임 전용 구성 재정의를 관리합니다.
  • /trace는 /verbose를 대체하지 않습니다. 일반 상세 도구/상태 출력은 계속 /verbose에 속합니다.

구성 업데이트

/config는 디스크의 구성(openclaw.json)에 씁니다. 소유자 전용입니다. 기본적으로 비활성화되어 있으며 commands.config: true로 활성화합니다.

예:

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

MCP 업데이트

/mcp는 OpenClaw가 관리하는 MCP 서버 정의를 mcp.servers 아래에 씁니다. 소유자 전용입니다. 기본적으로 비활성화되어 있으며 commands.mcp: true로 활성화합니다.

예:

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

Plugin 업데이트

/plugins를 사용하면 운영자가 발견된 Plugin을 검사하고 구성에서 활성화 여부를 전환할 수 있습니다. 읽기 전용 흐름에서는 /plugin을 별칭으로 사용할 수 있습니다. 기본적으로 비활성화되어 있으며 commands.plugins: true로 활성화합니다.

예:

/plugins
/plugins list
/plugin show context7
/plugins enable context7
/plugins disable context7

표면 참고 사항

표면별 세션
  • 텍스트 명령은 일반 채팅 세션에서 실행됩니다(DM은 main을 공유하고, 그룹은 자체 세션을 가짐).
  • 네이티브 명령은 격리된 세션을 사용합니다.
    • Discord: agent:<agentId>:discord:slash:<userId>
    • Slack: agent:<agentId>:slack:slash:<userId>(channels.slack.slashCommand.sessionPrefix를 통해 접두사 구성 가능)
    • Telegram: telegram:slash:<userId>(CommandTargetSessionKey를 통해 채팅 세션을 대상으로 함)
  • **/stop**은 현재 실행을 중단할 수 있도록 활성 채팅 세션을 대상으로 합니다.
Slack 세부 사항

channels.slack.slashCommand는 단일 /openclaw 스타일 명령에 대해 계속 지원됩니다. commands.native를 활성화하면 기본 제공 명령마다 Slack slash 명령을 하나씩 만들어야 합니다(/help와 같은 이름). Slack의 명령 인수 메뉴는 임시 Block Kit 버튼으로 전달됩니다.

Slack 네이티브 예외: Slack이 /status를 예약해 두었기 때문에 /status가 아니라 /agentstatus를 등록하세요. 텍스트 /status는 Slack 메시지에서 계속 작동합니다.

BTW 사이드 질문

/btw는 현재 세션에 대한 빠른 사이드 질문입니다. /side는 별칭입니다.

일반 채팅과 달리:

  • 현재 세션을 배경 컨텍스트로 사용합니다.
  • 별도의 도구 없는 일회성 호출로 실행됩니다.
  • 이후 세션 컨텍스트를 변경하지 않습니다.
  • transcript 기록에 쓰이지 않습니다.
  • 일반 assistant 메시지 대신 라이브 사이드 결과로 전달됩니다.

따라서 /btw는 주 작업이 계속 진행되는 동안 임시 설명이 필요할 때 유용합니다.

예:

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

전체 동작 및 클라이언트 UX 세부 정보는 BTW 사이드 질문을 참조하세요.

관련