@betaform/paperclaw-dashboard
v2.6.8
Published
Paperclip dashboard plugin for betaform.io — CEO overview of documents, leads, and agents
Maintainers
Readme
@betaform/paperclaw-dashboard
Paperclip plugin: executive control panel for betaform.io — Social Media Queue, Lead Pipeline, Agent Status, Analytics.
Setup
npm install
npm run buildInstall into a running Paperclip instance:
paperclipai plugin install ./ --api-base https://paperclip.betaform.ioEnvironment Variables
Configure these in Coolify (or your deployment environment):
| Variable | Required | Description |
|---|---|---|
| OPENAI_API_KEY | for image generation | Used by the "Bild neu generieren" action (gpt-image-1) |
| HOT_LEAD_WEBHOOK_URL | optional | POST webhook fired when an issue title matches 🔴 or HOT LEAD |
| BUFFER_ACCESS_TOKEN | for Buffer publishing | OAuth token for the Buffer API |
| BUFFER_LINKEDIN_PERSONAL_ID | for Buffer publishing | Buffer profile ID for LinkedIn Personal |
| BUFFER_LINKEDIN_COMPANY_ID | for Buffer publishing | Buffer profile ID for LinkedIn Company |
| BUFFER_INSTAGRAM_ID | for Buffer publishing | Buffer profile ID for Instagram |
Features degrade gracefully when variables are missing — no crashes, just silent no-ops.
Modules
| Tab | Description |
|---|---|
| Social Media | Queue of [LinkedIn …] / [Instagram] issues; one-click approve (→ done) + image regeneration |
| Lead Pipeline | Issues with label lead, split into Cold / Warm / Hot; HOT leads show cal.betaform.io booking link |
| Agents | Agent heartbeat, current issue, monthly spend vs. budget |
| Analytics | Lead funnel, social media stats, agent efficiency, budget overview |
| Dokumente | Issue documents with type/agent/date filters |
Worker
bf-dashboard— loads issues + agents, builds all tab data in one shotbf-analytics— deeper funnel + efficiency metrics; shares a 30s issue cache withbf-dashboardapprove-postaction — sets issue status todone, triggers Buffer publish via eventgenerate-post-imageaction — calls OpenAI gpt-image-1, upserts result as issue document
Development
npm run build # esbuild bundles (minified)
npm run typecheck # tsc --noEmitCI runs typecheck + build on every push via GitHub Actions.
