Docs map

기준일: 2026-07-26
공식 기준: Docs map

Docs map 문서는 OpenClaw 공식 문서(docs_map)를 한국어로 정리한 가이드입니다. Generated heading map for OpenClaw docs pages 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Generated heading map for OpenClaw docs pages

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

문서 구성

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

• agent-runtime-architecture.md
• announcements/bluebubbles-imessage.md
• auth-credential-semantics.md
• automation/auth-monitoring.md
• automation/clawflow.md
• automation/cron-jobs.md
• automation/cron-vs-heartbeat.md
• automation/gmail-pubsub.md
• automation/hooks.md
• automation/index.md
• automation/poll.md
• automation/standing-orders.md
• automation/taskflow.md
• automation/tasks.md
• automation/troubleshooting.md
• automation/webhook.md
• brave-search.md
• channels/access-groups.md
• channels/ambient-room-events.md
• channels/bot-loop-protection.md
• channels/broadcast-groups.md
• channels/channel-routing.md
• channels/clickclack.md
• channels/discord-activities.md
• channels/discord.md
• channels/feishu.md
• channels/googlechat.md
• channels/group-messages.md
• channels/groups.md
• channels/imessage-from-bluebubbles.md

상세 내용

OpenClaw docs map

This file is generated from docs/**/*.md and docs/**/*.mdx headings to help agents navigate the documentation tree. Do not edit it by hand; run pnpm docs:map:gen.

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

agent-runtime-architecture.md

주요 항목:

• Route: /agent-runtime-architecture
• Headings:
• H2: Runtime Layout
• H2: Boundaries
• H2: Manifests
• H2: Runtime Selection
• H2: Model Runtime Generations
• H2: Related

announcements/bluebubbles-imessage.md

주요 항목:

• Route: /announcements/bluebubbles-imessage
• Headings:
• H1: BlueBubbles removal and the imsg iMessage path
• H2: What changed
• H2: What to do
• H2: Migration notes
• H2: 함께 보기

auth-credential-semantics.md

주요 항목:

• Route: /auth-credential-semantics
• Headings:
• H2: Stable probe reason codes
• H2: Token credentials
• H3: Eligibility rules
• H3: Resolution rules
• H2: Agent copy portability
• H2: Config-only auth routes
• H2: Explicit auth order filtering
• H2: Probe target resolution
• H2: External CLI credential discovery
• H2: OAuth SecretRef Policy Guard
• H2: Legacy-Compatible Messaging
• H2: Related

automation/auth-monitoring.md

주요 항목:

• Route: /automation/auth-monitoring
• Headings:
• H2: Related

automation/clawflow.md

주요 항목:

• Route: /automation/clawflow
• Headings:
• H2: Related

automation/cron-jobs.md

주요 항목:

• Route: /automation/cron-jobs
• Headings:
• H2: Quick start
• H2: How cron works
• H2: Schedule types
• H3: Heartbeat task migration
• H3: Stream sources
• H3: Dynamic cadence (pacing)
• H3: Day-of-month and day-of-week use OR logic
• H2: Event triggers (condition watchers)
• H2: Payloads
• H3: Agent-turn options
• H3: Command payloads
• H3: Script payloads
• H2: Execution styles
• H2: Delivery and output
• H3: Failure notifications
• H3: Output language
• H2: CLI examples
• H2: Managing jobs
• H2: Webhooks
• H3: Authentication
• H2: Gmail PubSub integration
• H3: Wizard setup (recommended)
• H3: Gateway auto-start

automation/cron-vs-heartbeat.md

주요 항목:

• Route: /automation/cron-vs-heartbeat
• Headings:
• H2: Related

automation/gmail-pubsub.md

주요 항목:

• Route: /automation/gmail-pubsub
• Headings:
• H2: Related

automation/hooks.md

주요 항목:

• Route: /automation/hooks
• Headings:
• H2: Choose the right surface
• H2: Quick start
• H2: Event types
• H2: Writing hooks
• H3: Hook structure
• H3: HOOK.md format
• H3: Handler implementation
• H3: Event context highlights
• H2: Hook discovery
• H3: Hook packs
• H2: Bundled hooks
• H3: session-memory details
• H3: bootstrap-extra-files config
• H3: command-logger details
• H3: compaction-notifier details
• H3: boot-md details
• H2: Plugin hooks
• H2: Configuration
• H2: CLI reference
• H2: Best practices
• H2: Troubleshooting
• H3: Hook not discovered
• H3: Hook not eligible

