OpenClaw — Ravi Docs

Overview

The Ravi OpenClaw plugin gives your agent real-time email and SMS channels plus 19 tools for managing Identities, inboxes, passwords, and vault secrets. It’s a drop-in replacement for the combination of 1Password + AgentMail.

Why Ravi over 1Password + AgentMail?

	1Password + AgentMail	Ravi
Plugins to install	2 (+ tmux plugin)	1
Setup steps	~10+	2 (install + login)
Requires desktop app	Yes	No
Requires tmux workaround	Yes	No
Session expires mid-task	Yes	No
Email	AgentMail	Built in
Credentials	1Password	Built in
Fully autonomous	Barely	Yes

Install

openclaw plugins install @ravi-hq/ravi
openclaw ravi login

The login command:

Opens a browser for device-code authentication (copy-paste friendly for headless VMs)
Sets up E2E encryption (6-digit PIN)
Selects an Identity
Auto-configures OpenClaw

No manual config editing needed.

Real-time channels

The plugin provides two real-time messaging channels powered by Server-Sent Events:

Email channel

Each email thread maps 1:1 to an OpenClaw session
New threads create new sessions; replies resume existing ones
DM policy controls: allowlist or open

SMS channel

All messages from one phone number form a single session
Only active when the Identity has a provisioned phone number
DM policy controls: allowlist or open

Agent tools

The plugin registers 19 tools:

Category	Tools
Identity	List Identities, create Identity, get info
Email	List threads, read thread, compose, reply
SMS	List conversations, read conversation, send SMS
Passwords	List, get, create, delete
Vault	List secrets, get, set, delete
Feedback	Submit feedback

Secrets provider

The plugin includes a ravi-secrets binary that implements the OpenClaw exec secrets protocol. Use the Ravi vault as a secrets provider:

secrets:
  providers:
    ravi:
      source: exec
      command: ravi-secrets

Then reference vault secrets anywhere:

{ source: "exec", provider: "ravi", id: "my-api-key" }

Configuration

Authentication is stored in ~/.ravi/auth.json (written by openclaw ravi login). The Identity UUID is set automatically during login.

Manual configuration is only needed for multi-agent setups or to customize DM policies:

plugins:
  ravi:
    identityUuid: "identity-uuid-here"
    channels:
      ravi-email:
        accounts:
          "identity-uuid-here":
            identityUuid: "identity-uuid-here"
            identityName: "My Agent"
            email: "agent@in.ravi.app"
            dm:
              policy: "allowlist"
              allowFrom:
                - "you@gmail.com"
      ravi-sms:
        accounts:
          "identity-uuid-here":
            identityUuid: "identity-uuid-here"
            identityName: "My Agent"
            phone: "+15551234567"
            dm:
              policy: "allowlist"
              allowFrom:
                - "+15559876543"

CLI commands

Command	Description
`openclaw ravi login`	Authenticate, set up PIN, select Identity
`openclaw ravi status`	Show auth status and available Identities
`openclaw ravi setup`	Alias for `login`

Next steps

Agent Skills — skill files for any agent platform
Service Signup — use Ravi to sign up for services