온보딩 참조

이 문서는 openclaw onboard에 대한 전체 참조입니다. 상위 수준 개요는 온보딩(CLI)을 참조하세요.

# 흐름 세부 정보(로컬 모드)

# 비대화형 모드

온보딩을 자동화하거나 스크립트화하려면 --non-interactive를 사용하세요.

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback \
  --install-daemon \
  --daemon-runtime node \
  --skip-skills

머신이 읽을 수 있는 요약을 보려면 --json을 추가하세요.

비대화형 모드의 Gateway 토큰 SecretRef:

export OPENCLAW_GATEWAY_TOKEN="your-token"
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice skip \
  --gateway-auth token \
  --gateway-token-ref-env OPENCLAW_GATEWAY_TOKEN

--gateway-token과 --gateway-token-ref-env는 서로 배타적입니다.

제공자별 명령 예시는 CLI 자동화에 있습니다. 플래그 의미와 단계 순서는 이 참조 페이지를 사용하세요.

# 에이전트 추가(비대화형)

openclaw agents add work \
  --workspace ~/.openclaw/workspace-work \
  --model openai/gpt-5.5 \
  --bind whatsapp:biz \
  --non-interactive \
  --json

# Gateway 마법사 RPC

Gateway는 RPC(wizard.start, wizard.next, wizard.cancel, wizard.status)를 통해 온보딩 흐름을 노출합니다. 클라이언트(macOS 앱, Control UI)는 온보딩 로직을 다시 구현하지 않고 단계를 렌더링할 수 있습니다.

# Signal 설정(signal-cli)

온보딩은 GitHub 릴리스에서 signal-cli를 설치할 수 있습니다.

• 적절한 릴리스 자산을 다운로드합니다.
• ~/.openclaw/tools/signal-cli/<version>/ 아래에 저장합니다.
• 구성에 channels.signal.cliPath를 작성합니다.

참고:

• JVM 빌드는 Java 21이 필요합니다.
• 사용 가능한 경우 네이티브 빌드를 사용합니다.
• Windows는 WSL2를 사용합니다. signal-cli 설치는 WSL 내부의 Linux 흐름을 따릅니다.

# 마법사가 작성하는 내용

~/.openclaw/openclaw.json의 일반적인 필드:

• agents.defaults.workspace
• agents.defaults.model / models.providers(Minimax를 선택한 경우)
• tools.profile(설정되지 않은 경우 로컬 온보딩의 기본값은 "coding"입니다. 기존의 명시적 값은 보존됩니다)
• gateway.*(mode, bind, auth, tailscale)
• session.dmScope(동작 세부 정보: CLI 설정 참조)
• channels.telegram.botToken, channels.discord.token, channels.matrix.*, channels.signal.*, channels.imessage.*
• 프롬프트 중에 선택하는 경우 채널 허용 목록(Slack/Discord/Matrix/Microsoft Teams)(가능한 경우 이름이 ID로 확인됨).
• skills.install.nodeManager
  • setup --node-manager는 npm, pnpm 또는 bun을 허용합니다.
  • 수동 구성에서는 skills.install.nodeManager를 직접 설정하여 계속 yarn을 사용할 수 있습니다.
• wizard.lastRunAt
• wizard.lastRunVersion
• wizard.lastRunCommit
• wizard.lastRunCommand
• wizard.lastRunMode

openclaw agents add는 agents.list[]와 선택적 bindings를 기록합니다.

WhatsApp 자격 증명은 ~/.openclaw/credentials/whatsapp/<accountId>/ 아래에 저장됩니다. 세션은 ~/.openclaw/agents/<agentId>/sessions/ 아래에 저장됩니다.

일부 채널은 Plugin으로 제공됩니다. 설정 중 하나를 선택하면 구성하기 전에 온보딩에서 해당 Plugin을 설치하도록 안내합니다(npm 또는 로컬 경로).

# 관련 문서

• 온보딩 개요: 온보딩(CLI)
• macOS 앱 온보딩: 온보딩
• 구성 참조: Gateway 구성
• 제공자: WhatsApp, Telegram, Discord, Google Chat, Signal, BlueBubbles(iMessage), iMessage(레거시)
• Skills: Skills, Skills 구성