> ## Documentation Index
> Fetch the complete documentation index at: https://outlit-codex-platform-actions-create-update-cli.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# OpenClaw + Outlit
> Turn OpenClaw into your autonomous customer intelligence agent with Outlit. Get automated churn alerts, revenue snapshots, and at-risk user reports delivered to your messaging channels
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
```bash theme={null}
npm install -g @outlit/cli
```
```bash theme={null}
bun add -g @outlit/cli
```
```bash theme={null}
brew install outlitai/tap/outlit
```
```bash theme={null}
curl -fsSL https://outlit.ai/install.sh | bash
```
Detects your OS and architecture, downloads the latest binary to `~/.outlit/bin`, and adds it to your `PATH`.
Verify with `outlit --version`.
Get your API key from [Settings > API Keys](https://app.outlit.ai/settings/workspace/api-keys), then:
```bash theme={null}
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.
```bash theme={null}
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](https://docs.openclaw.ai/gateway/secrets). Run `openclaw secrets configure` to set it up securely without plaintext exposure. See the [CLI secrets guide](https://docs.openclaw.ai/cli/secrets) for more details.
```bash theme={null}
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.
```bash theme={null}
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.
```bash theme={null}
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.
```bash theme={null}
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.
```bash theme={null}
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.
```bash theme={null}
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
```bash theme={null}
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](/ai-integrations/skills) for richer customer-data workflows and optional SDK guidance:
```bash theme={null}
outlit setup skills
```
| Skill | What it teaches |
| -------------- | ----------------------------------------------------------------------- |
| **outlit** | Customer queries, search, facts, SQL, and CLI vs MCP workflow guidance |
| **outlit-sdk** | SDK integration for tracking: detection, consent, auth, billing, events |
These skills are also available on [ClawHub](https://clawhub.ai/leo-paz/outlit).
## Troubleshooting
| Problem | Solution |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------ |
| `outlit doctor` shows "Outlit skill not found" | Run `outlit setup openclaw` to install the skill |
| OpenClaw says it doesn't know about Outlit | Make sure `OUTLIT_API_KEY` is set in your shell environment and restart OpenClaw's Gateway |
| Commands return authentication errors | Run `outlit auth status` to verify your key is valid |
| Cron jobs aren't firing | Check `openclaw cron status` and verify timezone settings |
| JSON parsing errors | Ensure you're running the latest Outlit CLI (`outlit upgrade`) |
## What's Next
Learn more about OpenClaw's features: skills, cron, secrets, and more
Browse the Outlit skill on ClawHub