메인 콘텐츠로 건너뛰기

​
디버깅

이 페이지는 스트리밍 출력에 대한 디버깅 도우미를 다루며, 특히 프로바이더가 일반 텍스트에 추론을 섞어 보내는 경우에 초점을 둡니다.

​
런타임 디버그 오버라이드

채팅에서 /debug 를 사용하여 런타임 전용 구성 오버라이드(디스크가 아닌 메모리)를 설정합니다. /debug 는 기본적으로 비활성화되어 있으며, commands.debug: true 로 활성화합니다. 이는 openclaw.json 를 편집하지 않고도 잘 사용되지 않는 설정을 전환해야 할 때 유용합니다. 예시: 
/debug show
/debug set messages.responsePrefix="[openclaw]"
/debug unset messages.responsePrefix
/debug reset
/debug reset 은 모든 오버라이드를 지우고 디스크상의 구성으로 되돌립니다.

​
Gateway 감시 모드

빠른 반복을 위해 파일 감시자 하에서 Gateway(게이트웨이)를 실행합니다: 
pnpm gateway:watch --force
이는 다음에 매핑됩니다: 
tsx watch src/entry.ts gateway --force
gateway:watch 뒤에 Gateway CLI 플래그를 추가하면, 각 재시작 시 해당 플래그들이 전달됩니다.

​
Dev 프로필 + dev Gateway (—dev)

dev 프로필을 사용하면 상태를 분리하고, 디버깅을 위한 안전하고 일회용인 설정을 빠르게 구성할 수 있습니다. 두 가지 --dev 플래그가 있습니다:
  • 전역 --dev (프로필): 상태를 ~/.openclaw-dev 아래로 분리하고, Gateway 포트를 기본적으로 19001 로 설정합니다(파생 포트들도 함께 이동).
  • gateway --dev: 누락된 경우 기본 구성 + 워크스페이스를 자동으로 생성하도록 Gateway(게이트웨이)에 지시합니다(BOOTSTRAP.md 건너뜀).
권장 흐름(dev 프로필 + dev 부트스트랩): 
pnpm gateway:dev
OPENCLAW_PROFILE=dev openclaw tui
아직 전역 설치가 없다면 pnpm openclaw ... 를 통해 CLI 를 실행하십시오. 이 작업이 수행하는 내용:
  1. 프로필 분리 (전역 --dev)
    • OPENCLAW_PROFILE=dev
    • OPENCLAW_STATE_DIR=~/.openclaw-dev
    • OPENCLAW_CONFIG_PATH=~/.openclaw-dev/openclaw.json
    • OPENCLAW_GATEWAY_PORT=19001 (브라우저/캔버스도 이에 맞게 이동)
  2. Dev 부트스트랩 (gateway --dev)
    • 누락 시 최소 구성 작성 (gateway.mode=local, local loopback 바인딩).
    • agent.workspace 을 dev 워크스페이스로 설정.
    • agent.skipBootstrap=true 설정(BOOTSTRAP.md 없음).
    • 누락 시 워크스페이스 파일 시드: AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md.
    • 기본 아이덴티티: C3‑PO (프로토콜 드로이드).
    • dev 모드에서 채널 프로바이더 건너뜀 (OPENCLAW_SKIP_CHANNELS=1).
리셋 흐름(완전 초기화): 
pnpm gateway:dev:reset
참고: --dev 는 전역 프로필 플래그이며 일부 러너에서 소모됩니다. 명시적으로 지정해야 한다면 환경 변수 형태를 사용하십시오: 
OPENCLAW_PROFILE=dev openclaw gateway --dev --reset
--reset 는 구성, 자격 증명, 세션, 그리고 dev 워크스페이스를 삭제한 뒤 (rm 가 아니라 trash 사용), 기본 dev 설정을 다시 생성합니다. 팁: dev 가 아닌 Gateway(게이트웨이)가 이미 실행 중이라면(launchd/systemd), 먼저 중지하십시오: 
openclaw gateway stop

​
원시 스트림 로깅(OpenClaw)

OpenClaw 는 필터링/포맷팅 이전의 원시 어시스턴트 스트림 을 기록할 수 있습니다. 이는 추론이 일반 텍스트 델타로 도착하는지, 아니면 별도의 thinking 블록으로 도착하는지를 확인하는 가장 좋은 방법입니다. CLI 로 활성화: 
pnpm gateway:watch --force --raw-stream
선택적 경로 오버라이드: 
pnpm gateway:watch --force --raw-stream --raw-stream-path ~/.openclaw/logs/raw-stream.jsonl
Equivalent env vars: 
OPENCLAW_RAW_STREAM=1
OPENCLAW_RAW_STREAM_PATH=~/.openclaw/logs/raw-stream.jsonl
기본 파일: ~/.openclaw/logs/raw-stream.jsonl

​
원시 청크 로깅(pi-mono)

블록으로 파싱되기 전의 원시 OpenAI 호환 청크 를 캡처하기 위해, pi-mono 는 별도의 로거를 제공합니다: 
PI_RAW_STREAM=1
선택적 경로: 
PI_RAW_STREAM_PATH=~/.pi-mono/logs/raw-openai-completions.jsonl
기본 파일: ~/.pi-mono/logs/raw-openai-completions.jsonl
참고: 이는 pi-mono 의 openai-completions 프로바이더를 사용하는 프로세스에서만 출력됩니다.

​
안전 참고 사항

  • 원시 스트림 로그에는 전체 프롬프트, 도구 출력, 사용자 데이터가 포함될 수 있습니다.
  • 로그는 로컬에 보관하고 디버깅 후 삭제하십시오.
  • 로그를 공유할 경우, 먼저 비밀 정보와 PII 를 제거하십시오.