# Ravi for OpenClaw Agents

There are two ways to use Ravi with OpenClaw. Choose based on what you need:

## Option A: Plugin (full integration)

Gives you native OpenClaw tools, real-time email channels, and CLI commands.

```bash
openclaw plugins install @ravi-hq/ravi && openclaw gateway restart
openclaw ravi onboard
```

After onboarding, Ravi tools are available natively -- ravi_get_info,
ravi_inbox_email, ravi_email_compose, ravi_passwords_create,
ravi_sso_token, etc.

To switch identities: `openclaw ravi status` shows the current
identity. For multi-agent setups, the main agent can create identity
keys for sub-agents using `openclaw ravi create-agent-key <uuid>`.

## Option B: CLI + ClawHub skills (lightweight)

Install the Ravi CLI, then install only the skills you need. Best when
you only need specific capabilities (e.g., SSO + secrets for a
third-party service).

```bash
# 1. Install the CLI and authenticate
brew install ravi-hq/tap/ravi
ravi auth login

# 2. Install skills for what you need (pick from the list below)
clawhub install ravi          # Overview -- when to use each capability
clawhub install ravi-sso      # SSO tokens for third-party auth
clawhub install ravi-secrets  # Key-value secret storage
```

Skills are documentation -- they teach you how to use the `ravi` CLI.
You run CLI commands via shell instead of calling native OpenClaw tools.

Limitations compared to the plugin:
- No native OpenClaw tools -- you call the CLI via shell, which is slower
- No real-time email channels -- you poll the inbox manually via CLI
- No per-agent identity scoping -- the plugin can assign different identities to different agents via config; with the CLI, all agents share the active identity unless you manage separate config directories manually

Available Ravi skills on ClawHub:

- ravi            -- Overview of all Ravi capabilities
- ravi-identity   -- Get identity details, create identities
- ravi-inbox      -- Read email and SMS (OTPs, verification links)
- ravi-email-send -- Compose, reply, forward email
- ravi-email-writing -- Email content quality, formatting, spam avoidance
- ravi-login      -- Signup/login workflows with 2FA
- ravi-passwords  -- Website credential management
- ravi-secrets    -- Key-value secrets (API keys, env vars)
- ravi-sso        -- Short-lived identity verification tokens
- ravi-contacts   -- Contact search and management
- ravi-feedback   -- Submit feedback to the Ravi team

After installing the CLI and skills, verify setup:

```bash
ravi auth status    # should show identity name, email, and phone
```