automation/index.md

주요 항목:

• Route: /automation
• Headings:
• H2: Quick decision guide
• H3: Scheduled Tasks (Cron) vs Heartbeat
• H2: Core concepts
• H3: Scheduled tasks (cron)
• H3: Tasks
• H3: Task Flow
• H3: Standing orders
• H3: Hooks
• H3: Heartbeat
• H2: How they work together
• H2: Related

automation/poll.md

주요 항목:

• Route: /automation/poll
• Headings:
• H2: Related

automation/standing-orders.md

주요 항목:

• Route: /automation/standing-orders
• Headings:
• H2: Why standing orders
• H2: How they work
• H2: Anatomy of a standing order
• H2: Standing orders plus cron jobs
• H2: Examples
• H3: Example 1: content and social media (weekly cycle)
• H3: Example 2: finance operations (event-triggered)
• H3: Example 3: monitoring and alerts (continuous)
• H2: Execute-verify-report pattern
• H2: Multi-program architecture
• H2: Best practices
• H3: Do
• H3: Avoid
• H2: Related

automation/taskflow.md

주요 항목:

• Route: /automation/taskflow
• Headings:
• H2: When to use Task Flow
• H2: Sync modes
• H3: Managed mode
• H3: Mirrored mode
• H2: Flow statuses
• H2: Durable state and revision tracking
• H2: Cancel behavior
• H2: CLI commands
• H2: Reliable scheduled workflow pattern
• H2: How flows relate to tasks
• H2: Related

automation/tasks.md

주요 항목:

• Route: /automation/tasks
• Headings:
• H2: TL;DR
• H2: Quick start
• H2: What creates a task
• H2: Task lifecycle
• H2: Delivery and notifications
• H3: Notification policies
• H2: CLI reference
• H2: Chat task board (/tasks)
• H3: Control UI
• H2: Status integration (task pressure)
• H2: Storage and maintenance
• H3: Where tasks live
• H3: Automatic maintenance
• H2: How tasks relate to other systems
• H2: Related

automation/troubleshooting.md

주요 항목:

• Route: /automation/troubleshooting
• Headings:
• H2: Related

automation/webhook.md

주요 항목:

• Route: /automation/webhook
• Headings:
• H2: Related

brave-search.md

주요 항목:

• Route: /brave-search
• Headings:
• H2: Related

channels/access-groups.md

주요 항목:

• Route: /channels/access-groups
• Headings:
• H2: Static message sender groups
• H2: Reference groups from allowlists
• H2: Supported message-channel paths
• H2: Discord channel audiences
• H2: Plugin diagnostics
• H2: Security notes
• H2: Troubleshooting

channels/ambient-room-events.md

주요 항목:

• Route: /channels/ambient-room-events
• Headings:
• H2: Recommended setup
• H2: What changes
• H2: Discord example
• H2: Slack example
• H2: Telegram example
• H2: Agent specific policy
• H2: Visible reply modes
• H2: History
• H2: Troubleshooting
• H2: Related

channels/bot-loop-protection.md

주요 항목:

• Route: /channels/bot-loop-protection
• Headings:
• H2: Defaults
• H2: Configure shared defaults
• H2: Override per channel, account, or room
• H2: Channel support

channels/broadcast-groups.md

주요 항목:

• Route: /channels/broadcast-groups
• Headings:
• H2: Overview
• H2: Configuration
• H3: Basic setup
• H3: Processing strategy
• H3: Complete example
• H2: How it works
• H3: Message flow
• H3: Session isolation
• H3: Example: isolated sessions
• H2: Use cases
• H2: Best practices
• H2: Compatibility
• H3: Providers
• H3: Routing
• H2: Troubleshooting
• H2: Examples
• H2: API reference
• H3: Config schema
• H3: Fields
• H2: Limitations
• H2: Related

channels/channel-routing.md

주요 항목:

