OpenClaw

OpenClaw は実験的な自律型 AI エージェントフレームワークです。カスタム取引エージェントを構築したい場合や、高度な AI パイプラインと統合したい場合に利用します。

前提条件

• OpenClaw がインストール・設定済み
• FIX 認証情報（始める前にを参照）

Portal Token 方式

OpenClaw は主に Bearer トークン認証を使用します。

Step 1: トークンを生成する

ブラウザで次の URL にアクセスします:

https://mcp.axiory.ai/token-portal

1. ブローカーサーバーを選択
2. FIX 認証情報を入力
3. 取引モード（readonly/paper/live）を選択
4. Generate Token をクリック
5. すぐにトークンをコピー（一度しか表示されません）

Step 2: OpenClaw を設定する

openclaw.json 設定ファイルを編集します:

{
  "mcpServers": [
    {
      "name": "axiory-ai",
      "url": "https://mcp.axiory.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  ]
}

YOUR_TOKEN_HERE を Token Portal で取得したトークンに置き換えます。

Step 3: OpenClaw を初期化する

OpenClaw エージェントを起動します:

openclaw run --config openclaw.json

Step 4: 接続をテストする

OpenClaw エージェントに次のように尋ねます:

“Check your connection to cTrader and show me my current positions”

エージェントがアカウントのステータスを返します。

OpenClaw でカスタム取引エージェントを使う

OpenClaw はカスタムエージェントの構築に強力です。例:

# OpenClaw エージェント定義内:
tools:
  - axiory-ai/get_positions
  - axiory-ai/place_order
  - axiory-ai/get_quote

strategy:
  - name: "Daily MA Crossover"
    trigger: "Daily at 8:00 UTC"
    actions:
      - fetch_quote: "EURUSD"
      - calculate_ma_20: "EURUSD"
      - calculate_ma_50: "EURUSD"
      - if: "MA_20 > MA_50"
        then: "buy 100000 units of EURUSD"
      - else: "close all EURUSD positions"

最初の取引を行う

設定が完了したら:

openclaw ask "Buy 50,000 units of EURUSD at market price"

または、人間の入力なしで実行される、より複雑な自律的戦略を構築できます。

トークンローテーション

Portal トークンは 30 日で失効します。期限切れの前に:

1. Token Portal にアクセス
2. 新しいトークンを生成
3. openclaw.json を新しいトークンで更新
4. エージェントを再起動

トークンが失効すると、「401 Unauthorized」が表示されます。新しいトークンを生成してください。

トラブルシューティング

「Server connection failed」

確認事項:

1. openclaw.json が有効な JSON である（構文エラーなし）
2. サーバー URL が正確: https://mcp.axiory.ai/mcp
3. ヘッダーに Bearer トークンが設定されている
4. トークンが失効していない（生成から 30 日有効）

「Invalid token」または「401 Unauthorized」

トークンが失効しているか無効です:

1. Token Portal にアクセス
2. 新しいトークンを生成
3. openclaw.json を新しいトークンで更新
4. エージェントを再起動

「FIX connection timeout」

FIX 認証情報が誤っているか、ブローカーのサーバーに到達できない可能性があります:

1. 認証情報を確認: SenderCompID、FIX API Password（ログインパスワードではない）
2. Token Portal でトークンを再生成してみる — これにより認証情報が検証される
3. ネットワークがブローカーの FIX サーバーに到達可能か確認（TCP ポート 5212/5211）

エージェントが取引を実行しない

確認事項:

1. エージェントが有効化され、稼働しているか
2. 取引モードが live に設定されているか（readonly や paper ではない）
3. エージェントにリスク制限が設定されているか
4. エラーメッセージのためエージェントログを確認

カスタムエージェントを構築する

OpenClaw を使えば、高度な取引ロジックを定義できます:

# 例: ヘッジエージェント
triggers:
  - position_size_limit_exceeded: true
    action: place_hedge_order

rules:
  - if: "daily_loss > loss_limit"
    then: "kill_switch"
  - if: "volatility > 2%"
    then: "reduce_position_size"

完全な構文については OpenClaw のドキュメントを参照してください。

安全のヒント

• 必ず paper モードで先にテストしてから live 取引を有効化する
• エージェント設定で保守的なリスク制限を設定する
• エージェントの挙動を監視する — 設定して放置しない
• 手動キルスイッチを用意する — エージェントを即座に停止できる手段
• 初期テストには readonly モードを使用する

次のステップ

• 運用モード — readonly、paper、live を理解する
• リスク制限 — ポジションサイズと日次損失制限
• エージェントの選び方 — 他の MCP クライアントとの比較

OpenClaw は上級者向けです。ライブエージェントをデプロイする前に、十分に理解する時間をとってください。