openclaw logs

RPC를 통해 Gateway 파일 로그의 끝부분을 실시간으로 출력합니다. 원격 모드에서도 작동합니다.

옵션

• --limit <n>: 반환할 최대 로그 줄 수(기본값 200)
• --max-bytes <n>: 로그 파일에서 읽을 최대 바이트 수(기본값 250000)
• --follow: 로그 스트림을 계속 추적
• --interval <ms>: 추적 중 폴링 간격(기본값 1000)
• --json: 줄 단위 JSON 이벤트 출력
• --plain: 스타일 서식 없는 일반 텍스트 출력
• --no-color: ANSI 색상 비활성화
• --local-time: 타임스탬프를 로컬 시간대로 표시(기본값)
• --utc: 타임스탬프를 UTC로 표시

공통 Gateway RPC 옵션

• --url <url>: Gateway WebSocket URL
• --token <token>: Gateway 토큰
• --timeout <ms>: 제한 시간(밀리초, 기본값 30000)
• --expect-final: Gateway 호출이 에이전트 기반인 경우 최종 응답을 기다림

--url을 전달하면 자동 적용되는 구성 자격 증명을 건너뜁니다. 대상 Gateway에 인증이 필요한 경우 --token을 명시적으로 포함하세요.

예시

openclaw logsopenclaw logs --followopenclaw logs --follow --interval 2000openclaw logs --limit 500 --max-bytes 500000openclaw logs --jsonopenclaw logs --plainopenclaw logs --no-coloropenclaw logs --utcopenclaw logs --follow --local-timeopenclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

폴백 및 복구 동작

• 암시적 local loopback Gateway가 페어링을 요청하거나, 연결 중 종료되거나, logs.tail이 응답하기 전에 시간 초과되면 openclaw logs는 구성된 Gateway 파일 로그로 자동 폴백합니다. 명시적인 --url 대상에는 이 폴백을 사용하지 않습니다.
• 암시적 로컬 Gateway RPC 실패 후 --follow는 구성된 해당 파일로 폴백하지 않습니다. 함께 남아 있는 오래된 파일이 실시간 로그 추적 결과를 오도할 수 있기 때문입니다. Linux에서는 가능한 경우 대신 PID를 기준으로 활성 사용자 systemd Gateway 저널을 사용하고 선택한 소스를 출력합니다. 그렇지 않으면 실시간 Gateway에 계속 재연결을 시도합니다.
• --follow 실행 중 일시적인 연결 끊김(WebSocket 종료, 시간 초과, 연결 단절)이 발생하면 지수 백오프로 자동 재연결합니다. 최대 8회 재시도하며 시도 간격은 최대 30초입니다. 재시도할 때마다 stderr에 경고를 출력하며, 폴링이 성공하면 [logs] gateway reconnected 알림을 한 번 출력합니다. --json 모드에서는 둘 다 stderr에 {"type":"notice"} 레코드로 출력됩니다. 복구할 수 없는 오류(인증 실패, 잘못된 구성)는 여전히 즉시 종료됩니다.
• --follow --json 모드에서는 로그 소스 전환이 {"type":"meta"} 레코드로 출력됩니다. sourceKind별로 커서를 추적하세요. 스트림은 Gateway 파일 출력(sourceKind: "file")에서 로컬 저널 폴백(sourceKind: "journal", localFallback: true, service.pid/service.unit 포함)으로 전환되었다가 복구 후 다시 Gateway 파일 출력으로 돌아갈 수 있습니다. 전체 세션에서 단일 소스나 커서가 안정적으로 유지된다고 가정하지 말고, 복구 과정에서 Gateway 파일 커서를 다시 재생하여 줄이 겹치는 경우도 허용하세요.

관련 문서

• 로깅 개요
• Gateway CLI
• CLI 참조
• Gateway 로깅