CLIでOpenClawのセットアップを自動化する方法

新しいツールを導入する際、毎回手動で設定を入力するのは面倒ですよね。特に、複数の環境で同じセットアップを繰り返したり、スクリプトに組み込んで自動化したい場合、対話型のプロンプトは作業の妨げになります。

OpenClawでは、CLIフラグを活用することで、これらの手順をすべて自動化できます。定型的な作業をスキップして、すぐに開発に取り掛かりましょう。

必要なもの

セットアップを始める前に、以下の準備ができているか確認してください。

• openclaw CLI がインストールされていること
• 使用するプロバイダーの API キー（Anthropic, Gemini など）
• Node.js 環境（daemon を使用する場合）
• 設定を保存するためのワークスペース用ディレクトリ

クイックスタート

5分以内に自動セットアップを完了させるための最小ルートです。--non-interactive フラグを使用するのが最も効率的な方法です。

基本的な非対話モードの例

以下のコマンドを実行すると、Anthropic を使用したローカルモードのセットアップが自動で進行します。

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 を追加してください。

プロバイダー別の実行例

利用する API プロバイダーに合わせて、適切なフラグを選択してください。

Gemini の例

    openclaw onboard --non-interactive \
      --mode local \
      --auth-choice gemini-api-key \
      --gemini-api-key "$GEMINI_API_KEY" \
      --gateway-port 18789 \
      --gateway-bind loopback

Z.AI の例

    openclaw onboard --non-interactive \
      --mode local \
      --auth-choice zai-api-key \
      --zai-api-key "$ZAI_API_KEY" \
      --gateway-port 18789 \
      --gateway-bind loopback

Vercel AI Gateway の例

    openclaw onboard --non-interactive \
      --mode local \
      --auth-choice ai-gateway-api-key \
      --ai-gateway-api-key "$AI_GATEWAY_API_KEY" \
      --gateway-port 18789 \
      --gateway-bind loopback

Cloudflare AI Gateway の例

    openclaw onboard --non-interactive \
      --mode local \
      --auth-choice cloudflare-ai-gateway-api-key \
      --cloudflare-ai-gateway-account-id "your-account-id" \
      --cloudflare-ai-gateway-gateway-id "your-gateway-id" \
      --cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY" \
      --gateway-port 18789 \
      --gateway-bind loopback

Moonshot の例

    openclaw onboard --non-interactive \
      --mode local \
      --auth-choice moonshot-api-key \
      --moonshot-api-key "$MOONSHOT_API_KEY" \
      --gateway-port 18789 \
      --gateway-bind loopback

Synthetic の例

    openclaw onboard --non-interactive \
      --mode local \
      --auth-choice synthetic-api-key \
      --synthetic-api-key "$SYNTHETIC_API_KEY" \
      --gateway-port 18789 \
      --gateway-bind loopback

OpenCode Zen の例

    openclaw onboard --non-interactive \
      --mode local \
      --auth-choice opencode-zen \
      --opencode-zen-api-key "$OPENCODE_API_KEY" \
      --gateway-port 18789 \
      --gateway-bind loopback

エージェントの追加

既存の環境に別のエージェントを追加したい場合は、openclaw agents add <name> を使用します。これにより、独自のワークスペース、セッション、認証プロファイルを持つ独立したエージェントを作成できます。

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

このコマンドで設定される項目は以下の通りです：

• agents.list[].name
• agents.list[].workspace
• agents.list[].agentDir

注意点:

• デフォルトのワークスペースは ~/.openclaw/workspace-<agentId> に作成されます。
• インバウンドメッセージをルーティングするには bindings を追加してください。

トラブルシューティング

--json フラグを指定しても対話モードが終了しない

--json フラグは出力を JSON 形式にするためのものであり、非対話モードを強制するものではありません。スクリプトで利用する場合は、必ず --non-interactive と --workspace を併用してください。

结尾

セットアップに関する詳細な質問や不明点がある場合は、AI Setup Assistant を活用してください。

次のステップ

• Onboarding Wizard (CLI)
• CLI Onboarding Reference
• openclaw onboard Command Reference