Overview

This guide shows you how to connect Google Gemini to Nostr using OpenClaw. You'll configure the messaging channel, set up AI provider authentication, and deploy your assistant.

Nostr Capabilities

  • Direct messages
  • Reactions

Google Gemini Features

  • 1M token context window
  • Multimodal understanding
  • Fast inference
  • Competitive pricing

Step 1: Configure Nostr

  1. Generate a Nostr key pair
  2. Choose relay servers
  3. Configure nostr in openclaw.json
  4. Start the gateway
  5. Publish your public key

Step 2: Configure Google Gemini

Google AI API key

  1. Go to ai.google.dev
  2. Create or select a project
  3. Enable the Gemini API
  4. Generate an API key
  5. Set GOOGLE_API_KEY environment variable

Environment variable: GOOGLE_API_KEY

Step 3: Combined Configuration

Add both configurations to your openclaw.json:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "google-gemini/gemini-2.0-flash-exp"
      }
    }
  },
  "models": {
    "providers": {
      "google-gemini": {
  "models": {
    "providers": {
      "google-gemini": {
        "apiKey": "${GOOGLE_API_KEY}
    }
  },
  "channels": {
    "nostr": {
      "privateKey": "${NOSTR_PRIVATE_KEY}",
      "relays": ["wss://relay.damus.io", "wss://nos.lol"]
    }
  }
}
}

Step 4: Start and Test

# Start the gateway
openclaw gateway start

# Check connection status
openclaw status

# View real-time logs
openclaw logs --follow

Access Control

Nostr supports the following access control policies:

DM Policies

Policy Description
allowlist Only senders in allowFrom list are processed
open All DMs are processed (requires allowFrom: ["*"])

Group Policies

Policy Description
open All groups are processed

Deploy Options

Choose how to deploy your Nostr + Google Gemini setup:

Local Deployment

Run on your personal machine with local-only access

View Guide →

VPS Deployment

Always-on deployment on a Linux VPS

View Guide →

Cloud Deployment

Managed container deployment on Fly.io or similar

View Guide →

Docker Deployment

Containerized deployment with Docker

View Guide →