사고 수준

수행하는 작업

• 모든 수신 본문 안의 인라인 지시어: /t <level>, /think:<level> 또는 /thinking <level>.
• 수준(별칭): off | minimal | low | medium | high | xhigh | adaptive | max
  • minimal → "생각"
  • low → "깊게 생각"
  • medium → "더 깊게 생각"
  • high → "초고강도 사고" (최대 예산)
  • xhigh → "초고강도 사고+" (GPT-5.2+ 및 Codex 모델, Anthropic Claude Opus 4.7+ effort 포함)
  • adaptive → 공급자 관리형 적응형 사고(Anthropic/Bedrock의 Claude 4.6, Anthropic Claude Opus 4.7+, Google Gemini 동적 사고에서 지원)
  • max → 공급자 최대 추론(Anthropic Claude Opus 4.7+; Ollama는 이를 자체 최고 think effort에 매핑)
  • x-high, x_high, extra-high, extra high, extra_high는 xhigh에 매핑됩니다.
  • highest는 high에 매핑됩니다.
• 공급자 참고 사항:
  • 사고 메뉴와 선택기는 공급자 프로필에 의해 구동됩니다. 공급자 Plugin은 바이너리 on 같은 레이블을 포함해 선택된 모델의 정확한 수준 집합을 선언합니다.
  • adaptive, xhigh, max는 이를 지원하는 공급자/모델 프로필에만 표시됩니다. 지원되지 않는 수준을 입력한 지시어는 해당 모델의 유효한 옵션과 함께 거부됩니다.
  • 기존에 저장된 지원되지 않는 수준은 공급자 프로필 순위에 따라 다시 매핑됩니다. 비적응형 모델에서 adaptive는 medium으로 폴백하고, xhigh와 max는 선택한 모델이 지원하는 off가 아닌 가장 큰 수준으로 폴백합니다.
  • Anthropic Claude 4.6 모델은 명시적인 사고 수준이 설정되지 않으면 기본값이 adaptive입니다.
  • Anthropic Claude Opus 4.8 및 Opus 4.7은 사고 수준을 명시적으로 설정하지 않는 한 사고를 꺼 둡니다. Opus 4.8의 공급자 소유 effort 기본값은 적응형 사고가 활성화된 뒤 high입니다.
  • Anthropic Claude Opus 4.7+는 /think xhigh를 적응형 사고와 output_config.effort: "xhigh"에 매핑합니다. /think는 사고 지시어이고 xhigh는 Opus 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를 노출하며 DeepSeek 네이티브 최상위 reasoning_effort 대신 OpenRouter가 지원하는 reasoning.effort 값을 보냅니다. 더 낮은 비-off 수준은 high에 매핑되고, 저장된 max 오버라이드는 xhigh로 폴백합니다.
  • 사고 가능 Ollama 모델은 /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는 지원되지 않는 값을 보내는 대신 비활성화된 추론 페이로드를 생략합니다.
  • 사용자 지정 OpenAI 호환 카탈로그 항목은 models.providers.<provider>.models[].compat.supportedReasoningEfforts에 "xhigh"를 포함하도록 설정해 /think xhigh를 사용할 수 있습니다. 이는 아웃바운드 OpenAI 추론 effort 페이로드를 매핑하는 것과 동일한 호환성 메타데이터를 사용하므로 메뉴, 세션 검증, 에이전트 CLI, llm-task가 전송 동작과 일치합니다.
  • 오래된 구성의 OpenRouter Hunter Alpha 참조는 해당 폐기된 경로가 reasoning 필드를 통해 최종 답변 텍스트를 반환할 수 있었기 때문에 프록시 추론 주입을 건너뜁니다.
  • Google Gemini는 /think adaptive를 Gemini의 공급자 소유 동적 사고에 매핑합니다. Gemini 3 요청은 고정 thinkingLevel을 생략하고, Gemini 2.5 요청은 thinkingBudget: -1을 보냅니다. 고정 수준은 여전히 해당 모델 제품군에 가장 가까운 Gemini thinkingLevel 또는 예산에 매핑됩니다.
  • Anthropic 호환 스트리밍 경로의 MiniMax M2.x(minimax/MiniMax-M2*)는 모델 매개변수 또는 요청 매개변수에서 사고를 명시적으로 설정하지 않는 한 기본값이 thinking: { type: "disabled" }입니다. 이는 M2.x의 비네이티브 Anthropic 스트림 형식에서 reasoning_content 델타가 유출되는 것을 방지합니다. MiniMax-M3(및 M3.x)는 예외입니다. M3는 올바른 Anthropic thinking 블록을 내보내고 사고가 비활성화되면 빈 콘텐츠를 반환하므로 OpenClaw는 M3를 공급자의 생략/적응형 사고 경로에 둡니다.
  • Z.AI(zai/*)는 대부분의 GLM 모델에서 바이너리(on/off)입니다. GLM-5.2는 예외입니다. /think off|low|high|max를 노출하고, low와 high를 Z.AI reasoning_effort: "high"에 매핑하며, max를 reasoning_effort: "max"에 매핑합니다.
  • Moonshot Kimi K2.7 Code(moonshot/kimi-k2.7-code)는 항상 사고합니다. 해당 프로필은 on만 노출하며, OpenClaw는 Moonshot이 요구하는 대로 아웃바운드 thinking 필드를 생략합니다. 다른 moonshot/* 모델은 /think off를 thinking: { type: "disabled" }에, 비-off 수준을 thinking: { type: "enabled" }에 매핑합니다. 사고가 활성화되면 Moonshot은 tool_choice auto|none만 허용합니다. OpenClaw는 호환되지 않는 값을 auto로 정규화합니다.

해결 순서

1. 메시지의 인라인 지시어(해당 메시지에만 적용).
2. 세션 오버라이드(지시어만 포함한 메시지를 보내 설정).
3. 에이전트별 기본값(구성의 agents.list[].thinkingDefault).
4. 전역 기본값(구성의 agents.defaults.thinkingDefault).
5. 폴백: 사용 가능한 경우 공급자가 선언한 기본값. 그렇지 않으면 추론 가능 모델은 medium 또는 해당 모델에서 지원되는 가장 가까운 비-off 수준으로 해결되고, 추론 불가능 모델은 off로 유지됩니다.

세션 기본값 설정

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

에이전트별 적용

• 임베디드 OpenClaw: 해결된 수준이 프로세스 내 OpenClaw 에이전트 런타임에 전달됩니다.
• Claude CLI 백엔드: claude-cli를 사용할 때 비-끄기 수준은 Claude Code에 --effort로 전달됩니다. CLI 백엔드를 참조하세요.

빠른 모드(/fast)

• 수준: auto|on|off|default.
• 지시어만 포함한 메시지는 세션 빠른 모드 오버라이드를 전환하고 Fast mode set to auto., Fast mode enabled., 또는 Fast mode disabled.로 응답합니다. /fast default를 사용해 세션 오버라이드를 지우고 구성된 기본값을 상속하세요. 별칭에는 inherit, clear, reset, unpin이 포함됩니다.
• 현재 유효한 빠른 모드 상태를 보려면 모드 없이 /fast(또는 /fast status)를 보내세요.
• OpenClaw는 다음 순서로 빠른 모드를 해결합니다.
  1. 인라인/지시어 전용 /fast auto|on|off 오버라이드(/fast default는 이 계층을 지움)
  2. 세션 오버라이드
  3. 에이전트별 기본값(agents.list[].fastModeDefault)
  4. 모델별 구성: agents.defaults.models["<provider>/<model>"].params.fastMode
  5. 폴백: off
• auto는 세션/구성 모드를 auto로 유지하지만 각 새 모델 호출을 독립적으로 해결합니다. 자동 컷오프 전에 시작한 호출은 빠른 모드가 활성화되고, 이후 재시도, 폴백, 도구 결과 또는 이어가기 호출은 빠른 모드가 비활성화된 상태로 시작합니다. 컷오프 기본값은 60초입니다. 변경하려면 활성 모델에 agents.defaults.models["<provider>/<model>"].params.fastAutoOnSeconds를 설정하세요.
• openai/*의 경우 빠른 모드는 지원되는 Responses 요청에서 service_tier=priority를 보내 OpenAI 우선 처리에 매핑됩니다.
• Codex 기반 openai/* / openai-codex/* 모델의 경우 빠른 모드는 Codex Responses에 동일한 service_tier=priority 플래그를 보냅니다. 네이티브 Codex 앱 서버 턴은 turn/start 또는 스레드 시작/재개에서만 tier를 받으므로, auto는 이미 실행 중인 앱 서버 턴의 tier를 다시 지정할 수 없습니다. OpenClaw가 시작하는 다음 모델 턴에 적용됩니다.
• OAuth 인증 트래픽이 api.anthropic.com으로 전송되는 경우를 포함해 직접 공개 anthropic/* 요청의 경우 빠른 모드는 Anthropic 서비스 tier에 매핑됩니다. /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 서비스 tier 주입을 건너뜁니다.
• /status는 빠른 모드가 활성화되면 Fast를 표시하고, 구성된 모드가 auto이면 Fast:auto를 표시합니다.

자세한 지시어(/verbose 또는 /v)

• 수준: on(최소) | full | off(기본값).
• 지시어만 포함한 메시지는 세션 자세한 로깅을 전환하고 Verbose logging enabled. / Verbose logging disabled.로 응답합니다. 유효하지 않은 수준은 상태를 변경하지 않고 힌트를 반환합니다.
• /verbose off는 명시적인 세션 오버라이드를 저장합니다. Sessions UI에서 inherit을 선택해 지우세요.
• 권한이 있는 외부 채널 발신자는 세션 자세한 로깅 오버라이드를 유지할 수 있습니다. 내부 Gateway/웹챗 클라이언트는 이를 유지하려면 operator.admin이 필요합니다.
• 인라인 지시어는 해당 메시지에만 영향을 줍니다. 그렇지 않으면 세션/전역 기본값이 적용됩니다.
• 현재 자세한 수준을 보려면 인수 없이 /verbose(또는 /verbose:)를 보내세요.
• 자세한 로깅이 켜져 있으면 구조화된 도구 결과를 내보내는 에이전트는 사용 가능한 경우 <emoji> <tool-name>: <arg> 접두사가 붙은 각 도구 호출을 자체 메타데이터 전용 메시지로 다시 보냅니다. 이러한 도구 요약은 각 도구가 시작되는 즉시(별도 말풍선) 전송되며, 스트리밍 델타로 전송되지 않습니다.
• 도구 실패 요약은 일반 모드에서도 계속 표시되지만, 원시 오류 세부 정보 접미사는 자세한 수준이 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)

• 수준: on|off|stream.
• 지시어만 포함한 메시지는 thinking 블록을 응답에 표시할지 전환합니다.
• 활성화되면 추론은 Thinking 접두사가 붙은 별도 메시지로 전송됩니다.
• stream: 활성 채널이 추론 미리보기를 지원할 때 응답 생성 중 추론을 스트리밍한 다음, 추론 없이 최종 답변을 보냅니다.
• 별칭: /reason.
• 현재 추론 수준을 보려면 인수 없이 /reasoning(또는 /reasoning:)을 보내세요.
• 해결 순서: 인라인 지시어, 세션 오버라이드, 에이전트별 기본값(agents.list[].reasoningDefault), 전역 기본값(agents.defaults.reasoningDefault), 폴백(off).

잘못된 로컬 모델 추론 태그는 보수적으로 처리됩니다. 닫힌 <think>...</think> 블록은 일반 응답에서 숨겨진 상태로 유지되며, 이미 보이는 텍스트 뒤에 닫히지 않은 추론도 숨겨집니다. 응답이 닫히지 않은 단일 여는 태그로 완전히 감싸져 있고 그렇지 않으면 빈 텍스트로 전달될 경우, 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 전달은 기본적으로 최종 페이로드만 사용합니다. 별도의 Thinking 메시지도 전송하려면(사용 가능한 경우) agents.defaults.heartbeat.includeReasoning: true 또는 에이전트별 agents.list[].heartbeat.includeReasoning: true를 설정합니다.

웹 채팅 UI

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

제공자 프로필

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