mcpField
A
agentbox-bootstrap

agentbox-bootstrap

github.com/cascade-protocolエージェントワークフロー1337 回インストール31 週間前に更新
リポジトリ

agentbox-bootstrap について

agentbox-bootstrapは、OpenClawを実行するAgentBoxエージェントインスタンスの運用ガイドです。サービス管理、モデルプロバイダーの設定、ウォレットとx402の操作、スキル更新、トラブルシューティングを説明します。

主な機能

  1. 01OpenClawゲートウェイと関連サービスの管理
  2. 02LLMプロバイダーとモデルの設定
  3. 03残高と取引履歴の確認
  4. 04トークン、スワップ、決済ツールの利用
  5. 05スキル更新と一般的な問題の調査

活用シーン

  1. 01設定変更後のゲートウェイ再起動
  2. 02設定済みモデルプロバイダーの切り替え
  3. 03ウォレット残高の確認やUSDCの送金
  4. 04ゲートウェイやx402決済の障害調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/cascade-protocol/agentbox --skill agentbox-bootstrap

インストール後、Claude Code で/agentbox-bootstrapを入力して読み込まれたか確認します。

詳細

AgentBox の運用手順

専用の AgentBox エージェント上で実行されています。OpenClaw ゲートウェイ、HTTPS、ウェブターミナル、x402 マイクロペイメント用の Solana ウォレットを備えた、単一テナントのクラウドインスタンスです。

サービス

サービスポート管理方法
OpenClaw ゲートウェイ:18789（ループバック）openclaw gateway restart
Caddy（HTTPS リバースプロキシ）:443sudo systemctl restart caddy
ttyd（ウェブターミナル）:7681（ループバック）sudo systemctl restart ttyd

Caddy は HTTPS トラフィックをゲートウェイとターミナルにルーティングします。Caddy や systemd の設定を直接変更しないでください。

主なパス

対象パス
OpenClaw 設定~/.openclaw/openclaw.json
Solana ウォレット~/.openclaw/agentbox/wallet-sol.json
EVM ウォレット~/.openclaw/agentbox/wallet-evm.key
ニーモニック（ルートシークレット）~/.openclaw/agentbox/mnemonic
ワークスペース~/.openclaw/workspace/
スキル（管理対象）~/.openclaw/skills/
x402 プラグイン~/.openclaw/extensions/openclaw-x402/
ゲートウェイログ~/.openclaw/logs/

x402 決済プラグイン

openclaw-x402 プラグインは globalThis.fetch をパッチして、HTTP 402 Payment Required レスポンスを自動的に処理します。LLM の推論呼び出しが 402 を返すと、プラグインは Solana 上で USDC 決済に署名して再試行します。この処理は透過的に行われるため、特別な操作は必要ありません。

決済を利用するには、~/.openclaw/agentbox/wallet-sol.json のウォレットに USDC 残高が必要です。残高は /x_wallet または次のコマンドで確認できます。

spl-token balance --owner $(solana address) EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

コマンドとツール

スラッシュコマンド：

  • /x_wallet - 残高、トークン保有状況、最近の取引を表示するウォレットダッシュボード
  • /x_wallet send <amount|all> <address> - Solana アドレスに USDC を送金
  • /x_wallet history [page] - ページ分けされた取引履歴
  • /x_status - システムの概要（バージョン、モデル、料金、ウォレットの概要）
  • /x_update - プラグインとスキルを更新し、ゲートウェイを再起動

エージェントツール：

  • x_balance - ウォレットの SOL および USDC 残高を確認
  • x_swap - Solana トークンを別のトークンに交換（SOL、USDC、ミームトークン、任意の SPL トークン）
  • x_launch_token - pump.fun で新しいトークンをローンチ
  • x_token_info - トークンの価格、時価総額、取引量、流動性を検索
  • x_payment - x402 対応の有料 API を呼び出す

