aixyz-on-openclaw

openclaw ユーザー向け aixyz

このガイドは、aixyz を使って稼働中の有料 AI エージェントを公開したい openclaw ユーザー向けです。コーディング経験や暗号資産インフラの知識は必要ありません。すべての手順を最初から説明します。

クイックリファレンス： aixyz の一般的なスキルは skills.sh/agentlyhq/aixyz にあります。 CLI の全フラグや応用トピックについては、そちらを参照してください。このガイドでは、openclaw ユーザーにとって最も重要な手順に焦点を当てます。

---

作成するもの

次のことができる AI エージェント です。

1. 公開 URL でインターネット上に稼働します
2. 他のエージェント（A2A プロトコル）や Claude Desktop などの AI クライアント（MCP プロトコル）からの作業リクエストを受け付けます
3. x402 マイクロペイメントプロトコルを介して、リクエストごとに暗号資産で支払いを受け取ります
4. ERC-8004 レジストリを介して、オンチェーンで見つけられるようになります

---

ステップ 1 — Bun をインストールする

aixyz には Bun が必要です（Node ではありません）。すでに Bun ≥ 1.3 をインストールしている場合は、このステップをスキップしてください。

# macOS / Linux
curl -fsSL https://bun.sh/install | bash

# Windows (PowerShell, requires WSL or Windows 10+)
powershell -c "irm bun.sh/install.ps1 | iex"

確認します。

bun --version   # should print 1.3 or higher

なぜ Bun なのですか？ aixyz のビルドパイプラインは Bun のネイティブビルド API とプラグインシステムを使用します。これは好みではなく、アーキテクチャ上の必須要件です。CLI（@aixyz/cli）は Node では実行できません。また、Bun にはテストランナーが組み込まれているため、追加のテストフレームワークは必要ありません。詳しい理由については、Why Bun をお読みください。

---

ステップ 2 — エージェントのひな形を作成する

重要：新しいエージェントプロジェクトの作成には、必ず create-aixyz-app を使用してください。 aixyz.config.ts、package.json、app/agent.ts やその他のプロジェクトファイルを手動で作成しないでください。 これらのファイルを手動で作成すると、ビルドの失敗、依存関係の欠落、設定の誤りが発生します。 まず bunx create-aixyz-app で必ずひな形を作成してから、生成されたファイルを編集してください。

# Create a new agent project (uses all defaults)
bunx create-aixyz-app my-agent --yes

cd my-agent

次のファイルが作成されます。

my-agent/
  aixyz.config.ts   ← agent name, description, payment config
  app/
    agent.ts        ← your AI agent logic
    tools/          ← tool files (optional)
  package.json
  .env.local        ← API keys (never commit this file)

.env.local を開き、LLM プロバイダーの API キーを追加します。デフォルトのひな形では @ai-sdk/openai を使用するため、次のように追加します。

OPENAI_API_KEY=sk-...