• Route: /channels/channel-routing
• Headings:
• H1: Channels & routing
• H2: Key terms
• H2: Outbound target prefixes
• H2: Session key shapes (examples)
• H2: Main DM route pinning
• H2: Guarded inbound recording
• H2: Routing rules (how an agent is chosen)
• H2: Broadcast groups (run multiple agents)
• H2: Config overview
• H2: Session storage
• H2: WebChat behavior
• H2: Reply context
• H2: Related

channels/clickclack.md

주요 항목:

• Route: /channels/clickclack
• Headings:
• H2: Quick setup
• H3: Alternative: manual token
• H3: Alternative: env-based token
• H3: JSON5 reference
• H3: Account config keys
• H3: Keep an auth-gated public hostname
• H2: Multiple bots
• H2: Session discussions
• H2: Reply modes
• H2: Command menu
• H2: Durable media delivery
• H2: Agent activity rows
• H2: Targets
• H2: Permissions
• H2: Troubleshooting

channels/discord-activities.md

주요 항목:

• Route: /channels/discord-activities
• Headings:
• H2: Prerequisites
• H2: Setup
• H2: Security model
• H2: Troubleshooting
• H3: The Activity says “Gateway offline”
• H3: Discord opens a blank page or reports blocked:csp
• H3: “Widget unavailable”
• H3: “You cannot launch Activities in this channel”

channels/discord.md

주요 항목:

• Route: /channels/discord
• Headings:
• H2: Quick setup
• H2: Recommended: Set up a guild workspace
• H2: Runtime model
• H2: Forum channels
• H2: Interactive components
• H2: Access control and routing
• H3: Role-based agent routing
• H2: Native commands and command auth
• H2: Feature details
• H2: Tools and action gates
• H2: Components v2 UI
• H2: Voice
• H3: Voice channels
• H3: Follow users in voice
• H3: Voice messages
• H2: Troubleshooting
• H2: Configuration reference
• H3: Discord Activities
• H2: Safety and operations
• H2: Related

channels/feishu.md

주요 항목:

• Route: /channels/feishu
• Headings:
• H2: Quick start
• H2: Inbound durability
• H2: Access control
• H3: Direct messages
• H3: Group chats
• H2: Group configuration examples
• H3: Allow all groups, no @mention required
• H3: Allow all groups, still require @mention
• H3: Allow specific groups only
• H3: Restrict senders within a group
• H3: Bot-authored messages
• H2: Get group/user IDs
• H3: Group IDs (chat_id, format: oc_xxx)
• H3: User IDs (open_id, format: ou_xxx)
• H2: Common commands
• H2: Troubleshooting
• H3: Bot does not respond in group chats
• H3: Bot does not receive messages
• H3: QR setup does not react in the Feishu mobile app
• H3: App Secret leaked
• H2: Advanced configuration
• H3: Multiple accounts
• H3: Message limits

channels/googlechat.md

주요 항목:

• Route: /channels/googlechat
• Headings:
• H2: Install
• H2: Quick setup (beginner)
• H2: Add to Google Chat
• H2: Public URL (Webhook-only)
• H3: Option A: Tailscale Funnel (Recommended)
• H3: Option B: Reverse Proxy (Caddy)
• H3: Option C: Cloudflare Tunnel
• H2: How it works
• H3: Inbound durability
• H2: Targets
• H2: Config highlights
• H2: Troubleshooting
• H3: 405 Method Not Allowed
• H3: Other issues
• H2: Related

channels/group-messages.md

주요 항목:

• Route: /channels/group-messages
• Headings:
• H2: Behavior
• H2: Config example (WhatsApp)
• H3: Activation command (owner-only)
• H2: How to use
• H2: Testing / verification
• H2: Known considerations
• H2: Related

channels/groups.md

주요 항목:

• Route: /channels/groups
• Headings:
• H2: Beginner intro (2 minutes)
• H2: Visible replies
• H2: Context visibility and allowlists
• H2: Session keys
• H2: Pattern: personal DMs + public groups (single agent)
• H2: Display labels
• H2: Group policy
• H2: Mention gating (default)
• H2: Scope configured mention patterns
• H2: Group/channel tool restrictions (optional)
• H2: Group allowlists
• H2: Activation (owner-only)
• H2: Context fields
• H2: iMessage specifics
• H2: WhatsApp system prompts
• H2: WhatsApp specifics
• H2: Related

