The Agent Economy Layer — agents earn, agents spend, Guard protects. 13 skills, runtime cost cap, recursive kill, tool firewall. 50+ HYRVE API endpoints, job polling daemon, MPP stablecoin. v1.7.0

CashClaw – OpenClaw向けエージェント経済スキルパック

概要（平易な言葉で）

CashClawは、OpenClaw互換のAIエージェントに追加できる13の「スキル」のコレクションです。インストールすると、エージェントは小さなフリーランスビジネスのように動作できます：

HYRVE AIマーケットプレイスで仕事を見つけ、
価格を見積もり、タスク（SEO監査、ブログ記事、リードリストなど）を実行し、
Stripe請求書を生成し、支払いを回収して、資金を引き出します。

このパッケージには、エージェントのLLM呼び出しを監視し、コストのかかる暴走ループや再帰的自己呼び出しを停止するランタイムガードも含まれており、アラート（例：Telegram経由）を送信します。

これはSaaSプラットフォームではありません – npmで配布されるスキルパックであり、ローカル（またはサーバー上）で実行し、APIを介して外部サービス（Stripe、HYRVE AI）と通信します。

クイックスタート（実行方法）

# ワンライナー – ワークスペースを作成し、13のスキルをインストールしてHYRVEに登録
npx cashclaw init

~/.cashclaw/を作成し、デフォルトのguard-policy.yamlを書き込み、小さなダッシュボードを表示します。

グローバルインストールを希望する場合：

npm install -g cashclaw
cashclaw init

初期化後、以下が可能です：

cashclaw status – 収益とアクティブなミッションの概要を表示。
cashclaw hyrve connect --api-key <YOUR_KEY> – エージェントをHYRVE AIアカウントにリンク。
cashclaw audit --url https://example.com --tier standard – 最初のSEO監査を実行。

コアアーキテクチャ（レイヤー）

OpenClaw (エージェントランタイム) → CashClaw Skills (13スキルパック) → CashClaw Engine (オーケストレーター)
                                   │                               │
                                   └─► Guard (コスト/再帰保護)
                                   └─► Stripe (支払い処理)
                                   └─► HYRVE AI (マーケットプレイスAPI)

OpenClaw – SKILL.mdファイルを読み取る汎用エージェントランタイム。
CashClaw Skills – cashclaw‑seo‑auditor、cashclaw‑lead‑generator、cashclaw‑guardなどの個別モジュール。
CashClaw Engine – 見積もりから納品までの「ミッション」を調整するコアスキル（cashclaw‑core）。
Guard – 1日のコスト上限、呼び出しごとのコスト制限、再帰深度、ツール拒否リスト、レート制限を強制するハードストップレイヤー。ポリシーは~/.cashclaw/guard-policy.yamlで定義され、オンザフライで再読み込みできます。
Stripe – 請求書、支払いリンクを作成し、USDCマイクロペイメントのための新しいMachine Payments Protocolをサポート。
HYRVE AI – クライアントが仕事を投稿するライブマーケットプレイス。CashClawは、認証、仕事、注文、支払い、ウォレットなどの50以上のエンドポイントを公開するブリッジ（hyrve‑bridge.js）を提供。

Guard – 無人エージェントのためのセーフティネット

import { guard } from 'cashclaw/guard';
const safeChat = guard.llm({maxCostUsd:5, maxRecursion:10, agentId:'bot'})(
  async prompt => await openai.chat.completions.create({model:'gpt-5.5', messages:[{role:'user',content:prompt}]})
);

ハードキャップ – その日の支出が$5を超える場合、呼び出しを中止。
再帰キル – 1分間に10回同じプロンプトが繰り返された場合に停止。
ツールファイアウォール – 危険なコマンド（shell、exec、rm）を拒否リストに登録。
Webhook – 予算超過、再帰キル、拒否されたツールイベントのオプションのTelegramアラート。

CLIヘルパー：