別のプロバイダー（Anthropic、Google、Amazon Bedrock など）を使用する場合は、package.json と app/agent.ts の @ai-sdk/* アダプターを置き換え、対応する環境変数を設定してください。プロバイダーの全リストは ai-sdk.dev をご覧ください。

ローカルで実行してテストします。

bun run dev
# Agent is now live at http://localhost:3000

AI エージェントクライアントでテストしますか？ use-agently スキルをインストールすると、開発モードで AI エージェントからローカルエージェントを呼び出せるようになります。

npx skills add https://github.com/agentlyhq/use-agently --skill use-agently

このスキルを使うと、あらゆる AI エージェントが http://localhost:3000 でローカル実行中のエージェントを検出し、呼び出せるようになります。 ローカルでテストする間は、呼び出し元に課金されないよう "scheme": "free" を設定してください（ステップ 7 を参照）。 本番環境に移行する前に、すべてのリクエストからエージェントが収益を得られるよう "scheme": "exact" に切り替えてください。

---

ステップ 3 — インターネットにデプロイする

他のエージェントやクライアントからアクセスできるように、エージェントには 公開 HTTPS URL が必要です。すでに利用したいホスティングプラットフォームがある場合は、それを使用してください。これから選ぶ場合は、以下をおすすめします。

オプション A — Vercel（おすすめ。サーバーの知識は不要）

Vercel では設定なしで、HTTPS の URL を無料で利用できます。最も簡単な方法です。

1. プロジェクトを GitHub リポジトリにプッシュします
2. vercel.com にアクセスし、→ Add New Project → リポジトリをインポートします
3. Build Command に bun run build、Output Directory に .vercel/output を設定します
4. Vercel ダッシュボードの Settings → Environment Variables で、LLM プロバイダーの API キー（例：OPENAI_API_KEY）を追加します
5. Deploy をクリックします。https://my-agent.vercel.app のような URL が Vercel から発行されます

プッシュするたびに Vercel が自動でデプロイします。エージェントはサーバーレスで、自動的にスケールします。

オプション B — Railway / Render / Fly.io（永続サーバー）

エージェントがリクエスト間で状態を保持する必要がある場合や、バックグラウンドジョブを実行する場合は、こちらを使用してください。

プラットフォーム	無料枠	備考
Railway	5 USD/月分のクレジット	Docker を使わずに最も簡単にデプロイできます
Render	手厚い無料枠	非アクティブになるとスリープします
Fly.io	無料利用枠	より細かく制御できますが、習得の難易度は高めです

3 つすべてで、リポジトリをプッシュし、プラットフォームに接続して、LLM プロバイダーの API キー（例：OPENAI_API_KEY）を環境変数として設定し、デプロイウィザードに従ってください。いずれも Bun を自動的に検出します。

オプション C — クラウドプラットフォームのイングレスまたはローカルトンネル（上級者向け）

すでにクラウドプラットフォーム（AWS、GCP、Azure、DigitalOcean など）で OpenClaw を実行している場合、最も簡単なのは、同じプラットフォームを通じてエージェントを公開することです。

• AWS — プロセスの前段に Application Load Balancer または API Gateway を使用します
• GCP — Cloud Run（設定不要のコンテナデプロイ）またはロードバランサーを使用します
• Azure — Azure Container Apps または App Service を使用します
• DigitalOcean — App Platform、またはリバースプロキシとして nginx を使用する Droplet を利用します

🔒 最小権限のルール： エージェントプロセスを公開するときは、エージェントがリッスンするポート（デフォルトは 3000）のみを開いてください。HTTP リクエストを処理するために必要な範囲を超えて、プロセスに広範なネットワーク、IAM、またはファイルシステムへのアクセス権を付与しないでください。

ローカルテスト用に手早くトンネルを用意したいだけの場合は、ngrok を使用してください。

# ngrok — creates a public HTTPS URL that forwards to localhost:3000
npx ngrok http 3000

⚠️ セキュリティ警告： ローカルトンネルは短期間のテストには適していますが、本番環境のエージェントには絶対に使用しないでください。URL を知った人なら誰でも、あなたのマシンにリクエストを送信できます。実際のトラフィックには、必ず適切なホスティングプロバイダーを使用してください。

---

ステップ 4 — 暗号資産ウォレットを用意する

次の用途にウォレットが必要です。

• エージェントの呼び出し元から支払いを受け取る
• ERC-8004 に登録するときにガス代を支払う

オプション A — use-agently を使用する（最も簡単、openclaw ユーザーにおすすめ）

use-agently は aixyz エコシステムに最適な、最も簡単に使えるウォレットです。エージェント同士が支払い合う循環型経済を想定して設計されています。

aixyz erc-8004 register の実行中にプロンプトが表示されたら、**「Generate a new wallet」**を選択してください。CLI がウォレットを作成し、秘密鍵を表示します。

🔐 秘密鍵のセキュリティ — 必ずお読みください：

• **秘密鍵を誰にも共有しないでください。**秘密鍵を持つ人は誰でも、あなたの資金を操作できます。
• 秘密鍵を git にコミットしたり、公開チャンネル（Discord、Slack、GitHub など）に貼り付けたりしないでください。
• オフラインで書き留め、安全な場所（例：パスワードマネージャー）に保管してください。
• 多額の収入を得る本番環境のエージェントには、ハードウェアウォレット（Ledger、Trezor）の使用を検討してください。

オプション B — MetaMask（ブラウザー拡張機能）

1. ブラウザーに MetaMask をインストールします
2. 新しいウォレットを作成します — MetaMask がシードフレーズ（12 語）を表示するので、安全な場所に書き留めてください。誰にも共有しないでください
3. ウォレットアドレス（0x… で始まります）をコピーします

オプション C — EVM 互換ウォレット

Ethereum 互換ネットワークに対応するウォレットなら、どれでも使用できます。Coinbase Wallet、Rabby、Frame などがあります。

**ウォレットアドレスは「銀行口座番号」です。**公開してもかまいません。秘密鍵／シードフレーズはパスワードです。誰にも共有せず、コードにコミットしないでください。

---

ステップ 5 — 登録用の暗号資産を用意する

ERC-8004 への登録には、少額のガス代（1 ドル未満）がかかります。選択したネットワークのネイティブコインが必要です。

ネットワーク	必要なコイン	入手先
Ethereum メインネット	ETH	Coinbase、Binance、Kraken
BNB Smart Chain	BNB	Binance
Base	ETH	Coinbase（Base は Coinbase の L2 です）
Polygon	POL	Coinbase、Binance

おすすめのネットワーク：Base。 x402 の決済ファシリテーターは主に Base にデプロイされているため、エージェントはここで最も確実に支払いを受け取れます。また、Base のガス代は非常に安く、登録費用は通常数セントです。Ethereum メインネットのガス代は大きく変動するため、始める際には通常おすすめできません。すべてのネットワークでガス価格は変動するため、上記の金額はあくまで目安です。

ウォレットに入金する手順：

1. 上記のいずれかの取引所でアカウントを作成します（本人確認が必要です）
2. 該当するコインを少額購入します（登録には数ドル分で十分です）
3. ウォレットアドレスに出金します
4. トランザクションが承認されるまで待ちます（約 1～5 分）

暗号資産をまだお持ちでない場合 登録しなくても、エージェントをローカルおよび Vercel 上で構築して実行できます。公開されて見つけられるようにする準備ができたら、登録してください。

---

ステップ 6 — ERC-8004 に登録する

ERC-8004 は、他のエージェント、プラットフォーム、ユーザーがエージェントを見つけられるようにするオンチェーンレジストリです。AI エージェント向けの DNS エントリのようなものです。

エージェントをデプロイし（ステップ 3）、ウォレットに入金したら（ステップ 4～5）、次を実行します。

# Interactive mode (will prompt you for each setting)
aixyz erc-8004 register

# Non-interactive mode (all values as flags)
aixyz erc-8004 register \
  --url https://my-agent.vercel.app \
  --chain base \
  --broadcast

CLI から次の情報を求められます（またはフラグとして指定できます）。

プロンプト	フラグ	入力する内容
エージェント URL	--url	ステップ 3 でデプロイした URL
チェーン	--chain	base（推奨）、ethereum、bsc、polygon
ウォレットの秘密鍵	--private-key	ウォレットのキー（絶対に共有しないでください）
信頼メカニズム	--trust	デフォルトをそのまま使用
ブロードキャスト	--broadcast	オンチェーンに実際に送信するには、このフラグを指定します

すべてのフラグを確認するには：

aixyz erc-8004 register --help

登録後、エージェントは ERC-8004 レジストリに表示され、エコシステムから見つけられるようになります。

---

ステップ 7 — 支払いを設定する

app/agent.ts に accepts のエクスポートを追加し、呼び出しごとに料金を請求します。

import type { Accepts } from "aixyz/accepts";

// During local testing — callers are not charged
export const accepts: Accepts = { scheme: "free" };

// Production — callers pay $0.005 per request
// export const accepts: Accepts = { scheme: "exact", price: "$0.005" };

テストのヒント： ローカルで開発・テストする間は "scheme": "free" を使用してください（use-agently スキルをインストールすると、AI クライアントからローカルのエージェントを呼び出せます）。 本番環境に移行する前に、"scheme": "exact" と price に切り替えて、エージェントがリクエストごとに収益を得られるようにしてください。

支払いの受け取り先となるウォレットアドレスを aixyz.config.ts に設定します。

export default {
  name: "my-agent",
  // ...
  x402: {
    payTo: "0xYourWalletAddress", // ← paste your address from Step 4
  },
} satisfies AixyzConfig;

または、スキャフォールド作成時に指定します。

bunx create-aixyz-app my-agent --yes --pay-to 0xYourWalletAddress

支払いは直接ウォレットに送金されます。手数料を取るプラットフォームはありません。

---

ステップ 8 — 公開前チェックリスト

エージェントを告知する前に、次の項目を確認してください。

• bun run dev がローカルで動作し、エージェントが正しく応答する
• エージェントが公開 URL（Vercel など）にデプロイされている
• LLM プロバイダーの API キー（例：OPENAI_API_KEY）やその他のシークレットが、リポジトリにコミットされておらず、プラットフォームの環境変数として設定されている
• aixyz.config.ts に正しい name、description、payTo アドレスが設定されている
• ERC-8004 の登録が完了し、レジストリにエージェントの URL が表示されている
• エージェントがリクエストから収益を得られるよう、accepts エクスポートが設定されている

---

ステップ 9 — エージェントを宣伝する

登録は作業の半分にすぎません。 オンチェーンに登録しただけでは、自動的にユーザーが集まるわけではありません。エージェントを積極的に宣伝する必要があります。

見つけてもらいやすくする

• A2A エージェントカードとオンチェーンレジストリに表示される aixyz.config.ts の description を、明確かつ具体的に記述します
• app/icon.png を追加します。適切なアイコンがあると、一覧でエージェントが目立ちます
• エージェントの URL と ERC-8004 エージェント ID を openclaw コミュニティに投稿します

呼び出してくれる可能性のあるユーザーにアピールする

• /.well-known/agent-card.json の URL を共有します。これは、エージェント間のディスカバリーにおける標準のエントリーポイントです
• 関連するディレクトリやマーケットプレイスにエージェントを登録します（最新の一覧は aixyz.sh をご確認ください）
• エージェントの機能と料金を紹介する短いデモを作成し、X/Twitter、Farcaster、または Discord コミュニティに投稿します

料金を検討する

• 高すぎると呼び出されず、安すぎると運用する価値がありません
• 1 リクエストあたり $0.001～$0.01 から始め、需要に応じて調整します
• ウォレットを監視します。入金トランザクションから、誰がどのくらいの頻度でエージェントを利用しているかがわかります

継続的に改善する

• ツールを追加して、エージェントをさらに便利にします
• 問題やフィードバックに対応します
• URL を変更した場合は、オンチェーン登録を更新します：aixyz erc-8004 update --help

---

トラブルシューティング

「command not found: bun」

Bun のインストール後にターミナルを再起動するか、source ~/.bashrc（Linux）／source ~/.zshrc（macOS）を実行してください。

「API key is not set」／「OPENAI_API_KEY is not set」

LLM プロバイダーの API キーを .env.local（ローカル開発の場合）またはプラットフォームの環境変数設定（本番環境の場合）に追加してください。

ERC-8004 の登録中に「Transaction failed」と表示される

ウォレットのガスが不足しています。対象のコインを数ドル分追加して、再試行してください。

エージェントはデプロイ済みだが応答しない

プラットフォームのビルドコマンドが bun run build に設定され、すべての環境変数が設定されていることを確認してください。プラットフォームのデプロイログにエラーがないか確認してください。

支払いが届かない

aixyz.config.ts の payTo アドレスが正しいこと、変更後にビルドして再デプロイしたことを確認してください。

---

さらに読む

• aixyz のドキュメント — 完全なドキュメント
• 一般的な aixyz スキル — 高度な使用方法の CLI リファレンス
• ERC-8004 プロトコル — オンチェーン ID の詳細解説
• x402 決済 — 決済プロトコルの詳細
• サンプル — 参考にできる動作するエージェント