OpenClaw 생각 수준 설정 가이드: 추론 성능 최적화하기

AI 모델을 사용하다 보면 가끔은 모델이 더 깊게 고민해주길 원할 때가 있고, 또 어떤 때는 복잡한 생각 없이 바로 결과만 내놓길 원할 때가 있죠. 하지만 매번 프롬프트에 “깊게 생각해줘”라고 적는 건 꽤 번거로운 일이에요.

이제 디렉티브를 사용해서 AI의 사고 수준을 직접 제어해 보세요. 간단한 명령어로 AI가 얼마나 많은 리소스를 투입할지 결정할 수 있습니다.

기능 소개

• 모든 인바운드 바디에 인라인 디렉티브를 사용할 수 있어요: /t <level>, /think:<level>, 또는 /thinking <level>.
• Levels (별칭): off | minimal | low | medium | high | xhigh | adaptive
  • minimal → “think”
  • low → “think hard”
  • medium → “think harder”
  • high → “ultrathink” (최대 예산)
  • xhigh → “ultrathink+” (GPT-5.2 + Codex 모델 전용)
  • adaptive → 프로바이더가 관리하는 적응형 추론 예산 (Anthropic Claude 4.6 모델 제품군에서 지원)
  • x-high, x_high, extra-high, extra high, 그리고 extra_high는 xhigh로 매핑돼요.
  • highest, max는 high로 매핑돼요.
• 프로바이더 참고 사항:
  • Anthropic Claude 4.6 모델은 명시적인 thinking level이 설정되지 않은 경우 기본적으로 adaptive로 설정돼요.
  • 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. Fallback: Anthropic Claude 4.6 모델은 adaptive, 다른 추론 가능 모델은 low, 그 외에는 off.

세션 기본값 설정

• 디렉티브만 포함된 메시지를 보내세요 (공백 허용). 예: /think:medium 또는 /t high.
• 이 설정은 현재 세션 동안 유지되며(기본적으로 발신자별로 적용), /think:off를 보내거나 세션 유휴 상태로 리셋될 때까지 지속돼요.
• 설정이 완료되면 확인 답장이 전송됩니다 (Thinking level set to high. / Thinking disabled.). 레벨이 유효하지 않은 경우(예: /thinking big) 힌트와 함께 명령이 거부되며 세션 상태는 변경되지 않은 채로 유지돼요.
• 현재 thinking level을 확인하려면 인자 없이 /think (또는 /think:)를 보내세요.

에이전트별 적용

• Embedded Pi: 결정된 레벨이 프로세스 내 Pi 에이전트 런타임으로 전달돼요.

패스트 모드 (/fast)

• Levels: on|off.
• 디렉티브 전용 메시지는 세션 패스트 모드 오버라이드를 토글하고 Fast mode enabled. / Fast mode disabled.라고 답장해요.
• 현재 적용 중인 패스트 모드 상태를 보려면 모드 지정 없이 /fast (또는 /fast status)를 보내세요.
• OpenClaw는 다음 순서로 패스트 모드를 결정해요:
  1. 인라인/디렉티브 전용 /fast on|off
  2. 세션 오버라이드
  3. 에이전트별 기본값 (agents.list[].fastModeDefault)
  4. 모델별 설정: agents.defaults.models["<provider>/<model>"].params.fastMode
  5. Fallback: off
