Simple Application Server:OpenClaw よくある質問

既存サーバーへの OpenClaw のデプロイ

1. Simple Application Server コンソールにログインし、ターゲットインスタンスを選択して、システムのリセット をクリックします。

2. [他のイメージにリセット] を選択し、次に OpenClaw 2026.5.19 イメージを選択します。

3. OpenClaw を再設定します。システムをリセットすると、以前に設定した API キーとトークンは無効になります。アプリの詳細 に移動して API キーを再設定します。

アプリケーションイメージのリセット

現在のイメージがバージョン OpenClaw 2026.5.19 でない場合、システムをリセットしてアプリケーションイメージを更新し、最新の OpenClaw 機能にアクセスしてください。

1. Simple Application Server コンソールにログインし、ターゲットインスタンスを選択して、システムのリセット をクリックします。

2. [他のイメージにリセット] を選択し、バージョン OpenClaw 2026.5.19 を選択します。

3. OpenClaw を再設定します。システムをリセットすると、API キーとトークンが無効になります。アプリの詳細 に移動して API キーを再設定します。

OpenClaw イメージバージョンの確認

OpenClaw イメージバージョンは、2 つの方法で確認できます：

• コンソールから: Simple Application Server コンソールにログインします。対象の OpenClaw インスタンスの詳細ページに移動し、基本情報 > イメージ に進みます。

• ターミナルコマンドを使用：Simple Application Server コンソールで、接続 > 今すぐログイン をクリックしてターミナルを開き、次のコマンドを実行します：

  openclaw --version

これら 2 つの方法で返されるバージョン番号は、意味が異なります：

• コンソールのイメージバージョン：インスタンス作成時に選択された初期イメージバージョンを表示します。

• openclaw --version の出力：実行中の OpenClaw アプリケーションのバージョンを表示します。これはアプリケーションの更新に伴い変更されます。

これらのバージョン番号は異なるソースから取得されるため、一致しないことが想定されます。

システムリセットのエラー

システムリセットが失敗した場合、Simple Application Server インスタンスが停止していることを確認してください。システムはインスタンスが 停止 している場合にのみリセットできます。

1. Simple Application Server コンソールにログインします。サーバーリストで、ターゲットインスタンスをクリックします。

2. インスタンス詳細ページの右上隅で、電源を切る をクリックします。インスタンスのステータスが 停止 に変わるまで待ちます。

3. インスタンスが停止されると、システムのリセット と表示されます。

OpenClaw：「API rate limit reached」エラー

この問題をトラブルシューティングするには、以下の潜在的な原因を順番に確認してください：

1. OpenClaw の設定が正しくない。

   ベース URL またはモデルプロバイダーが誤って設定されている場合、リクエストが専用のコーディングプランチャンネルではなく、一般的な API エンドポイントにルーティングされ、レート制限がトリガーされる可能性があります。

   • コーディングプランを使用している場合は、OpenClaw 設定ファイルの models、agents、gateway パラメーター (ネストされたフィールドを含む) を確認し、ドキュメントに記載されている設定と一致していることを確認してください。例えば、モデルプロバイダーは次のように構成する必要があります：{ "models": { "providers": { "Model Studio": {...} } } }。

   • 現在コーディングプランを使用していない場合は、専用のクォータを取得するために切り替えることを検討してください。

2. プランのクォータを超過しました。[コーディングプランページ]で使用量をご確認ください。

3. API キーのリセット: 上記の確認を完了しても問題が解決しない場合は、[コーディングプラン] ページに移動して API キーをリセットしてください。

一般的なレート制限のトラブルシューティング (すべてのモデルプロバイダー向け)

モデルを呼び出す際に、以下の理由で API rate limit reached エラーが表示されることもあります：

• 高い呼び出し頻度：リクエストがモデルプロバイダーのレート制限ポリシーをトリガーしました。呼び出し頻度を減らし、少し待ってから再度試してください。

• 同時リクエストが多すぎる：アプリケーションが短時間に多数の同時リクエストを送信していないか確認してください。アプリケーションの設定で maxConcurrent パラメーターを確認し、同時実行数の上限を下げることを検討してください。

• 無料クォータの枯渇：無料クォータを使用している場合、クォータが枯渇していないか確認してください。一部のプロバイダーは、標準の課金に進むのではなく、無料クォータが枯渇した際に 403 またはレート制限エラーを返します。

OpenClaw はサードパーティモデルをサポートしていますか？

はい。設定方法は OpenClaw のイメージバージョンによって異なります。以下のタブを切り替えて、サポートされているプロバイダーとその統合手順をご確認ください。

WebUI でのサードパーティモデルの問題

DeepSeek や MiniMax などのサードパーティモデルを設定した後、WebUI のドロップダウンメニューに表示されない、または切り替え後にシステムがデフォルトモデル (Qwen など) に戻ってしまうことがあります。この問題をトラブルシューティングするには、以下の手順を使用してください：

• 設定の完全性を確認する：モデルを models.providers に追加し、そのリファレンスを agents.defaults.models に provider-id/model-id の形式で追加し、プライマリモデルを agents.defaults.model.primary で指定したことを確認してください。models.providers のみを設定し、リファレンスを追加しない場合、WebUI は新しいモデルを認識しません。

• サービスを再起動して変更を適用する：設定ファイルを変更した後、次のコマンドを実行して変更を適用します：

  openclaw gateway restart

