最初のステップ

オンボーディングウィザード (CLI)

オンボーディングウィザードは、macOS、Linux、または Windows (WSL2経由; 強く推奨) で OpenClaw をセットアップする 推奨 方法です。ローカルゲートウェイまたはリモートゲートウェイ接続に加え、チャネル、スキル、ワークスペースのデフォルトを一つのガイド付きフローで構成します。

openclaw onboard

ℹ️ 最速の初回チャット: コントロール UI を開きます (チャネル設定は不要)。openclaw dashboard を実行し、ブラウザでチャットします。ドキュメント: ダッシュボード。

後で再構成するには:

openclaw configure
openclaw agents add <name>

ℹ️ --json は非対話モードを意味しません。スクリプトの場合は、--non-interactive を使用してください。

💡 オンボーディングウィザードには、ウェブ検索プロバイダー (Perplexity, Brave, Gemini, Grok, または Kimi) を選択し、APIキーを貼り付けてエージェントが web_search を使用できるようにするステップが含まれています。これは後から openclaw configure --section web で構成することもできます。ドキュメント: ウェブツール。

QuickStart と Advanced

ウィザードは QuickStart (デフォルト) と Advanced (完全制御) から始まります。

  • ローカルゲートウェイ (ループバック)
  • ワークスペースのデフォルト (または既存のワークスペース)
  • ゲートウェイポート 18789
  • ゲートウェイ認証 トークン (ループバック上でも自動生成)
  • 新しいローカルセットアップのツールポリシーデフォルト: tools.profile: "coding" (既存の明示的なプロファイルは保持されます)
  • DM分離デフォルト: ローカルオンボーディング時、未設定の場合 session.dmScope: "per-channel-peer" を書き込みます。詳細: CLI オンボーディングリファレンス
  • Tailscale 公開 オフ
  • Telegram および WhatsApp DM はデフォルトで 許可リスト になります (電話番号の入力を求められます)

ウィザードが構成するもの

ローカルモード (デフォルト) では、以下のステップを案内します:

  1. モデル/認証 — サポートされている任意のプロバイダー/認証フロー (APIキー、OAuth、またはセットアップトークン) を選択します。カスタムプロバイダー (OpenAI互換、Anthropic互換、またはUnknown自動検出) も含みます。デフォルトモデルを選択します。セキュリティ上の注意: このエージェントがツールを実行したり、ウェブフック/フックのコンテンツを処理したりする場合は、利用可能な最新世代の最強モデルを優先し、ツールポリシーを厳格に保ってください。弱い/古い階層はプロンプトインジェクションが容易です。非対話実行の場合、--secret-input-mode ref は、プレーンテキストのAPIキー値の代わりに、環境変数に基づく参照を認証プロファイルに保存します。非対話 ref モードでは、プロバイダーの環境変数が設定されている必要があります。その環境変数なしでインラインキーフラグを渡すと、すぐに失敗します。対話実行では、シークレット参照モードを選択すると、環境変数または構成済みのプロバイダー参照 (file または exec) を指し示すことができ、保存前に高速な事前検証が行われます。
  2. ワークスペース — エージェントファイルの場所 (デフォルト ~/.openclaw/workspace)。ブートストラップファイルをシードします。
  3. ゲートウェイ — ポート、バインドアドレス、認証モード、Tailscale公開。対話的トークンモードでは、デフォルトのプレーンテキストトークン保存、またはSecretRefへのオプトインを選択します。非対話的トークンSecretRefパス: --gateway-token-ref-env <ENV_VAR>。
  4. チャネル — WhatsApp、Telegram、Discord、Google Chat、Mattermost、Signal、BlueBubbles、またはiMessage。
  5. デーモン — LaunchAgent (macOS) または systemd ユーザーユニット (Linux/WSL2) をインストールします。トークン認証にトークンが必要で、gateway.auth.token がSecretRefで管理されている場合、デーモンインストールはそれを検証しますが、解決されたトークンをスーパーバイザーサービスの環境メタデータに永続化しません。トークン認証にトークンが必要で、構成されたトークンSecretRefが未解決の場合、デーモンインストールはブロックされ、実行可能なガイダンスが表示されます。gateway.auth.token と gateway.auth.password の両方が構成されていて、gateway.auth.mode が未設定の場合、モードが明示的に設定されるまでデーモンインストールはブロックされます。
  6. ヘルスチェック — ゲートウェイを起動し、実行中であることを確認します。
  7. スキル — 推奨スキルとオプションの依存関係をインストールします。

ℹ️ ウィザードを再実行しても、明示的に リセット を選択 (または --reset を渡す) しない限り、何も消去されません。CLIの --reset はデフォルトで設定、認証情報、セッションを対象とします。ワークスペースを含めるには --reset-scope full を使用してください。設定が無効またはレガシーキーを含む場合、ウィザードは最初に openclaw doctor を実行するよう求めます。

リモートモード は、ローカルクライアントが別の場所にあるゲートウェイに接続するように構成するだけです。リモートホスト上では何もインストールまたは変更しません。

別のエージェントを追加する

openclaw agents add <name> を使用して、独自のワークスペース、セッション、認証プロファイルを持つ別のエージェントを作成します。--workspace なしで実行するとウィザードが起動します。設定する内容:

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

注意点:

  • デフォルトのワークスペースは ~/.openclaw/workspace-<agentId> に従います。
  • インバウンドメッセージをルーティングするには bindings を追加します (ウィザードでこれを行うことができます)。
  • 非対話フラグ: --model, --agent-dir, --bind, --non-interactive。

完全なリファレンス

詳細なステップバイステップの解説、非対話スクリプティング、Signalセットアップ、RPC API、およびウィザードが書き込む設定フィールドの完全なリストについては、ウィザードリファレンス を参照してください。

関連ドキュメント

オンボーディング概要オンボーディング: macOSアプリ