OpenClaw

OpenClaw は、個人のデバイス上で実行されるオープンソースの AI アシスタントです。ゲートウェイを通じてモデル、セッション、ツール、メッセージチャネルを一元管理し、端末TUIとブラウザ制御UIを提供します。 AGTCloud をカスタム Providerとして追加すると、OpenClaw は OpenAI Chat Completions 互換エンドポイントを通じて API Key で現在利用可能なモデルを呼び出すことができます。

このチュートリアルでは、ローカル インストール、モデルへのアクセス、ゲートウェイの起動、および基本的な検証のみを完了します。メッセージ チャネル、リモート ゲートウェイ、ClawHub プラグイン、スキル、MCP、スケジュールされたタスク、およびマルチエージェント機能は、このページでは展開されません。

事前準備

開始前に、次の項目を確認してください。

• OpenClaw がサポートする macOS、Linux、WSL2、または Windows デバイスを準備します。
• API Keys ページに AGTCloud API Keyを作成します。
• モデルマーケットプレイスから、現在の API Key で利用でき、Chat Completions に対応するモデル ID をコピーします。
• 本番用認証情報や機密性の高いソースコードが含まれないテストディレクトリを準備します。

MODEL_ID は、置き換える必要があるプレースホルダーです。ツール呼び出しをテストするには、現在のAPI Keyで利用可能で、ツール呼び出しを明示的にサポートしているモデルを選択します。

OpenClawをインストールする

OpenClaw 公式インストーラーは、必要に応じて、サポートされている Node.js ランタイム環境を準備できます。すでに Node.js を自​​分で管理しているお客様は、npm を使用してインストールすることもできます。

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

インストールが完了したら、バージョンと動作環境を確認します。

openclaw --version
openclaw doctor

インストーラーが自動的にブート ウィザードを開く場合は、最初にモデル設定ステップを終了し、以下の AGTCloud Provider 設定を完了してから、openclaw onboard --install-daemon を実行できます。これにより、ブートストラップは検証されたデフォルトのモデル設定を保持できるようになります。

API Keyを安全に保存する

OpenClaw は、~/.openclaw/.env をグローバル環境変数フォールバック ファイルとして読み取ります。まずファイルを作成してから、AGTCloud API Key と書き込みます。

~/.openclaw/.env

ファイルの内容:

AGTCLOUD_API_KEY=your-api-key

このファイルには実際の認証情報が含まれています。コードリポジトリへコミットしたり、共有ストレージにアップロードしたり、トラブルシューティングの添付ファイルとして送信したりしないでください。

AGTCloud Custom Providerを追加する

OpenClaw はカスタム Provider を models.providers に保存します。このチュートリアルでは差分を反映する設定コマンドを使い、既存の openclaw.json を上書きせずに agtcloud Provider をマージします。

openclaw config set models.providers.agtcloud \
  '{"baseUrl":"https://api.agtcloud.cn/v1","apiKey":"${AGTCLOUD_API_KEY}","api":"openai-completions","auth":"api-key","authHeader":true,"models":[{"id":"MODEL_ID","name":"MODEL_ID","input":["text"]}]}' \
  --strict-json \
  --merge

構成内の主要なフィールドは次のとおりです。

このチュートリアルでは、モデルをテキスト入力として宣言するだけで、未確認のコンテキストの長さ、最大出力、価格、推論、またはイメージング機能は入力されません。対象モデルの実際の機能を確認した後、OpenClaw 公式モデル フィールドの説明に従ってメタデータを補足できます。

モデルを設定して設定を確認する

登録したばかりのモデルをデフォルト モデルとして設定します。

openclaw models set agtcloud/MODEL_ID

設定ファイル、Provider モデル、現在のデフォルト モデルを確認します。

openclaw config validate
openclaw models list --provider agtcloud
openclaw models status

config validate が無効なフィールドを報告した場合は、まず構成を修正し、ゲートウェイの起動を続行しないでください。モデルリストに agtcloud/MODEL_ID がない場合は、モデルに models.providers.agtcloud.models が追加されているかどうかを確認してください。

