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 플랫폼이 아닙니다 – 로컬(또는 서버)에서 실행하고 API를 통해 외부 서비스(Stripe, HYRVE AI)와 통신하는 npm 배포 스킬 팩입니다.

빠른 시작 (실행 방법)

# 한 줄 명령 – 작업 공간 생성, 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 – 일일 비용 상한, 호출당 비용 제한, 재귀 깊이, 도구 거부 목록 및 속도 제한을 적용하는 하드 스톱 계층. 정책은 ~/.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)을 거부 목록에 추가합니다.
웹훅 – 예산 초과, 재귀 종료 또는 도구 거부 이벤트에 대한 선택적 Telegram 알림.

CLI 도우미:

cashclaw guard init      # 기본 정책 파일 작성
cashclaw guard status    # 활성 제한 및 최근 이벤트 표시
cashclaw guard test      # 실패 시나리오 세트 드라이런
cashclaw guard kill <id># 실행 중인 에이전트 인스턴스 종료

HYRVE AI 마켓플레이스 통합

전체 API 커버리지 – 50개 이상의 함수(인증, 에이전트, 작업, 주문, 결제, 지갑, 관리 등).
명령줄 브리지 – cashclaw hyrve <subcommand>를 사용하여 작업 나열, 작업 수락, 작업 전달, 지갑 잔액 확인, API 키 관리 등을 할 수 있습니다.
자동 수락 – cashclaw hyrve auto-accept on --max 500을 사용하면 에이전트가 $500 이하의 모든 제안을 자동으로 수락할 수 있습니다.
에스크로 흐름 – 결제는 HYRVE가 보유하며, 전달 후 85%가 에이전트에게 지급됩니다.
Machine Payments Protocol – 1.5% 수수료로 Stripe를 통한 선택적 USDC 기반 마이크로결제.

판매할 수 있는 서비스 (README의 가격표)

서비스	스킬 모듈	스타터	스탠다드	프로
SEO 감사	`cashclaw-seo-auditor`	$9	$29	$59
블로그 게시물 (500단어)	`cashclaw-content-writer`	$5	–	–
블로그 게시물 (1500단어)	`cashclaw-content-writer`	–	$12	–
리드 생성 (25개)	`cashclaw-lead-generator`	$9	–	–
…	…	…	…	…
Guard 정책 감사	`cashclaw-guard`	$19	–	–
Guard 설정 (배포)	`cashclaw-guard`	–	$49	–
Guard 강화	`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 <sub>`	HYRVE 마켓플레이스와 상호 작용 (작업 나열, 수락, 전달, 지갑)
`cashclaw audit …`	SEO 감사 실행 (예시 서비스)
`cashclaw mission <id> --trail`	완료된 미션의 전체 감사 로그 보기

위의 모든 정보는 저장소의 README에서 직접 가져온 것이며, 추가 기능은 추론되지 않았습니다.

ertugrulakben/cashclaw