메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
수행 내용

  • 수신 본문 어디서나 사용할 수 있는 인라인 지시문: /t <level>, /think:<level>, 또는 /thinking <level>.
  • 수준(별칭): off | minimal | low | medium | high | xhigh | adaptive | max
    • minimal → “think”
    • low → “think hard”
    • medium → “think harder”
    • high → “ultrathink” (최대 예산)
    • xhigh → “ultrathink+” (GPT-5.2+ 및 Codex 모델, Anthropic Claude Opus 4.7 effort 포함)
    • adaptive → 제공자가 관리하는 적응형 thinking(Anthropic/Bedrock의 Claude 4.6, Anthropic Claude Opus 4.7, Google Gemini dynamic thinking 지원)
    • max → 제공자 최대 추론(Anthropic Claude Opus 4.7; Ollama는 이를 가장 높은 네이티브 think effort에 매핑)
    • x-high, x_high, extra-high, extra high, extra_high는 xhigh에 매핑됩니다.
    • highest는 high에 매핑됩니다.
  • 제공자 참고 사항:
    • Thinking 메뉴와 선택기는 제공자 프로필 기반입니다. Provider Plugin은 선택된 모델의 정확한 수준 집합을 선언하며, 여기에는 이진 on 같은 레이블도 포함됩니다.
    • adaptive, xhigh, max는 이를 지원하는 제공자/모델 프로필에만 표시됩니다. 지원되지 않는 수준에 대해 입력된 지시문은 해당 모델의 유효한 옵션과 함께 거부됩니다.
    • 기존에 저장된 지원되지 않는 수준은 제공자 프로필 순위에 따라 다시 매핑됩니다. adaptive는 비적응형 모델에서 medium으로 대체되고, xhigh와 max는 선택된 모델이 지원하는 가장 큰 비-off 수준으로 대체됩니다.
    • Anthropic Claude 4.6 모델은 명시적인 thinking 수준이 설정되지 않은 경우 기본값이 adaptive입니다.
    • Anthropic Claude Opus 4.7은 adaptive thinking을 기본값으로 사용하지 않습니다. 명시적으로 thinking 수준을 설정하지 않는 한 API effort 기본값은 제공자 소유로 유지됩니다.
    • Anthropic Claude Opus 4.7은 /think xhigh를 adaptive thinking과 output_config.effort: "xhigh"로 매핑합니다. /think는 thinking 지시문이고 xhigh는 Opus 4.7 effort 설정이기 때문입니다.
    • Anthropic Claude Opus 4.7은 /think max도 제공합니다. 이는 동일한 제공자 소유 최대 effort 경로에 매핑됩니다.
    • 직접 DeepSeek V4 모델은 /think xhigh|max를 제공합니다. 둘 다 DeepSeek reasoning_effort: "max"에 매핑되며, 더 낮은 비-off 수준은 high에 매핑됩니다.
    • OpenRouter를 통해 라우팅되는 DeepSeek V4 모델은 /think xhigh를 제공하고 OpenRouter가 지원하는 reasoning_effort 값을 전송합니다. 저장된 max 재정의는 xhigh로 대체됩니다.
    • Ollama thinking 지원 모델은 /think low|medium|high|max를 제공합니다. Ollama의 네이티브 API가 low, medium, high effort 문자열을 허용하므로 max는 네이티브 think: "high"에 매핑됩니다.
    • OpenAI GPT 모델은 모델별 Responses API effort 지원을 통해 /think를 매핑합니다. /think off는 대상 모델이 이를 지원하는 경우에만 reasoning.effort: "none"을 전송합니다. 그렇지 않으면 OpenClaw는 지원되지 않는 값을 보내는 대신 비활성화된 reasoning 페이로드를 생략합니다.
    • 사용자 지정 OpenAI 호환 카탈로그 항목은 models.providers.<provider>.models[].compat.supportedReasoningEfforts에 "xhigh"를 포함하도록 설정하여 /think xhigh를 사용할 수 있습니다. 이는 발신 OpenAI reasoning effort 페이로드를 매핑하는 것과 동일한 compat 메타데이터를 사용하므로 메뉴, 세션 검증, 에이전트 CLI, llm-task가 전송 동작과 일치합니다.
    • 오래된 구성의 OpenRouter Hunter Alpha 참조는 프록시 reasoning 삽입을 건너뜁니다. 해당 폐기된 경로가 reasoning 필드를 통해 최종 답변 텍스트를 반환할 수 있기 때문입니다.
    • Google Gemini는 /think adaptive를 Gemini의 제공자 소유 dynamic thinking에 매핑합니다. Gemini 3 요청은 고정 thinkingLevel을 생략하고, Gemini 2.5 요청은 thinkingBudget: -1을 전송합니다. 고정 수준은 여전히 해당 모델 계열에 가장 가까운 Gemini thinkingLevel 또는 예산에 매핑됩니다.
    • Anthropic 호환 스트리밍 경로의 MiniMax(minimax/*)는 모델 매개변수나 요청 매개변수에서 thinking을 명시적으로 설정하지 않는 한 기본값이 thinking: { type: "disabled" }입니다. 이는 MiniMax의 비네이티브 Anthropic 스트림 형식에서 reasoning_content 델타가 유출되는 것을 방지합니다.
    • Z.AI(zai/*)는 이진 thinking(on/off)만 지원합니다. 비-off 수준은 모두 on으로 처리됩니다(low에 매핑).
    • Moonshot(moonshot/*)은 /think off를 thinking: { type: "disabled" }에 매핑하고, 비-off 수준은 모두 thinking: { type: "enabled" }에 매핑합니다. thinking이 활성화되면 Moonshot은 tool_choice auto|none만 허용합니다. OpenClaw는 호환되지 않는 값을 auto로 정규화합니다.

​
해석 순서

  1. 메시지의 인라인 지시문(해당 메시지에만 적용).
  2. 세션 재정의(지시문만 포함된 메시지를 보내 설정).
  3. 에이전트별 기본값(구성의 agents.list[].thinkingDefault).
  4. 전역 기본값(구성의 agents.defaults.thinkingDefault).
  5. 대체값: 제공자가 선언한 기본값이 있으면 사용합니다. 그렇지 않으면 reasoning 지원 모델은 medium 또는 해당 모델에서 지원되는 가장 가까운 비-off 수준으로 해석되고, reasoning 미지원 모델은 off로 유지됩니다.

​
세션 기본값 설정

  • 지시문만 포함된 메시지를 보냅니다(공백 허용). 예: /think:medium 또는 /t high.
  • 이는 현재 세션에 유지됩니다(기본적으로 발신자별). 세션 재정의를 지우고 구성/제공자 기본값을 상속하려면 /think default를 사용합니다. 별칭에는 inherit, clear, reset, unpin이 포함됩니다.
  • /think off는 명시적인 off 재정의를 저장합니다. 세션 재정의를 변경하거나 지울 때까지 thinking을 비활성화합니다.
  • 확인 응답이 전송됩니다(Thinking level set to high. / Thinking disabled.). 수준이 유효하지 않으면(예: /thinking big) 명령이 힌트와 함께 거부되고 세션 상태는 변경되지 않습니다.
  • 현재 thinking 수준을 보려면 인수 없이 /think(또는 /think:)를 보냅니다.

​
에이전트별 적용

  • Embedded Pi: 해석된 수준이 인프로세스 Pi 에이전트 런타임으로 전달됩니다.
  • Claude CLI 백엔드: claude-cli 사용 시 비-off 수준은 --effort로 Claude Code에 전달됩니다. CLI 백엔드를 참조하세요.

​
빠른 모드(/fast)

  • 수준: on|off|default.
  • 지시문만 포함된 메시지는 세션 빠른 모드 재정의를 전환하고 Fast mode enabled. / Fast mode disabled.로 응답합니다. 세션 재정의를 지우고 구성된 기본값을 상속하려면 /fast default를 사용합니다. 별칭에는 inherit, clear, reset, unpin이 포함됩니다.
  • 현재 유효한 빠른 모드 상태를 보려면 모드 없이 /fast(또는 /fast status)를 보냅니다.
  • OpenClaw는 다음 순서로 빠른 모드를 해석합니다.
    1. 인라인/지시문 전용 /fast on|off 재정의(/fast default는 이 계층을 지움)
    2. 세션 재정의
    3. 에이전트별 기본값(agents.list[].fastModeDefault)
    4. 모델별 구성: agents.defaults.models["<provider>/<model>"].params.fastMode
    5. 대체값: off
  • openai/*의 경우 빠른 모드는 지원되는 Responses 요청에서 service_tier=priority를 전송하여 OpenAI 우선 처리에 매핑됩니다.
  • openai-codex/*의 경우 빠른 모드는 Codex Responses에 동일한 service_tier=priority 플래그를 전송합니다. OpenClaw는 두 인증 경로 전체에서 하나의 공유 /fast 토글을 유지합니다.
  • OAuth 인증 트래픽이 api.anthropic.com으로 전송되는 경우를 포함한 직접 공개 anthropic/* 요청의 경우, 빠른 모드는 Anthropic 서비스 계층에 매핑됩니다. /fast on은 service_tier=auto를 설정하고, /fast off는 service_tier=standard_only를 설정합니다.
  • Anthropic 호환 경로의 minimax/*의 경우 /fast on(또는 params.fastMode: true)은 MiniMax-M2.7을 MiniMax-M2.7-highspeed로 다시 씁니다.
  • 명시적인 Anthropic serviceTier / service_tier 모델 매개변수는 둘 다 설정된 경우 빠른 모드 기본값을 재정의합니다. OpenClaw는 여전히 Anthropic이 아닌 프록시 기본 URL에 대해 Anthropic 서비스 계층 삽입을 건너뜁니다.
  • /status는 빠른 모드가 활성화된 경우에만 Fast를 표시합니다.

​
상세 출력 지시문(/verbose 또는 /v)

  • 수준: on(최소) | full | off(기본값).
  • 지시문만 포함된 메시지는 세션 상세 출력을 전환하고 Verbose logging enabled. / Verbose logging disabled.로 응답합니다. 유효하지 않은 수준은 상태를 변경하지 않고 힌트를 반환합니다.
  • /verbose off는 명시적인 세션 재정의를 저장합니다. Sessions UI에서 inherit을 선택하여 지우세요.
  • 인라인 지시문은 해당 메시지에만 영향을 줍니다. 그 외에는 세션/전역 기본값이 적용됩니다.
  • 현재 상세 출력 수준을 보려면 인수 없이 /verbose(또는 /verbose:)를 보냅니다.
  • 상세 출력이 켜져 있으면 구조화된 도구 결과를 내보내는 에이전트(Pi, 기타 JSON 에이전트)는 각 도구 호출을 자체 메타데이터 전용 메시지로 되돌려 보내며, 가능한 경우 <emoji> <tool-name>: <arg> 접두사가 붙습니다. 이러한 도구 요약은 각 도구가 시작되는 즉시 전송됩니다(별도 말풍선). 스트리밍 델타로 전송되지 않습니다.
  • 도구 실패 요약은 일반 모드에서도 계속 표시되지만, 원시 오류 세부 정보 접미사는 상세 출력이 on 또는 full이 아닌 한 숨겨집니다.
  • 상세 출력이 full이면 도구 출력도 완료 후 전달됩니다(별도 말풍선, 안전한 길이로 잘림). 실행 중에 /verbose on|full|off를 전환하면 이후 도구 말풍선은 새 설정을 따릅니다.
  • agents.defaults.toolProgressDetail은 /verbose 도구 요약과 진행 중 초안 도구 줄의 형태를 제어합니다. 🛠️ Exec: checking JS syntax 같은 간결한 사람이 읽기 쉬운 레이블에는 "explain"(기본값)을 사용하고, 디버깅을 위해 원시 명령/세부 정보도 추가하려면 "raw"를 사용합니다. 에이전트별 agents.list[].toolProgressDetail은 기본값을 재정의합니다.
    • explain: 🛠️ Exec: check JS syntax for /tmp/app.js
    • raw: 🛠️ Exec: check JS syntax for /tmp/app.js, node --check /tmp/app.js

​
Plugin 추적 지시문(/trace)

  • 수준: on | off(기본값).
  • 지시문만 포함된 메시지는 세션 Plugin 추적 출력을 전환하고 Plugin trace enabled. / Plugin trace disabled.로 응답합니다.
  • 인라인 지시문은 해당 메시지에만 영향을 줍니다. 그 외에는 세션/전역 기본값이 적용됩니다.
  • 현재 추적 수준을 보려면 인수 없이 /trace(또는 /trace:)를 보냅니다.
  • /trace는 /verbose보다 범위가 좁습니다. Active Memory 디버그 요약 같은 Plugin 소유 추적/디버그 줄만 노출합니다.
  • 추적 줄은 /status에 표시되거나 일반 어시스턴트 응답 뒤의 후속 진단 메시지로 나타날 수 있습니다.

​
Reasoning 표시 여부(/reasoning)

  • 수준: on|off|stream.
  • 지시문만 포함된 메시지는 응답에 thinking 블록을 표시할지 여부를 전환합니다.
  • 활성화되면 reasoning은 Reasoning: 접두사가 붙은 별도 메시지로 전송됩니다.
  • stream(Telegram 전용): 응답이 생성되는 동안 reasoning을 Telegram 초안 말풍선으로 스트리밍한 다음, reasoning 없이 최종 답변을 전송합니다.
  • 별칭: /reason.
  • 현재 reasoning 수준을 보려면 인수 없이 /reasoning(또는 /reasoning:)을 보냅니다.
  • 해석 순서: 인라인 지시문, 세션 재정의, 에이전트별 기본값(agents.list[].reasoningDefault), 전역 기본값(agents.defaults.reasoningDefault), 대체값(off).
형식이 잘못된 로컬 모델 reasoning 태그는 보수적으로 처리됩니다. 닫힌 <think>...</think> 블록은 일반 응답에서 숨겨진 상태로 유지되고, 이미 보이는 텍스트 뒤의 닫히지 않은 reasoning도 숨겨집니다. 응답이 하나의 닫히지 않은 여는 태그로 완전히 감싸져 있어 그렇지 않으면 빈 텍스트로 전달될 경우, OpenClaw는 형식이 잘못된 여는 태그를 제거하고 남은 텍스트를 전달합니다.

​
관련 항목

​
Heartbeats

  • Heartbeat 프로브 본문은 구성된 Heartbeat 프롬프트입니다(기본값: Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.). Heartbeat 메시지의 인라인 지시문은 평소처럼 적용됩니다(단, Heartbeat에서 세션 기본값을 변경하는 것은 피하세요).
  • Heartbeat 전달은 기본적으로 최종 페이로드만 전송합니다. 별도의 Reasoning: 메시지도 전송하려면(사용 가능한 경우) agents.defaults.heartbeat.includeReasoning: true 또는 에이전트별 agents.list[].heartbeat.includeReasoning: true를 설정합니다.

​
웹 채팅 UI

  • 웹 채팅 추론 선택기는 페이지가 로드될 때 인바운드 세션 저장소/구성에서 세션에 저장된 수준을 반영합니다.
  • 다른 수준을 선택하면 sessions.patch를 통해 세션 오버라이드를 즉시 기록합니다. 다음 전송을 기다리지 않으며 일회성 thinkingOnce 오버라이드도 아닙니다.
  • 첫 번째 옵션은 항상 오버라이드 해제 선택지입니다. 세션이 꺼져 있지 않은 유효 기본값을 상속하는 경우 상속됨: <resolved level>로 표시되고, 상속된 추론이 비활성화된 경우 끔으로 표시됩니다.
  • 명시적 선택기 선택지는 오버라이드로 표시되며, 제공자 레이블이 있는 경우 이를 보존합니다(예: 제공자가 레이블을 지정한 max 옵션의 경우 오버라이드: 최대).
  • 선택기는 Gateway 세션 행/기본값에서 반환된 thinkingLevels를 사용하며, thinkingOptions는 레거시 레이블 목록으로 유지됩니다. 브라우저 UI는 자체 제공자 정규식 목록을 유지하지 않습니다. Plugin이 모델별 수준 집합을 소유합니다.
  • /think:<level>는 계속 작동하며 동일하게 저장된 세션 수준을 업데이트하므로, 채팅 지시문과 선택기가 동기화된 상태로 유지됩니다.

​
제공자 프로필

  • 제공자 Plugin은 모델의 지원 수준과 기본값을 정의하기 위해 resolveThinkingProfile(ctx)를 노출할 수 있습니다.
  • Claude 모델을 프록시하는 제공자 Plugin은 직접 Anthropic 카탈로그와 프록시 카탈로그가 정렬된 상태를 유지하도록 openclaw/plugin-sdk/provider-model-shared의 resolveClaudeThinkingProfile(modelId)를 재사용해야 합니다.
  • 각 프로필 수준에는 저장된 정식 id(off, minimal, low, medium, high, xhigh, adaptive 또는 max)가 있으며 표시용 label을 포함할 수 있습니다. 바이너리 제공자는 { id: "low", label: "on" }을 사용합니다.
  • 명시적 추론 오버라이드를 검증해야 하는 도구 Plugin은 api.runtime.agent.resolveThinkingPolicy({ provider, model })와 api.runtime.agent.normalizeThinkingLevel(...)를 사용해야 합니다. 자체 제공자/모델 수준 목록을 유지해서는 안 됩니다.
  • 구성된 사용자 지정 모델 메타데이터에 접근할 수 있는 도구 Plugin은 catalog를 resolveThinkingPolicy에 전달하여 compat.supportedReasoningEfforts 옵트인이 Plugin 측 검증에 반영되도록 할 수 있습니다.
  • 게시된 레거시 훅(supportsXHighThinking, isBinaryThinking, resolveDefaultThinkingLevel)은 호환성 어댑터로 남아 있지만, 새로운 사용자 지정 수준 집합은 resolveThinkingProfile을 사용해야 합니다.
  • Gateway 행/기본값은 thinkingLevels, thinkingOptions, thinkingDefault를 노출하여 ACP/채팅 클라이언트가 런타임 검증에서 사용하는 것과 동일한 프로필 ID와 레이블을 렌더링하도록 합니다.