FAQ

​

目次

• 問題が起きたときの最初の 60 秒
• クイックスタートと初回セットアップ
  • 行き詰まったとき、最速で抜け出す方法は？
  • OpenClaw をインストールしてセットアップする推奨方法は？
  • オンボーディング後にダッシュボードを開くには？
  • localhost とリモートでダッシュボードトークンを認証する方法は？
  • 必要なランタイムは？
  • Raspberry Pi で動きますか？
  • Raspberry Pi へのインストールでコツはありますか？
  • オンボーディングで “wake up my friend” の画面から進まず hatch しません。どうすればいいですか？
  • 新しいマシン（Mac mini など）へ、オンボーディングをやり直さずにセットアップを移行できますか？
  • 最新バージョンの変更点はどこで確認できますか？
  • docs.openclaw.ai にアクセスできず SSL error が出ます。どうすればいいですか？
  • stable と beta の違いは何ですか？
  • beta 版のインストール方法と、beta と dev の違いは？
  • インストールとオンボーディングには通常どれくらい時間がかかりますか？
  • 最新版を試すには？
  • インストーラーが止まる。もっと詳しいフィードバックを得るには？
  • Windows インストールで git not found や openclaw not recognized と表示されます
  • Windows の exec 出力で中国語が文字化けします。どうすればいいですか？
  • ドキュメントで答えが見つからなかった場合、より良い答えを得るには？
  • Linux に OpenClaw をインストールするには？
  • VPS に OpenClaw をインストールするには？
  • クラウド/VPS のインストールガイドはどこにありますか？
  • OpenClaw に自分自身を更新させることはできますか？
  • オンボーディングウィザードは実際には何をしているのですか？
  • 実行するのに Claude や OpenAI のサブスクリプションは必要ですか？
  • API キーなしで Claude Max サブスクリプションを使えますか？
  • Anthropic の setup-token 認証はどのように動きますか？
  • Anthropic の setup-トークンはどこで取得できますか？
  • Claude サブスクリプション認証（Claude Pro または Max）はサポートしていますか？
  • Anthropic から HTTP 429 ratelimiterror が出るのはなぜですか？
  • AWS Bedrock はサポートされていますか？
  • Codex 認証はどのように動きますか？
  • OpenAI サブスクリプション認証の Codex OAuth はサポートしていますか？
  • Gemini CLI OAuth はどのように設定しますか？
  • 気軽なチャット用途ならローカルモデルでも大丈夫ですか？
  • ホスト型モデルのトラフィックを特定リージョン内に保つには？
  • これをインストールするには Mac Mini を買う必要がありますか？
  • iMessage サポートには Mac mini が必要ですか？
  • OpenClaw 用に Mac mini を買った場合、MacBook Pro と接続できますか？
  • Bun は使えますか？
  • Telegram の allowFrom には何を入れればいいですか？
  • 1 つの WhatsApp 番号を、複数の OpenClaw インスタンスで別々に使えますか？
  • 高速なチャット用エージェントと、コーディング用の Opus エージェントを分けて動かせますか？
  • Linux で Homebrew は使えますか？
  • hackable git インストールと npm インストールの違いは何ですか？
  • 後から npm インストールと git インストールを切り替えられますか？
  • ゲートウェイはラップトップと VPS のどちらで動かすべきですか？
  • OpenClaw を専用マシンで動かす重要性はどれくらいですか？
  • VPS の最小要件と推奨 OS は？
  • VM 上で OpenClaw を動かせますか？要件は？
• OpenClaw とは何ですか？
  • OpenClaw を 1 段落で説明すると
  • 価値提案は何ですか
  • セットアップした直後にまず何をすればよいですか
  • OpenClaw の日常的なユースケース上位 5 つは何ですか
  • OpenClaw は SaaS 向けのリード獲得、アウトリーチ、広告、ブログに役立ちますか
  • Web 開発において Claude Code と比べた利点は何ですか
• スキルと自動化
  • リポジトリを汚さずにスキルをカスタマイズするには
  • カスタムフォルダからスキルを読み込めますか
  • タスクごとに異なるモデルを使い分けるには
  • 重い処理をしている間にボットが固まりますどうやってオフロードすればいいですか
  • Discord でスレッドに紐づくサブエージェントセッションはどのように動作しますか
  • Cron やリマインダーが発火しません何を確認すべきですか
  • Linux でスキルをインストールするには
  • OpenClaw はスケジュール実行やバックグラウンドでの継続実行ができますか
  • Linux から Apple の macOS 専用スキルを実行できますか
  • Notion や HeyGen との連携はありますか
  • ブラウザ乗っ取り用の Chrome extension をインストールするには
• サンドボックスとメモリ
  • 専用のサンドボックス化ドキュメントはありますか
  • Docker には制限があるように感じます完全な機能を有効にするにはどうすればよいですか
  • ホストのフォルダをサンドボックスにバインドするにはどうすればよいですか
  • メモリはどのように動作しますか
  • メモリがすぐに忘れます定着させるにはどうすればよいですか
  • セマンティックメモリ検索には OpenAI API キーが必要ですか
  • メモリはずっと保持されますか制限はありますか
• データはディスク上のどこに存在しますか
  • OpenClaw で使われるデータはすべてローカルに保存されますか
  • OpenClaw はどこにデータを保存しますか
  • AGENTS.md SOUL.md USER.md MEMORY.md はどこに置くべきですか
  • 推奨されるバックアップ戦略は何ですか
  • OpenClaw を完全にアンインストールするにはどうすればよいですか
  • エージェントはワークスペースの外側でも動作できますか
  • リモートモードではセッションストアはどこにありますか
• 設定の基本
  • 設定ファイルの形式と場所は何ですか
  • gateway.bind を lan または tailnet に設定したら何も待ち受けず、UI に unauthorized と表示されます
  • localhost でも トークンが必要になったのはなぜですか
  • 設定変更後に再起動は必要ですか
  • CLI の面白いタグラインを無効にするにはどうすればよいですか
  • web search と web fetch を有効にするにはどうすればよいですか
  • 複数デバイスにまたがって、専用ワーカーを備えた中央ゲートウェイを実行するにはどうすればよいですか
  • OpenClaw ブラウザはヘッドレスで実行できますか
  • ブラウザ制御に Brave を使うにはどうすればよいですか
• リモートゲートウェイとノード
  • Telegram、ゲートウェイ、ノードの間でコマンドはどのように伝播しますか
  • ゲートウェイがリモートでホストされている場合、エージェントから自分のコンピュータにアクセスするにはどうすればよいですか
  • Tailscale は接続済みなのに返信が来ません。どうすればよいですか
  • ローカル環境と VPS 上の 2 つの OpenClaw インスタンスを相互に通信させることはできますか
  • 複数のエージェント用に別々の VPS は必要ですか
  • VPS から SSH する代わりに、個人用ラップトップ上のノードを使う利点はありますか
  • 2 台目のラップトップにはインストールすべきですか。それともノードを追加するだけでよいですか
  • ノードはゲートウェイサービスを実行しますか
  • 設定を適用する API / RPC の方法はありますか
  • config.apply で設定が消えました。復旧と再発防止の方法はありますか
  • 初回インストール向けの最小限で妥当な設定は何ですか
  • VPS 上で Tailscale を設定し、Mac から接続するにはどうすればよいですか
  • Mac ノードをリモートゲートウェイの Tailscale Serve に接続するにはどうすればよいですか
• 環境変数と .env の読み込み
  • OpenClaw は環境変数をどのように読み込みますか
  • サービス経由でゲートウェイを起動したら環境変数が消えましたどうすればよいですか
  • COPILOT_GITHUB_TOKEN を設定したのに、モデル status に Shell env off と表示されるのはなぜですか