• コンソールの制限を理解する：Simple Application Server コンソールの「アプリケーション詳細」ページは、Alibaba Cloud Model Studio モデルの表示と変更のみをサポートしています。サードパーティモデルの表示や変更はサポートしていません。サーバー上の ~/.openclaw/openclaw.json ファイルがサードパーティモデルの設定を定義しているため、コンソールには Model Studio モデルのみが表示されます。

• モデルの切り替え：

  • WebUI チャットでモデルを切り替えるには、コマンド /model provider-id/model-id を送信します。

  • ターミナルでモデルを切り替えるには、openclaw models set provider-id/model-id を実行します。

  • ターミナルで利用可能なモデルのリストを表示するには、openclaw models list を実行します。

  ~/.openclaw/openclaw.json 設定ファイルの agents.defaults.models リストは、切り替え可能なモデルを定義します。上記のコマンドを使用して、このリストで宣言されたモデルにのみ切り替えることができます。切り替え可能なモデルを追加するには、まず models.providers にモデル設定を追加し、次に agents.defaults.models に対応するリファレンスを追加します。

  モデルを切り替える前に、インスタンスのスナップショットを作成するか、設定ファイルをバックアップ (cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak) して、設定変更の失敗から迅速に回復できるようにしてください。

• フォールバック戦略のトラブルシューティング：設定が正しいにもかかわらず OpenClaw が別のモデルを呼び出す場合は、OpenClaw のログを確認してください。レート制限またはエラーがフォールバック戦略をトリガーしたかどうかを確認します。

HTTP 401 (不正な API キー / 無効なアクセストークン)

HTTP 401 エラーは通常、不正な API キー、またはベース URL とキーの不一致を示します。この問題を解決するには、以下のシナリオを確認してください：

シナリオ 1：Alibaba Cloud Model Studio 汎用モデル (従量課金)

• API キーのフォーマット：API キーが sk- で始まることを確認してください。

• リージョンの一致：API キーとベース URL が同じリージョンからのものであることを確認してください。例えば、中国 (北京) リージョンの API キーには、そのリージョンに対応する URL が必要です。

• ベース URL：ベース URL は通常 https://dashscope.aliyuncs.com/compatible-mode/v1 です。

• 注：コーディングプランのキーは、従量課金キーと互換性がありません。

シナリオ 2：Alibaba Cloud Model Studio トークンプラン

• API キーのフォーマット：API キーが sk-sp- で始まる長い文字列であることを確認してください。

• ベース URL：ベース URL https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 を使用する必要があります。

• 注：トークンプランはコンソールでのワンクリック設定をサポートしていません。設定ファイルを手動で編集する必要があります。

シナリオ 3：サードパーティモデル (MiniMax、DeepSeek、Tencent Cloud など)

• Alibaba Cloud Model Studio のキーではなく、サードパーティプラットフォームの API キーを使用してください。

• キーに余分なスペースや改行文字がないか確認してください。

• ベース URL が正しいことを確認してください。例えば、DeepSeek のベース URL は https://api.deepseek.com/v1 です。

• MiniMax などの一部のモデルでは、MiniMax CN や MiniMax Global などの特定の認証方式を選択する必要がある場合があります。

一般的なトラブルシューティング手順

• サードパーティのコンソールで API キーを再生成し、置き換えます。

• 設定ファイル ~/.openclaw/openclaw.json を確認し、apiKey フィールドが正しく設定されていることを確認します。

• サービスを再起動します：openclaw gateway restart。

ローカルモデルのサポート

Simple Application Server イメージからデプロイされたものなど、クラウドにデプロイされた OpenClaw インスタンスは、パブリックに到達可能な API エンドポイントを必要とするため、ローカルマシンや LAN (ローカルエリアネットワーク) で実行されている大規模モデルの呼び出しをサポートしていません。

ローカルモデルを使用するには、以下の要件を満たす必要があります：

• ローカルモデルサービスがパブリックインターネットに公開され、ご利用の ECS インスタンスからアクセス可能であることを確認してください。

• 「一般的なサードパーティモデル統合ガイド」で説明されているように、~/.openclaw/openclaw.json ファイルの models.providers にパブリックベース URL を設定してください。

モデルプロバイダー変更の影響

OpenClaw のモデルプロバイダーを変更すると、OpenClaw アプリケーションにのみ影響し、通常は Hermes などのサーバー上の他のアプリケーションには影響しません。

設定エラーが発生した場合は、Simple Application Server コンソールで作成したインスタンススナップショットを使用してロールバックできます。ベストプラクティスとして、設定を変更する前にスナップショットを作成するか、設定ファイルをバックアップ (cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak) してください。

OpenClaw のポート番号

悪意のあるスキャンや標的型攻撃を防ぐため、OpenClaw は初期化中にランダムなポートを自動的に生成します。ポート番号を表示するには、アプリの詳細 > 基本設定 > ポートを表示 に移動し、表示 をクリックします。

ローカルアプリケーションの制御

いいえ。Simple Application Server インスタンスはクラウドネットワークで実行され、ローカルネットワークから分離されています。このネットワーク分離により、OpenClaw がローカルコンピュータ上のアプリケーションを直接制御することはできません。

アップデート後に Web 検索が利用できなくなるのはなぜですか？