実際の接続検出を実行する必要がある場合は、次を実行できます。

openclaw models status --probe

ローカルセットアップを完了してGatewayを起動する

Provider 構成が完了したら、ローカル ブートを実行し、ゲートウェイ デーモンをインストールします。

openclaw onboard --install-daemon

ウィザードでモデル設定を要求された場合は、既存のモデル設定を保持することを選択します。メッセージ チャネル、Web Search、スキル、およびその他の拡張機能は、現時点ではスキップできます。初めての構成では、ゲートウェイがローカル マシンのみをリッスンし、アクセス認証を保持することをお勧めします。

完了したら、再起動してゲートウェイを確認します。

openclaw gateway restart
openclaw gateway status

ゲートウェイを起動できない場合は、最初に openclaw config validate と openclaw doctor を実行します。オープン パブリック ネットワークの監視を使用したり、一時的なバイパス ソリューションとして認証を無効にしたりしないでください。

起動して接続を確認する

Control UIまたはターミナルTUIを開く

ブラウザーのコントロール UI を使用する場合:

openclaw dashboard

または、ターミナルでローカル ゲートウェイに接続します。

openclaw tui

基本的なテキスト応答を確認する

初めて以下を開きます。

以下にのみ返信してください。AGTCloud 接続は成功しました。ツールを呼び出さないでください。

指定したテキストが返されれば、Gateway、AGTCloud Provider、API Key、モデル ID を使った基本的な接続を確認できます。

任意：読み取り専用ツールの機能を確認する

通常の会話が安定していることを確認したら、セキュリティテストプロジェクトに以下を開きます。

README.mdを読み、プロジェクトの目的を3点で要約してください。ファイルを変更したり、他のコマンドを実行したりしないでください。

OpenClawが提案する各操作を確認し、対象ファイルの読み取りに必要な権限だけを許可します。通常の対話は成功するものの、このステップが失敗する場合は、対象モデルまたは現在の互換エンドポイントが必要なツール呼び出し構造に完全対応していない可能性があります。

モデルを追加または切り替える

OpenClaw のモデル参照形式は provider/model であるため、AGTCloud モデルは次のように記述されます。

agtcloud/MODEL_ID

カスタム Providerは、AGTCloud /v1/models のすべての結果の自動読み取りを保証しません。モデルを追加する必要がある場合は、新しいモデル オブジェクトを models.providers.agtcloud.models にマージし、次のコマンドを使用して切り替える必要があります。

openclaw models set agtcloud/MODEL_ID
openclaw gateway restart

モデル名を変更した後、そのモデルが現在の API Key に表示され、対応するプロトコルをサポートしていることを確認する必要があります。そうしないと、モデルが存在しない、または使用できないというエラーが発生する可能性があります。

よくある質問

特定できない問題が発生した場合は、OpenClaw バージョン、リクエスト時刻、Base URL、Provider、モデルID、HTTP ステータス、および機密情報を除いたエラー情報を記録し、エラーとトラブルシューティング を確認してください。 .env、完全な設定のバックアップ、または任意の API Keyをコミットしないでください。

セキュリティ上の推奨事項

• OpenClaw 単一の信頼できるオペレータ向けに設計されており、保護されていないゲートウェイをパブリック ネットワークに公開しないでください。
• 最初のテストには分離されたディレクトリのみを使用し、ファイル、コマンド、ネットワーク、およびツールの権限を 1 つずつ確認してください。
• API Keyをリポジトリ、スクリーンショット、セッション エクスポート、ログ、または共有設定に保存しないでください。
• メッセージング チャネル、他のユーザー、または自動化されたタスクに接続する前に、OpenClaw の公式セキュリティおよびサンドボックスのドキュメントをお読みください。

次のステップ

• API Key と認証
• Chat Completions API Reference
• エラーとトラブルシューティング
• OpenClaw 公式ドキュメント