• セッションと複数チャット
  • 新しい会話を開始するにはどうすればよいですか
  • 新しいメッセージを一度も送らなかった場合、セッションは自動的にリセットされますか
  • OpenClaw インスタンスのチームを作り、1 人を CEO、複数をエージェントにする方法はありますか
  • タスクの途中でコンテキストが切り詰められました。どうすれば防げますか
  • OpenClaw をインストールしたまま完全にリセットするにはどうすればよいですか
  • context too large エラーが出ます。リセットまたは compact するにはどうすればよいですか
  • なぜ “LLM request rejected: messages.content.tool_use.input field required” と表示されるのですか
  • 30 分ごとに heartbeat メッセージが送られてくるのはなぜですか
  • WhatsApp グループにボットアカウントを追加する必要はありますか
  • WhatsApp グループの JID を取得するにはどうすればよいですか
  • グループで OpenClaw が返信しないのはなぜですか
  • グループ / スレッドは DM とコンテキストを共有しますか
  • 作成できるワークスペースとエージェントの数はいくつですか
  • 複数のボットやチャットを同時に実行できますか。Slack ではどう設定すべきですか
• Models: デフォルト、選択、aliases、切り替え
  • デフォルトモデルとは何ですか
  • どのモデルを推奨しますか
  • selfホスト型モデルs の llamacpp vLLM Ollama は使えますか
  • 設定を消さずにモデルを切り替えるにはどうすればよいですか
  • OpenClaw、Flawd、Krill はモデルに何を使っていますか
  • 再起動せずにその場でモデルを切り替えるにはどうすればよいですか
  • 日常作業には GPT 5.2、コーディングには Codex 5.3 を使えますか
  • Model is not allowed と表示され、その後返信がないのはなぜですか
  • Unknown モデル minimax/MiniMax-M2.5 と表示されるのはなぜですか
  • デフォルトに MiniMax、複雑なタスクには OpenAI を使えますか
  • opus sonnet gpt は builtin shortcuts ですか
  • モデル shortcuts aliases を定義 / 上書きするにはどうすればよいですか
  • OpenRouter や ZAI など他のプロバイダーのモデルを追加するにはどうすればよいですか
• モデルのフェイルオーバーと「All モデル failed」
  • failover はどのように動作しますか
  • このエラーは何を意味しますか
  • No credentials found for profile "anthropic:default" の修正チェックリスト
  • なぜ Google Gemini も試行され、失敗したのですか
• 認証プロファイル: 概要と管理方法
  • 認証プロファイルとは
  • 一般的なプロファイル ID は何ですか
  • 最初に試行される認証プロファイルを制御できますか
  • OAuth と API キーの違いは何ですか
• ゲートウェイ: ポート、「already running」、およびリモートモード
  • ゲートウェイはどのポートを使用しますか
  • openclaw ゲートウェイ status で Runtime running と表示されるのに RPC probe failed になるのはなぜですか
  • openclaw ゲートウェイ status で Config cli と Config サービスが異なって表示されるのはなぜですか
  • another ゲートウェイインスタンス is already listening とは何を意味しますか
  • OpenClaw をリモートモードで実行し、クライアントを別のゲートウェイに接続するにはどうすればよいですか
  • Control UI で unauthorized と表示される、または再接続を繰り返します。どうすればよいですか
  • gateway.bind を tailnet に設定したのにバインドできず、何も待ち受けません
  • 同じ host 上で複数のゲートウェイを実行できますか
  • invalid handshake code 1008 とは何を意味しますか
• ログとデバッグ
  • ログはどこにありますか
  • ゲートウェイサービスを開始/停止/再起動するには
  • Windows でターミナルを閉じてしまった場合 OpenClaw を再起動するには
  • ゲートウェイは起動しているのに返信が届かない場合何を確認すべきですか
  • ゲートウェイから理由なく切断された場合はどうすればよいですか
  • Telegram の setMyCommands がネットワークエラーで失敗する場合何を確認すべきですか
  • TUI に何も表示されない場合何を確認すべきですか
  • ゲートウェイを完全に停止してから再起動するには
  • ELI5 openclaw ゲートウェイ restart と openclaw ゲートウェイの違い
  • 何かが失敗したときに最速で詳細を取得する方法は何ですか
• メディアと添付ファイル
  • My スキル generated an image/PDF but nothing was sent
• セキュリティとアクセス制御
  • OpenClaw を受信 DM に公開しても安全ですか
  • プロンプトインジェクションは公開ボットだけの懸念ですか
  • ボット専用の email、GitHub account、または phone number を持たせるべきですか
  • 自分の text messages に対する自律性を与えてもよいですかまたそれは安全ですか
  • 個人アシスタント用途では、より安価なモデルを使えますか
  • Telegram で start を実行したのにペアリングコードが届きません
  • WhatsApp で連絡先にメッセージを送りますか Pairing はどのように機能しますか
• チャットコマンド、タスクの中断、「止まらない」場合
  • チャットに内部システムメッセージが表示されないようにするには
  • 実行中のタスクを停止または中断するには
  • Telegram から Discord にメッセージを送ろうとすると Cross-context messaging denied になるのはなぜですか
  • メッセージを連投するとボットが無視しているように感じるのはなぜですか
• スクリーンショット/チャットログの正確な質問に答える

​

問題が起きたときの最初の 60 秒

1. クイックステータス（最初の確認）
   openclaw status
   
   OS と更新、ゲートウェイ/サービスの到達性、エージェント/セッション、プロバイダー設定とランタイムの問題を、ローカルですばやく要約して表示します（ゲートウェイに到達可能な場合）。
2. 貼り付け可能なレポート（安全に共有可能）
   openclaw status --all
   
   読み取り専用の診断を実行し、ログの末尾も表示します（トークンは伏せ字化されます）。
3. デーモンとポートの状態
   openclaw gateway status
   
   supervisor のランタイムと RPC 到達性、プローブ対象の URL、サービスが使用した可能性が高い設定を表示します。
4. 詳細プローブ
   openclaw status --deep
   
   ゲートウェイ のヘルスチェックとプロバイダーのプローブを実行します（到達可能な ゲートウェイが必要です）。Health を参照してください。
5. 最新ログを追跡
   openclaw logs --follow
   
   RPC が停止している場合は、代わりに次を使用します。
   tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"
   
   ファイルログはサービスログとは別です。Logging と Troubleshooting を参照してください。
6. doctor を実行（修復）
   openclaw doctor
   
   設定と状態を修復または移行し、ヘルスチェックを実行します。Doctor を参照してください。
7. ゲートウェイ スナップショット
   openclaw health --json
   openclaw health --verbose   # エラー時に対象 URL と設定パスを表示
   
   実行中の ゲートウェイに完全なスナップショットを要求します（WS-only）。Health を参照してください。

​

クイックスタートと初回セットアップ

​

行き詰まったとき、最速で抜け出す方法は？

• Claude Code: https://www.anthropic.com/claude-code/
• OpenAI Codex: https://openai.com/codex/

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

openclaw status
openclaw models status
openclaw doctor

• openclaw status: ゲートウェイ/エージェント の健全性と基本設定を素早く確認します。
• openclaw models status: プロバイダー の認証と モデル の利用可否を確認します。
• openclaw doctor: よくある設定や 状態 の問題を検証し、修復します。

​

OpenClaw をインストールしてセットアップする推奨方法は？

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build # 初回実行時に UI の依存関係も自動インストール
openclaw onboard

​

オンボーディング後にダッシュボードを開くには？

​

localhost とリモートでダッシュボードトークンを認証する方法は？

• http://127.0.0.1:18789/ を開きます。
• 認証を求められた場合は、gateway.auth.token（または OPENCLAW_GATEWAY_TOKEN）の トークンを Control UI 設定 に貼り付けます。
• ゲートウェイホスト で openclaw config get gateway.auth.token を実行して取得します（または openclaw doctor --generate-gateway-token で生成できます）。

