Starter

README

# OpenClaw Starter Kit

Pre-configured OpenClaw AI agent with Strategic CRM, memory (BrainDB), and optional plugins for email, YouTube, voice, stock monitoring, and more.

## Quick Start

```bash
git clone https://github.com/mvtk1978/openclaw-starter.git
cd openclaw-starter
./setup.sh
docker compose up -d
```

The interactive setup wizard will guide you through plugin selection and configuration.

## What's Included

### Core (always installed)
| Plugin | Description |
|--------|-------------|
| **Strategic CRM** | Full networking CRM — contacts, interactions, tasks, goals, favors, travel/home modes |
| **BrainDB** | Persistent memory with pgvector — auto-captures facts from conversations |

### Optional Plugins
| Plugin | Description |
|--------|-------------|
| Email | Zoho IMAP/SMTP bridge — send and read email from the agent |
| YouTube | Transcript extraction via yt-dlp — summarize any YouTube video |
| TTS Proxy | Voice synthesis via Qwen TTS upstream |
| Gonka AI | Free Qwen3-235B LLM proxy with ECDSA auth |
| Plaud | Recording sync from Plaud devices |
| Health | Health monitoring integration |
| Twitter/X | Twitter API v2 with OAuth 2.0 PKCE |
| MTA GPT | MTA GPT integration |
| Finnhub | Stock market monitoring skill (40 tickers) |

### Infrastructure
| Component | Description |
|-----------|-------------|
| Watchdog | Auto-recovery from stale session locks (cron, every minute) |
| Backup | Daily automated backup of data + database (cron, 3am) |

## Architecture

```
┌─────────────────────────────────────────┐
│  openclaw (gateway, PID 14)             │
│  ├── Telegram bot                       │
│  ├── Heartbeat (30min)                  │
│  ├── Plugins: CRM, BrainDB, Email, ... │
│  └── Skills: strategic-crm, finnhub    │
├─────────────────────────────────────────┤
│  braindb (PostgreSQL + pgvector)        │
├─────────────────────────────────────────┤
│  email-bridge (optional)                │
│  gonka-proxy (optional)                 │
│  tts-proxy (optional)                   │
└─────────────────────────────────────────┘
```

## Security

The default setup includes:
- `read_only: true` filesystem
- `cap_drop: ALL`
- `no-new-privileges: true`
- `user: 1000:1000` (non-root)
- Gateway bound to `127.0.0.1` only
- Token-based authentication
- Memory/CPU limits (2G/2 cores)

## CRM Features

The Strategic CRM skill provides:
- **Contact management** with 3 circles (Support/Productivity/Growth)
- **Special roles**: Connector, Condenser, Bridge, Gatekeeper
- **Interaction logging** (meetings, calls, emails)
- **Task & goal tracking** with contact linking
- **Favor/trade ledger** (I owe / they owe)
- **Travel mode** — find contacts by location, plan meetings
- **Home mode** — guest dossier when someone visits
- **Daily briefing** with prioritized recommendations
- **Smart context capture** — extracts promises, interests, career changes from conversation

## Configuration

After running `setup.sh`:
- `.env` — all secrets and API keys
- `docker-compose.yml` — generated based on plugin selection
- `workspace/openclaw.example.json` — plugin registry config

## Maintenance

```bash
# View logs
docker logs -f openclaw

# Restart
docker restart openclaw

# Check for stale locks (watchdog does this automatically)
docker exec openclaw find /home/node/.openclaw/agents/main/sessions/ -name "*.lock"

# Manual backup
./scripts/backup.sh
```

## License

MIT