Audit records

기준일: 2026-07-26
공식 기준: Audit records

Audit records 문서는 OpenClaw 공식 문서(cli/audit)를 한국어로 정리한 가이드입니다. CLI reference for metadata-only run, tool, and message lifecycle audit records 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

CLI reference for metadata-only run, tool, and message lifecycle audit records

한국어 가이드 범위: cli/audit 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• Filters
• Recorded events
• Gateway RPC
• 관련 문서

상세 내용

openclaw audit

Query the Gateway's metadata-only audit ledger for agent runs, tool actions, and opt-in message lifecycle records.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

openclaw audit
openclaw audit --agent main --status failed
openclaw audit --session "agent:main:main" --after 2026-07-01T00:00:00Z
openclaw audit --run 8c69f72e-8b11-4c54-98d5-1a3dd67450c3
openclaw audit --kind tool_action --limit 50 --json
openclaw audit --kind message --direction outbound --channel telegram --json

Filters

The CLI queries the versioned activity RPC so one command shows the complete configured ledger. Text output shows time, kind, direction, channel, status, agent, run, and action. Missing message provenance renders as -; OpenClaw does not invent agent or run ids. Tool actions also show the tool name. JSON output includes nextCursor when another page exists. Pass that value to --cursor to continue without reordering records that arrive during paging.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• --agent <id>: exact agent id
• --session <key>: exact session key
• --run <id>: exact run id
• --kind <kind>: agent_run, tool_action, or message
• --status <status>: started, succeeded, failed, cancelled,
• --direction <direction>: message direction, inbound or outbound
• --channel <channel>: exact message channel
• --after <timestamp> / --before <timestamp>: inclusive ISO timestamp or
• --limit <count>: page size from 1 to 500; default 100
• --cursor <sequence>: continue a previous newest-first query
• --json: print the bounded page as JSON

Recorded events

The Gateway projects trusted lifecycle streams into six actions:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• agent.run.started
• agent.run.finished
• tool.action.started
• tool.action.finished
• message.inbound.processed
• message.outbound.finished

Gateway RPC

audit.activity.list requires operator.read and accepts the same filters. It returns the named V1 activity event union, including run, tool, inbound-message, and outbound-message records.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

openclaw gateway call audit.activity.list --params '{"channel":"telegram","limit":50}'

관련 문서

주요 항목:

• Audit history
• Gateway protocol
• Sessions
• Tasks
• Cron jobs

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/cli/audit
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

openclaw audit
openclaw audit --agent main --status failed
openclaw audit --session "agent:main:main" --after 2026-07-01T00:00:00Z
openclaw audit --run 8c69f72e-8b11-4c54-98d5-1a3dd67450c3
openclaw audit --kind tool_action --limit 50 --json
openclaw audit --kind message --direction outbound --channel telegram --json

openclaw gateway call audit.activity.list --params '{"channel":"telegram","limit":50}'

관련 링크

• 공식 원문: cli/audit
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.