Simple Application Server コンソールに移動します。Image Information セクションで、アプリケーションイメージが OpenClaw 2026.2.3 以降であることを確認してください。以前のバージョンを使用している場合は、「現在のアプリケーションイメージを最新バージョンにリセットするにはどうすればよいですか？」を参照して更新してください。このアプリケーションイメージバージョンでは、組み込みの SearXNG スキルを通じてすべてのリージョンで Web 検索がデフォルトで有効になります。追加の設定や料金は不要です。OpenClaw に SearXNG スキルを使用して Web を検索するように指示できます。中国 (香港) リージョンまたは中国本土以外のリージョンにデプロイされたサーバーについては、「OpenClaw の Brave Search 機能を設定する方法」を参照して、Web 検索用の Brave Search API を設定してください。

OpenClaw モデルの変更方法

コンソールで OpenClaw の異なるモデルを切り替えることができます。手順はイメージバージョンによって異なります：

• OpenClaw 2026.5.19 以降の場合：アプリケーション詳細ページに移動します。[モデル] カードで、設定済みのモデルを見つけて [モデルの切り替え] をクリックして別のモデルを選択するか、[モデルの追加] をクリックして新しいモデルプロバイダーに接続します。このバージョンは、AI コーディングプラン、Alibaba Cloud Model Studio トークンプラン、Alibaba Cloud Model Studio、deepseek、Kimi、GLM コーディングプラン、Zhipu など、複数のプロバイダーをサポートしています。

• OpenClaw 2026.5.19 より前のバージョンの場合：アプリの詳細 > [モデル設定] > [モデル設定] に移動し、デフォルトモデルを削除してから、ドロップダウンリストから別の Alibaba Cloud Model Studio モデルを選択します。

スキルのインストール

OpenClaw 2026.2.3 以降のアプリケーションイメージには、デフォルトで組み込みの SearXNG Web 検索スキルのみが含まれています。他のスキルを使用するには、以下の 3 つの方法のいずれかで手動でインストールする必要があります：

• チャットによるインストール：チャットで OpenClaw に目的のスキルをインストールするように依頼すると、自動的にインストールされます。

• URL によるインストール：スキルの URL を OpenClaw に送信すると、自動的にインストールされます。

• ClawHub によるインストール：clawhub install <skill-name> コマンドを使用して ClawHub からインストールします。

OpenClaw へのスキルの追加

OpenClaw にスキルを追加するには、インタラクティブな作成、URL からのインストール、ミラーソースからのインストールの 3 つの方法があります。

• インタラクティブな作成 (新しいスキル向け)

  スキルクリエーターとチャットし、要件を説明すると、自動的に新しいスキルが作成されます。

• URL からのインストール (既存のスキルの再利用向け)

  ビルド済みのスキルをインストールするには、その URL を OpenClaw に送信すると、OpenClaw が自動的にインストールします。例えば、Anthropic の Web Artifacts Builder をインストールするには、会話中に OpenClaw にインストールを依頼します。

• ミラーソースからのインストール (ネットワークが制限されたシナリオ向け)

  ご利用のサーバーが GitHub などの外部コードリポジトリにアクセスできない場合は、ミラーリングを使用します：

  1. ファイルをローカルマシンにダウンロードします。

  2. コードをアクセス可能なストレージにアップロードします (例えば、OSS にアップロードできます)。

  3. 新しいダウンロード URL を取得し、URL からインストールの手順を使用して、それを OpenClaw に送信してインストールします。

カスタムスキルディレクトリと読み込み優先度

はい。 ~/.openclaw/openclaw.json の skills.load.extraDirs を使用して、追加のディレクトリ (最低優先度) を追加できます。

OpenClaw は、この順序 (高いものから低いものへ) でスキルの読み込みを優先します：<workspace>/skills > ~/.openclaw/skills > 組み込み > skills.load.extraDirs。

デフォルトでは、 clawhub はスキルを ./skills にインストールし、OpenClaw はこれを <workspace>/skills として扱います。

ClawHub からのスキルのインストール

ClawHub は、サードパーティのスキルを検索、インストール、管理するための専用のスキルマーケットプレイスです。

• スキルの検索 (例：weather)：

  clawhub search weather

• スキルのインストール：

  clawhub install weather

• その他のコマンドの表示：

  clawhub --help

公式の ClawHub China ミラーは、中国のユーザーに再利用可能なエージェントスキルへの高速アクセスを提供します。高品質なコミュニティスキルを継続的にインデックス化し、ミラーリングしています。詳細と使用方法については、ClawHub China ミラーをご参照ください。

ClawHub China ミラーサイト

ClawHub は、高品質なコミュニティスキルをキュレーションし、ミラーリングする公式の中国ミラーサイトを提供しており、中国のユーザーが再利用可能なエージェントスキルに高速でアクセスできるようにしています。

ユースケース：Simple Application Server が中国本土のリージョンにデプロイされている場合、デフォルトのソースからスキルをインストールする際にネットワーク遅延やダウンロードの遅延が発生する可能性があります。中国ミラーサイトを使用してダウンロードを高速化してください。

手順：

1. ClawHub China ミラーサイトにアクセスして、スキルを閲覧または検索します。

2. 目的のスキルを見つけ、ミラーサイトからインストール URL をコピーします。

