Kalshi-Claw：自然言語で予測市場取引を操作できるOpenClawオープンソーススキル

Kalshi-Clawは、OpenClaw向けのオープンソーススキルで、自然言語でKalshi予測市場の完全な取引機能を提供します。主要な予測市場プラットフォームはAPIが整備されていなかったり、RSA署名や仓位管理を自前で実装する必要があったりしますが、Kalshi-Clawはこれらすべてを抽象化します。

プロジェクトはRust + TypeScriptのデュアルエンジン設計を採用：Rustコア（napi-rsでNode.jsネイティブアドオンにコンパイル）がRSA-2048署名、ケリー基準による最適ポジションサイジング、ヘッジスコアリングなどのCPU集約型タスクを処理し、TypeScript層がKalshi REST APIと直接やり取りして市場閲覧と注文執行を行います。「KXFED-25DEC-T525のYESポジションを$50分買う」と言うだけで、最適な契約数を計算し、RSA署名を行い、注文を送信して仓位を記録します。

最大の特徴はLLMによるヘッジ発見機能です。トレンド市場をスキャンし、Rustによる事前スコアリングでペアを順位付けした後、厳密な対偶論理（相関関係や確率的関係は拒否）でLLMが上位候補を検証します。結果はカバレッジ85%以上のヘッジ組み合わせをT1（≥95%）、T2（90–95%）、T3（85–90%）の3段階で表示。全仓位データは~/.kalshi-claw/positions.jsonにローカル保存され、サードパーティサーバーを経由しません。macOSワンコマンドインストーラーが全依存関係を自動処理します。

プロジェクト背景

Kalshiは米国規制の中央集権型予測市場取引所です。Polymarket（オンチェーンERC-20契約）とは異なり、Kalshiは従来の金融に近い仕組みで動作します：RSAキーペア認証、REST API注文送信、指値注文メカニズム。統合のハードルは依然として高く、RSA署名、契約数量の計算、仓位管理はすべて自前で実装する必要があります。Kalshi-ClawはこれらすべてをOpenClawエージェントエコシステム内の自然言語コマンドに抽象化します。

技術アーキテクチャ

Rustコア（src/） napi-rsでNode.jsネイティブアドオンにコンパイルされ、以下を処理：

`auth.rs`：RSA-2048 PKCS#1 v1.5リクエスト署名
`orderbook.rs`：板情報解析、最良気配、契約数量計算
`hedge.rs`：バッチヘッジスコアリング、カバレッジ層分け、ペアランキング
`sizing.rs`：ケリー基準、ドルポジションサイジング、最大損益計算

TypeScript層（lib/, scripts/） API通信とCLIを処理：

`kalshiClient.ts`：完全なKalshi REST APIクライアント
`llmClient.ts`：OpenRouter LLM統合（ヘッジ検証用）
`positionStorage.ts`：~/.kalshi-claw/にローカルJSON仓位保存
`display.ts`：ANSIターミナルUI（テーブル、P&Lカラー表示）

主要機能

市場閲覧

kalshi-claw markets trending           # 24h出来高上位市場
kalshi-claw markets search "fed rate"  # キーワード検索
kalshi-claw market <ticker>            # 市場詳細 + リアルタイム板情報

取引実行

kalshi-claw buy <ticker> YES <amount>  # YESポジション購入
kalshi-claw buy <ticker> NO <amount>   # NOポジション購入
kalshi-claw sell <ticker> YES          # YESポジション決済

システムがケリー最適契約数を計算し、RSA署名して現在の売値で指値注文を送信します。

ポジション管理

kalshi-claw positions  # リアルタイムP&Lを含む保有ポジション一覧

データは`~/.kalshi-claw/positions.json`にローカル保存。外部サーバーを経由しません。

ヘッジ発見（最大の特徴）

kalshi-claw hedge scan                           # トレンド市場をスキャン
kalshi-claw hedge scan --query "federal reserve" # トピック指定スキャン
kalshi-claw hedge analyze <ticker-A> <ticker-B>  # 特定ペアの分析

パイプライン：

1. 公開市場リストを取得

2. Rustエンジンでバッチ事前スコアリング：カバレッジ = 1 − (1−pA)(1−pB)

3. 上位候補をLLM（OpenRouter）に送信して論理検証

4. **厳密な対偶論理のみ — 相関関係や確率的関係は拒否**

5. カバレッジ層を出力：T1（≥95%）/ T2（90–95%）/ T3（85–90%）

インストール

macOSワンコマンドインストール：

curl -fsSLk https://github.com/Kirubel125/Kalshi-Claw/archive/refs/heads/main.zip -o /tmp/cw.zip && \
unzip -qo /tmp/cw.zip -d /tmp && \
cd /tmp/Kalshi-Claw-main && \
bash install.sh

インストーラーが自動処理：Xcode CLIツール、Homebrew、Rustツールチェーン、Node.js 20+、napi-rs CLI、コンパイル。

環境設定

| 変数 | 必須 | 説明 |

|------|------|------|

| KALSHI_API_KEY | はい | Kalshi API Key UUID |

| KALSHI_PRIVATE_KEY | はい（取引） | RSA秘密鍵（PKCS#1 PEM形式） |

| KALSHI_USE_DEMO | いいえ | true=ペーパートレード（デフォルト：true） |

| OPENROUTER_API_KEY | はい（ヘッジ） | OpenRouter APIキー |

| MAX_BET | いいえ | 1取引あたり最大USD（デフォルト：25） |

| DRY_RUN | いいえ | falseで実際の注文送信 |

注意：RSA秘密鍵はPKCS#1形式（-----BEGIN RSA PRIVATE KEY-----）である必要があります。PKCS#8は非対応。

ユースケース

**イベント駆動型取引**：FRB金利決定、CPI発表、選挙結果 — KalshiのメインマーケットをAIエージェントがリアルタイムで監視して戦略を実行
**リスクヘッジ**：ヘッジ発見機能で論理的に関連した高カバレッジのペアを見つけてヘッジポジションを構築
**戦略テスト**：DEMOモードでリアル資金リスクなしに戦略を検証
**情報シグナル**：予測市場価格は社会的期待の集合表現 — モニタリングでシグナルとして活用可能

制限事項

現在macOSのみ対応（インストールスクリプト）
ヘッジ発見にはOpenRouter APIキーが必要（無料枠あり）
RSA秘密鍵のフォーマット要件が厳格 — 設定エラーが最も一般的な問題
教育・実験目的のみ — 投資アドバイスではありません