cashclaw 1.0.0

package/skills/cashclaw-whatsapp-manager/SKILL.md

@@ -0,0 +1,357 @@
+---
+name: cashclaw-whatsapp-manager
+description: Sets up and manages WhatsApp Business accounts including auto-response systems, client communication workflows, FAQ templates, and broadcast campaigns.
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "\U0001F4F1",
+        "requires": { "bins": ["node"] },
+        "install":
+          [
+            {
+              "id": "npm",
+              "kind": "node",
+              "package": "cashclaw",
+              "bins": ["cashclaw"],
+              "label": "Install CashClaw via npm"
+            }
+          ]
+      }
+  }
+---
+
+# CashClaw WhatsApp Manager
+
+You set up and manage WhatsApp Business communication systems for clients.
+Your goal is to automate client communication, reduce response times, and
+increase conversion rates through professional WhatsApp workflows.
+
+## Pricing
+
+| Service | Scope | Price | Delivery |
+|---------|-------|-------|----------|
+| Initial Setup | Account config + 10 auto-responses | $19 | 24 hours |
+| Monthly Management | Ongoing optimization + new templates | $49/month | Ongoing |
+| Campaign Setup | Single broadcast campaign | $15 | 12 hours |
+| FAQ System | Up to 30 FAQ responses | $25 | 24 hours |
+
+## WhatsApp Business Setup Workflow
+
+### Step 1: Account Configuration
+
+Gather from the client:
+
+```yaml
+Business Profile:
+  Business Name: {legal name}
+  Display Name: {name shown to customers, max 25 chars}
+  Category: {e.g., "Professional Services", "E-commerce"}
+  Description: {about section, max 512 chars}
+  Address: {business address}
+  Email: {business email}
+  Website: {URL}
+  Hours: {business hours by day}
+  Profile Photo: {URL or file path, 640x640 recommended}
+  Cover Photo: {URL or file path, 1024x576 recommended}
+```
+
+Configure the profile with these settings:
+
+1. Set profile photo and cover photo.
+2. Write a compelling About section (max 512 chars) that includes:
+   - What the business does (1 sentence).
+   - Key differentiator (1 sentence).
+   - CTA or contact info.
+3. Add catalog items if the business sells products/services.
+4. Configure business hours accurately.
+5. Set up greeting message and away message.
+
+### Step 2: Greeting and Away Messages
+
+**Greeting Message** (sent to first-time contacts):
+
+```
+Hi there! Welcome to {Business Name}.
+
+We help {target audience} with {core service}.
+
+How can I help you today? You can:
+1. Learn about our services
+2. Get a price quote
+3. Schedule a consultation
+4. Ask a question
+
+Just type a number or describe what you need!
+```
+
+**Away Message** (sent outside business hours):
+
+```
+Thanks for reaching out to {Business Name}!
+
+We are currently outside business hours ({hours}).
+We will get back to you first thing when we are back.
+
+In the meantime, you can:
+- Visit our website: {URL}
+- Email us: {email}
+- Check our FAQ: {link}
+
+Talk soon!
+```
+
+### Step 3: Auto-Response System
+
+Create keyword-triggered auto-responses. Design at least 10 for the initial setup:
+
+```yaml
+Auto-Responses:
+  - triggers: ["pricing", "price", "cost", "how much", "rates"]
+    response: |
+      Here are our current rates:
+
+      {service_1}: ${price}
+      {service_2}: ${price}
+      {service_3}: ${price}
+
+      Want a custom quote? Just describe what you need and
+      I will get back to you within 1 hour.
+
+  - triggers: ["hours", "open", "available", "when"]
+    response: |
+      Our business hours:
+
+      Mon-Fri: 9:00 AM - 6:00 PM
+      Saturday: 10:00 AM - 2:00 PM
+      Sunday: Closed
+
+      Need something urgent? Email {email} with URGENT
+      in the subject line.
+
+  - triggers: ["location", "address", "where", "directions"]
+    response: |
+      You can find us at:
+      {address}
+
+      Google Maps: {maps_link}
+
+      Parking is available {parking_info}.
+
+  - triggers: ["appointment", "schedule", "book", "meeting", "call"]
+    response: |
+      I would love to schedule a time with you!
+
+      You can book directly here: {calendar_link}
+
+      Or let me know your preferred:
+      - Date
+      - Time
+      - Topic to discuss
+
+      And I will confirm within 1 hour.
+
+  - triggers: ["thanks", "thank you", "thx"]
+    response: |
+      You are welcome! Happy to help.
+
+      Is there anything else I can assist you with?
+
+      If you found our service helpful, we would love a
+      review: {review_link}
+
+  - triggers: ["help", "support", "issue", "problem"]
+    response: |
+      I am sorry to hear you are having an issue.
+
+      To help you as quickly as possible, please share:
+      1. Your name / order number
+      2. Description of the issue
+      3. Any screenshots (just attach them here)
+
+      Our support team typically responds within 30 minutes
+      during business hours.
+
+  - triggers: ["portfolio", "work", "examples", "case study"]
+    response: |
+      Great question! Here are some of our recent projects:
+
+      {portfolio_link_1} - {brief_description}
+      {portfolio_link_2} - {brief_description}
+      {portfolio_link_3} - {brief_description}
+
+      Want to discuss a similar project? Just let me know!
+
+  - triggers: ["quote", "estimate", "proposal"]
+    response: |
+      I would be happy to provide a quote!
+
+      To give you an accurate estimate, I need:
+      1. What service are you interested in?
+      2. What is your timeline?
+      3. Any specific requirements?
+
+      I will have a quote ready within 2 hours.
+
+  - triggers: ["cancel", "refund", "return"]
+    response: |
+      I understand. Let me help you with that.
+
+      Our cancellation/refund policy:
+      - {policy_details}
+
+      Please share your order/invoice number and I will
+      process this right away.
+
+  - triggers: ["1"]
+    response: |
+      Here is an overview of our services:
+
+      {service_list_with_brief_descriptions}
+
+      Which one interests you? I can share more details
+      or set up a quick call to discuss.
+```
+
+### Step 4: Quick Reply Templates
+
+Create reusable quick replies for common agent responses:
+
+```yaml
+Quick Replies:
+  - name: "confirm_appointment"
+    text: "Your appointment is confirmed for {date} at {time}. See you then!"
+
+  - name: "request_info"
+    text: "Thanks for your interest! Could you share a bit more about {topic} so I can give you the best recommendation?"
+
+  - name: "follow_up"
+    text: "Hi {name}! Just following up on our conversation about {topic}. Have you had a chance to think it over?"
+
+  - name: "payment_received"
+    text: "Payment received! Thank you. Your {service} will be delivered by {date}. I will keep you updated."
+
+  - name: "delivery_complete"
+    text: "Your {deliverable} is ready! {link_or_attachment}. Let me know if you need any adjustments."
+
+  - name: "review_request"
+    text: "Hi {name}! Hope you are enjoying {service}. If you have a moment, a quick review would mean a lot to us: {review_link}"
+```
+
+### Step 5: Broadcast Campaign Setup
+
+For campaign service, configure:
+
+```yaml
+Campaign:
+  Name: {campaign_name}
+  Audience: {segment description}
+  Template:
+    Header: {text or image}
+    Body: |
+      {message body with {variables}}
+    Footer: {optional footer text}
+    Buttons:
+      - type: url
+        text: "Learn More"
+        url: "{link}"
+      - type: quick_reply
+        text: "Interested"
+  Schedule: {date and time}
+  Frequency: {one-time | weekly | monthly}
+```
+
+**Campaign Rules:**
+- Never send more than 1 broadcast per week to the same contact.
+- Always include an opt-out option: "Reply STOP to unsubscribe."
+- Only send to contacts who have opted in.
+- Track delivery rate, read rate, and response rate.
+- Best times: Tue-Thu, 10AM-12PM or 2PM-4PM local time.
+
+### Step 6: Client Communication Workflow
+
+Design the complete communication flow:
+
+```
+New Contact
+  -> Greeting Message
+  -> Auto-response based on keyword
+  -> If no keyword match -> "I will connect you with our team shortly"
+  -> Agent picks up within 5 minutes during business hours
+  -> Resolution or escalation
+
+Returning Contact
+  -> Skip greeting
+  -> Direct to auto-response or agent
+  -> Reference previous conversation context
+
+Post-Purchase
+  -> Day 0: Thank you + delivery confirmation
+  -> Day 3: Check-in ("How is everything going?")
+  -> Day 7: Review request
+  -> Day 30: Re-engagement ("We have something new for you!")
+```
+
+## FAQ System Design
+
+For the FAQ service ($25), create up to 30 question-answer pairs:
+
+1. Analyze the client's website, product pages, and existing support tickets.
+2. Identify the top 30 most common questions.
+3. Write concise, helpful answers (2-5 sentences each).
+4. Map each FAQ to trigger keywords.
+5. Organize into categories: General, Products/Services, Pricing, Support, Policy.
+
+Deliverable format:
+
+```json
+{
+  "faqs": [
+    {
+      "id": 1,
+      "category": "General",
+      "question": "What services do you offer?",
+      "answer": "We offer...",
+      "triggers": ["services", "what do you do", "offerings"]
+    }
+  ]
+}
+```
+
+## Deliverables
+
+For each service, deliver:
+
+| Service | Deliverables |
+|---------|-------------|
+| Initial Setup | Profile config doc, 10 auto-responses, greeting/away messages, setup checklist |
+| Monthly | Performance report, new/updated templates, optimization recommendations |
+| Campaign | Campaign brief, message template, audience segment, schedule, results report |
+| FAQ System | 30 FAQ entries in JSON + Markdown, keyword mapping, category structure |
+
+## Performance Metrics to Track
+
+```yaml
+Monthly Report:
+  Messages Received: {count}
+  Messages Sent: {count}
+  Avg Response Time: {minutes}
+  Auto-Response Rate: {%}  # messages handled without human
+  Conversion Rate: {%}     # conversations that led to sale/booking
+  Customer Satisfaction: {rating}
+  Top Keywords: {list}
+  Unmatched Queries: {list} # queries with no auto-response, need new templates
+```
+
+## Example Commands
+
+```bash
+# Set up WhatsApp Business account
+cashclaw whatsapp setup --config business-profile.yaml
+
+# Create auto-response templates
+cashclaw whatsapp templates --count 10 --industry "dental practice"
+
+# Launch a broadcast campaign
+cashclaw whatsapp campaign --template promo.yaml --audience "active-clients"
+```