• Tailscale Serve（推奨）: bind は loopback のままにして、openclaw gateway --tailscale serve を実行し、https://<magicdns>/ を開きます。gateway.auth.allowTailscale が true なら、ID headers によって Control UI/WebSocket 認証が満たされます（トークンは不要で、信頼済みの ゲートウェイホスト を前提とします）。ただし HTTP APIs には引き続き トークン / パスワード が必要です。
• Tailnet bind: openclaw gateway --bind tailnet --token "<token>" を実行し、http://<tailscale-ip>:18789/ を開いて、ダッシュボード 設定 に トークンを貼り付けます。
• SSH tunnel: ssh -N -L 18789:127.0.0.1:18789 user@host を実行してから http://127.0.0.1:18789/ を開き、Control UI 設定 に トークンを貼り付けます。

​

必要なランタイムは？

​

Raspberry Pi で動きますか？

​

Raspberry Pi へのインストールでコツはありますか？

• 64-bit OS を使い、Node は 22 以上を維持してください。
• ログを見やすく、更新もしやすい hackable (git) install を推奨します。
• チャネル/スキル なしで始め、あとから 1 つずつ追加してください。
• 変なバイナリ問題が出た場合、多くは ARM compatibility の問題です。

​

オンボーディングで “wake up my friend” の画面から進まず hatch しません。どうすればいいですか？

1. ゲートウェイを再起動します。

openclaw gateway restart

2. status と認証を確認します。

openclaw status
openclaw models status
openclaw logs --follow

3. まだ止まる場合は、以下を実行します。

openclaw doctor

​

新しいマシン（Mac mini など）へ、オンボーディングをやり直さずにセットアップを移行できますか？

1. 新しいマシンに OpenClaw をインストールします。
2. 古いマシンから $OPENCLAW_STATE_DIR（既定: ~/.openclaw）をコピーします。
3. ワークスペース（既定: ~/.openclaw/workspace）をコピーします。
4. openclaw doctor を実行し、ゲートウェイ サービス を再起動します。

​

最新バージョンの変更点はどこで確認できますか？

​

docs.openclaw.ai にアクセスできず SSL error が出ます。どうすればいいですか？

​

stable と beta の違いは何ですか？

• latest = stable
• beta = テスト用の先行ビルド

​

beta 版のインストール方法と、beta と dev の違いは？

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

​

インストールとオンボーディングには通常どれくらい時間がかかりますか？

• Install: 2-5 分
• Onboarding: 5-15 分（設定する チャネル/モデル の数に依存）

​

最新版を試すには？

1. Dev チャネル（git checkout）:

openclaw update --channel dev

2. Hackable install（installer site から）:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build

​

インストーラーが止まる。もっと詳しいフィードバックを得るには？

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --verbose

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --beta --verbose

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose

# install.ps1 にはまだ専用の -Verbose フラグはありません。
Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0

​

Windows インストールで git not found や openclaw not recognized と表示されます

• Git for Windows をインストールし、git が PATH に入っていることを確認してください。
• PowerShell を閉じて開き直し、installer を再実行してください。

• npm の global bin folder が PATH に入っていません。
• パスは次で確認できます。
  npm config get prefix
  
• そのディレクトリをユーザー PATH に追加してください（Windows では \bin の接尾辞は不要です。多くの環境では %AppData%\npm です）。
• PATH を更新したら、PowerShell を閉じて開き直してください。

​

Windows の exec 出力で中国語が文字化けします。どうすればいいですか？

• system.run/exec の出力で中国語が mojibake になる
• 同じコマンドが別の terminal プロファイル では正常に見える

