Simple Application Server:OpenClaw（旧称：MoltBotおよびClawbot）よくある質問

既存のサーバーにOpenClawをデプロイする

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

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

3. OpenClawを再構成します。システムのリセットにより、以前のAPIキーおよびトークンが無効になります。[アプリケーションの詳細] に移動して、APIキーを再設定してください。

イメージを最新バージョンにリセットする

現在のイメージが Openclaw 2026.3.13でない場合、システムをリセットしてイメージを更新し、最新のOpenClaw機能をご利用ください。

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

2. [オペレーティングシステムのリセット] を選択します。

3. OpenClawを再構成します。リセットにより、以前のAPIキーおよびトークンが無効になります。[アプリケーションの詳細] に移動して、APIキーを再設定してください。

OpenClawのポート番号

悪意のあるスキャンおよび標的型攻撃を防止するため、OpenClawは初期化時にランダムなポートを自動生成します。ポート番号を確認するには、[アプリケーションの詳細] > [基本構成] > [ポートの表示] に移動し、[表示] をクリックします。

OpenClawはローカルアプリケーションを制御できますか？

対応していません。 Simple Application Serverは、ローカルネットワークとは隔離されたクラウド環境で実行されるため、OpenClawはローカルコンピューター上のアプリケーションを直接制御できません。

OpenClawの更新後にWeb検索が利用できなくなる

Simple Application Serverコンソールに移動します。[イメージ情報] セクションで、アプリケーションイメージが OpenClaw 2026.2.3 以降に更新されていることを確認します。そうでない場合は、「現在のアプリケーションイメージを最新バージョンにリセットする方法」をご参照ください。このアプリケーションイメージバージョンでは、組み込みのSearXNGスキルを通じて、すべてのリージョンでデフォルトのWeb検索が提供されます。追加の構成や料金は不要です。OpenClawにSearXNGスキルを使用してWeb検索を実行するよう直接指示できます。サーバーが中国（香港）リージョンまたは中国以外のリージョンに展開されている場合は、「OpenClawでBrave SearchをWeb検索用に構成する方法」をご参照ください。

サードパーティモデルプロバイダーを構成する

OpenClawイメージは、Model Studioプロバイダー で事前に構成されています。設定からモデルを変更できます。OpenAI、Anthropic、Google Geminiなどの他のプロバイダーのサービスに接続するには、以下の手順に従います。

1. Simple Application Serverに admin ユーザーとしてログインします。

2. モデルプロバイダーを変更します。この例ではOpenRouterを使用します。

   openclaw onboard

   

3. Webコンソールにログインし、エージェントとチャットして変更を確認します。

OpenClawのモデルを変更する方法

OpenClawはAlibaba Cloud Model Studioと統合されており、ページ上で異なるモデル間を切り替えることができます。[アプリケーションの詳細] > [モデル構成] > [モデル構成] で、デフォルトのモデルを削除し、ドロップダウンリストから別のModel Studioモデルを選択します。

モデル名を手動で入力することもできます。モデルコードは、Model Studioマーケットプレイス ページで確認できます。

OpenClawにスキルを追加する

OpenClawでは、会話によるインタラクション、リンクベースのインストール、中継元からのインストールという3つの方法でスキルを追加できます。

• 会話によるインタラクション（新しいスキルの場合）

  OpenClawには組み込みの [スキル作成者] コンポーネントがあります。スキル作成者と直接チャットし、要件を説明すると、自動的に新しいスキルが作成されます。

• リンクベースのインストール（既存のスキルを再利用する場合）

  既存のスキルをインストールするには、そのURLをOpenClawに送信すると、自動的にインストールされます。たとえば、Anthropicの Web Artifacts Builder をインストールするには、そのURLをエージェントに送信します。

• 中継元からのインストール（ネットワーク制限のある環境の場合）

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

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

  2. コードをOSSなどのアクセス可能なストレージスペースにアップロードします。OSS。

  3. 新しいダウンロードリンクを取得し、リンクベースのインストール の手順に従って、OpenClawにスキルをインストールします。

