Docs

Quickstart, troubleshooting, and reference for LiveBridge.

1. Quickstart (Standard tier — cloud agents)

Subscribe on the pricing page. Standard tier ships in private build — join the waitlist there.
Wait ~90 seconds after checkout while we boot your dedicated VPS in DigitalOcean. We email you when it’s ready.
Open your landing page at https://app.<your-slug>.livebridge.cloud — we send the URL by email.
Open the agent dashboard from the landing page (one click). Authenticate with the gateway token shown on the landing page.
Paste an LLM API key — Anthropic, OpenAI, or Gemini. The key lives on your VPS’s encrypted disk; we never see it.
Create an agent: name it, describe its job in plain English, pick a schedule (cron-style or event-driven), tick the tools it can use, and save.
Watch it run on the agent dashboard’s Logs view.

2. Quickstart (Developer tier — with Mac connector)

Everything in Standard quickstart.
Generate a pairing token on your agent dashboard: Connectors → Add Mac.
Install the Mac daemon on the Mac you want connected:
curl -fsSL https://livebridge.cloud/install.sh | bash -s -- --token <PAIRING_TOKEN>
Grant Privacy permissions on the Mac when prompted: Screen Recording, Accessibility (only what the daemon needs).
Your cloud agents can now invoke mac.run, mac.screenshot, mac.files, and mac.claude_code tools.

3. Connect Claude.ai

Each customer’s VPS exposes its own MCP endpoint. To wire Claude.ai into your agents:

In claude.ai: Settings → Connectors → Add custom connector.
URL: https://mcp.<your-slug>.livebridge.cloud/mcp (your landing page shows the exact URL).
Authorize with the connector token shown on your dashboard.

Now from any claude.ai chat you can invoke your agents’ tools and read their memory.

4. Tools available to your agents

Always available (Standard tier)

Web — browse, fill forms, scrape, screenshot.
Filesystem — read/write files in the agent’s workspace.
Shell — run commands in an isolated sandbox.
HTTP — arbitrary REST calls with allowlisted hosts.
Memory — vector-searched markdown notes that persist across restarts.
Scheduler — cron-style triggers.
Integrations — Gmail, Calendar, GitHub, Notion, Linear, Slack, Discord, Telegram, Spotify, Hue, custom APIs.

Added on Developer tier

mac.run — execute a shell command on a paired Mac.
mac.screenshot — capture the Mac’s screen.
mac.files — read files from the Mac.
mac.claude_code — drive a Claude Code session on the Mac (requires Claude Code CLI installed).

5. Memory

Each agent has a workspace at /home/node/.openclaw/workspace with two key files:

MEMORY.md — long-term durable facts, preferences, decisions. Read at the start of every run.
memory/YYYY-MM-DD.md — daily working notes. Indexed for vector search.

Tools memory_search and memory_get let the agent find context across thousands of past entries.

6. Billing

Stripe-managed subscription. Cancel any time.
30-day data retention after cancellation, then we destroy your VPS and the keys with it.
Email novu@livebridge.cloud for refunds, downgrades, or anything weird.

7. Security

One isolated DO droplet per customer. No shared compute.
Caddy + Let’s Encrypt TLS for every customer subdomain.
ufw firewall locked to 22/80/443. fail2ban on SSH.
API keys + agent memory live on the customer’s VPS’s encrypted disk — never copied to the control plane.
Pre-built Docker images delivered from a private registry — our source code never lives on customer machines.
See the Security page for the full threat model.

8. Troubleshooting

My VPS isn’t healthy

Open your landing page and check the Agent dashboard link. If the page fails to load or the agent dashboard returns errors, email us with your slug — we’ll inspect your droplet and restart any failed containers.

My agent is stuck

On the agent dashboard, open the agent’s Logs view. Most stuck states are LLM rate-limits or invalid API keys; the logs will say which. Update the key and re-trigger.

I want to bring my own domain

Not supported in private build. After GA you’ll be able to point a CNAME at your relay subdomain.