chcp 65001
[Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false)
[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
$OutputEncoding = [System.Text.UTF8Encoding]::new($false)

openclaw gateway restart

• Issue #30640

​

ドキュメントで答えが見つからなかった場合、より良い答えを得るには？

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

​

Linux に OpenClaw をインストールするには？

• Linux の最短手順 + サービス install: Linux。
• フル手順: Getting Started。
• installer と更新: Install & updates。

​

VPS に OpenClaw をインストールするには？

​

クラウド/VPS のインストールガイドはどこにありますか？

• VPS hosting（全 プロバイダー を集約）
• Fly.io
• Hetzner
• exe.dev

​

OpenClaw に自分自身を更新させることはできますか？

openclaw update
openclaw update status
openclaw update --channel stable|beta|dev
openclaw update --tag <dist-tag|version>
openclaw update --no-restart

openclaw update --yes --no-restart
openclaw gateway restart

​

オンボーディングウィザードは実際には何をしているのですか？

• Model/auth setup（プロバイダー OAuth/setup-token フロー、API キー、LM Studio などの ローカルモデルのオプションを含む）
• Workspace の場所と bootstrap files
• ゲートウェイ 設定（bind/port/auth/tailscale）
• Providers（WhatsApp, Telegram, Discord, Mattermost (plugin), Signal, iMessage）
• Daemon install（macOS では LaunchAgent、Linux/WSL2 では systemd user unit）
• Health checks と スキル の選択

​

実行するのに Claude や OpenAI のサブスクリプションは必要ですか？

​

API キーなしで Claude Max サブスクリプションを使えますか？

​

Anthropic の setup-token 認証はどのように動きますか？

​

Anthropic の setup-トークンはどこで取得できますか？

claude setup-token

​

Claude サブスクリプション認証（Claude Pro または Max）はサポートしていますか？

​

Anthropic から HTTP 429 ratelimiterror が出るのはなぜですか？

​

AWS Bedrock はサポートされていますか？

​

Codex 認証はどのように動きますか？

​

OpenAI サブスクリプション認証の Codex OAuth はサポートしていますか？

​

Gemini CLI OAuth はどのように設定しますか？

1. plugin を有効化します: openclaw plugins enable google-gemini-cli-auth
2. login します: openclaw models auth login --provider google-gemini-cli --set-default

​

気軽なチャット用途ならローカルモデルでも大丈夫ですか？

​

ホスト型モデルのトラフィックを特定リージョン内に保つには？

​

これをインストールするには Mac Mini を買う必要がありますか？

​

iMessage サポートには Mac mini が必要ですか？

• ゲートウェイ は Linux/VPS で動かし、BlueBubbles server は Messages にサインインした任意の Mac で動かす。
• もっとも単純な単一マシン構成にしたい場合は、すべてをその Mac 上で動かす。

​

OpenClaw 用に Mac mini を買った場合、MacBook Pro と接続できますか？

• ゲートウェイ は Mac mini 上（常時稼働）。
• MacBook Pro は macOS app または ノード host を実行し、ゲートウェイ とペアリング。
• openclaw nodes status / openclaw nodes list で状態を確認。

​

Bun は使えますか？

​

Telegram の allowFrom には何を入れればいいですか？

• ボット に DM を送り、openclaw logs --follow を実行して from.id を確認する。

• ボット に DM を送り、https://api.telegram.org/bot<bot_token>/getUpdates を呼び、message.from.id を確認する。

• @userinfobot または @getidsbot に DM を送る。

​

1 つの WhatsApp 番号を、複数の OpenClaw インスタンスで別々に使えますか？

​

高速なチャット用エージェントと、コーディング用の Opus エージェントを分けて動かせますか？

​

Linux で Homebrew は使えますか？

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profile
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
brew install <formula>

​

hackable git インストールと npm インストールの違いは何ですか？

• Hackable (git) install: 完全なソース checkout で、編集可能です。contributor に最適です。 ローカルで build し、コードや docs を修正できます。
• npm install: repo なしの global CLI install で、「とにかく動かしたい」場合に最適です。 更新は npm dist-tags から行われます。

​

後から npm インストールと git インストールを切り替えられますか？

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
openclaw doctor
openclaw gateway restart

npm install -g openclaw@latest
openclaw doctor
openclaw gateway restart

​

ゲートウェイはラップトップと VPS のどちらで動かすべきですか？

• Pros: server コスト不要、ローカルファイルへ直接アクセス可能、ブラウザ window が見える。
• Cons: sleep や network drop で切断、OS update や reboot で中断、常時起動が必要。

• Pros: 常時稼働、安定した network、ラップトップ の sleep 問題がない、継続運用しやすい。
• Cons: ヘッドレス 運用が多い（screenshots を使う）、ファイルアクセスはリモートのみ、更新には SSH が必要。

​

OpenClaw を専用マシンで動かす重要性はどれくらいですか？

• Dedicated host（VPS/Mac mini/Pi）: 常時稼働しやすく、sleep/reboot による中断が少なく、権限が整理しやすく、継続運用も容易です。
• 共有 ラップトップ/desktop: テストやアクティブ利用には十分ですが、sleep や update による停止は見込んでください。

​

VPS の最小要件と推奨 OS は？

• Absolute minimum: 1 vCPU, 1GB RAM, 約 500MB disk。
• Recommended: 1-2 vCPU, 2GB RAM 以上。ログ、メディア、複数 チャネル の余裕が取れます。ノード tools や browser automation はリソースを消費しやすいです。

​

VM 上で OpenClaw を動かせますか？要件は？

• Absolute minimum: 1 vCPU, 1GB RAM。
• Recommended: 複数 チャネル、browser automation、media tools を使うなら 2GB RAM 以上。
• OS: Ubuntu LTS または同等の新しい Debian/Ubuntu。

​

OpenClaw とは何ですか？

​

OpenClaw を 1 段落で説明すると

​

価値提案は何ですか

• 自分のデバイス、自分のデータ: ゲートウェイ は好きな場所（Mac、Linux、VPS）で実行でき、 ワークスペース と セッション履歴 をローカルに保持できます。
• web sandbox ではなく実際のチャネル: WhatsApp/Telegram/Slack/Discord/Signal/iMessage/etc に加え、対応プラットフォームではモバイル音声と Canvas も使えます。
• モデル非依存: Anthropic、OpenAI、MiniMax、OpenRouter などを利用でき、エージェント ごとの routing と failover に対応します。
• ローカル専用オプション: ローカルモデルを実行すれば、必要に応じて すべてのデータを自分のデバイス上に とどめる ことができます。
• マルチエージェント routing: チャネル、アカウント、またはタスクごとに エージェント を分けられ、 それぞれが独自の ワークスペース と defaults を持てます。
• オープンソースで拡張しやすい: 中身を確認し、拡張し、vendor lock-in なしで self-host できます。

​

セットアップした直後にまず何をすればよいですか

• Web サイトを作る（WordPress、Shopify、またはシンプルな静的サイト）。
• モバイルアプリを試作する（構成、画面、API プラン）。
• ファイルやフォルダを整理する（クリーンアップ、命名、タグ付け）。
• Gmail を接続して、要約やフォローアップを自動化する。

​

OpenClaw の日常的なユースケース上位 5 つは何ですか

• 個人向けブリーフィング: inbox、calendar、気になるニュースの要約。
• 調査とドラフト作成: メールやドキュメントのための簡易リサーチ、要約、初稿作成。
• リマインダーとフォローアップ: cron や heartbeat で動く通知やチェックリスト。
• ブラウザ自動化: フォーム入力、データ収集、繰り返しの Web 作業。
• デバイス横断の連携: スマートフォンからタスクを送り、ゲートウェイをサーバー上で実行し、結果をチャットで受け取る。

​

OpenClaw は SaaS 向けのリード獲得、アウトリーチ、広告、ブログに役立ちますか

​

Web 開発において Claude Code と比べた利点は何ですか

• セッションをまたいで持続する memory + ワークスペース
• マルチプラットフォーム access（WhatsApp、Telegram、TUI、WebChat）
• tool orchestration（browser、files、scheduling、hooks）
• 常時稼働する ゲートウェイ（VPS 上で実行し、どこからでも操作可能）
• Nodes によるローカルの browser/screen/camera/exec

​

スキルと自動化

​

リポジトリを汚さずにスキルをカスタマイズするには

​

カスタムフォルダからスキルを読み込めますか

​

タスクごとに異なるモデルを使い分けるには

• Cron jobs: 分離された job ごとに model override を設定できます。
• Sub-エージェント: デフォルトモデルの異なる個別の エージェントにタスクをルーティングできます。
• On-demand switch: /model を使えば、現在のセッションモデルをいつでも切り替えられます。

​

重い処理をしている間にボットが固まりますどうやってオフロードすればいいですか

​

Discord でスレッドに紐づくサブエージェントセッションはどのように動作しますか

• sessions_spawn を thread: true で実行します（継続的な follow-up が必要なら mode: "session" も任意で指定します）。
• あるいは /focus <target> で手動で bind します。
• /agents を使って binding の状態を確認します。
• /session idle <duration|off> と /session max-age <duration|off> を使って auto-unfocus を制御します。
• thread を切り離すには /unfocus を使います。

• Global defaults: session.threadBindings.enabled, session.threadBindings.idleHours, session.threadBindings.maxAgeHours。
• Discord overrides: channels.discord.threadBindings.enabled, channels.discord.threadBindings.idleHours, channels.discord.threadBindings.maxAgeHours。
• spawn 時に auto-bind するには: channels.discord.threadBindings.spawnSubagentSessions: true を設定します。

​

Cron やリマインダーが発火しません何を確認すべきですか

• cron が有効であること（cron.enabled）と、OPENCLAW_SKIP_CRON が設定されていないことを確認してください。
• ゲートウェイが 24/7 稼働していることを確認してください（スリープや再起動なし）。
• job のタイムゾーン設定（--tz とホストのタイムゾーン）を確認してください。

openclaw cron run <jobId> --force
openclaw cron runs --id <jobId> --limit 50

​

Linux でスキルをインストールするには

npm i -g clawhub

pnpm add -g clawhub

​

OpenClaw はスケジュール実行やバックグラウンドでの継続実行ができますか

• Cron jobs はスケジュール実行または定期実行のタスク向けです（再起動後も保持されます）。
• Heartbeat は “main セッション” の定期チェック向けです。
• Isolated jobs は、自律的に summary を投稿したり chat に配信したりする エージェント 向けです。

​

Linux から Apple の macOS 専用スキルを実行できますか

1. binary 用の SSH wrapper を作成します（例: Apple Notes 用の memo）。
   #!/usr/bin/env bash
   set -euo pipefail
   exec ssh -T user@mac-host /opt/homebrew/bin/memo "$@"
   
2. wrapper を Linux host の PATH 上に配置します（例: ~/bin/memo）。
3. Linux を許可するように Skill metadata を override します（ワークスペース または ~/.openclaw/skills）。
   ---
   name: apple-notes
   description: Manage Apple Notes via the memo CLI on macOS.
   metadata: { "openclaw": { "os": ["darwin", "linux"], "requires": { "bins": ["memo"] } } }
   ---
   
4. 新しい セッション を開始して、スキル snapshot を更新します。

​

Notion や HeyGen との連携はありますか

• Custom skill / plugin: 信頼性の高い API アクセスにはこれが最適です（Notion も HeyGen も API を提供しています）。
• Browser automation: コードなしでも動きますが、遅く壊れやすくなります。

• クライアントごとに Notion page を 1 つ用意する（context + preferences + active work）。
• セッション の開始時に、その page を取得するよう エージェントに依頼する。

clawhub install <skill-slug>
clawhub update --all

​

ブラウザ乗っ取り用の Chrome extension をインストールするには

openclaw browser extension install
openclaw browser extension path

​

サンドボックスとメモリ

​

専用のサンドボックス化ドキュメントはありますか

​

Docker には制限があるように感じます完全な機能を有効にするにはどうすればよいですか

• OPENCLAW_HOME_VOLUME で /home/node を永続化し、キャッシュが保持されるようにする
• OPENCLAW_DOCKER_APT_PACKAGES で system deps をイメージに組み込む
• バンドルされている CLI で Playwright のブラウザをインストールする: node /app/node_modules/playwright-core/cli.js install chromium
• PLAYWRIGHT_BROWSERS_PATH を設定し、そのパスが永続化されるようにする

​

ホストのフォルダをサンドボックスにバインドするにはどうすればよいですか

​

メモリはどのように動作しますか

• memory/YYYY-MM-DD.md の daily notes
• MEMORY.md の curated long-term notes（main/private セッション のみ）

​

メモリがすぐに忘れます定着させるにはどうすればよいですか

​

セマンティックメモリ検索には OpenAI API キーが必要ですか

​

メモリはずっと保持されますか制限はありますか

​

データはディスク上のどこに存在しますか

​

OpenClaw で使われるデータはすべてローカルに保存されますか

• デフォルトではローカル: セッション、memory files、設定、ワークスペース は ゲートウェイ ホスト上にあります （~/.openclaw とあなたの ワークスペース ディレクトリ）。
• 必然的にリモート: モデル プロバイダー（Anthropic/OpenAI など）に送るメッセージは それらの API に送信され、chat platform（WhatsApp/Telegram/Slack など）は message data を それらのサーバーに保存します。
• 影響範囲は自分で制御可能: ローカルモデルs を使えば prompts はあなたのマシン上に残りますが、チャネル traffic は依然としてその チャネル のサーバーを経由します。

​

OpenClaw はどこにデータを保存しますか

​

AGENTS.md SOUL.md USER.md MEMORY.md はどこに置くべきですか

• Workspace（エージェント ごと）: AGENTS.md、SOUL.md、IDENTITY.md、USER.md、 MEMORY.md（または memory.md）、memory/YYYY-MM-DD.md、任意で HEARTBEAT.md。
• State dir（~/.openclaw）: 設定、認証情報、認証プロファイル、セッション、logs、 および共有 スキル（~/.openclaw/skills）。

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}

