Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lucid.foundation/llms.txt

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

​
Launch Your First Agent

Pick the path that fits you. Both end in the same place: a live AI agent with an on-chain passport, cryptographic receipts, and Solana-anchored proof of every inference.

Telegram (fastest)

No terminal. No API key. Tap a few buttons and your agent is live.

CLI (developers)

One install, one login, one command. Full control from your terminal.

​
Path 1: Telegram

The fastest way to launch. You only need a Telegram account.
1

Open the Lucid bot

Go to t.me/mylclaw_bot in Telegram and tap Start.
2

Start the launch wizard

Send /launch. The bot walks you through everything.
3

Pick an agent

Tap OpenClaw from the catalog. It is a general-purpose conversational agent ready to go out of the box.
4

Choose your model provider

Select Lucid Gateway (no key needed). Lucid routes your calls across 100+ models with zero configuration on your part.
5

Choose a deploy target

Tap Lucid Cloud (one-click). Your agent will be deployed to managed infrastructure in seconds.
6

Add skills (optional)

The bot offers optional skills (web search, code execution, etc.). Skip them for now or select a few — you can change this later.
7

Launch

Tap Launch and wait about 30 seconds. The bot will confirm once your agent is live.
8

Talk to your agent

Send any message in the chat. Your agent responds — and every response is backed by a verifiable receipt.
That is it. You just deployed a verifiable AI agent without writing a single line of code.

​
Path 2: CLI

For developers who want terminal-level control.
1

Install the Lucid CLI

npm i -g @lucid/cli
2

Authenticate

lucid login
This opens your browser for a one-time auth flow. Your session is stored locally.
3

Launch an agent

lucid launch --agent openclaw --target railway
The CLI pulls the OpenClaw image, provisions a Railway service, registers an on-chain passport, and deploys — all in one command.You will see output like this:
✔ Passport created: LCDp...7xKm
✔ Image pushed to registry
✔ Railway service provisioned
✔ Agent live at https://openclaw-a3f9.up.railway.app

Your agent is running. Every inference is receipted and anchored to Solana.
4

Verify it is running

lucid deploy status LCDp...7xKm

Status:     RUNNING
Target:     railway
Passport:   LCDp...7xKm
Uptime:     2m 14s
Receipts:   0
5

Send your first message

curl -X POST https://openclaw-a3f9.up.railway.app/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello from Lucid!"}]
  }'
The response includes a x-lucid-receipt-id header — that is your cryptographic proof.

​
What Just Happened?

Whether you used Telegram or the CLI, behind the scenes Lucid did all of this:
1

Passport minted

Your agent received an on-chain passport — a unique identity registered on Solana. This is not a database entry; it is a verifiable on-chain record that proves your agent exists and who owns it.
2

Agent deployed

The agent container was built, pushed to a registry, and deployed to your chosen target (Lucid Cloud or Railway). It is running right now, ready to handle requests.
3

Inference receipted

Every message your agent processes generates a cryptographic receipt — a SHA-256 hash of the canonicalized request and response, stored in a Merkle Mountain Range.
4

Receipts anchored to Solana

Receipts are batched into epochs. When an epoch closes (100+ receipts or 1 hour), the MMR root is committed on-chain. Anyone can verify any receipt against this anchor.
5

Reputation begins

Your agent is now building reputation. Every successful inference, every verified receipt, every on-chain anchor contributes to a reputation score that other agents, users, and protocols can query.
You / Telegram / curl
        │
        ▼
┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  Your Agent  │────▶│  Lucid       │────▶│  LLM Model   │
│  (Passport)  │     │  Gateway     │     │  (100+)      │
└──────────────┘     └──────┬───────┘     └──────────────┘
                            │
                     ┌──────▼───────┐
                     │   Receipt    │  SHA-256 + MMR proof
                     └──────┬───────┘
                            │
                     ┌──────▼───────┐
                     │   Solana     │  On-chain epoch anchor
                     └──────────────┘

​
Next Steps

Add Skills

Give your agent web search, code execution, and custom tool access.

Understand Passports

Learn how on-chain identity works for agents, models, compute, tools, and datasets.

Explore Receipts

Dive into cryptographic receipts, MMR proofs, and epoch anchoring.

Deploy from Source

Build a fully custom agent with your own code and deploy it through Lucid.
Need help? Message the bot /help in Telegram or run lucid --help in your terminal. You can also reach us at kevin.wayne@raijinlabs.io.