カスタムスキルの読み込みと優先順位

はい。設定項目 ~/.openclaw/openclaw.json の skills.load.extraDirs を設定することで、追加のディレクトリ（最低優先順位）を指定できます。

デフォルトのスキル読み込み優先順位は次のとおりです：<workspace>/skills > ~/.openclaw/skills > 組み込み > skills.load.extraDirs。

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

OpenClawゲートウェイを再起動する

openclaw gateway restart

OpenClawの設定ファイル

• 設定ファイルディレクトリ：/root/.openclaw/

• メイン設定ファイル：/root/.openclaw/openclaw.json（使用中のモデルを指定）

• モデルAPIキー設定ファイル：/root/.openclaw/agents/main/agent/auth-profiles.json

これらのファイルを編集して、モデルを追加したり、APIキーを構成したりできます。

OpenClawでコーディングプランを手動で構成する

1. コーディングプラン固有のAPIキー をコピーして保存します。

2. 以下のコードブロックで、「"apiKey": "YOUR_API_KEY"」の YOUR_API_KEY を、コーディングプラン固有のAPIキー に置き換えます。

    "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": <span class="hljs-keyword">false</span>,
               "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をクリックして、OpenClawの会話ページを開きます。

5. [設定] > [すべての設定] > [Raw] をクリックして設定ファイルを開きます。修正済みの "apiKey" パラメーターを含むコードブロックをコピーします。下図に示すように、設定コード内の元の "agents"{...} の内容を、コピーしたブロックで置き換え、変更を保存します。

Web検索用にBrave Searchを構成する

Brave Searchの構成は、中国（香港）または中国以外のリージョンのSimple Application Serverインスタンスでのみ可能です。

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

1. Brave Search公式サイト でBrave Search APIアカウントを作成し、APIキーを生成します。

2. イメージを構成するには、OpenClawページに移動し、ナビゲーションペインで [設定] > [すべての設定] > [Raw] をクリックして設定ファイルを開きます。BRAVE_API_KEY をご自身のBrave Search APIキーに変更し、以下のコードブロックをコピーして、図に示す場所に設定ファイルに貼り付けます。

     "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
         }
       }
     },

   

Dockerコンテナ内でツールを実行する

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

一般的なOpenClaw CLIツール

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

無料クォータのみを使用して課金を回避する

デフォルトでは、Model Studio の大規模言語モデル （シンガポール地域） は、無料クォータが上限に達した後に課金されます。追加のモデル呼び出し課金を回避するには、Model Studio コンソールで無料クォータの上限に達したときに停止するを有効化します。この設定を有効化すると、モデルの無料クォータが上限に達した時点でモデルは利用不可になります。その後、利用可能な無料クォータを持つ別のモデルに切り替えることができます。

インスタンス構成要件

サービスパフォーマンスを確保するには、最低でも2 vCPUおよび2 GBのメモリを備えた構成を選択してください。

OpenClawの追加課金

Model StudioのAPIキーを使用してOpenClawでモデルを呼び出す場合、トークン使用量に基づいて課金されます。課金の詳細については、「モデル呼び出しの課金」ドキュメントをご参照ください。

シンガポールリージョンにおける無料クォータの確認

Model Studioコンソールにログインします。[無料クォータ] エリアで、モデルの残りの無料クォータを確認できます。

モデル呼び出し記録の表示

リージョン別の違い：シンガポール、米国（バージニア）、中国（北京）

Alibaba Cloud Model Studioは、シンガポール、米国（バージニア）、および中国（北京）の各リージョンでモデルサービスを提供しています。ネットワーク遅延を低減するには、近隣のリージョンを選択してください。サービスエンドポイント（Endpoint／ベースURL）はリージョンごとに異なり、APIキーはリージョン間で互換性がありません。サポートされるモデル、プラットフォーム機能、および価格設定もリージョンごとに異なります。詳細については、「モデル一覧」をご参照ください。

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

