メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

CLI オンボーディングは、macOS、Linux、または Windows (WSL2 経由、強く推奨) で OpenClaw をセットアップする推奨の方法です。 ローカル Gateway またはリモート Gateway 接続に加え、チャンネル、Skills、 ワークスペースのデフォルトを、1つのガイド付きフローで設定します。 
openclaw onboard
最速の初回チャット: Control UI を開きます (チャンネル設定は不要)。openclaw dashboard を実行し、ブラウザーでチャットします。ドキュメント: Dashboard。
後で再設定するには: 
openclaw configure
openclaw agents add <name>
--json は非対話モードを意味しません。スクリプトでは --non-interactive を使用してください。
CLI オンボーディングには Web 検索ステップが含まれており、Brave、DuckDuckGo、Exa、Firecrawl、Gemini、Grok、Kimi、MiniMax Search、 Ollama Web Search、Perplexity、SearXNG、Tavily などのプロバイダーを選択できます。一部のプロバイダーには API キーが必要ですが、キー不要のものもあります。後で openclaw configure --section web でも設定できます。ドキュメント: Web ツール。

​
クイックスタート vs 詳細設定

オンボーディングは、クイックスタート (デフォルト) と 詳細設定 (完全な制御) から始まります。
  • ローカル Gateway (loopback)
  • ワークスペースのデフォルト (または既存のワークスペース)
  • Gateway ポート 18789
  • Gateway 認証 Token (loopback でも自動生成)
  • 新しいローカルセットアップ向けのツールポリシーのデフォルト: tools.profile: "coding" (既存の明示的なプロファイルは保持されます)
  • DM 分離のデフォルト: ローカルオンボーディングは未設定時に session.dmScope: "per-channel-peer" を書き込みます。詳細: CLI セットアップリファレンス
  • Tailscale 公開 オフ
  • Telegram + WhatsApp の DM はデフォルトで allowlist (電話番号の入力を求められます)

​
オンボーディングで設定される内容

ローカルモード (デフォルト) では、次のステップを順に案内します。
  1. モデル/認証 — Custom Provider を含む、サポートされている任意のプロバイダー/認証フロー (API キー、OAuth、またはプロバイダー固有の手動認証) を選択します (OpenAI 互換、Anthropic 互換、または Unknown 自動検出)。デフォルトモデルを選択します。 セキュリティ上の注意: このエージェントがツールを実行したり Webhook/hooks コンテンツを処理したりする場合は、利用可能な最新世代の最も強力なモデルを優先し、ツールポリシーを厳格に保ってください。弱い/古い階層ほどプロンプトインジェクションを受けやすくなります。 非対話実行では、--secret-input-mode ref は平文の API キー値ではなく、環境変数に基づく参照を認証プロファイルに保存します。 非対話 ref モードでは、プロバイダーの環境変数が設定されている必要があります。その環境変数なしでインラインのキーフラグを渡すと、即座に失敗します。 対話実行では、シークレット参照モードを選ぶと、環境変数または設定済みのプロバイダー参照 (file または exec) を指し示せます。保存前に高速な事前検証が行われます。 Anthropic では、対話型のオンボーディング/設定で、推奨されるローカルパスとして Anthropic Claude CLI、推奨される本番パスとして Anthropic API key が提示されます。Anthropic setup-token も、サポートされるトークン認証パスとして引き続き利用できます。
  2. ワークスペース — エージェントファイルの場所 (デフォルトは ~/.openclaw/workspace)。ブートストラップファイルをシードします。
  3. Gateway — ポート、バインドアドレス、認証モード、Tailscale 公開。 対話型トークンモードでは、デフォルトの平文トークン保存を選ぶか、SecretRef にオプトインします。 非対話トークン SecretRef パス: --gateway-token-ref-env <ENV_VAR>。
  4. チャンネル — iMessage、Discord、Feishu、Google Chat、Mattermost、Microsoft Teams、QQ Bot、Signal、Slack、Telegram、WhatsApp などの組み込みおよび同梱チャットチャンネル。
  5. デーモン — LaunchAgent (macOS)、systemd ユーザーユニット (Linux/WSL2)、またはユーザーごとの Startup フォルダーへのフォールバック付きのネイティブ Windows Scheduled Task をインストールします。 トークン認証でトークンが必要で、gateway.auth.token が SecretRef 管理の場合、デーモンのインストールではそれを検証しますが、解決済みトークンをスーパーバイザーサービスの環境メタデータに永続化しません。 トークン認証でトークンが必要で、設定済みのトークン SecretRef が未解決の場合、デーモンのインストールは実行可能な案内とともにブロックされます。 gateway.auth.token と gateway.auth.password の両方が設定され、gateway.auth.mode が未設定の場合、モードが明示的に設定されるまでデーモンのインストールはブロックされます。
  6. ヘルスチェック — Gateway を起動し、実行中であることを検証します。
  7. Skills — 推奨 Skills と任意の依存関係をインストールします。
オンボーディングを再実行しても、Reset を明示的に選択しない限り (または --reset を渡さない限り)、何も消去されません。 CLI の --reset はデフォルトで設定、認証情報、セッションを対象にします。ワークスペースを含めるには --reset-scope full を使用してください。 設定が無効であるかレガシーキーを含む場合、オンボーディングはまず openclaw doctor の実行を求めます。
リモートモード は、ローカルクライアントが別の場所にある Gateway に接続するための設定だけを行います。 リモートホストには何もインストールせず、変更もしません。

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

openclaw agents add <name> を使用して、独自のワークスペース、 セッション、認証プロファイルを持つ別個のエージェントを作成します。--workspace なしで実行するとオンボーディングが起動します。 設定される内容:
  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir
注記:
  • デフォルトのワークスペースは ~/.openclaw/workspace-<agentId> に従います。
  • 受信メッセージをルーティングするには bindings を追加します (オンボーディングで実行できます)。
  • 非対話フラグ: --model、--agent-dir、--bind、--non-interactive。

​
完全なリファレンス

詳細なステップごとの内訳と設定出力については、 CLI セットアップリファレンス を参照してください。 非対話の例については、CLI 自動化 を参照してください。 RPC の詳細を含む、より深い技術リファレンスについては、 オンボーディングリファレンス を参照してください。

​
関連ドキュメント