​

推奨されるバックアップ戦略は何ですか

​

OpenClaw を完全にアンインストールするにはどうすればよいですか

​

エージェントはワークスペースの外側でも動作できますか

{
  agents: {
    defaults: {
      workspace: "~/Projects/my-repo",
    },
  },
}

​

リモートモードではセッションストアはどこにありますか

​

設定の基本

​

設定ファイルの形式と場所は何ですか

$OPENCLAW_CONFIG_PATH

​

gateway.bind を lan または tailnet に設定したら何も待ち受けず、UI に unauthorized と表示されます

{
  gateway: {
    bind: "lan",
    auth: {
      mode: "token",
      token: "replace-me",
    },
  },
}

• gateway.remote.token / .password だけでは、ローカル ゲートウェイ の 認証は有効になりません。
• gateway.auth.* が未設定の場合、ローカルの呼び出し経路ではフォールバックとして gateway.remote.* を使用できます。
• Control UI は connect.params.auth.token（app/UI 設定に保存）で認証します。URL に トークンを含めるのは避けてください。

​

localhost でも トークンが必要になったのはなぜですか

​

設定変更後に再起動は必要ですか

• gateway.reload.mode: "hybrid"（デフォルト）: 安全な変更は hot-apply し、重要な変更は再起動します
• hot、restart、off もサポートされています

​

CLI の面白いタグラインを無効にするにはどうすればよいですか

{
  cli: {
    banner: {
      taglineMode: "off", // random | default | off
    },
  },
}

• off: タグラインの文言を非表示にしますが、バナーのタイトル/バージョン行は残ります。
• default: 毎回 All your chats, one OpenClaw. を使用します。
• random: 面白い/季節限定のタグラインをローテーション表示します（デフォルト動作）。
• バナー自体を完全に表示したくない場合は、環境変数 OPENCLAW_HIDE_BANNER=1 を設定してください。

​

web search と web fetch を有効にするにはどうすればよいですか

{
  tools: {
    web: {
      search: {
        enabled: true,
        apiKey: "BRAVE_API_KEY_HERE",
        maxResults: 5,
      },
      fetch: {
        enabled: true,
      },
    },
  },
}

• allowlist を使っている場合は、web_search/web_fetch または group:web を追加してください。
• web_fetch はデフォルトで有効です（明示的に無効化していない限り）。
• daemon は ~/.openclaw/.env（またはサービス環境）から環境変数を読み取ります。

​

複数デバイスにまたがって、専用ワーカーを備えた中央ゲートウェイを実行するにはどうすればよいですか

• ゲートウェイ (central): チャネル（Signal/WhatsApp）、routing、セッション を管理します。
• Nodes (devices): Mac、iOS、Android などが周辺デバイスとして接続し、ローカル tools（system.run、canvas、camera）を公開します。
• Agents (workers): 特定の役割向けに分離された brain/ワークスペース です（例: “Hetzner ops”、“Personal data”）。
• Sub-エージェント: 並列化したいときに、メイン エージェント からバックグラウンド作業を spawn します。
• TUI: ゲートウェイに接続し、エージェント や セッション を切り替えます。

​

OpenClaw ブラウザはヘッドレスで実行できますか

{
  browser: { headless: true },
  agents: {
    defaults: {
      sandbox: { browser: { headless: true } },
    },
  },
}

• ブラウザウィンドウは表示されません（見た目を確認したい場合は screenshot を使用してください）。
• ヘッドレス モードでは、一部のサイトが自動化に対してより厳格になります（CAPTCHA、anti-ボット）。 たとえば、X/Twitter は ヘッドレス セッション をブロックすることがよくあります。

​

ブラウザ制御に Brave を使うにはどうすればよいですか

​

リモートゲートウェイとノード

​

Telegram、ゲートウェイ、ノードの間でコマンドはどのように伝播しますか

​

ゲートウェイがリモートでホストされている場合、エージェントから自分のコンピュータにアクセスするにはどうすればよいですか

1. 常時稼働する host（VPS / home server）で ゲートウェイを実行します。
2. ゲートウェイホスト と自分のコンピュータを同じ tailnet に参加させます。
3. ゲートウェイ WS に到達できることを確認します（tailnet bind または SSH tunnel）。
4. ローカルで macOS app を開き、Remote over SSH mode（または direct tailnet）で接続して、 ノード として登録できるようにします。
5. ゲートウェイ 上で ノード を承認します:
   openclaw devices list
   openclaw devices approve <requestId>
   

​

Tailscale は接続済みなのに返信が来ません。どうすればよいですか

• ゲートウェイが実行中であること: openclaw gateway status
• ゲートウェイ の health: openclaw status
• チャネル の health: openclaw channels status

• Tailscale Serve を使っている場合は、gateway.auth.allowTailscale が正しく設定されていることを確認します。
• SSH tunnel 経由で接続している場合は、ローカル tunnel が起動しており、正しい port を向いていることを確認します。
• allowlist（DM または group）に自分の account が含まれていることを確認します。

​

ローカル環境と VPS 上の 2 つの OpenClaw インスタンスを相互に通信させることはできますか

openclaw agent --message "Hello from local bot" --deliver --channel telegram --reply-to <chat-id>

​

複数のエージェント用に別々の VPS は必要ですか

​

VPS から SSH する代わりに、個人用ラップトップ上のノードを使う利点はありますか

• インバウンド SSH が不要です。 ノード は ゲートウェイ WebSocket に outbound 接続し、device pairing を使います。
• より安全な実行制御。 system.run はその ラップトップ 上の ノード allowlists / approvals によって制御されます。
• より多くの device tools。 ノード は system.run に加えて canvas、camera、screen を公開します。
• ローカル browser automation。 ゲートウェイ は VPS 上に置いたまま、Chrome はローカルで動かし、Chrome extension と ラップトップ 上の ノード host で制御を中継できます。

​

2 台目のラップトップにはインストールすべきですか。それともノードを追加するだけでよいですか

​

ノードはゲートウェイサービスを実行しますか

​

設定を適用する API / RPC の方法はありますか

​

config.apply で設定が消えました。復旧と再発防止の方法はありますか

