Nirvana Skill

Nirvana Local: Privacy-Preserving Context Stripper

> For teams that already have a local inference engine. Just strip the private data before cloud API calls. Nothing else.

What This Is

Nirvana Local is a lightweight skill for OpenClaw agents that already have a local LLM inference engine (Ollama, Llamafile, vLLM, LM Studio, etc.).

It does one thing: strips private context before cloud API calls.

Why You Need This

Today: Privacy Leak

When you ask your agent a question, the full system prompt goes to cloud:

Your question: "How do I build synbio?"
System prompt sent to OpenAI:
Agent identity (SOUL.md)
Your personal info (USER.md)
Agent memories (MEMORY.md)
Full chat history
Everything costs 2,000–5,000 extra tokens

With Nirvana Local: Protected

Your question: "How do I build synbio?"
Query to local LLM first:
Try local inference (free)
If local fails, ask the cloud
Cloud API call (if needed):
Original question: [STRIPPED]
System prompt: [STRIPPED]
Sanitized query: "How do I build synbio?" (no context)
Cloud never sees: SOUL, USER, MEMORY, chat history
Cost: $0.01–$0.03 (no context overhead)

Installation

Prerequisites

Setup (3 minutes)

# 1. Install skill
clawhub install shivaclaw/nirvana-local
2. Configure your local LLM endpoint
openclaw nirvana-local configure \
  --local-endpoint http://localhost:11434 \
  --local-model qwen2.5:7b
3. Verify
openclaw nirvana-local status
Output:
✅ Local LLM: qwen2.5:7b @ localhost:11434
✅ Privacy audit: enabled
✅ Context stripper: active

How It Works

Routing Decision Logic

Agent receives your question
    ↓
Try local LLM first
(qwen2.5:7b, Mistral, Llama, whatever you have)
    ↓
┌─────────────────────────────────────────┐
│ Success?                                 │
└─────────────────────────────────────────┘
   ↙ YES (80%)           ↘ NO (20%)
   
Return local answer    Ask cloud for help
                             ↓
                    Strip private context
                    (SOUL, USER, MEMORY)
                             ↓
                    Sanitized query to cloud
                    "How do I build synbio?"
                    (no personal data)
                             ↓
                    Cache response locally
                    Agent learns
                             ↓
                    Return integrated answer

What Gets Stripped

✅ Always Removed:

✅ What the Cloud Gets:

Configuration

Basic Setup

Edit ~/.openclaw/workspace/openclaw.json:

{
  "plugins": {
    "nirvana-local": {
      "enabled": true,
      "local_llm": {
        "endpoint": "http://localhost:11434",
        "model": "qwen2.5:7b",
        "timeout_ms": 180000,
        "api_format": "openai-compatible"
      },
      "privacy": {
        "strip_soul": true,
        "strip_user": true,
        "strip_memory": true,
        "strip_chat_history": true,
        "audit_logging": true
      },
      "routing": {
        "local_threshold": 0.75,
        "max_local_context_tokens": 8000,
        "cloud_fallback": true
      }
    }
  }
}

Custom API Format

If your local LLM uses a different API:

{
  "plugins": {
    "nirvana-local": {
      "local_llm": {
        "endpoint": "http://your-server:5000",
        "model": "your-model",
        "api_format": "custom",
        "custom_api_handler": "llamafile"  // or "vllm", "lm-studio", etc.
      }
    }
  }
}

Privacy Audit Trail

View What Gets Stripped

# See every boundary crossing
openclaw nirvana-local audit-log --tail 20
Output:
[2026-04-24 14:23:45] LOCAL HANDLING
Question: "What's my salary range for synbio roles?"
Handled by: qwen2.5:7b locally
Private data: None exposed
Cost: $0
[2026-04-24 14:25:12] CLOUD FALLBACK (WITH STRIPPING)
Original question: [STRIPPED]
Sanitized query sent: "What are typical salary ranges in synthetic biology?"
Private data stripped: SOUL.md, USER.md, chat history
Cost: $0.02

Transparency

Every cloud API call is logged with:

Supported Local LLMs

| Provider | Endpoint | API Format | Tested | |----------|----------|-----------|--------| | Ollama | http://localhost:11434 | openai-compatible | ✅ | | Llamafile | http://localhost:8000 | openai-compatible | ✅ | | vLLM | http://localhost:8000 | openai-compatible | ✅ | | LM Studio | http://localhost:1234 | openai-compatible | ✅ | | Text Generation WebUI | http://localhost:5000 | custom | ✅ | | GPT4All | http://localhost:4891 | custom | ✅ | | LocalAI | http://localhost:8080 | openai-compatible | ✅ |

Philosophy

You own the learning. The cloud provides intelligence.

Without Nirvana Local:

With Nirvana Local:

Cost Savings

Example: 10 Questions/Day

Today (without Nirvana Local):

With Nirvana Local:

Savings: $15.30/month + 100% privacy protection

When to Use

✅ Perfect For

⚠️ When to Use Full Plugin

Support

License

MIT-0 — Free to use, modify, and redistribute. No attribution required.

*Your privacy is yours to keep. Nirvana Local makes it happen.*

Basic Setup

Edit ~/.openclaw/workspace/openclaw.json:

{
  "plugins": {
    "nirvana-local": {
      "enabled": true,
      "local_llm": {
        "endpoint": "http://localhost:11434",
        "model": "qwen2.5:7b",
        "timeout_ms": 180000,
        "api_format": "openai-compatible"
      },
      "privacy": {
        "strip_soul": true,
        "strip_user": true,
        "strip_memory": true,
        "strip_chat_history": true,
        "audit_logging": true
      },
      "routing": {
        "local_threshold": 0.75,
        "max_local_context_tokens": 8000,
        "cloud_fallback": true
      }
    }
  }
}

Custom API Format

If your local LLM uses a different API:

{
  "plugins": {
    "nirvana-local": {
      "local_llm": {
        "endpoint": "http://your-server:5000",
        "model": "your-model",
        "api_format": "custom",
        "custom_api_handler": "llamafile"  // or "vllm", "lm-studio", etc.
      }
    }
  }
}