3. OpenClaw チャットで、ミラーサイトからのインストール URL をエージェントに送信します。エージェントは自動的にスキルをインストールします。

中国ミラーサイトには、ClawHub のデフォルトソースと同じコンテンツが含まれていますが、中国本土のダウンロードノードを使用しているため、ネットワークアクセスが高速です。他のリージョンのユーザーは、引き続きデフォルトソースを使用できます。

スキルのダウンロードが遅い

中国本土リージョンの Simple Application Server インスタンスでスキルをダウンロードまたはインストールすると、遅延やタイムアウトが発生することがあります。この問題は、デフォルトのスキルリソースが海外のノードでホストされており、ネットワーク遅延が大きくなるために発生します。

ソリューション：

• ClawHub China ミラーサイトの使用：ClawHub China ミラーサイトにアクセスして、中国本土のノードからスキルのダウンロードを高速化するミラーダウンロード URL を取得してください。詳細については、「ClawHub China ミラーサイトの使用方法」をご参照ください。

• 中間ソースを使用したインストール：ご利用のネットワーク環境が GitHub などの外部コードリポジトリにアクセスできない場合は、スキルファイルをローカルマシンにダウンロードし、OSS などのアクセス可能なストレージスペースにアップロードしてから、生成された URL を OpenClaw に提供してインストールします。詳細については、「OpenClaw にスキルを追加またはインストールする方法」をご参照ください。

OpenClaw ゲートウェイの再起動

openclaw gateway restart

Brave Search Web 検索の設定

Brave Search Web 検索機能は、中国 (香港) リージョンまたは中国本土以外のリージョンの Simple Application Server インスタンスでのみ利用可能です。

OpenClaw アプリケーションイメージ、バージョン 2024.2.3 以降には、SearXNG ベースの Web 検索スキルがデフォルトで含まれています。

1. Brave Search 公式ウェブサイトにアクセスして、Brave Search API アカウントを作成し、API キーを生成します。

2. これをイメージで設定するには、OpenClaw ページに移動します。左のナビゲーションウィンドウで、 をクリックして設定ファイルを開きます。BRAVE_API_KEY をご利用の Brave Search API キーに変更し、以下のコードブロックをコピーして tools.web.search 設定場所に貼り付けます。

     "tools": {
       "web": {
         "search": {
           "provider": "brave",
           "apiKey": "<span class="var-span" contenteditable="true" data-var="BRAVE_API_KEY">BRAVE_API_KEY"</span>,
           "maxResults": 5,
           "timeoutSeconds": 30
         }
       }
     },

   左のメニューで [Config] をクリックします。[Settings] パネルで [All Settings] を選択し、[Raw] タブに切り替えます。コードブロックを tools.web.search 設定に貼り付け、右上隅の [Save] をクリックします。

Docker でのツールの実行

OpenClaw は、リスクを軽減するために Docker コンテナ内でツールを実行できます。このオプション機能は、ツールを隔離されたサンドボックス環境で実行します。設定手順については、OpenClaw サンドボックスガイドをご参照ください。

一般的な OpenClaw CLI ツール

サーバーターミナルにログインし、root ユーザーに切り替えて次のコマンドを実行します。

コンソール初期化の影響

コンソールで API キーを初期化または再設定しても、インストール済みのスキル、メモリ、チャット履歴、トレーニングデータは消去されません。この操作はモデル接続設定のみをリセットします。

再起動時のデータ損失

いいえ。OpenClaw ゲートウェイまたはサーバーを再起動してもデータ損失は発生しません。設定やスキルを含むデータは ~/.openclaw ディレクトリに保存され、システムをリセットするかディレクトリを削除しない限り保持されます。

複数のチャンネルセッション

はい、これは想定される動作です。Feishu や DingTalk などのチャンネルを接続すると、システムはその接続用のセッションを自動的に生成します。これらのセッションは Web UI で手動で削除できます。ただし、セッションを削除すると、そのチャンネルからのメッセージを受信できなくなります。

Model Studio で無料クォータのみを使用する

デフォルトでは、Model Studio はシンガポールリージョンで無料クォータを超えたモデル使用量に対して課金します。これらの料金を防ぐには、Model Studio プラットフォームで[無料クォータが枯渇したら停止] を有効にしてください。有効にすると、無料クォータが枯渇したときにモデルは利用できなくなります。その後、無料クォータのある別のモデルに切り替えることができます。

無料クォータのみの設定

デフォルトでは、無料クォータを超えたモデル使用量に対して課金されます。「無料クォータのみ」機能が有効になっている場合、無料クォータが枯渇すると API 呼び出しは AllocationQuota.FreeTierOnly エラーで失敗し、追加料金の発生を防ぎます。

OpenClaw でコーディングプランを手動で設定する

1. 「ステップ 2：プラン専用の API キーとベース URL を取得する」から API キーとベース URL をコピーして保存します。