• backup（git またはコピーしておいた ~/.openclaw/openclaw.json）から復元します。
• backup がない場合は、openclaw doctor を再実行して チャネル / モデル を再設定します。
• 想定外の動作だった場合は bug を報告し、最後に把握していた 設定 または任意の backup を添付してください。
• ローカルの coding エージェント であれば、logs や 履歴 から動作する 設定 を再構築できることがよくあります。

• 小さな変更には openclaw config set を使います。
• 対話的な編集には openclaw configure を使います。

​

初回インストール向けの最小限で妥当な設定は何ですか

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

​

VPS 上で Tailscale を設定し、Mac から接続するにはどうすればよいですか

1. VPS に install して login する
   curl -fsSL https://tailscale.com/install.sh | sh
   sudo tailscale up
   
2. Mac に install して login する
   • Tailscale app を使い、同じ tailnet に sign in します。
3. MagicDNS を有効にする（推奨）
   • Tailscale admin console で MagicDNS を有効にし、VPS に安定した名前を付けます。
4. tailnet hostname を使う
   • SSH: ssh user@your-vps.tailnet-xxxx.ts.net
   • ゲートウェイ WS: ws://your-vps.tailnet-xxxx.ts.net:18789

openclaw gateway --tailscale serve

​

Mac ノードをリモートゲートウェイの Tailscale Serve に接続するにはどうすればよいですか

1. VPS と Mac が同じ tailnet に参加していることを確認します。
2. macOS app を Remote mode で使います（SSH target には tailnet hostname を指定できます）。 app が ゲートウェイ port を tunnel し、ノード として接続します。
3. ゲートウェイ 上で ノード を承認します:
   openclaw devices list
   openclaw devices approve <requestId>
   

​

環境変数と .env の読み込み

​

OpenClaw は環境変数をどのように読み込みますか

• 現在の作業ディレクトリの .env
• ~/.openclaw/.env にあるグローバルなフォールバック用の .env（別名 $OPENCLAW_STATE_DIR/.env）

{
  env: {
    OPENROUTER_API_KEY: "sk-or-...",
    vars: { GROQ_API_KEY: "gsk-..." },
  },
}

​

サービス経由でゲートウェイを起動したら環境変数が消えましたどうすればよいですか

1. 不足しているキーを ~/.openclaw/.env に追加して、サービス が shell の環境変数を継承しない場合でも読み込まれるようにします。
2. shell import を有効にします（オプトインの利便機能）。

{
  env: {
    shellEnv: {
      enabled: true,
      timeoutMs: 15000,
    },
  },
}

​

COPILOT_GITHUB_TOKEN を設定したのに、モデル status に Shell env off と表示されるのはなぜですか

1. トークンを ~/.openclaw/.env に記述します。
   COPILOT_GITHUB_TOKEN=...
   
2. または shell import を有効にします（env.shellEnv.enabled: true）。
3. または 設定 の env ブロックに追加します（存在しない場合のみ適用されます）。

openclaw models status

​

セッションと複数チャット

​

新しい会話を開始するにはどうすればよいですか

​

新しいメッセージを一度も送らなかった場合、セッションは自動的にリセットされますか

{
  session: {
    idleMinutes: 240,
  },
}

​

OpenClaw インスタンスのチームを作り、1 人を CEO、複数をエージェントにする方法はありますか

​

タスクの途中でコンテキストが切り詰められました。どうすれば防げますか

• ボット に現在の状態を要約させて、ファイルに書き出してもらう。
• 長い作業の前に /compact を使い、話題を切り替えるときは /new を使う。
• 重要なコンテキストはワークスペース内に置き、ボット に再読込させる。
• 長時間または並列の作業では sub-エージェント を使い、メインチャットを小さく保つ。
• 頻繁に起こる場合は、より大きなコンテキストウィンドウを持つモデルを選ぶ。

​

OpenClaw をインストールしたまま完全にリセットするにはどうすればよいですか

openclaw reset

openclaw reset --scope full --yes --non-interactive

openclaw onboard --install-daemon

• オンボーディングウィザードも、既存の設定を検出した場合は Reset を提示します。Wizard を参照してください。
• プロファイル（--profile / OPENCLAW_PROFILE）を使用している場合は、各 状態 dir（デフォルトは ~/.openclaw-<profile>）をリセットしてください。
• Dev reset: openclaw gateway --dev --reset（開発専用。開発用の 設定、認証情報、セッション、ワークスペースを消去します）。

​

context too large エラーが出ます。リセットまたは compact するにはどうすればよいですか

• Compact（会話は維持しつつ、古いターンを要約します）:
  /compact
  
  または、要約の方針を指定するには /compact <instructions> を使います。
• Reset（同じチャットキーに対して新しいセッション ID を作成します）:
  /new
  /reset
  

• セッション pruning（agents.defaults.contextPruning）を有効化または調整して、古いツール出力を削減する。
• より大きなコンテキストウィンドウを持つモデルを使う。

​

なぜ “LLM request rejected: messages.content.tool_use.input field required” と表示されるのですか

​

30 分ごとに heartbeat メッセージが送られてくるのはなぜですか

{
  agents: {
    defaults: {
      heartbeat: {
        every: "2h", // or "0m" to disable
      },
    },
  },
}

​

WhatsApp グループにボットアカウントを追加する必要はありますか

{
  channels: {
    whatsapp: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

​

WhatsApp グループの JID を取得するにはどうすればよいですか

openclaw logs --follow --json

openclaw directory groups list --channel whatsapp

​

グループで OpenClaw が返信しないのはなぜですか

• メンションゲーティングが有効です（デフォルト）。ボット を @mention する必要があります（または mentionPatterns に一致させる必要があります）。
• channels.whatsapp.groups を "*" なしで設定しており、そのグループが allowlist に入っていません。

​

グループ / スレッドは DM とコンテキストを共有しますか

​

作成できるワークスペースとエージェントの数はいくつですか

• Disk growth: セッション と transcripts は ~/.openclaw/agents/<agentId>/sessions/ に保存されます。
• Token cost: エージェント が増えるほど、同時に使うモデル量も増えます。
• Ops overhead: エージェント ごとの 認証プロファイル、ワークスペース、チャネル routing の管理負荷が増えます。

• エージェント ごとに active な ワークスペースを 1 つに保つ（agents.defaults.workspace）。
• ディスク使用量が増えたら、古い セッション を prune する（JSONL または store entries を削除する）。
• openclaw doctor を使って、孤立した ワークスペース や プロファイル の不一致を見つける。

​

複数のボットやチャットを同時に実行できますか。Slack ではどう設定すべきですか

• 常時稼働する ゲートウェイホスト（VPS/Mac mini）。
• 役割ごとに 1 つの エージェント（bindings）。
• それらの エージェントにバインドされた Slack チャネル。
• 必要に応じて、extension relay（または ノード）経由のローカルブラウザ。

​

Models: デフォルト、選択、aliases、切り替え

​

デフォルトモデルとは何ですか

agents.defaults.model.primary

​

どのモデルを推奨しますか

​

selfホスト型モデルs の llamacpp vLLM Ollama は使えますか

​

設定を消さずにモデルを切り替えるにはどうすればよいですか

• chat で /model を使う（手軽、セッション ごと）
• openclaw models set ...（モデル設定 だけを更新）
• openclaw configure --section model（interactive）
• ~/.openclaw/openclaw.json の agents.defaults.model を編集

​

OpenClaw、Flawd、Krill はモデルに何を使っていますか

• これらの deployment はそれぞれ異なる場合があり、時間とともに変わる可能性があります。固定の プロバイダー 推奨はありません。
• 各 ゲートウェイ の現在の ランタイム 設定は openclaw models status で確認してください。
• セキュリティに敏感な / tool が有効な エージェントには、利用可能な最新世代で最も強力な モデル を使ってください。

​

再起動せずにその場でモデルを切り替えるにはどうすればよいですか

/model sonnet
/model haiku
/model opus
/model gpt
/model gpt-mini
/model gemini
/model gemini-flash

/model 3

/model opus@anthropic:default
/model opus@anthropic:work

/model anthropic/claude-opus-4-6

​

日常作業には GPT 5.2、コーディングには Codex 5.3 を使えますか

• 手早い切り替え（セッション ごと）: 日常作業には /model gpt-5.2、Codex OAuth を使った coding には /model openai-codex/gpt-5.4。
• デフォルト + 切り替え: agents.defaults.model.primary を openai/gpt-5.2 に設定し、coding 時だけ openai-codex/gpt-5.4 に切り替えます（逆でも構いません）。
• Sub-エージェント: coding タスクを、異なるデフォルト モデル を持つ sub-エージェントにルーティングします。

​

Model is not allowed と表示され、その後返信がないのはなぜですか

Model "provider/model" is not allowed. Use /model to list available models.

​

Unknown モデル minimax/MiniMax-M2.5 と表示されるのはなぜですか

1. 2026.1.12 に upgrade する（または source の main から実行する）うえで、ゲートウェイを再起動します。
2. MiniMax が設定されていることを確認します（ウィザード または JSON）、あるいは MiniMax API キー が env/認証プロファイル に存在して プロバイダー を注入できるようにします。
3. 正確な モデル id を使います（大文字小文字を区別します）: minimax/MiniMax-M2.5 または minimax/MiniMax-M2.5-highspeed。
4. 次を実行します。
   openclaw models list
   
   そして list から選択します（または chat で /model list を使います）。

​

デフォルトに MiniMax、複雑なタスクには OpenAI を使えますか

{
  env: { MINIMAX_API_KEY: "sk-...", OPENAI_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "minimax/MiniMax-M2.5" },
      models: {
        "minimax/MiniMax-M2.5": { alias: "minimax" },
        "openai/gpt-5.2": { alias: "gpt" },
      },
    },
  },
}

