​

よくある質問

​

目次

• [クイックスタートと初回セットアップ]
  • 詰まっています。最速で抜け出す方法は？
  • OpenClaw をインストールしてセットアップする推奨方法は？
  • オンボーディング後にダッシュボードを開くには？
  • localhost とリモートで、ダッシュボードの認証（トークン）はどう違いますか？
  • 必要なランタイムは？
  • Raspberry Pi で動きますか？
  • Raspberry Pi へのインストールのコツはありますか？
  • それは「私の友人を目覚めさせる」/オンボーディングは孵化しませんでした。 今何ですか?
  • オンボーディングをやり直さずに新しいマシン（Mac mini）へ移行できますか？
  • 最新バージョンの変更点はどこで確認できますか？
  • Docs.openclaw.ai(SSLエラー)にアクセスできません。 今何ですか?
  • stable と beta の違いは何ですか？
  • beta 版のインストール方法と、beta と dev の違いは？
  • 最新のビルドを試すには？
  • インストールとオンボーディングには通常どれくらいかかりますか？
  • Installer stuck? もっとフィードバックを得るにはどうすればいいですか?
  • Windows で git が見つからない、または openclaw が認識されないと表示されます
  • ドキュメントで解決しませんでした。より良い回答を得るには？
  • Linux に OpenClaw をインストールするには？
  • VPS に OpenClaw をインストールするには？
  • クラウド / VPS 向けのインストールガイドはどこにありますか？
  • OpenClaw に自己更新させることはできますか？
  • オンボーディングウィザードは実際に何をしますか？
  • 実行には Claude や OpenAI のサブスクリプションが必要ですか？
  • API キーなしで Claude Max サブスクリプションを使えますか？
  • Anthropic の setup-token 認証はどのように動作しますか？
  • Anthropic の setup-token はどこで取得できますか？
  • Claude のサブスクリプション認証（Claude Pro / Max）をサポートしていますか？
  • Anthropic から HTTP 429 ratelimiterror が表示されるのはなぜですか？
  • AWS Bedrock はサポートされていますか？
  • Codex の認証はどのように動作しますか？
  • OpenAI サブスクリプション認証（Codex OAuth）をサポートしていますか？
  • Gemini CLI OAuth の設定方法は？
  • カジュアルなチャットにローカルモデルは適していますか？
  • ホスト型モデルの通信を特定リージョンに限定するには？
  • インストールのために Mac mini を購入する必要はありますか？
  • iMessage のサポートに Mac mini は必要ですか？
  • Mac mini で OpenClaw を動かし、MacBook Pro から接続できますか？
  • Bun は使えますか？
  • Telegram: allowFrom には何を入れますか？
  • 1 つの WhatsApp 番号を複数の OpenClaw インスタンスで使えますか？
  • 高速チャット用エージェントと、コーディング用 Opus エージェントを同時に動かせますか？
  • Homebrew は Linux でも動きますか？
  • hackable（git）インストールと npm インストールの違いは？
  • 後から npm と git インストールを切り替えられますか？
  • Gateway はノート PC と VPS のどちらで動かすべきですか？
  • 専用マシンで OpenClaw を動かす重要性はどれくらいですか？
  • VPS の最小要件と推奨 OS は？
  • VM 上で OpenClaw を実行できますか？ 要件は？