package/src/cli/commands/dashboard.js

@@ -0,0 +1,72 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import open from 'open';
+import { loadConfig } from '../utils/config.js';
+import { createDashboardServer } from '../../dashboard/server.js';
+import { showMiniBanner } from '../utils/banner.js';
+
+const orange = chalk.hex('#FF6B35');
+const green = chalk.hex('#16C784');
+const dim = chalk.dim;
+
+export async function runDashboard(options = {}) {
+  showMiniBanner();
+
+  const config = await loadConfig();
+  const port = options.port || config.server.port || 3847;
+  const host = config.server.host || 'localhost';
+
+  const spinner = ora('Starting dashboard server...').start();
+
+  try {
+    const app = createDashboardServer();
+
+    await new Promise((resolve, reject) => {
+      const server = app.listen(port, host, () => {
+        resolve(server);
+      });
+      server.on('error', (err) => {
+        if (err.code === 'EADDRINUSE') {
+          reject(new Error(`Port ${port} is already in use. Try: cashclaw dashboard --port ${port + 1}`));
+        } else {
+          reject(err);
+        }
+      });
+    });
+
+    const url = `http://${host}:${port}`;
+    spinner.succeed(`Dashboard running at ${green.bold(url)}`);
+
+    console.log();
+    console.log(`  ${orange('API Endpoints:')}`);
+    console.log(`  ${dim('GET')}  ${url}/api/status`);
+    console.log(`  ${dim('GET')}  ${url}/api/missions`);
+    console.log(`  ${dim('GET')}  ${url}/api/earnings`);
+    console.log(`  ${dim('GET')}  ${url}/api/skills`);
+    console.log(`  ${dim('POST')} ${url}/api/config`);
+    console.log();
+    console.log(dim('  Press Ctrl+C to stop the server.\n'));
+
+    // Auto-open browser unless --no-open flag
+    if (!options.noOpen) {
+      try {
+        await open(url);
+      } catch {
+        console.log(dim(`  Could not auto-open browser. Visit ${url} manually.\n`));
+      }
+    }
+
+    // Keep process alive
+    process.on('SIGINT', () => {
+      console.log(dim('\n  Dashboard stopped.\n'));
+      process.exit(0);
+    });
+
+    process.on('SIGTERM', () => {
+      process.exit(0);
+    });
+  } catch (err) {
+    spinner.fail(err.message);
+    process.exit(1);
+  }
+}