• openai/*의 경우, 패스트 모드는 지원되는 Responses 요청에 service_tier=priority를 전송하여 OpenAI 우선 처리(priority processing)로 매핑돼요.
• openai-codex/*의 경우, 패스트 모드는 Codex Responses에 동일한 service_tier=priority 플래그를 전송해요. OpenClaw는 두 인증 경로 모두에서 하나의 공유된 /fast 토글을 유지합니다.
• api.anthropic.com으로 전송되는 OAuth 인증 트래픽을 포함한 직접적인 퍼블릭 anthropic/* 요청의 경우, 패스트 모드는 Anthropic 서비스 티어로 매핑돼요: /fast on은 service_tier=auto로 설정하고, /fast off는 service_tier=standard_only로 설정합니다.
• 명시적인 Anthropic serviceTier / service_tier 모델 파라미터가 설정되어 있다면 패스트 모드 기본값보다 우선해요. OpenClaw는 Anthropic 프록시 베이스 URL이 아닌 경우에는 Anthropic 서비스 티어 주입을 건너뜁니다.

상세 로그 디렉티브 (/verbose 또는 /v)

• Levels: on (minimal) | full | off (기본값).
• 디렉티브 전용 메시지는 세션 verbose를 토글하고 Verbose logging enabled. / Verbose logging disabled.라고 답장해요. 유효하지 않은 레벨은 상태 변경 없이 힌트를 반환합니다.
• /verbose off는 명시적인 세션 오버라이드를 저장해요. Sessions UI에서 inherit을 선택하여 이를 해제할 수 있습니다.
• 인라인 디렉티브는 해당 메시지에만 영향을 주며, 그 외에는 세션/글로벌 기본값이 적용돼요.
• 현재 verbose 레벨을 확인하려면 인자 없이 /verbose (또는 /verbose:)를 보내세요.
• verbose가 켜져 있으면 구조화된 도구 결과(Pi, 기타 JSON 에이전트)를 내보내는 에이전트가 각 도구 호출을 별도의 메타데이터 전용 메시지로 다시 보냅니다. 이때 가능한 경우 <emoji> <tool-name>: <arg> (경로/명령어)가 접두사로 붙어요. 이러한 도구 요약은 각 도구가 시작되는 즉시(별도의 말풍선으로) 전송되며, 스트리밍 델타 방식이 아닙니다.
• 도구 실패 요약은 일반 모드에서도 계속 보이지만, verbose가 on 또는 full이 아니면 원시 에러 상세 접미사는 숨겨져요.
• verbose가 full인 경우, 도구 출력이 완료된 후에도 전달됩니다(별도의 말풍선, 안전한 길이로 잘림). 실행 중에 /verbose on|full|off를 토글하면 이후의 도구 말풍선에 새로운 설정이 반영돼요.

추론 가시성 (/reasoning)

• Levels: on|off|stream.
• 디렉티브 전용 메시지는 답장에 thinking 블록을 표시할지 여부를 토글해요.
• 활성화되면 추론 내용은 Reasoning:이라는 접두사가 붙은 별도의 메시지로 전송돼요.
• stream (Telegram 전용): 답장이 생성되는 동안 Telegram 드래프트 말풍선에 추론 내용을 스트리밍하고, 최종 답변은 추론 없이 전송합니다.
• 별칭: /reason.
• 현재 reasoning 레벨을 확인하려면 인자 없이 /reasoning (또는 /reasoning:)을 보내세요.
• 적용 순서: 인라인 디렉티브, 세션 오버라이드, 에이전트별 기본값 (agents.list[].reasoningDefault), 그리고 fallback (off).

관련 문서

• Elevated mode 문서는 Elevated mode에서 확인할 수 있어요.

하트비트 (Heartbeats)

• 하트비트 프로브 바디는 설정된 하트비트 프롬프트입니다 (기본값: 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.). 하트비트 메시지의 인라인 디렉티브는 평소와 같이 적용되지만, 하트비트에서 세션 기본값을 변경하는 것은 피하는 것이 좋습니다.
• 하트비트 전달은 기본적으로 최종 페이로드만 전송돼요. 별도의 Reasoning: 메시지도 함께 보내려면(사용 가능한 경우), agents.defaults.heartbeat.includeReasoning: true 또는 에이전트별로 agents.list[].heartbeat.includeReasoning: true를 설정하세요.

웹 채팅 UI

• 웹 채팅의 thinking 셀렉터는 페이지가 로드될 때 인바운드 세션 저장소/설정에 저장된 세션 레벨을 반영해요.
• 다른 레벨을 선택하면 다음 메시지에만 적용되며(thinkingOnce), 메시지를 보낸 후 셀렉터는 다시 저장된 세션 레벨로 돌아갑니다.
• 세션 기본값을 변경하려면 이전처럼 /think:<level> 디렉티브를 보내세요. 다음 로드 후에 셀렉터에 반영될 거예요.

---

다음 단계

• Elevated mode에 대해 더 알아보기

도움이 필요하신가요? AI Setup Assistant에게 물어보세요!