1. APIキーの構成を確認します。 ご利用のSimple Application Serverにリモート接続します。以下のコードで、お使いのリージョンに対応するAPIキーおよびベースURLを置き換えます。更新されたコードをターミナルにコピー＆ペーストして、API呼び出しをテストします。エラーが発生した場合は、「エラーメッセージ」ドキュメントでエラーメッセージを検索し、解決策を確認してください。ベース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

   1. Analysis of the English text structure and meaning: This is an HTML code block containing a curl command with editable variables (YOUR_API_KEY_BASE_URL and YOUR_API_KEY). The HTML includes extensive JavaScript event handlers for editing functionality, tooltips, and clipboard handling. The code itself shows a POST request to an API endpoint with authorization headers and JSON payload. 2. Identification of technical terms and their proper translations: - "curl" remains as "curl" (standard command name) - "POST" remains as "POST" (HTTP method) - "Authorization: Bearer" remains as "Authorization: Bearer" (standard HTTP header) - "Content-Type: application/json" remains as "Content-Type: application/json" (standard MIME type) - JSON keys like "model", "messages", "role", "content", "user" should remain in English as they are part of the API specification - The tooltip text "Edit" needs translation based on language context, but since this is Japanese output, it should be "編集" 3. Consideration of context and tone: This is a technical code example for developers, so the translation must preserve all technical accuracy while making the UI elements (like tooltip) appropriate for Japanese users. The HTML structure and attributes must be preserved exactly. 4. Draft translation with reasoning: - The HTML structure and all attributes must remain unchanged - The tooltip text in the onmouseover handler needs to be translated to Japanese ("編集") - The code content itself should remain in English since it's actual code that users will copy/paste - The variable placeholders (YOUR_API_KEY_BASE_URL, YOUR_API_KEY) remain in English as they are placeholders - All JavaScript event handlers remain unchanged except for the tooltip label 5. Optimization and final review: - Verify all HTML tags and attributes are preserved - Confirm the tooltip text is correctly translated to "編集" - Ensure no technical terms are incorrectly translated (e.g., "POST", "Bearer", JSON keys) - Check spacing rules: Japanese text should have half-width spaces before English words/numbers - Since this is a code block, only the tooltip text needs translation, not the code content

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

   1. コーディングプラン： このプランには、1時間ごと、週ごと、月ごとのリクエスト制限があります。クォータ使用状況は、[コーディングプランコンソール] で確認できます。制限を超えると、エラーが返されます：hour/week/month allocated quota exceeded。

      解決策： クォータが自動的にリセットされるのを待つか、Pro版にアップグレードしてください。

   2. 従量課金制Model Studio APIキー：

      1. 無料クォータを確認します。Model Studio コンソールにログオンします。[無料クォータ] エリアで、アカウントの残りの無料クォータを確認できます。

      2. 支払い遅延を確認します。[課金管理] センターにアクセスして、支払い遅延がないか確認します。

3. エラーログのトラブルシューティング： OpenClawチャットページに移動し、ナビゲーションペインで [ログ] をクリックします。WARN および ERROR を選択してエラーログを表示し、OpenClaw FAQ ドキュメントでエラーの解決策を検索します。

   

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

4. イメージをリセットする

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

   重要

   オペレーティングシステムのリセット は、オペレーティングシステムの再インストールと同等です。この操作により、保存された構成、ログ、データベースを含むシステムディスク上のすべてのデータが消去されます。実行前に、スナップショットを作成するか、ローカルデバイスにエクスポートすることで、重要なデータをバックアップ する必要があります。

OpenClawページでHTTP 401エラーが発生する

このエラーは、トークンが期限切れになったことを意味します。これを解決するには、Simple Application Serverコンソールのアプリケーション詳細ページに移動し、OpenClawログインURLを再生成して、再度試行してください。