2. 以下のコードブロックで、"apiKey": "YOUR_API_KEY" の YOUR_API_KEY を「ステップ 2：プラン専用の API キーとベース URL を取得する」で取得した API キーに置き換えます。

   "models": {"mode": "merge","providers": {"bailian": {"baseUrl": "https://coding.dashscope.aliyuncs.com/v1","apiKey": "<span class="var-span" contenteditable="true" data-var="YOUR_API_KEY">YOUR_API_KEY"</span>,"api": "openai-completions","models": [{"id": "qwen3-max-2026-01-23","name": "qwen3-max-thinking","reasoning": false,"input": ["text"],"cost": {"input": 0,"output": 0,"cacheRead": 0,"cacheWrite": 0},"contextWindow": 262144,"maxTokens": 65536}]}}},"agents": {"defaults": {"model": {"primary": "bailian/qwen3-max-2026-01-23"},"models": {"bailian/qwen3-max-2026-01-23": {"alias": "qwen3-max-thinking"}},"maxConcurrent": 4,"subagents": {"maxConcurrent": 8}}},

   "models": {"mode": "merge","providers": {"bailian": {"baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1","apiKey": "<span class="var-span" contenteditable="true" data-var="YOUR_API_KEY">YOUR_API_KEY"</span>,"api": "openai-completions","models": [{"id": "qwen3-max-2026-01-23","name": "qwen3-max-thinking","reasoning": false,"input": ["text"],"cost": {"input": 0,"output": 0,"cacheRead": 0,"cacheWrite": 0},"contextWindow": 262144,"maxTokens": 65536}]}}},"agents": {"defaults": {"model": {"primary": "bailian/qwen3-max-2026-01-23"},"models": {"bailian/qwen3-max-2026-01-23": {"alias": "qwen3-max-thinking"}},"maxConcurrent": 4,"subagents": {"maxConcurrent": 8}}},

3. Simple Application Server コンソール - サーバーページで、OpenClaw サーバーカードのインスタンス ID をクリックして サーバー概要 ページを開きます。

4. アプリの詳細 タブをクリックします。[アクセスの制御ページ] で、ウェブサイト URL の横にある コマンドの実行 をクリックします。ポップアップウィンドウで、URL をクリックして OpenClaw チャットページを開きます。

5. をクリックして設定ファイルを開きます。変更した "apiKey" パラメーターを含む上記のコードブロックをコピーし、設定コード内の元の "agents"{...} コンテンツを置き換えてから、変更を保存します。

qwen3.6-plus をデフォルトモデルとして設定する

Lite プランは qwen3.6-plus をサポートしていません。

OpenClaw 2026.4.14 イメージ以降では、アプリケーション詳細ページが qwen3.6-plus をサポートしています。コンソールのモデルドロップダウンメニューから直接選択できます。古いイメージを使用している場合は、次のように手動で設定します：

1. OpenClaw Web UI で、左側のメニューから 構成 > [Raw] を選択します。

2. models.providers.dashscope-coding.models セクションに、次の qwen3.6-plus モデル設定を追加します：

   {
     "id": "qwen3.6-plus",
     "name": "Qwen3.6-Plus",
     "api": "openai-completions",
     "reasoning": false,
     "input": ["text", "image"],
     "cost": {
       "input": 0,
       "output": 0,
       "cacheRead": 0,
       "cacheWrite": 0
     },
     "contextWindow": 1000000,
     "maxTokens": 65536
   }

3. agents.defaults.model.primary パラメーターを dashscope-coding/qwen3.6-plus に変更します。

4. [保存] をクリックし、次に [更新] をクリックして変更を適用します。

OpenClaw インスタンスの設定要件

サービスパフォーマンスを確保するため、少なくとも 2 vCPU と 2 GB のメモリを持つインスタンスを選択してください。

OpenClaw 使用時の追加料金

インスタンスに Model Studio の API キーを設定して OpenClaw を使用すると、トークン使用量に基づいてモデル呼び出し料金が発生します。課金の詳細については、「モデル呼び出しの課金」ドキュメントをご参照ください。

モデルのシンガポールでの無料クォータ

Model Studio コンソールにログインして、無料クレジット セクションで残りのクォータを確認します。

モデル呼び出し統計の表示

Model Studio シンガポール、米国 (バージニア) 、中国 (北京) ：リージョン間の差異

Alibaba Cloud Model Studio は、シンガポール、米国 (バージニア)、および 中国 (北京) リージョンで利用できます。近くのリージョンを選択すると、ネットワーク遅延を削減できます。サービスエンドポイント (エンドポイント/ベース URL) と API キーは、各リージョンに固有です。サポートされているモデル、プラットフォームの機能、および料金もリージョンによって異なります。詳細については、「モデルの選択」をご参照ください。

クロスリージョンでの API キーの使用

はい。海外リージョンの Simple Application Server は、中国 (北京) の Model Studio モデルサービスを呼び出すことができます。ただし、クロスリージョンのネットワーク遅延により、応答時間が大幅に増加します。

ファイル管理

OpenClaw を使用すると、エージェントは生成されたファイル (コード、レポート、画像など) をデフォルトで /home/admin/.openclaw/ ディレクトリに保存します。

生成されたファイルを見つける：

• ターミナルで ls を実行して、現在のディレクトリのファイルを一覧表示します。

• find / -name "filename" を実行して、インスタンス全体で特定のファイルを検索します。

• OpenClaw チャットでエージェントに正確なファイルパスを尋ねます。

ファイルのアップロードとダウンロード：

Workbench のファイル管理機能を使用して、ファイルをアップロードおよびダウンロードします。詳細な手順については、「Workbench 経由でのファイルのアップロードまたはダウンロード」をご参照ください。

応答しない OpenClaw チャットページ

