Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.outlit.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw is a self-hosted autonomous AI agent that runs 24/7 on your machine. Outlit gives it customer intelligence superpowers: query customers, pull revenue metrics, search context, and run SQL analytics, all through a simple skill install. Combined with OpenClaw’s built-in cron scheduler, you get automated customer health reports delivered straight to Telegram, Slack, Discord, or any channel OpenClaw is connected to.

​
Setup

1

Install the Outlit CLI

npm install -g @outlit/cli
Verify with outlit --version.
2

Authenticate

Get your API key from Settings > API Keys, then:
outlit auth login
The CLI prompts for your key, validates it, and stores it securely.
Treat your API key like a password. It grants read access to your customer data. Revoke keys anytime from the dashboard.
3

Install the Outlit skill

outlit setup openclaw
This installs the outlit skill into the OpenClaw skills target through the shared skills installer. OpenClaw detects and loads it automatically.
OpenClaw needs your OUTLIT_API_KEY to authenticate. The recommended way to store it is through OpenClaw’s SecretRefs. Run openclaw secrets configure to set it up securely without plaintext exposure. See the CLI secrets guide for more details.
4

Verify

outlit doctor
You should see:
✓ OpenClaw: Outlit skill installed
Then message OpenClaw in your chat platform:
List my paying customers sorted by MRR.

​
What OpenClaw Can Do with Outlit

Once the skill is installed, OpenClaw learns how to use the full outlit CLI. You can ask it anything in natural language:
Ask OpenClaw…What it runs
”Show me paying customers who went silent this month”outlit customers list --billing-status PAYING --no-activity-in 30d
”Get the full profile for acme.com”outlit customers get acme.com --include users,revenue,recentTimeline
”What’s been happening with Acme on Slack?”outlit customers timeline acme.com --channels SLACK --limit 50
”Find inactive users at Acme Corp”outlit users list --customer-id YOUR_CUSTOMER_ID --journey-stage INACTIVE
”Search for pricing concerns across all customers”outlit search "pricing concerns"
”What do we know about acme.com recently?”outlit facts list acme.com --status ACTIVE --limit 20
”Open the exact call behind that search result”outlit sources get --source-type CALL --source-id call_123
”Which event types fire most often?”outlit sql "SELECT event_type, COUNT(*) FROM activity GROUP BY 1 ORDER BY 2 DESC LIMIT 10"
”Show me the available analytics views”outlit schema
OpenClaw parses JSON responses, converts monetary values from cents to dollars, and handles pagination automatically, all guided by the skill’s built-in rules.

​
Automated Reports with Cron

OpenClaw’s built-in cron scheduler lets you set up recurring customer intelligence reports that get delivered to your messaging channels. No external scheduler needed.

​
Churn Risk Alert (Daily)

The highest-value alert. Catch paying customers who went silent before they churn. 
openclaw cron add \
  --name "Churn Risk Alert" \
  --cron "0 9 * * *" \
  --tz "America/New_York" \
  --message "Run: outlit customers list --billing-status PAYING --no-activity-in 30d --order-by mrr_cents. Summarize as a churn risk report, highlight the top accounts by MRR and how long they've been inactive. Flag any above $500 MRR as critical." \
  --announce

​
Trial Health Check (Daily)

Trials that went quiet after a week probably need a nudge before expiration. 
openclaw cron add \
  --name "Trial Health Check" \
  --cron "0 9 * * *" \
  --tz "America/New_York" \
  --message "Run: outlit customers list --billing-status TRIALING --no-activity-in 7d. Summarize as a trial health report, list each trial, days since last activity, and suggest an outreach action." \
  --announce

​
Revenue Snapshot (Weekly)

Monday morning pulse on your top accounts. Track MRR movement week over week. 
openclaw cron add \
  --name "Revenue Snapshot" \
  --cron "0 9 * * 1" \
  --tz "America/New_York" \
  --message "Run: outlit sql \"SELECT domain, mrr_cents FROM customers ORDER BY mrr_cents DESC LIMIT 15\". Format as a revenue snapshot table, convert cents to dollars, show rank, and note the total MRR across all listed accounts." \
  --announce

​
Inactive Users (Twice a Week)

Individual users who went inactive, even if their company account is still active. 
openclaw cron add \
  --name "Inactive Users" \
  --cron "0 9 * * 2,4" \
  --tz "America/New_York" \
  --message "Run: outlit users list --journey-stage INACTIVE --limit 20. Summarize as an inactive users report, group by customer, show user emails and journey stage, and note any patterns." \
  --announce

​
New Signups Overview (Weekly)

Friday recap of new customers that signed up during the week. 
openclaw cron add \
  --name "New Signups Overview" \
  --cron "0 10 * * 5" \
  --tz "America/New_York" \
  --message "Run: outlit users list --journey-stage SIGNED_UP --order-by first_seen_at --limit 50. Summarize as a weekly new signups report, group users by customer, and note current activity level." \
  --announce
Replace America/New_York with your timezone. OpenClaw supports any valid IANA timezone string.

​
Managing Cron Jobs

openclaw cron list                  # View all scheduled jobs
openclaw cron run JOB_ID            # Test a job immediately
openclaw cron disable JOB_ID        # Pause without deleting
openclaw cron enable JOB_ID         # Resume a paused job
openclaw cron rm JOB_ID             # Delete a job

​
Outlit Agent Skills

Outlit also provides agent skills for richer customer-data workflows and optional SDK guidance: 
outlit setup skills
SkillWhat it teaches
outlitCustomer queries, search, facts, SQL, and CLI vs MCP workflow guidance
outlit-sdkSDK integration for tracking: detection, consent, auth, billing, events
These skills are also available on ClawHub.

​
Troubleshooting

ProblemSolution
outlit doctor shows “Outlit skill not found”Run outlit setup openclaw to install the skill
OpenClaw says it doesn’t know about OutlitMake sure OUTLIT_API_KEY is set in your shell environment and restart OpenClaw’s Gateway
Commands return authentication errorsRun outlit auth status to verify your key is valid
Cron jobs aren’t firingCheck openclaw cron status and verify timezone settings
JSON parsing errorsEnsure you’re running the latest Outlit CLI (outlit upgrade)

​
What’s Next

OpenClaw Docs

Learn more about OpenClaw’s features: skills, cron, secrets, and more

Outlit on ClawHub

Browse the Outlit skill on ClawHub