🦀 OpenClaw Integration

Nugs.gg works fully on its own — no account, no server, no AI required. But if you want your new tab page to adapt to you, you can connect an OpenClaw agent.

What It Does

When connected, your AI agent can:

• Change backgrounds based on time of day, mood, or context
• Push market data with live ticker updates
• Adjust widget layouts — move, resize, minimize widgets remotely
• Set widget appearance — accent colors and opacity per widget
• Curate your tab — greetings, themes, and background picks on every new tab

All of this happens through chat. Tell your agent "feeling Bitcoin today" and your background switches to a Bitcoin-themed image with an orange accent.

How It Works

Nugs.gg connects to an OpenClaw bridge server via WebSocket. The bridge relays commands from your AI agent to the browser app.

You (Discord/Telegram/etc.)
  → OpenClaw Agent
    → Bridge Server (WebSocket)
      → nugs.gg (browser)

Setup

1. Install OpenClaw

Follow the OpenClaw setup guide to get an AI agent running on your machine.

2. Start the Bridge Server

The bridge server lives in the nugs.gg repo under server/:

cd server
npm install
npm run dev

The server runs on port 18790 by default.

3. Find Your Auth Token

On first run, the bridge generates a token in server/openclaw-bridge.json:

{
  "token": "your-generated-token-here"
}

Copy this token — you'll need it in the next step.

4. Connect nugs.gg

1. Open nugs.gg and click the gear icon (⚙️) to open Settings
2. Go to the OpenClaw tab
3. Enter the bridge URL:
   • Same machine: ws://localhost:18790
   • Different machine: ws://[bridge-ip]:18790 (e.g., ws://192.168.1.100:18790)
4. Paste the auth token from step 3
5. Click Connect

Status indicator shows 🟢 when connected, 🔴 when disconnected.

Privacy

• The connection is local by default (localhost or LAN)
• No data leaves your network unless you set up remote access
• nugs.gg never sends personal data to the bridge — only widget state when requested
• You can disconnect at any time; the app continues working normally

Commands

Your AI agent can send these commands to nugs.gg:

Without OpenClaw

Everything works without it:

• Backgrounds rotate from Unsplash or your chosen source
• Market auto-populates from CoinGecko
• Regimen tracks your protocols locally
• All data stays in your browser (IndexedDB)

OpenClaw is an enhancement layer, not a dependency.