1. API キー設定の確認：Simple Application Server インスタンスにリモート接続します。以下のコードブロックで、プレースホルダーをご利用の API キーとリージョンのベース URL に置き換えます。ターミナルでコマンドを実行して、モデルの呼び出しをテストします。エラーメッセージが表示された場合は、「エラーメッセージ」ドキュメントでそれを見つけ、推奨される解決策に従ってください。ベース URL はリージョン固有であり、互換性はありません：

   • 中国 (北京)： https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions

   • 米国 (バージニア)： https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions

   • シンガポール： https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions

   • コーディングプラン: https://coding-intl.dashscope.aliyuncs.com/v1/chat/completions

   curl -X POST YOUR_API_KEY_BASE_URL \
   -H "Authorization: Bearer <span class="var-span" contenteditable="true" data-var="YOUR_API_KEY">YOUR_API_KEY"</span> \
   -H "Content-Type: application/json" \
   -d '{
       "model": "qwen3-max-2026-01-23",
       "messages": [
           {
               "role": "user",
               "content": "Who are you?"
           }
       ]
   }'

2. 支払い遅延またはレート制限の確認。

   1. Coding Plan: このプランには、5時間、週次、月次のリクエスト制限があります。クォータ使用量は、Coding Plan コンソールで確認できます。制限を超えると、hour/week/month allocated quota exceeded エラーがトリガーされます。

      解決策：クォータが自動的にリセットされるのを待ちます。

   2. 従量課金の Model Studio API キーの場合：

      1. 無料クォータを確認するには、Model Studio コンソールにログインします。無料クレジット セクションに、モデルの残りのクォータが表示されます。

      2. 支払い遅延を確認するには、課金管理センターにアクセスし、アカウントに未払い残高がないことを確認してください。

3. エラーログの確認: OpenClaw Chat ページに移動します。左側のナビゲーションウィンドウで、[ログ] をクリックします。次に、WARN と ERROR のチェックボックスを選択します。エラーを OpenClaw よくある質問 で確認し、ソリューションを探します。

   ログにエラーが表示されない場合は、コンソールからゲートウェイを再起動します。

4. アプリケーションイメージのリセット

   サーバーに重要なデータが含まれていない場合は、Simple Application Server インスタンスを最新の OpenClaw アプリケーションイメージにリセットし、サービスを再設定します。

   重要

   システムのリセット操作は、オペレーティングシステムを再インストールし、保存された設定、ログ、データベースなど、システムディスク上のすべてのデータを消去します。続行する前に、重要なデータをバックアップしてください。スナップショットを作成するか、データをローカルデバイスにエクスポートすることをお勧めします。メモリ、ID 設定、スキルなど、ご利用の OpenClaw ワークスペースのデータを保持するには、「OpenClaw アップグレードのためのデータのバックアップと復元」をご参照ください。

入力長エラー

このエラーは、会話の累積コンテキストがモデルの入力制限を超えた場合に発生します。これを解決するには、OpenClaw 会話ページで /new コマンドを実行します。

OpenClaw ゲートウェイの再起動

接続の中断やサービスの利用不可などの問題が発生した場合は、コンソールで OpenClaw ゲートウェイを再起動できます。アプリの詳細 > 基本設定 > OpenClaw ゲートウェイを再起動 に移動し、再起動 をクリックします。

OpenClaw エラー：HTTP 401

このエラーは通常、アプリケーション詳細ページでの初期設定が失敗した場合、API キーが欠落している場合、サードパーティ (Model Studio 以外) の API キーが使用された場合、または選択されたリージョンが手動で入力された API キーのリージョンと一致しない場合に発生します。

解決策：

1. Simple Application Server コンソールで、インスタンスの アプリの詳細 ページに移動し、初期化手順で Model Studio API キーまたはコーディングプランを再設定します。

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

3. 最新の WebUI URL を取得し、それを開いてエラーが解決されたことを確認します。

OpenClaw エラー：「browser failed: timed out」

完全なエラーメッセージは次のとおりです：

error [tools] browser failed: timed out. Restart the OpenClaw gateway (OpenClaw.app menubar, or 'openclaw gateway'). Do NOT retry the browser tool — it will keep failing. Use an alternative approach or inform the user that the browser is currently unavailable.

このエラーを解決するには、OpenClaw ゲートウェイを再起動してください。

ブロックされたスキルインストール

OpenClaw 管理インターフェイスは、一部のスキルコンポーネントのワンクリックインストールを提供します。ただし、ほとんどのコンポーネントは Homebrew を必要とし、ワンクリックではインストールできません。これらのスキルを使用するには、サーバーに Homebrew をインストールし、その後インストールと設定を行ってください。

「disconnected (1008): unauthorized」エラー

これは、アクセスリンクに認証トークンが欠落しているためです。OpenClaw Web コンソールは、IP アドレスを使用した直接アクセスを許可せず、URL に正しいトークンパラメーターが含まれている必要があります。サーバーコンソールで、サーバーカードのインスタンス ID をクリックしてサーバー概要ページに移動します。アプリの詳細 タブをクリックし、[アクセスの制御ページ] セクションで コマンドの実行 をクリックして、トークンを含む正しいアクセスアドレスを取得します。

デバイス ID エラーの解決

サーバーにログインし、OpenClaw 設定ファイルの dangerouslyDisableDeviceAuth パラメーターを変更して、デバイス ID 検証を無効にします。