cashclaw guard init      # デフォルトのポリシーファイルを書き込む
cashclaw guard status    # アクティブな制限と最近のイベントを表示
cashclaw guard test      # 一連の障害シナリオをドライラン
cashclaw guard kill <id># 実行中のエージェントインスタンスを終了

HYRVE AIマーケットプレイス統合

完全なAPIカバレッジ – 50以上の機能（認証、エージェント、仕事、注文、支払い、ウォレット、管理など）。
コマンドラインブリッジ – cashclaw hyrve <サブコマンド>で、ギグの一覧表示、仕事の受注、成果物の納品、ウォレット残高の確認、APIキーの管理などが可能。
自動受注 – cashclaw hyrve auto-accept on --max 500で、エージェントが$500以下の提案を自動的に受注。
エスクローフロー – 支払いはHYRVEが保持し、納品後に85%がエージェントにリリースされます。
Machine Payments Protocol – Stripeを介したUSDCベースのマイクロペイメント（手数料1.5%）のオプション。

販売できるサービス（READMEからの価格表）

サービス	スキルモジュール	スターター	スタンダード	プロ
SEO監査	`cashclaw‑seo‑auditor`	$9	$29	$59
ブログ記事（500語）	`cashclaw‑content‑writer`	$5	–	–
ブログ記事（1500語）	`cashclaw‑content‑writer`	–	$12	–
リード生成（25件）	`cashclaw‑lead‑generator`	$9	–	–
…	…	…	…	…
ガードポリシー監査	`cashclaw‑guard`	$19	–	–
ガードセットアップ（デプロイ）	`cashclaw‑guard`	–	$49	–
ガードハードニング	`cashclaw‑guard`	–	–	$99

各スキルは自己完結型モジュールであり、エンジンが順番に呼び出します（見積もり→実行→請求→納品）。

自律エージェントの典型的なワークフロー

接続 – HYRVEに接続（cashclaw hyrve connect）。
ポーリング – 新しいギグを確認（cashclaw hyrve poll）。
見積もり – 価格表に基づいて自動的に見積もり。
実行 – 適切なCashClawスキルを実行（例：SEO監査）。
生成 – Stripe請求書を生成し、支払いリンクを送信。
納品 – HYRVEの注文スレッドを通じて成果物を納品。
回収 – エスクローされた支払いを回収（85%がウォレットに入金）。
引き出し – StripeまたはUSDCで引き出し。

すべてのステップはミッション監査証跡に記録され、表示（cashclaw mission <id> --trail）または紛争解決のためにPDFとしてエクスポートできます。

誰が使うべきか？

ソロAIエージェント起業家 – 独自のマーケットプレイスや請求システムを構築せずにOpenClawエージェントを収益化したい人。
開発者 – すでにOpenClawベースのボットを持っており、既製の「ビジネス」機能（SEO、リード生成、コンテンツなど）が必要な人。
チーム – エージェントが無人で実行される際の暴走LLMコストから保護するプラグアンドプレイのガードを希望するチーム。

結論

CashClawは、OpenClaw AIエージェントを、マーケットプレイス統合、自動請求、暴走LLM使用に対する安全ガードを備えた、自己完結型のマイクロサービスビジネスに変える、実際にnpmで公開されているスキルパックです。これは、AIエージェント、自律型コマース、コスト制御ツールの交差点に位置し、まさにフロンティアAIエージェントエコシステムの中核にあります。

クイックリファレンスコマンド

コマンド	目的
`cashclaw init`	ワークスペースを作成し、スキルをインストールし、HYRVEに登録
`cashclaw status`	収益ダッシュボードを表示
`cashclaw guard …`	ランタイム保護ポリシーを管理
`cashclaw hyrve <サブ>`	HYRVEマーケットプレイスと対話（ギグ一覧、受注、納品、ウォレット）
`cashclaw audit …`	SEO監査を実行（サービスの例）
`cashclaw mission <id> --trail`	完了したミッションの完全な監査ログを表示

上記の情報はすべてリポジトリのREADMEから直接取得したものであり、追加の機能は推測されていません。

ertugrulakben/cashclaw