• OpenClaw とは？
  • [OpenClawとは何ですか?] (#what-is-openclaw-in-one-paragraph)
  • 価値提案は何ですか？
  • 最初に何をすべきかを設定しました
  • OpenClaw の日常的なトップ 5 のユースケースは何ですか
  • OpenClaw は SaaS 向けのリード獲得アウトリーチ広告やブログに役立ちますか
  • ウェブ開発におけるクロード・コードに対する利点は何ですか?
• Skills と自動化
  • リポジトリを汚さずにスキルをカスタマイズするには？
  • カスタムフォルダからスキルを読み込むことはできますか?
  • 異なるタスクに異なるモデルをどのように使用できますか?
  • [The bot freezes while do heading work. ボットが重い仕事をしながらフリーズする。 どうすればそれをオフロードできますか?
  • Cronまたはリマインダーは発火しません。 何をチェックすればいいですか?
  • Linux にスキルをインストールするにはどうすればいいですか?
  • OpenClaw はスケジュール実行やバックグラウンドでの継続実行ができますか？
  • Apple macOSのみのスキルをLinuxから実行できますか?
  • [Notion か HeyGen 統合がありますか？] (#do-you-have-a-notion-or-heygen-integration)
  • ブラウザの乗っ取りにChrome拡張機能をインストールするにはどうすればいいですか?
• サンドボックスとメモリ
  • 専用のサンドボックス作成ドキュメントはありますか?
  • ホストフォルダを Sandbox にバインドするにはどうすればよいですか?
  • メモリはどのように動作しますか?
  • [記憶は物事を忘れ続ける] スティックを作るにはどうすればいいですか?](#memory-keeps-forgetting-things-how-do-i-make-it-stick)
  • メモリは永遠に持続しますか? 限界は何ですか?
  • Semantic memory search requires an OpenAI API key?
• ディスク上の配置
  • OpenClawのデータはすべてローカルに保存されますか?
  • OpenClaw のデータはどこに保存されますか？
  • AGENTS.md / SOUL.md / USER.md / MEMORY.md live?
  • 推奨されるバックアップ戦略は何ですか?
  • どうすればOpenClawを完全にアンインストールできますか?
  • エージェントはワークスペース外で動作できますか？
  • I in remote mode - where the session store?
• 設定の基本
  • 設定のフォーマットは? どこにありますか?
  • gateway.bind: "lan" (または "tailnet")を設定し、現在は何もリッスンせず/UIが許可されていない
  • なぜ localhost にトークンが必要なのですか?
  • 設定を変更してから再起動する必要がありますか?
  • Web 検索(および Web フェッチ)を有効にするにはどうすればいいですか?
  • [config.apply ]設定を消去しました。 これを回避するにはどうすればいいですか?](#configapply-wiped-my-config-how-do-i-recover-and-avoid-this)
  • デバイス間で専門的なワーカーを使用して中央ゲートウェイを実行するにはどうすればよいですか?
  • OpenClawブラウザはヘッドレスで動作できますか?
  • ブラウザ操作に Brave を使うには？
• リモート Gateway とノード
  • Telegram、ゲートウェイ、ノード間でコマンドが伝播するにはどうすればよいですか?
  • ゲートウェイがリモートホストされている場合、エージェントはどうやってコンピュータにアクセスできますか?
  • [Tailscale is connected but I get no replies. Tailscale is connected but I get no replies(私は返信を得ない。 今何ですか?
  • 2 つの OpenClawインスタンスが互いに通信できますか(ローカル + VPS)?
  • 複数エージェントに別々の VPS は必要ですか
  • VPSからSSHではなく個人用ラップトップでノードを使用するメリットはありますか?
  • [ノードはゲートウェイサービスを実行しますか?] (#do-nodes-run-a-gateway-service)
  • 設定を適用するAPI/RPC方法はありますか?
  • 最初のインストールで最小限の “正しい” 設定とは何ですか?
  • TailscaleをVPSに設定し、Macから接続するにはどうすればいいですか?
  • Mac ノードをリモートゲートウェイ(Tailscale Serve)に接続するにはどうすればいいですか?
  • 2 台目のラップトップにインストールするか、ノードを追加する必要がありますか?
• 環境変数と .env の読み込み
  • OpenClawの環境変数はどのようにロードされますか?
  • “私はサービス経由でゲートウェイを開始し、私のEnv varsが消えました。 今何ですか?
  • COPILOT_GITHUB_TOKEN に設定しましたが、モデルの状態は “Shell env: off” になります。 なぜですか?
• セッションと複数チャット
  • How do I start a new conversation?
  • [/newを送信しないとセッションが自動的にリセットされますか？]（#do-sessions-reset-automatically-if-i-never-send-new）
  • OpenClaw インスタンスの 1 つの CEO と多くのエージェントのチームを作る方法はありますか
  • なぜコンテキストが途中で切り捨てられたのでしょうか? どうすれば防げますか?
  • OpenClawを完全にリセットするにはどうすればいいですか?
  • コンテキストが大きすぎます。リセットまたはコンパクトにするにはどうすればいいですか？
  • なぜ LLM リクエストが拒否されましたか? messages.N.content.X.tool_use.input: フィールドが必要です”?
  • なぜ 30 分おきにハートビートのメッセージを受け取るのですか?
  • WhatsAppグループに「ボットアカウント」を追加する必要がありますか？
  • WhatsAppグループのJIDを取得するにはどうすればいいですか?
  • なぜOpenClawはグループで返信しないのですか？
  • グループ/スレッドはDMとコンテキストを共有しますか?
  • ワークスペースとエージェントはいくつ作成できますか？
  • 複数のボットやチャットを同時に実行できますか(Slack)、そしてどのように設定すればいいですか?
• モデル: デフォルト、選択、エイリアス、切り替え
  • デフォルトモデルとは?
  • どのモデルをおすすめしますか？
  • 設定を消さずにモデルを切り替えるにはどうすればいいですか?
  • 自己ホストモデル(llama.cpp, vLLM, Ollama)を使用できますか?
  • OpenClaw、Flawd、およびKrillがモデルに何を使用するか?
  • モデルをオンザフライで(再起動せずに)切り替えるにはどうすればいいですか?
  • 毎日のタスクにGPT 5.2を、コーディングにコーデック5.3を使用できます
  • Why do I see “Model … は許可されていません。そして返信しませんか？
  • Unknown model: minimax/MiniMax-M2.1”が表示されるのはなぜですか?
  • MiniMax をデフォルトとして、OpenAI を複雑なタスクに使用できますか?
  • opus / sonnet / gpt 組み込みショートカットはありますか?
  • モデルショートカットを定義/オーバーライドするにはどうすればいいですか?
  • OpenRouterやZ.AIなどの他のプロバイダからモデルを追加するにはどうすればいいですか?
• モデルのフェイルオーバーと「All models failed」
  • フェイルオーバーはどのように動作しますか?
  • このエラーはどういう意味ですか?
  • Fix checklist for No credentials for profile "anthropic:default"
  • なぜグーグルジェミニも試して失敗したのか?
• 認証プロファイル: 概要と管理方法
  • 認証プロファイルとは何ですか?
  • 一般的なプロファイルIDは何ですか？
  • どの認証プロファイルが最初に試されるかを制御できますか?
  • OAuth vs API キー: 違いは何ですか?
• Gateway: ポート、「すでに実行中」、リモートモード
  • Gatewayはどのポートを使用しますか？
  • openclaw gateway status は Runtime: running と RPCprobe: failed と言うのはなぜですか？
  • openclaw gateway status が Config (cli) と Config (service) と異なるのはなぜですか？
  • “別のゲートウェイインスタンスが既にリッスンしている”とはどういう意味ですか?
  • リモートモードでOpenClawを実行するにはどうすればよいですか(クライアントはどこか他のゲートウェイに接続します)?
  • Control UI が「許可されていない」(または再接続を続ける)と表示されます。 今何ですか?
  • gateway.bind: "tailnet"に設定しましたが、バインドできません/何もリッスンできません
  • 同じホストで複数のゲートウェイを実行できますか?
  • 無効なハンドシェイク/コード 1008 はどういう意味ですか？
• ログとデバッグ
  • ログはどこにありますか？
  • ゲートウェイサービスを開始/停止/再起動するにはどうすればよいですか?
  • Windows 上で端末を閉じました - どうやってOpenClawを再起動しますか?
  • ゲートウェイは稼働していますが、応答が届きません。 何をチェックすればいいですか?
  • “ゲートウェイから切断されました: 理由なし” - 今何ですか?
  • Telegram setMyCommands fails with network errors. 何をチェックすればいいですか?
  • TUI は出力を表示しません。 何をチェックすればいいですか?
  • ゲートウェイを完全に停止するにはどうすればいいですか？
  • ELI5: openclaw gateway restart と openclaw gateway の違いは？
  • 何かが失敗したときに詳細を取得する最速の方法は何ですか?
• メディアと添付ファイル
  • スキルが画像/PDFを生成しましたが、何も送信されませんでした
• セキュリティとアクセス制御
  • OpenClawをインバウンドDMに公開しても安全ですか?
  • プロンプトインジェクションはパブリックボットの関心だけですか?
  • ボット専用のメール、GitHubアカウント、または電話番号を用意すべきですか？
  • テキストメッセージの自律的な操作を任せることはできますか？また、それは安全ですか？
  • パーソナルアシスタントに安価なモデルを使用できますか?
  • Telegram で /start を実行しましたが、ペアリングコードが見つかりませんでした
  • WhatsApp:それは私の連絡先にメッセージを送信しますか? ペアリングはどのように機能しますか?
• チャットコマンド、タスク中断、「止まらない」問題
  • How do I stop internal system messages from showing in chat
  • 実行中のタスクを停止/キャンセルするにはどうすればいいですか?
  • TelegramからDiscordメッセージを送信するにはどうすればいいですか？ (“Cross-context messaging denied”)
  • [ボットが素早い発火メッセージを「無視」するのはなぜですか？]（#why-does-it-feel-like-the-bot-ignores-rapidfire-messages）

​

もし何かが壊れている場合、最初の60秒

1. クイックステータス（最初のチェック）
   openclaw status
   
   Fast local summary: OS + update, gateway/service reachability, agents/sessions, provider config + runtime issues (ゲートウェイに到達可能な場合).
2. 貼り付け可能なレポート (安全に共有できます)
   openclawの状態 --all
   
   ログテール付きの読み取り専用の診断 (トークンが削除されました)。
3. デーモン+ポート状態
   openclaw gateway status
   
   スーパーバイザランタイム対RPC到達性、プローブターゲットURL、およびおそらく使用されているサービスの設定を表示します。
4. Deep probes
   openclawの状態 --deep
   
   ゲートウェイのヘルスチェック+プロバイダプローブを実行します (到達可能なゲートウェイが必要です)。 Health を参照してください。
5. 最新のログを記録
   openclaw logs --follow
   
   RPCがダウンした場合は、以下に戻ります：
   tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"
   
   ファイルログはサービスログとは別のものです; Logging と Troubleshooting を参照してください。
6. 医師を実行（修理）
   openclaw doctor
   
   Repairs/migrates config/state + はヘルスチェックを実行します。 Doctor を参照してください。
7. Gateway snapshot
   openclaw health --json
   openclaw health --verbose # エラー時にターゲット URL + config pathを表示する
   
   フルスナップショット(WSのみ)の実行中のゲートウェイに尋ねます。 Health を参照してください。

​

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

​

イムはスタックを解除するための最速の方法をスタックしました

• クロードコード: 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状態
openclawモデル状態
openclaw doctor

• openclaw status: gateway/agent health + basic configのクイックスナップショット。
• openclawモデルの状態: プロバイダの認証+モデルの可用性をチェックします。
• openclaw doctor: 一般的な設定/状態の問題を検証および修復します。

​

OpenClawのインストールとセットアップの推奨方法は？

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

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build # auto-installs UI deps on first run
openclawオン

​

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

​

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

• http://127.0.0.1:18789/を開きます。
• authを要求する場合は、gateway.auth.token (または OPENCLAW_GATEWAY_TOKEN ) からトークンをControl UI 設定に貼り付けます。
• ゲートウェイ ホストから取得します: openclaw config get gate gateway.auth.token (または 1 つを生成: openclaw doctor --generate-gateway-token )。

• tailscale Serve (推奨): バインドループバックを維持し、openclaw gateway --tailscale serveを実行し、https://<magicdns> /を開きます。 gateway.auth.allowTailscale が true の場合、アイデンティティヘッダーは auth (トークンなし) を満たします。
• Tailnet bind: run openclaw gateway --bindtailnet --token "<token>", open http://<tailscale-ip>:18789/, paste token
• SSHトンネル: ssh -N -L 18789:127.0.0.1:18789 user@hostを開き、http://127.0.0.1:18789/を開き、Control UI設定でトークンを貼り付けます。

​

どのランタイムが必要ですか？

​

Raspberry Pi で実行しますか？

​

Raspberry Pi がインストールするためのヒント

• 64ビット OSを使用し、ノード>= 22を維持します。
• hackable (git) インストールを好むので、ログを見ることができ、更新が速くなります。
• チャネル/スキルなしで開始し、それらを1つずつ追加します。
• もしあなたが変なバイナリ問題に遭遇した場合、通常は ARM 互換 の問題になります。

​

それは私の友人のオンボーディングは孵化しません目を覚ます上で立ち往生している 今何を今

1. ゲートウェイを再起動:

openclaw gateway restart

2. ステータスの確認 + 認証:

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ドクターを実行し、ゲートウェイサービスを再起動します。

​

最新バージョンの新機能はどこで確認できますか？

​

docs.openclaw.ai にアクセスできません（SSL エラー）。どうすればいいですか？

​

安定版とベータ版の違いは？

• latest = stable
• beta = テスト用の初期ビルド

​

ベータ版と開発者の違いをインストールするにはどうすればいいですか？

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

​

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

• インストール: 2-5分
• オンボーディング: 設定したチャンネル数/モデル数に応じて5-15 分

​

最新のビットを試してみる方法

1. 開発チャンネル(git checkout):

openclawアップデート --channel dev

2. ハッキング可能なインストール(インストーラーサイトから):

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

​

Windowsのインストールでは、git が見つからないか、openclawが認識されていないと表示されます

• Git for Windowsをインストールし、gitがPATH上にあることを確認してください。
• PowerShell を閉じて再起動し、インストーラを再実行します。

• npm global bin フォルダーが PATH にありません。
• パスを確認:
  npm config get prefix
  
• <prefix>\\binがPATH上にあることを確認します（ほとんどのシステムでは%AppData%\\npm）。
• PATHを更新した後、PowerShellを閉じて再び開きます。

​

ドキュメントは、より良い答えを得るにはどうすればよい私の質問に答えませんでした。

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

​

OpenClawをLinuxにインストールする方法

• Linux quick path + service install: Linux.
• Full walkthrough: Getting Started.
• インストーラ+アップデート: Install & updates.

​

VPSにOpenClawをインストールする方法

​

cloudVPSのインストールガイド

• VPSホスティング (すべてのプロバイダーが1つの場所にあります)
• 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の更新 --yes --no-restart
openclawゲートウェイ再起動

​

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

• Model/auth setup (Anthropic setup-token for Claude subscriptions, OpenAI Codex OAuth supported, API keys optional, LM Studio local models)
• ワークスペース の場所 + ブートストラップファイル
• ゲートウェイ設定 (bind/port/auth/tailscale)
• プロバイダー (WhatsApp, Telegram, Discord, Mattermost (plugin), Signal, iMessage)
• デーモンインストール (macOSでLaunchAgent; systemd user unit on Linux/WSL2)
• 健康チェック と スキル 選択

​

これを実行するにはClaudeまたはOpenAIサブスクリプションが必要ですか？

​

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

​

Anthropic setuptoken認証の仕組み

​

Anthropic setuptokenはどこにありますか？

claude setup-token

​

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

​

Anthropic から HTTP 429 ratelimiterror が表示されるのはなぜですか？

​

Is AWS Bedrock supported

​

Codex authの仕組み

​

OpenAIサブスクリプション認証コードをサポートしていますか？

​

Gemini CLI OAuthの設定

1. プラグインを有効にする: openclawプラグインを有効にするgoogle-gemini-cli-auth
2. ログイン: openclaw models auth login --provider google-gemini-cli --set-default

​

ローカルモデルはカジュアルなチャットでOKです

​

特定の地域でホストされているモデルトラフィックを維持するにはどうすればよいですか？

​

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

​

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

• Linux/VPS上でゲートウェイを実行し、メッセージにサインインしたMac上でBlueBubblesサーバーを実行します。
• 最も単一マシンのセットアップが必要な場合は、Mac上のすべてを実行します。

​

Mac miniを購入してOpenClawを実行すると、MacBook Proに接続できますか?

• Mac miniのゲートウェイ(常時オン)。
• MacBook Proは、macOSアプリまたはノードホストを実行し、Gatewayにペアを設定します。
• openclaw nodes status / openclaw nodes list を使用してください。

​

Bun を使用できますか?

​

許可されているものをTelegram

• ボットにDMを付けて、openclawログ --follow を実行し、from.id を読み込みます。

• ボットにDMをかけ、https://api.telegram.org/bot<bot_token>/getUpdates を呼び出し、message.from.id を読み込みます。

• DM @userinfobot または @getidsbot 。

​

複数の人が異なるOpenClawインスタンスで1つのWhatsApp番号を使用することができます。

​

高速チャットエージェントとコーディングエージェントの Opus を実行できますか?

​

HomebrewはLinuxで動作しますか？

/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 install と npm install の違いは何ですか？

• Hackable (git) install: full source checkout, editable, best for contributors. ローカルでビルドを実行し、コード/ドキュメントにパッチを適用できます。
• npm install: global CLI install, no repo, best for “just run it”. 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: サーバーコストはなく、ローカルファイル、ライブブラウザウィンドウに直接アクセスできます。
• 短所: sleep/network drops = disconnects, OS の更新/再起動の中断, スリープ状態を維持する必要があります。

• Pros: 常にオン、安定したネットワークで、ラップトップの睡眠の問題はありません。簡単に実行できます。
• Cons: よくヘッドレスで（スクリーンショットを使用）リモートファイルアクセスのみを実行します。SSHで更新する必要があります。

​

OpenClawを専用のマシンで実行することがどれほど重要か

• 専用ホスト (VPS/Mac mini/Pi): 常時オン、スリープ/再起動の中断の少ない、クリーンなパーミッション、実行し続けるのが簡単。
• 共有されたラップトップ/デスクトップ： テストやアクティブな使用には問題ありませんが、マシンがスリープやアップデートを行うと一時停止することを期待しています。

​

最小VPS要件と推奨OS

• Absolute minimum: 1 vCPU, 1GB RAM, ~500MB ディスク.
• 推奨： 1-2 vCPU、2GB RAM以上のヘッドルーム（ログ、メディア、複数のチャンネル）。 ノードツールとブラウザーの自動化は、リソースに飢えている可能性があります。

​

OpenClawをVMで実行することはできますか?

• 絶対最小限: 1 vCPU, 1GB RAM.
• 推奨: 複数のチャンネル、ブラウザの自動化、またはメディアツールを実行している場合は、2GB RAM以上。
• OS: Ubuntu LTSまたは他のモダンなDebian/Ubuntu.

​

What is OpenClaw?

​

1つの段落のOpenClawとは

​

価値提案の内容

• お使いのデバイス、データ: ご希望の場所(Mac、Linux、VPS)でゲートウェイを実行し、 ワークスペース + セッション履歴をローカルに保持します。
• 実際のチャンネル、ウェブサンドボックスではありません: WhatsApp/Telegram/Slack/Discord/Signal/iMessage/etc、 プラスモバイル音声とCanvas 対応プラットフォーム。
• Model-agnostic: Anthropic, OpenAI, MiniMax, OpenRouterなどをエージェントごとのルーティング とフェイルオーバーで使用します。
• ローカルのみのオプション: ローカルモデルを実行すると、すべてのデータがあなたのデバイスに残る ことができます。
• マルチエージェントのルーティング: チャンネル、アカウント、またはタスクごとに、それぞれ独自の ワークスペースとデフォルトを持つエージェントを分けます。
• オープンソースとハッキング可能: ベンダーロックインなしで、検査、拡張、およびセルフホストを行います。

​

最初に何をすべきかを設定しました

• ウェブサイト(WordPress、Shopify、またはシンプルな静的サイト)を構築します。
• モバイルアプリ(概要、画面、APIプラン)をプロトタイプ化します。
• ファイルとフォルダを整理します(クリーンアップ、名前付け、タグ付け)。
• Gmailを接続し、概要やフォローアップを自動化します。

​

OpenClawの毎日のトップ5のユースケースは何ですか？

• パーソナルブリーフィング: 受信トレイ、カレンダー、あなたが気になるニュースの概要。
• 研究と製図: メールやドキュメントの簡単なリサーチ、概要、および最初のドラフト。
• リマインダーとフォローアップ： cronまたはheartbeat駆動のnudgesとチェックリスト。
• ブラウザの自動化: フォームを入力し、データを収集し、Webタスクを繰り返します。
• クロスデバイスの座標 スマートフォンからタスクを送信し、ゲートウェイにサーバー上でタスクを実行させ、結果をチャットに戻します。

​

OpenClawはSaaSのリード世代の広告やブログを支援できますか？

​

Web開発のためのクロードコードとの利点は何ですか

• セッションごとに永続的なメモリ + ワークスペース
• マルチプラットフォームアクセス (WhatsApp, Telegram, TUI, WebChat)
• ツールオーケストレーション (ブラウザ、ファイル、スケジュール、フック)
• 常時オンゲートウェイ (VPS上で動作し、どこからでも動作します)
• Nodes ローカルブラウザ/スクリーン/カメラ/exec

​

スキルと自動化

​

レポを汚さずにスキルをカスタマイズする方法

​

カスタムフォルダからスキルを読み込むことはできますか？

​

異なるタスクに異なるモデルを使用する方法

• Cron jobs: ジョブごとに「モデル」オーバーライドを設定できます。
• サブエージェント: 異なるデフォルトモデルを持つ別のエージェントにタスクをルーティングします。
• オンデマンドスイッチ: /model を使用して、いつでも現在のセッションモデルを切り替えます。

​

作業中にボットがフリーズします。どうすればオフロードできますか？

​

Cronまたはリマインダーを起動しない

• Confirm cron is enabled (cron.enabled) and OPENCLAW_SKIP_CRON is not set
• ゲートウェイが24時間365日稼働していることを確認してください(睡眠/再起動なし)。
• ジョブのタイムゾーン設定を確認します (--tz vs ホストのタイムゾーン)。

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

​

Linuxにスキルをインストールする方法

npm i -g clawhub

pnpm add -g clawhub

​

OpenClawはスケジュールまたはバックグラウンドで連続的にタスクを実行できます。

• スケジュールされたタスクまたは繰り返されるタスクのCronジョブ (再起動後も継続します)。
• Heartbeat は「メインセッション」の定期的なチェックを行います。
• サマリーを投稿したりチャットに配信したりする自律エージェントの 単離されたジョブ

​

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

1. バイナリの SSH ラッパーを作成します (例: Apple Notes の memo )。
   #!/usr/bin/env bash
   set -euo pipefail
   exec ssh -T user@mac-host /opt/homebrew/bin/memo "$@"
   
2. PATHのラッパーをLinuxホストに置きます（例えば~/bin/memo）。
3. Linuxを許可するには、スキルメタデータ (ワークスペースまたは ~/.openclaw/skills) を上書きします。
   ---
   name: apple-notes
   description: Manage Apple Notes via the memo CLI on macOS.
   metadata: { "openclaw": { "os": ["darwin", "linux"], "requires": { "bins": ["memo"] } } }
   ---
   
4. スキルスナップショットが更新されるように、新しいセッションを開始します。

​

NotionまたはHeyGen統合をお持ちですか？

• カスタムスキル/プラグイン: 信頼性の高い API アクセスに最適です (注意/HeyGen 両方に API があります)。
• ブラウザの自動化はコードなしで動作しますが、より遅く壊れやすいです。

• クライアントごとに1つの通知ページ (コンテキスト + 環境設定 + アクティブな作業)。
• エージェントにセッションの開始時にそのページを取得するように依頼します。

clawhubのインストール <skill-slug>
clawhubの更新 --all

​

ブラウザの乗っ取りにChrome拡張機能をインストールする方法

openclaw browser extension install
openclaw browser extension path

​

サンドボックス化とメモリ

​

サンドボックス作成専用のドキュメントがありますか？

​

Dockerの気分は限られています フル機能を有効にするにはどうすればいいですか?

• OPENCLAW_HOME_VOLUME で /home/node を保持し、キャッシュは生き残ります。
• OPENCLAW_DOCKER_APT_PACKAGES を使用してシステムデップを画像に焼きます。
• バンドルされた CLI 経由で Playwrite ブラウザーをインストールします: node /app/node_modules/playwright-core/cli.js install chromium
• PLAYWRIGHT_BROWSERS_PATH を設定し、パスが保持されていることを確認します。

​

ホストフォルダを Sandbox にバインドする方法

​

メモリの仕組みを教えてください

• 毎日のノート (memory/YYYY-MM-DD.md)
• MEMORY.md でキュレートされた長期ノート (メイン/プライベートセッションのみ)

​

物事を忘れてしまい続けるメモリ どのように棒状にするか

​

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

​

メモリが永続的に保持されますか?

​

物事がディスク上にある場所

​

ローカルに保存されたOpenClawで使用されるすべてのデータです

• Local by default: sessions, memory files, config, and workspace live on the Gateway host (~/.openclaw + your workspace directory).
• 必要に応じてリモート: モデルプロバイダ（Anthropic/OpenAI/etc）に送信するメッセージ。 go to their APIs, and chat platforms (WhatsApp/Telegram/Slack/etc.) サーバーにメッセージデータを保存します。
• あなたは足跡を制御します: ローカルモデルを使用してあなたのマシンのプロンプトを保持しますが、チャンネル のトラフィックはまだチャネルのサーバーを通過します。

​

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

​

AGENTSmd SOULmd USERmd MEMORYmd はどこに住むべきか

• ワークスペース (エージェントごと): AGENTS.md, SOUL.md, IDENTITY.md, USER.md, MEMOORY.md (または memory.md), memory/YYYY-MM-DD.md, オプションの HEARTBEAT.md.
• State dir (~/.openclaw): config, credentials, auth profiles, sessions, logs, and shared skills (~/.openclaw/skills).

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

​

推奨されるバックアップ戦略

​

OpenClawを完全にアンインストールする方法

​

エージェントはワークスペースの外で作業できますか？

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

​

Im in remote mode where the session store

​

設定の基本

​

設定のフォーマットはどこにありますか？

$OPENCLAW_CONFIG_PATH

​

gatewaybindlanまたはtailnetを設定しました。今はUIが不正であることを聞くものはありません。

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

• gateway.remote.token は remote CLI calls のみで、ローカルゲートウェイ認証を有効にしません。
• Control UI は connect.params.auth.token (app/UI 設定に保存されています) を介して認証します。 URLにトークンを入れないようにします。

​

なぜ今すぐlocalhostにトークンが必要なのですか？

​

設定を変更した後に再起動する必要がありますか？

• gateway.reload.mode: "hybrid" (デフォルト): ホット適用される安全な変更、重要なもののために再起動します。
• hot 、 restart 、 off もサポートされています

​

Web検索とWebフェッチを有効にする方法

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

• allowlistsを使用する場合は、 web_search/web_fetch または group:web を追加します。
• web_fetch は、明示的に無効化されない限りデフォルトで有効です。
• デーモンは ~/.openclaw/.env (またはサービス環境) から env vars を読み込みます。

​

デバイス間で専門的なワーカーを使用して中央ゲートウェイを実行する方法

• Gateway (central): チャンネル(Signal/WhatsApp)、ルーティング、セッションを所有しています。
• ノード (デバイス): Macs/iOS/Androidは周辺機器として接続し、ローカルツール (system.run, canvas, camera) を公開します。
• エージェント（ワーカー）： 特別な役割のための脳/ワークスペース（例：「Hetzner ops」、「個人データ」）。
• サブエージェント: 並列化したいときにメインエージェントからバックグラウンドワークを生成します。
• TUI: ゲートウェイに接続し、エージェント/セッションを切り替えます。

​

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

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

• ブラウザウィンドウが表示されません(画面が必要な場合はスクリーンショットを使用してください)。
• 一部のサイトでは、ヘッドレスモード(CAPTCHA、アンチボット)での自動化についてより厳しいものがあります。 たとえば、X/Twitterはヘッドレスセッションをブロックすることがよくあります。

​

ブラウザーコントロールにBraveを使用する方法

​

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

​

ゲートウェイとノードの間でコマンドが伝播する方法

​

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

1. 常時オンホスト(VPS/ホームサーバー)でゲートウェイを実行します。
2. ゲートウェイホストとコンピューターを同じテールネットに置きます。
3. Gateway WS が到達可能であることを確認します (tailnet バインドまたは SSH トンネル)。
4. macOS アプリをローカルに開き、Remote over SSH モード (または直接テールネット) で接続してノードとして登録できます。
5. ゲートウェイのノードを承認:
   openclaw nodes pending
   openclaw nodes approve <requestId>
   

​

テールスケールは接続されていますが、返信がありません。

• ゲートウェイが実行中: openclawゲートウェイの状態
• ゲートウェイの状態: openclawステータス
• チャネルの状態: openclaw channels status

• Tailscale Servを使用する場合は、gateway.auth.allowTailscaleが正しく設定されていることを確認してください。
• SSH トンネル経由で接続する場合は、ローカルトンネルが上にあり、正しいポートでポイントがあることを確認します。
• 許可リスト(DMまたはグループ)にアカウントが含まれていることを確認します。

​

2つのOpenClawインスタンスがお互いにローカルVPSと通信できます。

openclawエージェント --message "Hello from local bot" --delivery --channel telegram --reply-to <chat-id>

​

複数のエージェントにVPSを分離する必要がありますか？

8. 強力な分離（セキュリティ境界）が必要な場合や、共有したくない大きく異なる設定がある場合にのみ、別々の VPS を使用してください。 それ以外の場合は、1つのゲートウェイと で複数のエージェントまたはサブエージェントを使用してください。

​

VPSからSSHではなく個人用ラップトップでノードを使用する利点はありますか?

9. はい。ノードはリモート Gateway からラップトップに到達するための第一級の手段であり、シェルアクセス以上のことを可能にします。 10. Gateway は macOS/Linux（Windows は WSL2 経由）で動作し、軽量です（小規模な VPS や Raspberry Pi クラスのマシンで十分。RAM 4 GB あれば余裕です）。そのため、常時稼働のホスト + ラップトップをノードとして使う構成が一般的です。

• インバウンドSSHは必要ありません。 ノードはゲートウェイWebSocketに接続し、デバイスのペアリングを使用します。
• より安全な実行コントロール system.run はそのラップトップのノードの許可リスト/承認によって与えられています。
• より多くのデバイスツール ノードはsystem.runに加えてcanvas、camera、そしてscreenを公開します。
• 11. ローカルブラウザ自動化。 Gateway は VPS 上に置いたまま、Chrome はローカルで実行し、Chrome 拡張機能 + ラップトップ上のノードホストで制御を中継します。

​

2台目のラップトップにインストールするかノードを追加する必要があります

​

Do nodes runs a gateway service

​

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

​

configapply wished my config How do I recover this

• バックアップから復元します (git または ~/.openclaw/openclaw.json をコピーしました)。
• バックアップがない場合は、openclaw doctor を再実行し、チャンネル/モデルを再設定します。
• これが想定外の場合は、バグを修正し、最後に既知の設定やバックアップを含めてください。
• ローカルのコーディングエージェントは、しばしばログや履歴から動作する設定を再構築できます。

• 小さな変更には、 openclaw設定セット を使用します。
• 対話的な編集にはopenclaw設定を使用してください。

​

最初にインストールするための最小限の正常な設定とは何ですか？

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

​

VPSでTailscaleを設定し、Macから接続する方法

1. VPSにインストール+ログイン
   curl -fsSL https://tailscale.com/install.sh | sh
   sudo tailscale up
   
2. Macにインストール+ログイン
   • Tailscale アプリを使用して、同じテールネットにサインインします。
3. MagicDNSを有効にする（推奨）
   • Tailscale管理コンソールでMagicDNSを有効にすると、VPSの名前が安定しています。
4. tailnet ホスト名を使用します
   • SSH: ssh [email protected]
   • Gateway WS: ws://your-vps.tailnet-xxxx.ts.net:18789

openclaw gateway --tailscale serve

​

Mac ノードをリモート Gateway Tailscale Serve に接続する方法

1. VPS+Macが同じテールネット上にあることを確認してください。
2. リモートモードでmacOSアプリを使用します (SSHターゲットはテールネットのホスト名にできます)。 アプリはゲートウェイポートをトンネルし、ノードとして接続します。
3. ゲートウェイのノードを承認：
   openclaw nodes pending
   openclaw nodes approve <requestId>
   

​

Env var と .env の読み込み

​

OpenClawが環境変数をロードする方法

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

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

​

私はサービスを介してゲートウェイを開始し、私のenvのvarsは消えました 今何を今。

1. 欠けているキーを ~/.openclaw/.env に入れると、サービスがシェルの env を継承していなくても取り上げられるようになります。
2. シェルのインポートを有効にする (オプトインの利便性):

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

​

COPILOTGITHUBTOKENを設定しましたが、モデルの状態はShellenvをOFFにしています。

1. トークンを ~/.openclaw/.env に入れます。
   COPILOT_GITHUB_TOKEN=...
   
2. またはシェルインポート (env.shellEnv.enabled: true) を有効にします。
3. 設定envブロックに追加します（不足している場合にのみ適用されます）。

openclaw models status

​

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

​

新鮮な会話を始めるには

​

新しいメッセージを送信しない場合、セッションが自動的にリセットされます

{
  session: {
    idleMinutes: 240,
  },
}

​

OpenClawインスタンスのチームを1つのCEOと多くのエージェントにする方法はありますか？

​

コンテキストが途中で切り捨てられたのはなぜですか?

• ボットに現在の状態をまとめてファイルに書き込むように依頼します。
• 長いタスクの前に /compact を、トピックを切り替えるときは /new を使います。
• ワークスペースで重要なコンテキストを保持し、ボットに読み返すように求めます。
• メインチャットが小さくなるように、長または並列作業にサブエージェントを使用します。
• これが頻繁に発生した場合は、コンテキストウィンドウが大きいモデルを選択します。

​

OpenClawを完全にリセットするにはどうすればいいですか？しかし、それをインストールしておいてください

openclaw reset

openclawリセット--scope full --yes --non-interactive

openclaw onboard --install-daemon

• オンボーディングウィザードでは、既存の設定が表示されている場合は リセット も提供されます。 Wizard を参照してください。
• プロファイル(--profile / OPENCLAW_PROFILE)を使用した場合、それぞれの状態ディレクトリをリセットします(デフォルトは ~/.openclaw-<profile>)。
• 開発者リセット: openclaw gateway --dev --reset (dev-only; wipes dev config + credentials + sessions + workspace).

​

コンテキストが大きすぎます。リセットまたはコンパクトにするには、エラーが発生しました

• コンパクト (会話を保持しますが、古い順番をまとめました):
  /compact
  
  または /compact <instructions> を使用して概要を説明します。
• リセット (同じチャットキーの新しいセッションID):
  /new
  /reset
  

• 古いツール出力をトリムするために session pruning (agents.defaults.contextPruning) を有効にするか調整します。
• 大きなコンテキストウィンドウを持つモデルを使用します。

​

LLM要求が拒否されたメッセージを見る理由NcontentXtooluseinputフィールドが必要

​

30分ごとにハートビートメッセージが表示されるのはなぜですか？

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

​

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

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

​

WhatsAppグループのJIDを取得する方法

openclawログ --follow --json

16. @g.us で終わる chatId（または from）を探してください。例: [email protected]。

openclawディレクトリグループリスト --channel whatsapp

​

なぜグループ内でOpenClawの返信がないのか

• メンションゲートがオン（デフォルト）です。 Botを@メンションする必要があります（またはmentionPatternsにマッチします）。
• channels.whatsapp.groupsを`”*“なしで設定し、グループは許可されていません。

​

Do groupssthreads share context with DM

​

作成できるワークスペースとエージェントの数

• ディスクの成長: セッション + トランスクリプトは ~/.openclaw/agents/<agentId>/sessions/ の下で実行されます。
• トークンコスト: エージェントの数が多ければ多いほど、モデルの使用量が多くなります。
• Opsオーバーヘッド： エージェント毎の認証プロファイル、ワークスペース、チャンネルルーティング。

• エージェント (agents.defaults.workspace) につき 1 つの アクティブ ワークスペースを保持します。
• ディスクが成長すると古いセッション(JSONLまたは保存エントリを削除)を削除します。
• 浮遊ワークスペースとプロフィールの不一致を見つけるには、openclaw doctorを使用します。

​

複数のボットやチャットを同時に実行することはできますか? どのように設定すればいいですか?

17. ブラウザアクセスは強力ですが、「人間ができることは何でもできる」わけではありません。アンチボット、CAPTCHA、MFA によって自動化が阻止される場合があります。 最も信頼性の高いブラウザ制御を行うには、ブラウザを実行するマシンのChrome拡張リレー を使用します(どこにでもゲートウェイを維持します)。

• 常時オンゲートウェイホスト (VPS/Mac mini)
• ロールごとに1つのエージェント(バインディング)。
• Slackチャンネルはエージェントに紐付けられています。
• 必要に応じて、拡張リレー(またはノード)を介したローカルブラウザ。

​

モデル: デフォルト、選択、エイリアス、切り替え

​

デフォルトのモデルは何ですか？

agents.defaults.model.primary

​

どのモデルをお勧めしますか？

​

自己ホスト型モデルを使用できますか? llamacpp vLLM Ollama

​

設定を消去せずにモデルを切り替える方法

• /model in chat (quick, persession)
• openclaw models set ... (model configだけ更新)
• openclaw configure --section model (interactive)
• ~/.openclaw/openclaw.jsonでagents.defaults.modelを編集します

​

OpenClaw、Flawd、およびKrillがモデルで使用するもの

• OpenClaw + Flawd: Anthropic Opus (anthropic/claude-opus-4-6) - Anthropic.
• Krill: MiniMax M2.1 (minimax/MiniMax-M2.1) - see MiniMax.

​

再起動せずにモデルをオンザフライで切り替える方法

/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を、コーディングにコーディングにコーディング5.3を使用できますか?

• クイックスイッチ（セッションごと） /model gpt-5.2 を毎日のタスクに使用します。/model gpt-5.3-codex をコーディングに使用します。
• Default + switch: agents.defaults.model.primaryをopenai/gpt-5.2に設定し、コーディング時にはopenai-codex/gpt-5.3-codexに切り替えます。
• サブエージェント: 異なるデフォルトモデルを持つサブエージェントにコーディングタスクをルーティングします。

​

Modelが許可されていないと返信できないのはなぜですか？

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

​

Unknown model minimaxMiniMaxM21 が表示される理由

1. 2026.1.12 にアップグレードしてから、ゲートウェイを再起動してください。
2. MiniMax が設定されていること (ウィザードまたは JSON)、または MiniMax API キー がenv/auth プロファイルに存在していることを確認してください。
3. 正確なモデル id (大文字と小文字を区別する): minimax/MiniMax-M2.1 または minimax/MiniMax-M2.1-lightning を使用します。
4. Run:
   openclaw models list
   
   を選択し、リストから選択します(もしくはチャットの /model list )。

​

MiniMaxをデフォルトとして、OpenAIを複雑なタスクに使用できますか?

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

/model gpt

• エージェント A デフォルト: MiniMax
• エージェントBのデフォルト: OpenAI
• エージェントでルート化するか、 /agent を使用して切り替えます

​

Opus sonnet gpt 組み込みショートカット

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

​

モデルショートカットのエイリアスを定義する方法

20. {
  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などの他のプロバイダからモデルを追加する方法

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

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

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

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

​

モデルのフェイルオーバーと “すべてのモデルが失敗しました”

​

フェイルオーバーの仕組み

1. 認証プロファイルのローテーション
2. agents.defaults.model.fallbacks 内の次のモデルへの モデルフォールバック。

​

このエラーが意味するもの

プロファイル "anthropic:default" の資格情報が見つかりません。

​

プロファイルanthropicdefault の資格情報が見つからない場合のチェックリストを修正しました。

• 認証プロファイルが存在する場所を確認 (新しいパスとレガシーパス)
  • 現在: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • レガシー: ~/.openclaw/agent/* (openclaw doctorによって移行)
• あなたの env var がゲートウェイによってロードされていることを確認します
  • シェルで ANTHROPIC_API_KEY を設定し、systemd/launchd 経由で Gateway を実行した場合、それを継承しない可能性があります。 ~/.openclaw/.env または env.shellEnv を有効にします。
• 正しいエージェントを編集していることを確認してください
  • 複数エージェントのセットアップは、複数の auth-profiles.json ファイルがあることを意味します。
• Sanity-check model/auth status
  • 設定されたモデルとプロバイダが認証されているかどうかを確認するには、openclawモデルのステータス を使用してください。

• setup-tokenを使用
  • claude setup-token を実行し、 openclaw models setup-token ---provider anthropic を貼り付けます。
  • トークンが別のマシンで作成された場合は、 openclaw models auth paste-token ---provider anthropic を使用してください。
• 代わりにAPIキーを使用したい場合
  • ~/.openclaw/.envにANTHROPIC_API_KEYをゲートウェイホストに置きます。
  • ピン留めされたプロファイルを強制的に消去します:
    openclaw models auth order clear --provider anthophic
    
• ゲートウェイホストでコマンドを実行していることを確認します
  • リモートモードでは、ラップトップではなくゲートウェイマシン上で認証プロファイルが実行されます。

​

なぜそれはまたGoogle Geminiを試して失敗したか

​

認証プロファイル：それらが何であるかとそれらを管理する方法

​

認証プロファイルとは

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

​

典型的なプロフィールIDとは？

• anthropic:default (メールIDが存在しない場合に一般的)
• anthropic:<email> OAuth identities
• 選択したカスタム ID (例: anthropic:work)

​

どの認証プロファイルが最初に試されたかを制御できますか？

24. # 設定されたデフォルトエージェントが既定（--agent を省略）
openclaw models auth order get --provider anthropic

# ローテーションを単一プロファイルに固定（これのみ試行）
openclaw models auth order set --provider anthropic anthropic:default

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

# オーバーライドをクリア（config の auth.order / ラウンドロビンに戻す）
openclaw models auth order clear --provider anthropic

openclaw モデル auth order set --provider anthropic --agent main anthropic:default

​

OAuth vs API キー

• OAuth は頻繁にサブスクリプションアクセスを利用します(該当する場合)。
• API キー はトークンごとの支払いを使用します。

​

ゲートウェイ：ポート、“すでに実行中”、およびリモートモード。

​

ゲートウェイのポート番号

--port > OPENCLAW_GATEWAY_PORT > gateway.port > デフォルト 18789

​

なぜopenclawゲートウェイの状態はランタイムが実行されているがRPCプローブが失敗していると言うのか？

• プローブターゲット： （実際にプローブが使用したURL）
• 聞き取り: (ポートで実際にバインドされているもの)
• Last gateway error: (プロセスが生きているが、ポートがリッスンされていないときに一般的な原因)

​

なぜopenclawゲートウェイステータスがConfigcliとConfigサービスが異なるのか?

openclaw gateway install --force

​

別のゲートウェイインスタンスが既にリッスンしているのは何ですか？

​

リモートモードクライアントでOpenClawを実行する方法は、他のゲートウェイに接続します

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

• openclaw gateway は gateway.mode が local (またはオーバーライドフラグを渡す) のときにのみ起動します。
• macOS アプリは、設定ファイルとスイッチモードがこれらの値が変更されたときに動作するのを監視します。

​

コントロールUIが許可されていないか、再接続を続けています。

• Control UI は、ブラウザーの localStorage キー openclaw.control.settings.v1 にトークンを保存します。

• 最速: openclawダッシュボード (印刷 + ダッシュボードのURLをコピーして開こうとします。頭のない場合はSSHヒントを表示します)。
• トークンがまだない場合: openclaw doctor --generate-gateway-token 。
• リモートの場合、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ステータス --all を実行し、 Troubleshooting に従ってください。 認証の詳細については、 Dashboard を参照してください。

​

gatewaybind tailnet を設定しましたが、何もリッスンをバインドできません。

• Start Tailscale on that host (so it has a 100.x address), or
• gateway.bind: "loopback" / "lan" に切り替えます。

​

同じホストで複数のゲートウェイを実行できますか？

• OPENCLAW_CONFIG_PATH (インスタンス毎の設定)
• OPENCLAW_STATE_DIR (インスタンス毎の状態)
• agents.defaults.workspace (ワークスペースの隔離)
• gateway.port (一意のポート)

• インスタンスごとに openclaw--profile <name> … を使用します (~/.openclaw-<name>).
• プロファイルの設定ごとに固有の gateway.port を設定します（手動で実行するには --port を渡します）。
• Install a per-profile service: openclaw --profile <name> gateway install.

​

無効なハンドシェイクコード1008が意味するもの

26. Gateway は WebSocket サーバー であり、最初のメッセージとして connect フレームを受け取ることを想定しています。 それ以外のものを受け取った場合は、接続 を code 1008 (ポリシー違反) で閉じます。

• WSクライアントの代わりにブラウザ（http://...）でHTTP URLを開きました。
• 間違ったポートまたはパスを使用しました。
• プロキシまたはトンネルが認証ヘッダーを取り除いたり、ゲートウェイ以外のリクエストを送信しました。

1. WSのURLを使用します: wss://<host>:18789 (HTTPSの場合はwss://...)
2. 通常のブラウザタブでWSポートを開かないでください。
3. 認証がオンの場合は、トークン/パスワードを connect フレームに含めます。

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ゲートウェイ (<profile>)" /V /FO LIST

​

ゲートウェイサービスの再起動を停止する方法

オープンクロウゲートウェイの状態
オープンクロウゲートウェイの再起動

​

OpenClawを再起動する方法は、Windows上で端末を閉じました。

wsl
openclawゲートウェイステータス
openclawゲートウェイ再起動

openclaw gateway run

オープンクロウゲートウェイの状態
オープンクロウゲートウェイの再起動

openclaw gateway run

​

ゲートウェイは起動していますが、応答が届かない 何を確認すべきか

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

• モデル認証が ゲートウェイホスト にロードされていません (models status を確認してください)。
• チャネルのペアリング/許可リストのブロック返信 (チャネル設定 + ログを確認してください)。
• WebChat/Dashboardは正しいトークンなしで開いています。

​

ゲートウェイから切断された理由はありません

1. ゲートウェイは稼働していますか? openclaw gateway status
2. ゲートウェイは健全ですか? openclaw status
3. UIには正しいトークンがありますか？ openclaw dashboard
4. リモートの場合、トンネル/尾尺度は上にリンクされますか?

openclaw logs --follow

​

Telegram setMyCommands fails with network errors What should I be check

openclawチャンネルステータス
openclawチャンネルログ --channel Telegram

​

TUIは出力を表示しません

openclaw status
openclaw models status
openclaw logs --follow

​

完全に停止し、ゲートウェイを起動する方法

openclaw gateway stop
openclaw gateway start

openclaw gateway run

​

ELI5 openclawゲートウェイの再起動 vs openclawゲートウェイ

• openclaw gateway restart: background service (launchd/systemd) を再起動します。
• openclaw gateway: この端末セッションのゲートウェイを 前面で実行します。

​

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

​

メディアと添付ファイル

​

私のスキルはimagePDFを生成しましたが、何も送信されませんでした。

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

• ターゲットチャンネルはアウトバウンドメディアをサポートし、許可リストによってブロックされません。
• ファイルはプロバイダのサイズ制限内にあります(画像は最大2048ピクセルにリサイズされます)。

​

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

​

OpenClawをインバウンドDMに公開しても安全ですか？

• DM対応チャンネルのデフォルトの動作はペアリングです:
  • 不明な送信者はペアリングコードを受け取ります。ボットはメッセージを処理しません。
  • 承認: openclawペアリング承認 <channel> <code>
  • 保留中のリクエストは3チャンネルに上限されます。コードが届かない場合は、openclawペアリングリスト <channel> を確認してください。
• DMを開くには明示的なオプトインが必要です (dmPolicy: "open" と allowlist `”*”)。

​

迅速な注入はパブリックボットに対する懸念のみです

• 信頼できないコンテンツを要約するために読み取り専用またはツール無効化された「リーダ」エージェントを使用する
• ツール対応エージェントには、 web_search / web_fetch / browser をオフにします
• サンドボックス化と厳格なツールの許可リスト

​

自分のbotがGitHubアカウントまたは電話番号を持っている必要があります

​

自分のテキストメッセージ上で自律性を与えることができますし、その安全性です

• ペアリングモード または厳しい許可リストにDMを維持します。
• あなたに代わってメッセージを送りたい場合は、別の番号またはアカウントを使用してください。
• 下書きを許可し、送信前に承認

​

パーソナルアシスタントに安価なモデルを使用できますか？

​

僅用於中文

openclaw pairing list telegram

​

WhatsAppは私の連絡先にメッセージを表示します ペアリングはどのように動作します

28. openclaw pairing approve whatsapp <code>

openclaw pairing list whatsapp

​

チャットコマンド、タスクを中断し、“それは止まらない”

​

内部システムメッセージのチャット表示を停止するにはどうすればいいですか？

/verbose off
/reasoning off

​

実行中のタスクをキャンセルするにはどうすればいいですか？

停止
esc
wait
exit
interrupt

プロセス アクション:kill sessionId:XXX

29. スラッシュコマンドの概要: スラッシュコマンドを参照してください。

​

Telegram クロスコンテクストからDiscordメッセージを送信するにはどうすればいいですか？

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

​

なぜボットが迅速なメッセージを無視しているのか？

• steer - 新しいメッセージは現在のタスクをリダイレクトします
• followup - 一度に1つのメッセージを実行する
• collect - 一括送金と返信（デフォルト）
• steer-backlog - ステアリングしてバックログを処理する
• interrupt - 現在の実行を中止して新たに開始する

​

スクリーンショット/チャットログから正確な質問に答えます