1. Simple Application Server コンソールにログインします。サーバーリストから対象のサーバーを見つけ、接続 をクリックします。ワークベンチワンクリック接続 エリアで、今すぐログイン をクリックします。

2. 次のコマンドを実行して、OpenClaw 設定ファイルを編集します：

   vim ~/.openclaw/openclaw.json

3. gateway 設定で "dangerouslyDisableDeviceAuth": false を見つけ、false を true に変更します。その後、ファイルを保存して終了します。

4. 次のコマンドを実行してゲートウェイサービスを再起動し、新しい設定を適用します：

   openclaw gateway restart

「disconnected (1006): no reason」エラーの解決

この問題をトラブルシューティングするには、次の手順に従ってください：

1. 新しいトークンを生成する：Alibaba Cloud Simple Application Server コンソールにログインし、インスタンスのアプリケーション詳細ページに移動して、新しいトークンを生成します。

2. 新しいトークンでアクセスする：アクセス URL に新しいトークンを http://<public IP address>:<port>/?token=<newly-generated-token> の形式で追加します。コンソールから提供されたアクセス URL のポート番号を使用します。その後、シークレットウィンドウで完全な URL をテストします。

3. サービスステータスを確認する：SSH でサーバーにログインし、OpenClaw サービスが実行中であることを確認します。

4. ファイアウォールルールを確認する：Simple Application Server インスタンスのファイアウォールが、リッスンポートでのインバウンド TCP トラフィックを許可していることを確認します。

   サービスがパブリック IP アドレスに正しくバインドされていない場合や、リバースプロキシが誤って設定されている場合も、WebSocket 接続が失敗する可能性があります。ベストプラクティスとして、ローカルマシンから curl または telnet を使用して基本的な接続性をテストしてください。

「origin not allowed」エラーの解決

IP アドレスの代わりにカスタムドメイン名で OpenClaw Web UI にアクセスすると、次のエラーが発生する場合があります：origin not allowed (open the Control UI from the gateway host or allow it in gateway.controlUi.allowedOrigins)。

原因：デフォルトでは、OpenClaw ゲートウェイはサーバーの IP アドレスを使用した Web UI アクセスのみを許可します。ドメイン名を使用して UI にアクセスすると、リクエストのオリジンが許可されたオリジンのリストに含まれていないため、ゲートウェイが接続をブロックします。

この問題を解決するには、サーバーにログオンし、openclaw.json 設定ファイルの allowedOrigins 設定にドメイン名のソース URL を追加します。

1. Simple Application Server コンソールにログオンします。サーバーリストで対象のサーバーを見つけ、接続 をクリックします。ワークベンチワンクリック接続 セクションで、今すぐログイン をクリックします。

2. OpenClaw 設定ファイルで allowedOrigins フィールドを見つけ、ドメイン名のソース URL を追加します。

   "allowedOrigins": [
     "http://47.**.**.59:15386",
     "http://openclaw-us.hewushui.cn:15386"
   ]

   例を、ご利用のプロトコル、ドメイン名または IP アドレス、ポートに置き換えてください。

3. ファイルを保存した後、OpenClaw ゲートウェイを再起動します。

OpenClaw Web UI のトラブルシューティング

OpenClaw Web UI にアクセスできない場合は、Simple Application Server コンソールにログインし、次の項目を確認してください。

1. OpenClaw のポートを開く：サーバーリストで、ターゲットサーバーの OpenClawを管理する をクリックします。次に、OpenClaw の使用手順 セクションの ポートを開放 タブで、ワンクリックで通過 をクリックします。

   イメージをリセットした場合は、サーバーを再初期化し、新しい Web UI URL を取得する必要があります。

2. 設定ファイルの変更を確認する：サーバーリストに戻り、ターゲットサーバーの 接続 をクリックします。ワークベンチワンクリック接続 セクションで、今すぐログイン をクリックします。次のコマンドを実行します：

   openclaw doctor --fix

   このコマンドは、openclaw.json から allowlist などのサポートされていないフィールドを自動的に削除します。

3. コマンドが終了したら、OpenClaw ゲートウェイを再起動して新しい設定を適用します。

401 Unauthorized モデル検出エラーのトラブルシューティング

Alibaba Cloud Model Studio のモデルを使用すると、システムは Failed to discover Alibaba Cloud models: 401 Unauthorized エラーを返します。

考えられる原因：401 エラーは通常、不正な API キー、API キーのリージョンとリクエストのベース URL の不一致、またはワークスペースやアカウントの呼び出し権限の不足を示します。

トラブルシューティングと解決策：

curl -X POST https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions \

- H "Authorization: Bearer <span class="var-span" contenteditable="true" data-var="DASHSCOPE_API_KEY">DASHSCOPE_API_KEY"</span> \

- H "Content-Type: application/json" \

- d '{

    "model": "qwen3-max-2026-01-23",
    "messages": [
        {
            "role": "system",
            "content": "あなたは役立つアシスタントです。"
        },
        {
            "role": "user", 
            "content": "あなたは誰ですか？"
        }
    ]
}'

エラー：openclaw: command not found

次のコマンドを実行して、シンボリックリンクを作成します：

ln -sf /home/clawdbot/dist/entry.js /usr/bin/openclaw
openclaw --help

Tailscale を有効にした後、トークンを取得できない