/model gpt

• Agent A のデフォルト: MiniMax
• Agent B のデフォルト: OpenAI
• エージェント ごとにルーティングするか、/agent を使って切り替える

​

opus sonnet gpt は builtin shortcuts ですか

• opus → anthropic/claude-opus-4-6
• sonnet → anthropic/claude-sonnet-4-6
• gpt → openai/gpt-5.4
• gpt-mini → openai/gpt-5-mini
• gemini → google/gemini-3.1-pro-preview
• gemini-flash → google/gemini-3-flash-preview
• gemini-flash-lite → google/gemini-3.1-flash-lite-preview

​

モデル shortcuts aliases を定義 / 上書きするにはどうすればよいですか

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": { alias: "opus" },
        "anthropic/claude-sonnet-4-5": { alias: "sonnet" },
        "anthropic/claude-haiku-4-5": { alias: "haiku" },
      },
    },
  },
}

​

OpenRouter や ZAI など他のプロバイダーのモデルを追加するにはどうすればよいですか

{
  agents: {
    defaults: {
      model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
      models: { "openrouter/anthropic/claude-sonnet-4-5": {} },
    },
  },
  env: { OPENROUTER_API_KEY: "sk-or-..." },
}

{
  agents: {
    defaults: {
      model: { primary: "zai/glm-5" },
      models: { "zai/glm-5": {} },
    },
  },
  env: { ZAI_API_KEY: "..." },
}

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

• openclaw agents add <id> を実行し、ウィザード 中に 認証を設定する。
• または、メイン エージェント の agentDir にある auth-profiles.json を、新しい エージェント の agentDir にコピーする。

​

モデルのフェイルオーバーと「All モデル failed」

​

failover はどのように動作しますか

1. 同一 プロバイダー 内での 認証プロファイル rotation。
2. agents.defaults.model.フォールバックs 内の次のモデルへの モデル フォールバック。

​

このエラーは何を意味しますか

No credentials found for profile "anthropic:default"

​

No credentials found for profile "anthropic:default" の修正チェックリスト

