AI Market Maker Skill
目的
このスキルは、OpenClaw環境でマルチエージェントのLangGraph取引ワークフローを実行、分析、拡張するためのツールとドキュメントを提供します。
実行前の厳格なリスクガード拒否権、透明性のための構造化トレース、および専用のOpenClaw統合ツールが含まれています。
クイックスタート
インストール
# OpenClawから
claw install https://github.com/olaxbt/ai-market-maker
# またはローカルで
git clone https://github.com/olaxbt/ai-market-maker.git
cd ai-market-maker
claw skill install ./openclaw
確認
# 依存関係の確認
./openclaw/scripts/verify_installation.sh
# または
python3 openclaw/scripts/claw_runner.py --verify
使用方法
# デフォルト設定でバックテストを実行
python3 openclaw/scripts/claw_runner.py --backtest
# ペーパートレーディング
python3 openclaw/scripts/claw_runner.py --paper --ticker BTC/USDT
# カスタムバックテスト
python3 openclaw/scripts/claw_runner.py --backtest --symbols "BTC/USDT,ETH/USDT" --steps 150
デフォルト設定
デフォルト設定では複数のシンボルと控えめなリスクパラメータを使用します:
取引回数: 17
総リターン: 14.95%
BTCバイ＆ホールドに対する超過リターン: +30.25%
シャープレシオ: 1.79
最大ドローダウン: 11.84%
勝率: 62.5%
これらの結果は、BTC、ETH、SOLの過去100日間の履歴データに基づき、完全なベンチマーク比較とリスクイベントログを含みます。
🔧 OpenClaw固有の機能
自動環境設定
- OpenClaw環境向けのPythonパス設定
- Nexus APIキー管理（デモキー含む）
- TA-Lib依存関係の検出とガイダンス
- Claw向けに最適化されたエラーリカバリとログ記録
事前設定済みコマンド
# カスタムティッカーでペーパートレーディング
claw run ai-market-maker --paper --ticker ETH/USDT
# 複数シンボルでバックテスト
claw run ai-market-maker --backtest --symbols "BTC/USDT,ETH/USDT" --steps 150
# インストール確認
claw run ai-market-maker --verify
よくある問題と修正
1. TA-Libのインストール
問題: ModuleNotFoundError: No module named 'talib'
解決策:
# sudoがない環境で推奨
conda install -y ta-lib -c conda-forge
# 代替案: ソースコンパイル
wget http://prdownloads.sourceforge.net/ta-lib/ta-lib-0.4.0-src.tar.gz
tar -xzf ta-lib-0.4.0-src.tar.gz
cd ta-lib/
./configure --prefix=$HOME/.local
make
make install
export LD_LIBRARY_PATH=$HOME/.local/lib:$LD_LIBRARY_PATH
pip install ta-lib
2. モジュールインポートエラー
問題: ModuleNotFoundError: No module named 'agents.market_scanner'
解決策:
# 開発モードでインストール
pip install -e .
# またはPythonパスを設定
export PYTHONPATH=/path/to/ai-market-maker/src:$PYTHONPATH
3. Nexus APIレート制限
問題: 429 Too Many Requests
解決策:
- デモキーは含まれています（レート制限あり）
- 本番環境では
.envに独自のNexus APIキーを設定 - リクエストキャッシュを実装
4. 環境設定
問題: 環境変数が設定されていない 解決策:
# claw_runner.pyによる自動設定
# 手動オーバーライド:
export NEXUS_API_KEY=your_key
export AIMM_DESK_STRATEGY_PRESET=default
📊 Flow API（外部ツール向け）
このリポジトリは、軽量でほとんど読み取り専用のHTTP APIを公開しています:
GET /runs/latest→ 最新の実行データGET /runs/{run_id}/payload→ 実行の完全ペイロードGET /runs/{run_id}/events→ イベントとトレースGET /pm/portfolio-health→ ポートフォリオサマリーGET /backtests→ バックテスト実行の一覧
セキュリティ
AIMM_API_KEYとAIMM_AUTH_SECRETは常に必須です（出荷時デフォルトはありません）。- 空の値は未設定として扱われます。初回起動時に
.secrets/以下に一意のキーが書き込まれます。 GET /healthを除くすべてのFlow APIリクエストにはx-api-key（または同じキーを使用したAuthorization: Bearer）が必要です。- 本番環境では、Flow APIをリバースプロキシの背後に配置し、
AIMM_CORS_ORIGINSをダッシュボードのオリジンに設定してください。
OpenClaw統合用の主要ファイル
| エリア | 場所 | 目的 |
|---|---|---|
| OpenClawランナー | openclaw/scripts/claw_runner.py | メインエントリポイント |
| インストール確認ツール | openclaw/scripts/verify_installation.sh | 依存関係チェッカー |
| スキルマニフェスト | openclaw/manifest.json | OpenClawスキル定義 |
| 使用例 | openclaw/examples/claw_usage.md | 使用方法ガイド |
| メインワークフロー | src/main.py | コア取引ロジック |
| エージェントシステム | src/agents/ | 7つの取引デスク |
| Webダッシュボード | web/ | Next.js監視UI |
パフォーマンスのヒント
- キャッシュを有効にする: ローカルのOHLCVキャッシュでAPI呼び出しを削減
- インターバルを調整する:
STRATEGY_INTERVAL_SECを増やすとリソース使用量が低下 - ペーパーモードを使用する: 実際の資金を使わずに戦略をテスト
- リソースを監視する: メモリ/CPU使用量を確認
貢献
私たちは貢献を歓迎します！最初にメインのCONTRIBUTING.mdをお読みください。
優先分野:
- エラーハンドリングの改善
- インストールの簡素化
- パフォーマンスの最適化
- ドキュメントの拡充
貢献方法:
# 1. リポジトリをフォーク
# 2. 機能ブランチを作成
git checkout -b feature/improvement
# 3. 変更を加える
# 4. 確認スクリプトでテスト
./openclaw/scripts/verify_installation.sh
# 5. プルリクエストを送信
ドキュメント
利用可能なガイド
- クイックスタート:
README.md - OpenClaw使用方法:
openclaw/examples/claw_usage.md - 韓国語ガイド:
openclaw/examples/korean_guide.md - 技術ドキュメント:
docs/ディレクトリ
サポート
- GitHub Issues: https://github.com/olaxbt/ai-market-maker/issues
- ドキュメント:
docs/ディレクトリおよびopenclaw/examples/
バージョン: 1.0.0 最終更新日: 2026-04-17