name: ko-fi
description: Manage Ko-fi donations via browser automation. Check balance, view recent donations, list supporters, and configure webhooks. Use when working with Ko-fi creator dashboard, donation tracking, or supporter management. Triggers on: Ko-fi, donations, supporters, tips, coffee, buy me a coffee.

Ko-fi Integration

Browser-based Ko-fi management. No official API exists—use browser automation with profile=openclaw.

Prerequisites

• Logged into Ko-fi in the openclaw browser profile
• Browser control enabled in OpenClaw

Dashboard URLs

Check Balance & Recent Donations

1. Navigate to https://ko-fi.com/manage/supportreceived
2. Take snapshot to read donation list
3. Look for elements containing supporter names, amounts, messages

Example workflow:

browser navigate https://ko-fi.com/manage/supportreceived profile=openclaw
browser snapshot profile=openclaw
# Parse snapshot for donation entries

View Supporters

1. Navigate to https://ko-fi.com/manage/supporters
2. Snapshot to extract supporter list with names and totals

Webhook Configuration

Ko-fi sends POST requests to your webhook URL on donations.

Setup Steps

1. Navigate to https://ko-fi.com/manage/webhooks
2. Enter your webhook URL
3. Copy the verification token
4. Save settings

Webhook Payload Format

Ko-fi sends application/x-www-form-urlencoded with a data field containing JSON:

{
  "verification_token": "your-token-here",
  "message_id": "uuid",
  "timestamp": "2024-01-30T12:00:00Z",
  "type": "Donation",
  "is_public": true,
  "from_name": "Supporter Name",
  "message": "Love your work!",
  "amount": "5.00",
  "url": "https://ko-fi.com/...",
  "email": "[email protected]",
  "currency": "USD",
  "is_subscription_payment": false,
  "is_first_subscription_payment": false,
  "kofi_transaction_id": "uuid"
}

Webhook Types

Webhook Receiver Script

See scripts/webhook_receiver.py for a Flask-based webhook handler.

Auto-Thank Donors

To send thank-you messages, use the Ko-fi messaging feature:

1. Navigate to supporter's Ko-fi profile (from donation URL)
2. Use browser automation to send message

Note: Ko-fi doesn't have bulk messaging—individual thank-yous only.

Common Workflows

Daily Donation Check

Navigate to https://ko-fi.com/manage/supportreceived
Snapshot and parse for new donations since last check
Report summary: count, total amount, any messages

Monthly Supporter Report

Navigate to https://ko-fi.com/manage/supporters
Extract supporter list with lifetime totals
Generate summary report

Webhook Setup Verification

Navigate to https://ko-fi.com/manage/webhooks
Verify webhook URL is configured
Check verification token matches your server

Limitations

• No official API—browser automation required
• Rate limiting applies to rapid navigation
• Login session may expire (re-login in openclaw browser if needed)
• Can't send automated DMs to donors (manual only)