スキルのインストールがブロックされる

OpenClaw管理インターフェイスでは、一部のスキルコンポーネントに対してワンクリックインストールがサポートされています。ただし、Homebrewに依存するコンポーネントでは、この方法は利用できません。これらのスキルを使用するには、まずサーバーにHomebrewをインストールし、その後インストールを完了する必要があります。

"Disconnected (1008): unauthorized"エラー

このエラーは、アクセスリンクに認証トークンが欠落していることを示します。OpenClaw Webコンソールでは、トークンによるアクセスが必要であり、IPアドレスによる直接アクセスは許可されていません。[サーバーコンソール] で、サーバーカード上のインスタンスIDをクリックしてサーバーの概要ページを開きます。[アプリケーションの詳細] タブをクリックします。[アクセス制御] ページで、[コマンドの実行] をクリックして、必要なトークンを含む正しいアクセスURLを取得します。

"Disconnected (1008)"エラー

このエラーは、トークンが初期化されていないことを示します。これを解決するには、Simple Application Serverコンソールのアプリケーション詳細ページに移動し、APIキーを設定してから、新しいアクセスリンクを取得してください。

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

トラブルシューティングのために、以下の手順に従います。

1. Alibaba Cloud Simple Application Serverコンソールから、ご利用のインスタンスのアプリケーション詳細ページに移動し、トークンを再生成します。

2. 新しいトークンを http://XXX:18789/?token=new_token の形式でURLに追加し、シークレットウィンドウで新しいURLをテストします。

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

4. ご利用のSimple Application Serverのセキュリティグループが、リスニングポートへのインバウンドTCPトラフィックを許可していることを確認します。

   サービスがパブリックIPアドレスに正しくバインドされていない場合、またはリバースプロキシの構成が誤っている場合、WebSocket接続が失敗する可能性があります。トラブルシューティングを開始するには、curlまたはtelnetを使用して、ローカルマシンから接続性をテストします。

"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": "あなたは誰ですか？"
        }
    ]
}'

"command not found: openclaw"エラーの解決

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

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ポート18789が外部アクセスをブロックする

OpenClawサービスのポート18789のリスニングアドレスは 127.0.0.1 であり、外部ネットワークからのアクセスを防いでいます。

原因の可能性： OpenClaw設定ファイルの bind パラメーターが変更されています。デフォルトでは、このパラメーターは 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. サーバーにログインします。 Simple Application Serverに admin ユーザーとしてログインします。

2. 現在のプロセスを終了します。 以下のコマンドを実行して、現在のOpenClaw Gatewayプロセスを強制終了します：

   killall openclaw-gateway

3. サービスを再起動します。 以下のコマンドを実行して、ゲートウェイサービスを再起動します：

   openclaw gateway start

   注： このコマンドによって表示されるエラーメッセージは、安全に無視できます。

4. サービスのステータスを確認します。 ps aux | grep gate を実行して、openclaw-gateway プロセスが起動していることを確認します。その後、netstat -nltp を実行して、関連するポートがリスニング状態であることを確認します。

   

ダウンタイム、高メモリ使用率、OOM Killerのトラブルシューティング

• インスタンス構成のアップグレード
  インスタンス構成を少なくとも2 vCPUおよび2 GBのメモリにアップグレードすることを推奨します。これにより、OpenClawの安定性が向上し、リソース不足によるサーバーダウンタイム、Webサイトのアクセス不能、高メモリ使用率などの問題を防止できます。
  
  

• スワップ領域の確認および追加
  2026年2月26日以降にリリースされたOpenClawアプリケーションイメージには、デフォルトでスワップ領域が含まれています。インスタンスがそれより前のバージョンを実行している場合、スワップ領域を手動で構成するか、現在のアプリケーションイメージを最新バージョンにリセットすることを推奨します。スワップ領域は、メモリが不足した場合のバッファーとして機能し、OOM Killerイベントおよび予期しないサービス中断を軽減します。