cashclaw 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +281 -0
  3. package/bin/cashclaw.js +2 -0
  4. package/missions/blog-post-1500.json +21 -0
  5. package/missions/blog-post-500.json +19 -0
  6. package/missions/lead-list-50.json +20 -0
  7. package/missions/seo-audit-basic.json +19 -0
  8. package/missions/seo-audit-pro.json +23 -0
  9. package/missions/social-media-weekly.json +19 -0
  10. package/missions/whatsapp-setup.json +22 -0
  11. package/package.json +45 -0
  12. package/skills/cashclaw-content-writer/SKILL.md +245 -0
  13. package/skills/cashclaw-core/SKILL.md +251 -0
  14. package/skills/cashclaw-invoicer/SKILL.md +395 -0
  15. package/skills/cashclaw-invoicer/scripts/stripe-ops.js +441 -0
  16. package/skills/cashclaw-lead-generator/SKILL.md +246 -0
  17. package/skills/cashclaw-lead-generator/scripts/scraper.js +356 -0
  18. package/skills/cashclaw-seo-auditor/SKILL.md +240 -0
  19. package/skills/cashclaw-seo-auditor/scripts/audit.js +401 -0
  20. package/skills/cashclaw-social-media/SKILL.md +374 -0
  21. package/skills/cashclaw-whatsapp-manager/SKILL.md +357 -0
  22. package/src/cli/commands/dashboard.js +72 -0
  23. package/src/cli/commands/init.js +290 -0
  24. package/src/cli/commands/status.js +174 -0
  25. package/src/cli/index.js +496 -0
  26. package/src/cli/utils/banner.js +44 -0
  27. package/src/cli/utils/config.js +170 -0
  28. package/src/dashboard/public/app.js +329 -0
  29. package/src/dashboard/public/index.html +139 -0
  30. package/src/dashboard/public/style.css +464 -0
  31. package/src/dashboard/server.js +224 -0
  32. package/src/engine/earnings-tracker.js +184 -0
  33. package/src/engine/mission-runner.js +224 -0
  34. package/src/engine/scheduler.js +139 -0
  35. package/src/integrations/hyrve-bridge.js +213 -0
  36. package/src/integrations/openclaw-bridge.js +207 -0
  37. package/src/integrations/stripe-connect.js +204 -0
  38. package/templates/config.default.json +83 -0
  39. package/templates/invoice.html +260 -0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Ertugrul Akben
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,281 @@
1
+ <p align="center">
2
+ <img src="https://cashclaw.ai/logo.png" alt="CashClaw Logo" width="120" />
3
+ </p>
4
+
5
+ <h1 align="center">CashClaw</h1>
6
+
7
+ <p align="center">
8
+ <strong>Turn your OpenClaw into a money-making machine.</strong>
9
+ </p>
10
+
11
+ <p align="center">
12
+ <a href="#what-is-cashclaw">What is CashClaw?</a> &middot;
13
+ <a href="#quick-start">Quick Start</a> &middot;
14
+ <a href="#how-it-works">How It Works</a> &middot;
15
+ <a href="#available-services">Services</a> &middot;
16
+ <a href="#dashboard">Dashboard</a> &middot;
17
+ <a href="#commands">Commands</a> &middot;
18
+ <a href="#hyrveai-integration">HYRVEai</a>
19
+ </p>
20
+
21
+ <p align="center">
22
+ <a href="https://www.npmjs.com/package/cashclaw"><img src="https://img.shields.io/npm/v/cashclaw?color=crimson&label=npm" alt="npm version" /></a>
23
+ <a href="https://github.com/AkbenLabs/cashclaw/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="license" /></a>
24
+ <a href="https://github.com/AkbenLabs/cashclaw/stargazers"><img src="https://img.shields.io/github/stars/AkbenLabs/cashclaw?style=social" alt="stars" /></a>
25
+ <a href="https://hyrveai.com"><img src="https://img.shields.io/badge/powered%20by-HYRVEai-ff6b35" alt="HYRVEai" /></a>
26
+ </p>
27
+
28
+ ---
29
+
30
+ > *"I deployed CashClaw on Friday. By Monday, my agent had completed 12 missions and earned $847."*
31
+ >
32
+ > -- Early beta tester
33
+
34
+ ---
35
+
36
+ ## What is CashClaw?
37
+
38
+ CashClaw is a set of **OpenClaw skills** that turn your AI agent into a freelance business operator.
39
+
40
+ Your agent wakes up. Checks the pipeline. Picks up a client request. Runs an SEO audit. Writes a blog post. Generates 50 qualified leads. Creates a Stripe invoice. Sends a payment link. Follows up three days later. Collects the money.
41
+
42
+ **You sleep. CashClaw works.**
43
+
44
+ It is not a framework. It is not a SaaS dashboard. It is a skill pack that plugs into any OpenClaw-compatible agent and gives it the ability to sell, deliver, and collect payment for digital services -- autonomously.
45
+
46
+ ```
47
+ No employees. No overhead. No invoicing headaches.
48
+ Just an agent, a Stripe account, and CashClaw.
49
+ ```
50
+
51
+ ## Quick Start
52
+
53
+ ```bash
54
+ npx cashclaw init
55
+ ```
56
+
57
+ That is it. CashClaw will:
58
+
59
+ 1. Create your `~/.cashclaw/` workspace
60
+ 2. Set up the mission pipeline
61
+ 3. Connect to Stripe (optional, you can add it later)
62
+ 4. Install all 7 skills into your OpenClaw agent
63
+ 5. Print your first dashboard
64
+
65
+ ```bash
66
+ # Or install globally
67
+ npm install -g cashclaw
68
+
69
+ # Initialize workspace
70
+ cashclaw init
71
+
72
+ # Check status
73
+ cashclaw status
74
+
75
+ # Run your first audit
76
+ cashclaw audit --url "https://your-client.com" --tier standard
77
+ ```
78
+
79
+ ## How It Works
80
+
81
+ ```
82
+ +------------------+ +---------------------+ +------------------+
83
+ | | | | | |
84
+ | OpenClaw |---->| CashClaw Skills |---->| CashClaw Engine |
85
+ | (Your Agent) | | (7 skill packs) | | (Orchestrator) |
86
+ | | | | | |
87
+ +------------------+ +---------------------+ +--------+---------+
88
+ |
89
+ v
90
+ +--------+---------+
91
+ | |
92
+ | Stripe |
93
+ | (Payments) |
94
+ | |
95
+ +--------+---------+
96
+ |
97
+ v
98
+ +--------+---------+
99
+ | |
100
+ | HYRVEai |
101
+ | (Marketplace) |
102
+ | |
103
+ +------------------+
104
+ ```
105
+
106
+ | Layer | What It Does |
107
+ |-------|-------------|
108
+ | **OpenClaw** | Your AI agent runtime. Reads SKILL.md files, executes instructions. |
109
+ | **CashClaw Skills** | 7 specialized skill packs (SEO, content, leads, invoicing, etc.). |
110
+ | **CashClaw Engine** | The `cashclaw-core` skill that orchestrates the mission lifecycle. |
111
+ | **Stripe** | Payment processing. Invoices, payment links, subscriptions, refunds. |
112
+ | **HYRVEai** | Optional marketplace where clients discover and hire CashClaw agents. |
113
+
114
+ ## Available Services
115
+
116
+ Every service has transparent, fixed pricing. No hourly rates. No surprises.
117
+
118
+ | Service | Skill | Starter | Standard | Pro |
119
+ |---------|-------|---------|----------|-----|
120
+ | SEO Audit | `cashclaw-seo-auditor` | $9 | $29 | $59 |
121
+ | Blog Post (500w) | `cashclaw-content-writer` | $5 | -- | -- |
122
+ | Blog Post (1500w) | `cashclaw-content-writer` | -- | $12 | -- |
123
+ | Email Newsletter | `cashclaw-content-writer` | $9 | -- | -- |
124
+ | Lead Generation (25) | `cashclaw-lead-generator` | $9 | -- | -- |
125
+ | Lead Generation (50) | `cashclaw-lead-generator` | -- | $15 | -- |
126
+ | Lead Generation (100) | `cashclaw-lead-generator` | -- | -- | $25 |
127
+ | WhatsApp Setup | `cashclaw-whatsapp-manager` | $19 | -- | -- |
128
+ | WhatsApp Monthly | `cashclaw-whatsapp-manager` | -- | $49/mo | -- |
129
+ | Social Media (1 platform) | `cashclaw-social-media` | $9/wk | -- | -- |
130
+ | Social Media (3 platforms) | `cashclaw-social-media` | -- | $19/wk | -- |
131
+ | Social Media (Full) | `cashclaw-social-media` | -- | -- | $49/mo |
132
+
133
+ **Custom packages available.** Combine services or request enterprise pricing.
134
+
135
+ ## Dashboard
136
+
137
+ CashClaw tracks everything. Check your numbers anytime:
138
+
139
+ ```bash
140
+ cashclaw status
141
+ ```
142
+
143
+ ```
144
+ CashClaw Dashboard
145
+ ==================
146
+
147
+ Today $58 | 3 missions completed
148
+ This Week $247 | 9 missions completed
149
+ This Month $847 | 31 missions completed
150
+ All Time $2,340 | 84 missions completed
151
+
152
+ Active Missions
153
+ ---------------
154
+ MISSION-20260223-014 SEO Audit (Pro) EXECUTE $59
155
+ MISSION-20260223-015 Lead Gen (50) DELIVER $15
156
+ MISSION-20260223-016 Blog Post (1500w) QUOTE $12
157
+
158
+ Pending Payments
159
+ ----------------
160
+ INV-0042 $29 Due Feb 28 client@acme.com
161
+ INV-0043 $49 Due Mar 01 hello@startup.io
162
+ ```
163
+
164
+ ## Commands
165
+
166
+ ```bash
167
+ # Core
168
+ cashclaw init # Initialize workspace
169
+ cashclaw status # Show dashboard
170
+ cashclaw missions # List all missions
171
+ cashclaw mission <id> # Show mission details
172
+
173
+ # SEO
174
+ cashclaw audit --url <URL> # Run SEO audit
175
+ cashclaw audit --url <URL> --tier pro --output report.md
176
+
177
+ # Content
178
+ cashclaw content --type blog --words 1500 --keyword "topic"
179
+ cashclaw content --type newsletter --topic "monthly update"
180
+ cashclaw content --type social --platform instagram --posts 5
181
+
182
+ # Leads
183
+ cashclaw leads --icp "saas,10-50,US" --count 50
184
+ cashclaw leads --query "ecommerce startups" --output leads.json
185
+
186
+ # WhatsApp
187
+ cashclaw whatsapp setup --config profile.yaml
188
+ cashclaw whatsapp templates --count 10 --industry "restaurant"
189
+
190
+ # Social Media
191
+ cashclaw social --platform linkedin --type weekly
192
+ cashclaw social --platforms all --type monthly
193
+ cashclaw social analytics --period "2026-02"
194
+
195
+ # Invoicing
196
+ cashclaw invoice --client "email" --amount 29 --service "SEO Audit"
197
+ cashclaw invoice --list --status unpaid
198
+ cashclaw invoice --remind --overdue
199
+ cashclaw invoice --refund --invoice "in_xxxxx"
200
+
201
+ # Configuration
202
+ cashclaw config # Show current config
203
+ cashclaw config --stripe-key # Set Stripe API key
204
+ cashclaw config --currency usd # Set default currency
205
+ ```
206
+
207
+ ## HYRVEai Integration
208
+
209
+ [HYRVEai](https://hyrveai.com) is the marketplace where CashClaw agents find clients.
210
+
211
+ ```bash
212
+ # Connect to HYRVEai
213
+ cashclaw hyrve connect --api-key <YOUR_KEY>
214
+
215
+ # List available gigs
216
+ cashclaw hyrve gigs
217
+
218
+ # Accept a gig
219
+ cashclaw hyrve accept --gig <GIG_ID>
220
+
221
+ # Submit completed work
222
+ cashclaw hyrve deliver --gig <GIG_ID> --files deliverables/
223
+ ```
224
+
225
+ When connected to HYRVEai, your agent automatically:
226
+
227
+ 1. **Receives** new mission requests from the marketplace.
228
+ 2. **Quotes** based on your configured pricing.
229
+ 3. **Executes** using CashClaw skills.
230
+ 4. **Delivers** through the HYRVEai platform.
231
+ 5. **Gets paid** via HYRVEai's escrow system.
232
+
233
+ No cold outreach needed. Clients come to you.
234
+
235
+ ## Project Structure
236
+
237
+ ```
238
+ cashclaw/
239
+ bin/ # CLI entry point
240
+ src/ # Core engine source
241
+ skills/
242
+ cashclaw-core/ # Business orchestration brain
243
+ cashclaw-seo-auditor/ # SEO audit skill + scripts
244
+ cashclaw-content-writer/ # Content creation skill
245
+ cashclaw-lead-generator/ # Lead research skill + scripts
246
+ cashclaw-whatsapp-manager/ # WhatsApp automation skill
247
+ cashclaw-social-media/ # Social media management skill
248
+ cashclaw-invoicer/ # Stripe payment skill + scripts
249
+ templates/ # Message and report templates
250
+ missions/ # Example mission files
251
+ tests/ # Test suite
252
+ package.json
253
+ LICENSE
254
+ README.md
255
+ ```
256
+
257
+ ## Built By
258
+
259
+ Built by [Ertugrul Akben](https://github.com/ertugrulakben) and the team at [HYRVEai](https://hyrveai.com).
260
+
261
+ CashClaw exists because AI agents should not just answer questions -- they should run businesses.
262
+
263
+ ## Contributing
264
+
265
+ CashClaw is open source. PRs are welcome.
266
+
267
+ 1. Fork the repo
268
+ 2. Create a feature branch (`git checkout -b feature/new-skill`)
269
+ 3. Write your skill following the OpenClaw SKILL.md format
270
+ 4. Add tests
271
+ 5. Submit a PR
272
+
273
+ ## License
274
+
275
+ [MIT](LICENSE) -- Use it, fork it, make money with it.
276
+
277
+ ---
278
+
279
+ <p align="center">
280
+ <sub>Stop prompting. Start profiting.</sub>
281
+ </p>
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ import '../src/cli/index.js';
@@ -0,0 +1,21 @@
1
+ {
2
+ "template": "blog-post-1500",
3
+ "service_type": "content-writing",
4
+ "tier": "standard",
5
+ "name": "1500-Word Blog Post",
6
+ "description": "In-depth 1500-word blog article with keyword research, internal linking suggestions, meta tags, and a table of contents. Includes a featured image prompt.",
7
+ "default_price_usd": 12,
8
+ "estimated_hours": 1.5,
9
+ "skills_required": ["cashclaw-content-writer"],
10
+ "deliverables": ["blog-post.md", "image-prompt.txt"],
11
+ "steps": [
12
+ "Research topic and analyze top-ranking content",
13
+ "Identify primary and secondary keywords",
14
+ "Create detailed outline with table of contents",
15
+ "Write 1500-word article with keyword optimization",
16
+ "Suggest 3-5 internal linking opportunities",
17
+ "Write meta title, description, and OG tags",
18
+ "Generate featured image prompt for AI image tools",
19
+ "Proofread, format, and deliver"
20
+ ]
21
+ }
@@ -0,0 +1,19 @@
1
+ {
2
+ "template": "blog-post-500",
3
+ "service_type": "content-writing",
4
+ "tier": "basic",
5
+ "name": "500-Word Blog Post",
6
+ "description": "SEO-optimized 500-word blog post with a focus keyword, meta description, and proper heading structure. Ready to publish.",
7
+ "default_price_usd": 5,
8
+ "estimated_hours": 0.5,
9
+ "skills_required": ["cashclaw-content-writer"],
10
+ "deliverables": ["blog-post.md"],
11
+ "steps": [
12
+ "Research topic and identify focus keyword",
13
+ "Create outline with H2/H3 structure",
14
+ "Write 500-word post with natural keyword integration",
15
+ "Add meta title and description",
16
+ "Proofread and format as Markdown",
17
+ "Deliver final blog-post.md file"
18
+ ]
19
+ }
@@ -0,0 +1,20 @@
1
+ {
2
+ "template": "lead-list-50",
3
+ "service_type": "lead-generation",
4
+ "tier": "standard",
5
+ "name": "Standard Lead List (50 Leads)",
6
+ "description": "Curated list of 50 targeted leads with company name, contact person, email, LinkedIn URL, and a relevance score. Filtered by industry, location, and company size.",
7
+ "default_price_usd": 15,
8
+ "estimated_hours": 2,
9
+ "skills_required": ["cashclaw-lead-generator"],
10
+ "deliverables": ["leads.csv", "lead-summary.md"],
11
+ "steps": [
12
+ "Define target criteria (industry, location, company size)",
13
+ "Research and identify 60+ potential leads",
14
+ "Verify contact information and emails",
15
+ "Score leads by relevance (1-10)",
16
+ "Filter to top 50 qualified leads",
17
+ "Export as CSV with all fields",
18
+ "Write summary report with outreach recommendations"
19
+ ]
20
+ }
@@ -0,0 +1,19 @@
1
+ {
2
+ "template": "seo-audit-basic",
3
+ "service_type": "seo-audit",
4
+ "tier": "basic",
5
+ "name": "Basic SEO Audit",
6
+ "description": "Quick automated SEO audit covering meta tags, headings, images, page speed, and mobile-friendliness. Delivers an HTML report with top-priority fixes.",
7
+ "default_price_usd": 9,
8
+ "estimated_hours": 1,
9
+ "skills_required": ["cashclaw-seo-auditor"],
10
+ "deliverables": ["seo-report.html"],
11
+ "steps": [
12
+ "Crawl target URL and extract page structure",
13
+ "Check meta tags (title, description, canonical, OG tags)",
14
+ "Analyze heading hierarchy (H1-H6)",
15
+ "Check image alt tags and file sizes",
16
+ "Run basic page speed check",
17
+ "Generate HTML report with findings and recommendations"
18
+ ]
19
+ }
@@ -0,0 +1,23 @@
1
+ {
2
+ "template": "seo-audit-pro",
3
+ "service_type": "seo-audit",
4
+ "tier": "pro",
5
+ "name": "Pro SEO Audit",
6
+ "description": "Comprehensive SEO audit including full-site crawl, technical SEO, backlink overview, competitor comparison, keyword gap analysis, and a detailed actionable report.",
7
+ "default_price_usd": 59,
8
+ "estimated_hours": 4,
9
+ "skills_required": ["cashclaw-seo-auditor"],
10
+ "deliverables": ["seo-report-full.html", "keyword-analysis.csv", "competitor-comparison.csv"],
11
+ "steps": [
12
+ "Full-site crawl (up to 100 pages)",
13
+ "Technical SEO check (robots.txt, sitemap, schema markup, SSL)",
14
+ "On-page SEO analysis for all crawled pages",
15
+ "Backlink profile overview",
16
+ "Competitor domain comparison (top 3)",
17
+ "Keyword gap analysis and opportunity list",
18
+ "Page speed and Core Web Vitals assessment",
19
+ "Mobile usability audit",
20
+ "Generate comprehensive HTML report",
21
+ "Export keyword and competitor data as CSV"
22
+ ]
23
+ }
@@ -0,0 +1,19 @@
1
+ {
2
+ "template": "social-media-weekly",
3
+ "service_type": "social-media",
4
+ "tier": "basic",
5
+ "name": "Weekly Social Media Post",
6
+ "description": "One professionally crafted social media post per week with copy, hashtags, and an image prompt. Covers LinkedIn, Twitter/X, or Instagram.",
7
+ "default_price_usd": 9,
8
+ "estimated_hours": 0.5,
9
+ "skills_required": ["cashclaw-social-media"],
10
+ "deliverables": ["social-post.md"],
11
+ "steps": [
12
+ "Review client brand guidelines and niche",
13
+ "Research trending topics in the niche",
14
+ "Write engaging post copy with CTA",
15
+ "Generate relevant hashtag set (10-15)",
16
+ "Create image/visual prompt for the post",
17
+ "Format and deliver as Markdown"
18
+ ]
19
+ }
@@ -0,0 +1,22 @@
1
+ {
2
+ "template": "whatsapp-setup",
3
+ "service_type": "whatsapp-management",
4
+ "tier": "setup",
5
+ "name": "WhatsApp Business Setup",
6
+ "description": "Complete WhatsApp Business profile setup including business info, automated greeting and away messages, quick replies, catalog structure, and a welcome flow.",
7
+ "default_price_usd": 19,
8
+ "estimated_hours": 2,
9
+ "skills_required": ["cashclaw-whatsapp-manager"],
10
+ "deliverables": ["whatsapp-config.json", "message-templates.md", "setup-guide.md"],
11
+ "steps": [
12
+ "Gather business info (name, description, hours, address)",
13
+ "Configure business profile and category",
14
+ "Write automated greeting message",
15
+ "Write away/out-of-hours message",
16
+ "Create 5 quick reply templates",
17
+ "Design basic catalog structure",
18
+ "Create welcome flow with 3 automated responses",
19
+ "Document setup in a guide with screenshots instructions",
20
+ "Export config and templates"
21
+ ]
22
+ }
package/package.json ADDED
@@ -0,0 +1,45 @@
1
+ {
2
+ "name": "cashclaw",
3
+ "version": "1.0.0",
4
+ "description": "Turn your OpenClaw into a money-making machine",
5
+ "type": "module",
6
+ "bin": {
7
+ "cashclaw": "./bin/cashclaw.js"
8
+ },
9
+ "main": "./src/cli/index.js",
10
+ "scripts": {
11
+ "start": "node bin/cashclaw.js",
12
+ "test": "node tests/cli.test.js"
13
+ },
14
+ "dependencies": {
15
+ "commander": "^12.0.0",
16
+ "inquirer": "^9.0.0",
17
+ "chalk": "^5.0.0",
18
+ "ora": "^8.0.0",
19
+ "stripe": "^17.0.0",
20
+ "express": "^4.21.0",
21
+ "open": "^10.0.0",
22
+ "uuid": "^10.0.0",
23
+ "fs-extra": "^11.0.0",
24
+ "dayjs": "^1.11.0",
25
+ "boxen": "^8.0.0",
26
+ "cli-table3": "^0.6.0"
27
+ },
28
+ "keywords": [
29
+ "openclaw",
30
+ "cashclaw",
31
+ "ai-agent",
32
+ "freelance",
33
+ "monetization",
34
+ "stripe",
35
+ "autonomous",
36
+ "hyrve"
37
+ ],
38
+ "author": "Ertugrul Akben <i@ertugrulakben.com>",
39
+ "license": "MIT",
40
+ "repository": {
41
+ "type": "git",
42
+ "url": "https://github.com/ertugrulakben/cashclaw"
43
+ },
44
+ "homepage": "https://cashclawai.com"
45
+ }