スワップには Jupiter アグリゲーターを使用して最適なルートを選択し、ボンディングカーブトークンの場合は自動的に PumpPortal にフォールバックします。金額は入力トークン単位で指定し、スリッページはベーシスポイント単位です（デフォルト：250 = 2.5%）。

デフォルトのモデルプロバイダー

このインスタンスには、x402 を利用する設定済みの LLM プロバイダー（blockrun）が含まれています。OpenRouter などの別のプロバイダーを使用するには、以下の「OpenRouter の設定」セクションを参照してください。

OpenRouter の設定

OpenRouter を LLM プロバイダーとして設定し、単一の API キーで Claude、GPT、Gemini などを利用する手順：

  1. API キーを取得する：https://openrouter.ai で登録し、https://openrouter.ai/keys に移動して、キーを作成します（sk-or- で始まります）。

  2. OpenClaw を設定する：

jq --arg key "sk-or-USER_KEY_HERE" \
   --arg model "openrouter/anthropic/claude-sonnet-4-5" \
   '.env.OPENROUTER_API_KEY = $key | .agents.defaults.model.primary = $model' \
   ~/.openclaw/openclaw.json > /tmp/openclaw-update.json \
   && mv /tmp/openclaw-update.json ~/.openclaw/openclaw.json
  1. ゲートウェイを再起動する：openclaw gateway restart

人気のモデル：openrouter/anthropic/claude-sonnet-4-5、openrouter/anthropic/claude-opus-4-6、openrouter/openai/gpt-4o、openrouter/google/gemini-2.5-pro。一覧は https://openrouter.ai/models で確認できます。

後からモデルを切り替える（API キーを再入力せずに切り替える場合）：

jq --arg model "openrouter/anthropic/claude-opus-4-6" \
   '.agents.defaults.model.primary = $model' \
   ~/.openclaw/openclaw.json > /tmp/openclaw-update.json \
   && mv /tmp/openclaw-update.json ~/.openclaw/openclaw.json
openclaw gateway restart

ゲートウェイの再起動

~/.openclaw/openclaw.json の設定を変更した後は、次のコマンドを実行してください。

openclaw gateway restart

ステータスを確認します。

openclaw status

スキルの更新

最新の AgentBox スキルを取得するには、次のコマンドを実行してください。

npx skills add -g cascade-protocol/agentbox

スキルは ~/.openclaw/skills/（OpenClaw の管理対象スキルパス、自動検出）にインストールされます。変更は次の新しいセッションから反映されます。

トラブルシューティング

  • ゲートウェイが起動しない：openclaw status と ~/.openclaw/logs/ にあるゲートウェイのログを確認してください
  • x402 の支払いに失敗する：USDC の残高を確認してください（上記を参照）。ウォレットには Solana のメインネット上の USDC が必要です。
  • 設定の変更が反映されない：~/.openclaw/openclaw.json を編集した後、openclaw gateway restart を実行してください
  • スキルが表示されない：ls ~/.openclaw/skills/ を確認してください。更新するには npx skills add -g cascade-protocol/agentbox を実行してください。
  • 「無効な API キー」（OpenRouter）：キーが sk-or- で始まっていること、および https://openrouter.ai/credits にクレジットがあることを確認してください
  • モデルが応答しない（OpenRouter）：https://openrouter.ai/models でモデルの利用状況を確認してください
  • 編集後に設定が壊れた：cat ~/.openclaw/openclaw.json | jq . で JSON の構文を確認してください

重要なルール

  • ゲートウェイの再起動には必ず openclaw gateway restart を使用してください。ゲートウェイの再起動に systemctl を直接使用しないでください。
  • ~/.openclaw/openclaw.json を編集するときは、まず現在のファイルを読み込み、変更してから書き戻してください。部分的な設定を書き込まないでください。
  • ウォレットキーは ~/.openclaw/agentbox/（wallet-sol.json、wallet-evm.key、mnemonic）にあります。共有したり、ユーザーに表示したりしないでください。

コメント

Markdown 対応