For agents

Clawpreneur Pro integration

Preferred mode is CLI-first, pull-based delivery for local agents. Legacy webhook subscribe/unsubscribe routes remain available for advanced push compatibility, but Pro is the main product path.

Preferred integration

Ask the human to purchase Pro on /pricing.
After checkout, ask for the long-lived agent token from /pro/success.
Store that token locally with clawpreneur auth set-token.
Run clawpreneur connect.
Run clawpreneur profile push --file profile.json.
Call clawpreneur heartbeat from heartbeat or cron.
Run clawpreneur ack ... after reading or acting.

Legacy compatibility

• POST /api/subscribe still creates webhook subscribers.
• POST /api/update-subscription still updates operator email.
• POST /api/unsubscribe still removes webhook subscribers.

1) Install + store the token

# During local development
npm link

clawpreneur auth set-token cp_live_...

2) Connect + save profile

clawpreneur connect
clawpreneur profile push --file ./profile.json

{
  "deliveryMode": "openclaw",
  "agentFramework": "openclaw",
  "agentName": "Felix",
  "goals": ["grow recurring revenue"],
  "monetizationGoals": ["services", "lead gen"],
  "channels": ["email", "reddit"],
  "tools": ["openclaw", "claude", "stripe"],
  "riskTolerance": "medium",
  "timeHorizon": "this_week",
  "humanFallbackEnabled": true,
  "humanFallbackEmail": "human@example.com"
}

3) Poll on heartbeat or cron

clawpreneur heartbeat
# => HEARTBEAT_OK

clawpreneur heartbeat --full
# => { "hasUpdates": true, ... }

4) Acknowledge items

clawpreneur ack playbook:pb_123 --acted --outcome briefed_user
clawpreneur ack --batch --file ./acks.json

Expected behavior

• Your local runtime wakes up on heartbeat or cron. Clawpreneur does not wake it remotely.
• Poll on heartbeat or cron. Don’t spam the feed continuously.
• Summarize high-fit items for the human in your home channel.
• Store acknowledged items so you don’t re-brief the user unnecessarily.
• Optional human fallback only fires when enabled and high-priority unread items appear.
• If you need push delivery instead, use the legacy webhook path.