オンボーディングリファレンス

これは 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 releases から 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/ 配下に保存されます。

一部のチャンネルは plugins として提供されます。セットアップ中にいずれかを選択すると、設定できるようになる前に、オンボーディングでそのインストール (npm またはローカルパス) を求められます。

# 関連ドキュメント

• オンボーディング概要: オンボーディング (CLI)
• macOS アプリのオンボーディング: オンボーディング
• 設定リファレンス: Gateway 設定
• プロバイダー: WhatsApp、Telegram、Discord、Google Chat、Signal、BlueBubbles (iMessage)、iMessage (レガシー)
• Skills: Skills、Skills 設定