これは、Tailscale がルーティングポリシーを変更するためです。代わりに、次のコマンドを実行して、インスタンスから直接トークンを読み取ります：

1. OpenClaw サーバーターミナルにログインします。

2. 次のコマンドを実行します：

   echo $(sed -z 's/.*"token": "\([^"]*\)".*/\1/' /root/.clawdbot/clawdbot.json | tr -d '\0')

3. 出力がトークンです。

OpenClaw ポートがパブリックネットワークからアクセスできない

OpenClaw のポート 18789 のリッスンアドレスは 127.0.0.1 であり、これによりサービスがパブリックネットワークからアクセスできなくなります。

考えられる原因：この問題は、OpenClaw 設定ファイルの bind パラメーターが loopback に設定されている場合に発生します。デフォルト値の lan はパブリックネットワークアクセスを許可します。パラメーターを loopback に設定すると、サービス再起動後にポートはローカルループバックアドレス 127.0.0.1 でのみリッスンするようになります。

解決策：

1. サーバーにログオンして設定を確認する。Simple Application Server に admin ユーザーとしてログオンし、次のコマンドを実行して bind パラメーターの値を確認します：

   cat /home/admin/.openclaw/openclaw.json | grep bind

2. 設定ファイルを変更する。コマンドの出力を確認します。出力が "bind": "loopback" の場合は、設定ファイルを編集して値を "lan" に戻します。

3. ゲートウェイサービスを再起動する。設定ファイルを保存した後、次のコマンドを実行してゲートウェイサービスを再起動します：

   openclaw gateway restart

   サービスが再起動すると、パブリックネットワークアクセスが復元されます。

openclaw gateway restart コマンドの失敗

このエラーは、openclaw gateway restart コマンドがゲートウェイサービスの再起動に失敗した場合に発生します。

解決策：標準の再起動コマンドが失敗した場合は、プロセスを手動で停止して再起動し、サービスを復元します。次の手順に従ってください：

1. サーバーにログオンする：admin ユーザーとして Simple Application Server インスタンスにアクセスします。

2. 現在のプロセスを終了する：openclaw-gateway プロセスを強制的に停止します：

   killall openclaw-gateway

3. サービスを再起動する：ゲートウェイサービスの開始コマンドを実行します：

   openclaw gateway start

   注：開始コマンドから返されるエラーメッセージは安全に無視できます。

4. サービスステータスを確認する：ps aux | grep gate を実行して openclaw-gateway プロセスが開始されたことを確認します。次に、netstat -nltp を使用して、関連するポートがリッスン状態にあることを確認します。

頻繁なダウンタイム、メモリ枯渇、OOM

• インスタンス設定のアップグレード
  インスタンス設定を少なくとも 2 vCPU と 2 GB のメモリにアップグレードすることを推奨します。インスタンス設定をアップグレードすると、OpenClaw の安定性が向上し、サーバーのダウンタイム、ウェブサイトへのアクセス不能、メモリ枯渇など、リソース不足による問題が軽減されます。
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  

• スワップパーティションの確認と追加
  2026 年 2 月 26 日以降にリリースされた OpenClaw アプリケーションイメージには、デフォルトでスワップパーティションが含まれています。インスタンスが古いイメージを使用している場合は、スワップパーティションを手動で設定するか、現在のアプリケーションイメージを最新バージョンにリセットできます。スワップパーティションは、メモリが少ないときのバッファーとして機能し、OOM Killer のトリガーや予期しないサービス中断を減らすのに役立ちます。
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  

コーディングプランからトークンプランへの切り替え

手順：

1. Model Studio コンソールに移動して、トークンプラン Team Edition にサブスクライブします。

2. 「OpenClaw で Model Studio トークンプラン Team Edition を接続する方法」の手順に従って、トークンプランを設定します。

3. 設定が完了すると、OpenClaw は会話でトークンプランのモデルを自動的に使用します。

OpenClaw との Model Studio の統合

トークンプラン Team Edition は、チームがトークンクォータを共有して、qwen3.7-max、qwen3.6-plus、deepseek-v4-pro、kimi-k2.6、glm-5.1、MiniMax-M2.5 などのさまざまなモデルを使用できる月額サブスクリプションです。OpenClaw と統合すると、会話でこれらのモデルを呼び出すことができます。

手順：

1. トークンプラン Team Edition にサブスクライブしていることを確認してください。

次のいずれかの方法で設定ファイルを変更します：

リソース不足とエージェントの共存

• リソース要件：OpenClaw を安定して実行するには、少なくとも 2 コア、2 GB のメモリを搭載した Simple Application Server インスタンスを推奨します。低スペックのインスタンスでは、メモリ不足が OOM Killer をトリガーし、サービス停止時間を引き起こす可能性があります。

• スワップ領域：2026 年 2 月 26 日以降に作成されたイメージには、デフォルトでスワップ領域が含まれています。古いイメージを使用しているインスタンスの場合は、手動でスワップ領域を設定するか、最新のイメージに更新してメモリの圧迫を緩和することを推奨します。

• 共存リスク：OpenClaw と Hermes などの他のエージェントサービスを、同じ低スペックのサーバーにデプロイすることは避けてください。これにより、リソース競合、パフォーマンスの低下、または機能の競合が発生する可能性があります。各サービスは、別のインスタンスにデプロイしてください。