SKILL: CleanApp Ingest v1 (OpenClaw/ClawHub)

# SKILL: CleanApp Ingest v1 (OpenClaw/ClawHub)

This is a **skill package** that lets an agent submit **any problem signal** into CleanApp (bugs, incidents, scams, UX friction, policy violations, safety hazards, improvement proposals) using the **Fetcher Key System**:

This is **not** a long-lived agent running inside the CleanApp backend. It’s a client-side integration that talks to CleanApp over HTTPS.

Why This Is Safe (Compartmentalized)

1. The only secret in the agent is a **revocable CleanApp API key** (`CLEANAPP_API_TOKEN`).

2. New keys default to a **quarantine lane** on the backend:

- Stored + analyzed

- Not publicly published

- Not automatically routed to third parties

- Not rewarded

3. The backend enforces:

- rate limits / quotas

- idempotency (`source_id`)

- kill switches (revoke/suspend)

So even if an agent is prompt-injected, the blast radius is limited to “submitting more quarantined reports” until the key is revoked.

Required Secret

- `POST /v1/fetchers/register` (see `references/API_REFERENCE.md`)

- Store it as a ClawHub/OpenClaw secret; never paste into chat logs.

Optional env:

Data Handling (Minimal by Default)

This skill submits:

Recommended low-risk defaults:

Idempotency (Important)

Every item must include a stable `source_id`. The backend enforces:

Usage

Bulk ingest from JSON (recommended)

export CLEANAPP_API_TOKEN="cleanapp_fk_live_..."
python3 ingest.py \\
  --base-url https://live.cleanapp.io \\
  --input examples/sample_items.json \\
  --approx-location \\
  --no-media

Dry run (no network)

python3 ingest.py --input examples/sample_items.json --dry-run

Single-item helper (shell)

This is useful for quick manual submissions while debugging.

export CLEANAPP_API_TOKEN="cleanapp_fk_live_..."
./scripts/submit_report.sh --title "Broken elevator" --description "Stuck on floor 3" --lat 34.0702 --lng -118.4441 --approx-location

Promotion (Out of Quarantine)

Promotion is a **reviewed** process. As you build reputation, CleanApp can:

See:

References