• 認証プロファイル の保存場所を確認する（新しいパスか legacy path か）
  • Current: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • Legacy: ~/.openclaw/agent/*（openclaw doctor により移行）
• env var が ゲートウェイに読み込まれていることを確認する
  • シェルで ANTHROPIC_API_KEY を設定していても、ゲートウェイを systemd/launchd 経由で実行している場合は継承されないことがあります。~/.openclaw/.env に配置するか、env.shellEnv を有効にしてください。
• 正しい エージェント を編集していることを確認する
  • multi-エージェント 構成では、auth-profiles.json が複数存在する場合があります。
• モデル/auth の状態を簡易確認する
  • openclaw models status を使うと、設定済みモデルと プロバイダー が認証済みかどうかを確認できます。

• setup-トークンを使用する
  • claude setup-token を実行し、その後 openclaw models auth setup-token --provider anthropic で貼り付けてください。
  • その トークンを別のマシンで作成した場合は、openclaw models auth paste-token --provider anthropic を使ってください。
• 代わりに API キー を使いたい場合
  • ゲートウェイホスト 上の ~/.openclaw/.env に ANTHROPIC_API_KEY を設定してください。
  • 存在しない プロファイル を強制する pinned order を解除してください。
    openclaw models auth order clear --provider anthropic
    
• ゲートウェイホスト上でコマンドを実行していることを確認する
  • リモートモード では、認証プロファイルは手元の ラップトップ ではなく ゲートウェイホスト 上に保存されます。

​

なぜ Google Gemini も試行され、失敗したのですか

​

認証プロファイル: 概要と管理方法

​

認証プロファイルとは

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

​

一般的なプロファイル ID は何ですか

• anthropic:default（メール ID が存在しない場合によく使われます）
• OAuth ID 用の anthropic:<email>
• 自分で選択するカスタム ID（例: anthropic:work）

​

最初に試行される認証プロファイルを制御できますか

# 設定済みのデフォルト agent を対象にします（--agent を省略）
openclaw models auth order get --provider anthropic

# ローテーションを 1 つの profile に固定します（これだけを試行）
openclaw models auth order set --provider anthropic anthropic:default

# または明示的な順序を設定します（provider 内で フォールバック）
openclaw models auth order set --provider anthropic anthropic:work anthropic:default

# override をクリアします（config の auth.order / round-robin にフォールバック）
openclaw models auth order clear --provider anthropic

openclaw models auth order set --provider anthropic --agent main anthropic:default

​

OAuth と API キーの違いは何ですか

• OAuth は、適用可能な場合、サブスクリプションのアクセスを活用することがよくあります。
• API キー は、トークン単位課金を使用します。

​

ゲートウェイ: ポート、「already running」、およびリモートモード

​

ゲートウェイはどのポートを使用しますか

--port > OPENCLAW_GATEWAY_PORT > gateway.port > default 18789

​

openclaw ゲートウェイ status で Runtime running と表示されるのに RPC probe failed になるのはなぜですか

• Probe target:（probe が実際に使用した URL）
• Listening:（そのポートで実際に bind されているもの）
• Last gateway error:（プロセスは生きているのにポートが 待ち受けていない場合によくある根本原因）

​

openclaw ゲートウェイ status で Config cli と Config サービスが異なって表示されるのはなぜですか

openclaw gateway install --force

​

another ゲートウェイインスタンス is already listening とは何を意味しますか

​

OpenClaw をリモートモードで実行し、クライアントを別のゲートウェイに接続するにはどうすればよいですか

{
  gateway: {
    mode: "remote",
    remote: {
      url: "ws://gateway.tailnet:18789",
      token: "your-token",
      password: "your-password",
    },
  },
}

• openclaw gateway が起動するのは、gateway.mode が local の場合だけです（または override flag を渡した場合）。
• macOS app は設定ファイルを監視しており、これらの値が変わると ライブで モードを切り替えます。

​

Control UI で unauthorized と表示される、または再接続を繰り返します。どうすればよいですか

• Control UI は トークンを、現在の ブラウザタブのセッション と選択中の ゲートウェイ URL に対して sessionStorage に保持します。そのため、同じ タブ内での refresh は引き続き動作しますが、長期保持のための localStorage token persistence は復元しません。

• 最速: openclaw dashboard（ダッシュボード URL を表示してコピーし、開こうとします。ヘッドレス なら SSH のヒントを表示します）。
• まだ トークンがない場合: openclaw doctor --generate-gateway-token。
• remote の場合は先に tunnel を張ります: ssh -N -L 18789:127.0.0.1:18789 user@host を実行してから http://127.0.0.1:18789/ を開いてください。
• ゲートウェイホスト側で gateway.auth.token（または OPENCLAW_GATEWAY_TOKEN）を設定してください。
• Control UI の設定に、同じ トークンを貼り付けてください。
• まだ解決しない場合は、openclaw status --all を実行し、Troubleshooting に従ってください。auth の詳細は Dashboard を参照してください。

​

gateway.bind を tailnet に設定したのにバインドできず、何も待ち受けません

• その host で Tailscale を起動する（100.x の address を持たせる）、または
• gateway.bind: "loopback" / "lan" に切り替えてください。

​

同じ host 上で複数のゲートウェイを実行できますか

• OPENCLAW_CONFIG_PATH（インスタンス ごとの 設定）
• OPENCLAW_STATE_DIR（インスタンス ごとの state）
• agents.defaults.workspace（ワークスペース の分離）
• gateway.port（一意なポート）

• インスタンス ごとに openclaw --profile <name> … を使ってください（~/.openclaw-<name> が自動作成されます）。
• 各 プロファイル 設定 で一意の gateway.port を設定してください（または手動実行時に --port を渡してください）。
• プロファイル ごとの サービス を install してください: openclaw --profile <name> gateway install。

​

invalid handshake code 1008 とは何を意味しますか

• HTTP URL（http://...）を browser で開いてしまい、WS client を使っていない。
• port または path が間違っている。
• proxy または tunnel が auth header を削除したか、ゲートウェイ ではない request を送っている。

1. WS URL を使ってください: ws://<host>:18789（HTTPS の場合は wss://...）。
2. WS port を通常の browser tab で開かないでください。
3. 認証が有効なら、connect frame に トークン / パスワード を含めてください。

openclaw tui --url ws://<host>:18789 --token <token>

​

ログとデバッグ

​

ログはどこにありますか

/tmp/openclaw/openclaw-YYYY-MM-DD.log

openclaw logs --follow

• macOS: $OPENCLAW_STATE_DIR/logs/gateway.log と gateway.err.log（既定: ~/.openclaw/logs/...。プロファイル使用時は ~/.openclaw-<profile>/logs/...）
• Linux: journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager
• Windows: schtasks /Query /TN "OpenClaw Gateway (<profile>)" /V /FO LIST

​

ゲートウェイサービスを開始/停止/再起動するには

openclaw gateway status
openclaw gateway restart

​

Windows でターミナルを閉じてしまった場合 OpenClaw を再起動するには

wsl
openclaw gateway status
openclaw gateway restart

openclaw gateway run

openclaw gateway status
openclaw gateway restart

openclaw gateway run

​

ゲートウェイは起動しているのに返信が届かない場合何を確認すべきですか

openclaw status
openclaw models status
openclaw channels status
openclaw logs --follow

• モデル認証情報が ゲートウェイ ホスト に読み込まれていない（models status を確認）。
• Channel のペアリング/許可リストにより返信がブロックされている（Channel 設定とログを確認）。
• WebChat/Dashboard が正しいトークンなしで開かれている。

​

ゲートウェイから理由なく切断された場合はどうすればよいですか

1. ゲートウェイ は動作していますか。openclaw gateway status
2. ゲートウェイ は健全ですか。openclaw status
3. UI は正しいトークンを使用していますか。openclaw dashboard
4. リモート環境の場合、トンネル/Tailscale 接続は有効ですか。

openclaw logs --follow

​

Telegram の setMyCommands がネットワークエラーで失敗する場合何を確認すべきですか

openclaw channels status
openclaw channels logs --channel telegram

​

TUI に何も表示されない場合何を確認すべきですか

openclaw status
openclaw models status
openclaw logs --follow

​

ゲートウェイを完全に停止してから再起動するには

openclaw gateway stop
openclaw gateway start

openclaw gateway run

​

ELI5 openclaw ゲートウェイ restart と openclaw ゲートウェイの違い

• openclaw gateway restart: バックグラウンドサービス（launchd/systemd）を再起動します。
• openclaw gateway: このターミナルセッションで ゲートウェイを フォアグラウンド 実行します。

​

何かが失敗したときに最速で詳細を取得する方法は何ですか

​

メディアと添付ファイル

​

My スキル generated an image/PDF but nothing was sent

openclaw message send --target +15555550123 --message "Here you go" --media /path/to/file.png

• 対象チャネルが送信メディアに対応しており、allowlist によってブロックされていないこと。
• ファイルがプロバイダーのサイズ上限内であること（画像は最大 2048px にリサイズされます）。

​

セキュリティとアクセス制御

​

OpenClaw を受信 DM に公開しても安全ですか

• DM 対応チャネルでのデフォルト動作は pairing です:
  • 未知の送信者には ペアリングコード が送られ、ボット はそのメッセージを処理しません。
  • 承認コマンド: openclaw pairing approve --channel <channel> [--account <id>] <code>
  • 保留中のリクエストは チャネルごとに 3 件 までです。code が届いていない場合は openclaw pairing list --channel <channel> [--account <id>] を確認してください。
• DM を公開で開放するには、明示的な opt-in が必要です (dmPolicy: "open" と allowlist "*"）。

​

プロンプトインジェクションは公開ボットだけの懸念ですか

• 信頼できないコンテンツの要約には、read-only または tool-disabled の “reader” エージェント を使う
• tool-enabled エージェント では web_search / web_fetch / browser を無効にしておく
• sandboxing と厳格な tool allowlist を使う

​

ボット専用の email、GitHub account、または phone number を持たせるべきですか

​

自分の text messages に対する自律性を与えてもよいですかまたそれは安全ですか

• DM は pairing mode または厳格な allowlist のままにする。
• あなたの代わりにメッセージを送らせたい場合は、別の number または account を使う。
• 下書きを作らせ、送信前に承認する。

​

個人アシスタント用途では、より安価なモデルを使えますか

​

Telegram で start を実行したのにペアリングコードが届きません

openclaw pairing list telegram

​

WhatsApp で連絡先にメッセージを送りますか Pairing はどのように機能しますか

openclaw pairing approve whatsapp <code>

openclaw pairing list whatsapp

​

チャットコマンド、タスクの中断、「止まらない」場合

​

チャットに内部システムメッセージが表示されないようにするには

/verbose off
/reasoning off

​

実行中のタスクを停止または中断するには

stop
stop action
stop current action
stop run
stop current run
stop agent
stop the agent
stop openclaw
openclaw stop
stop don't do anything
stop do not do anything
stop doing anything
please stop
stop please
abort
esc
wait
exit
interrupt

process action:kill sessionId:XXX

​

Telegram から Discord にメッセージを送ろうとすると Cross-context messaging denied になるのはなぜですか

{
  agents: {
    defaults: {
      tools: {
        message: {
          crossContext: {
            allowAcrossProviders: true,
            marker: { enabled: true, prefix: "[from {channel}] " },
          },
        },
      },
    },
  },
}

​

メッセージを連投するとボットが無視しているように感じるのはなぜですか

• steer - 新しいメッセージが現在のタスクを誘導し直します
• followup - メッセージを 1 件ずつ順番に実行します
• collect - メッセージをまとめて 1 回だけ返信します（デフォルト）
• steer-backlog - 今のタスクを誘導し直したうえで、あとから backlog を処理します
• interrupt - 現在の run を中断して新しく開始します

​

スクリーンショット/チャットログの正確な質問に答える