channels/imessage-from-bluebubbles.md

주요 항목:

• Route: /channels/imessage-from-bluebubbles
• Headings:
• H2: Migration checklist
• H2: What imsg does
• H2: Before you start
• H2: Config translation
• H2: Group registry footgun
• H2: Step-by-step
• H2: Action parity at a glance
• H2: Pairing, sessions, and ACP bindings
• H2: No rollback channel
• H2: Related

channels/imessage.md

주요 항목:

• Route: /channels/imessage
• Headings:
• H2: Quick setup
• H2: Requirements and permissions (macOS)
• H2: Enabling the imsg private API
• H3: Setup
• H3: When SIP stays enabled
• H2: Access control and routing
• H2: ACP conversation bindings
• H2: Deployment patterns
• H2: Media, chunking, and delivery targets
• H2: Private API actions
• H2: Config writes
• H2: Coalescing split-send DMs (command + URL in one composition)
• H2: Inbound recovery after a bridge or gateway restart
• H3: Operator-visible signal
• H3: Migration
• H2: Troubleshooting
• H2: Configuration reference pointers
• H2: Related

channels/index.md

주요 항목:

• Route: /channels
• Headings:
• H2: Supported channels
• H2: Delivery notes
• H2: Notes

channels/irc.md

주요 항목:

• Route: /channels/irc
• Headings:
• H2: Quick start
• H2: Inbound durability
• H2: Connection settings
• H2: Security defaults
• H2: Access control
• H3: Common gotcha: allowFrom is for DMs, not channels
• H2: Reply triggering (mentions)
• H2: Security note (recommended for public channels)
• H3: Same tools for everyone in the channel
• H3: Different tools per sender (owner gets more power)
• H2: NickServ
• H2: Environment variables
• H2: Troubleshooting
• H2: Related

channels/line.md

주요 항목:

• Route: /channels/line
• Headings:
• H2: Install
• H2: Setup
• H2: Configure
• H2: Access control
• H2: Message behavior
• H2: Channel data (rich messages)
• H2: ACP support
• H2: Outbound media
• H2: Troubleshooting
• H2: Related

channels/location.md

주요 항목:

• Route: /channels/location
• Headings:
• H2: Text formatting
• H2: Context fields
• H2: Outbound payloads
• H2: Channel notes
• H2: Related

channels/matrix-migration.md

주요 항목:

• Route: /channels/matrix-migration
• Headings:
• H2: What the migration does automatically
• H2: Upgrading from OpenClaw releases older than 2026.4
• H2: Recommended upgrade flow
• H2: Common messages and what they mean
• H3: Manual recovery messages
• H2: If encrypted history still does not come back
• H2: If you want to start fresh for future messages
• H2: Related

channels/matrix-presentation.md

주요 항목:

• Route: /channels/matrix-presentation
• Headings:
• H2: Event content
• H2: Fallback behavior
• H2: Supported blocks
• H2: Interactions
• H2: Relationship to approval metadata
• H2: Media messages

channels/matrix-push-rules.md

주요 항목:

• Route: /channels/matrix-push-rules
• Headings:
• H2: Prerequisites
• H2: Steps
• H2: Multi-bot notes
• H2: Homeserver notes
• H2: Related

channels/matrix.md

주요 항목:

• Route: /channels/matrix
• Headings:
• H2: Install
• H2: Setup
• H3: Interactive setup
• H3: Minimal config
• H3: Auto-join
• H3: Allowlist target formats
• H3: Account ID normalization
• H3: Cached credentials
• H3: Environment variables
• H2: Configuration example
• H2: Streaming previews
• H2: Voice messages
• H2: Approval metadata
• H3: Self-hosted push rules for quiet finalized previews
• H2: Bot-to-bot rooms
• H2: Encryption and verification
• H3: Enable encryption
• H3: Status and trust signals
• H3: Verify this device with a recovery key
• H3: Bootstrap or repair cross-signing
• H3: Room-key backup
• H3: Listing, requesting, and responding to verifications
• H3: Multi-account notes

실습 체크리스트

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

관련 링크

• 공식 원문: docs_map
• OpenClaw 문서 홈

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