Dual Brain

# Dual-Brain Skill

**What it does:** Provides cognitive diversity by automatically generating perspectives from a secondary LLM (different from your primary model) for every user message.

## For Agents

Before responding to any user message, check for a dual-brain perspective:

```bash
cat ~/.dual-brain/perspectives/{your-agent-id}-latest.md
```

If the file exists and contains a recent perspective (check timestamp in comment), consider it alongside your own reasoning. The perspective may highlight:
- Angles you might miss
- Alternative approaches
- Important things to verify

**Integration:**
- Perspectives are generated automatically by a background daemon
- No manual action required on your part
- Simply read the file before forming your response
- Synthesize both viewpoints (yours + the secondary LLM's)

**Example workflow:**
1. User sends message
2. Daemon intercepts, sends to secondary LLM (e.g., Kimi, GPT-4, Llama)
3. Secondary LLM generates 2-3 sentence perspective
4. Written to `~/.dual-brain/perspectives/{agent-id}-latest.md`
5. You (primary agent) read it before responding
6. You synthesize both perspectives into your answer

## For Humans

**Setup:**
```bash
npm install -g openclaw-dual-brain
dual-brain setup    # Interactive configuration
dual-brain start    # Start daemon
```

**Providers:**
- `ollama` - Local models (zero cost, requires Ollama)
- `moonshot` - Kimi/Moonshot API (Chinese LLM, fast)
- `openai` - GPT-4o, GPT-4-turbo, etc.
- `groq` - Fast inference with Llama models

**Commands:**
- `dual-brain setup` - Configure provider, model, API key
- `dual-brain start` - Run daemon (foreground)
- `dual-brain stop` - Stop daemon
- `dual-brain status` - Check running status
- `dual-brain logs` - View recent activity
- `dual-brain install-daemon` - Install as system service

**Config location:** `~/.dual-brain/config.json`

**Perspectives location:** `~/.dual-brain/perspectives/`

## Architecture

```
User Message → OpenClaw Session (JSONL)...

# 🧠 openclaw-dual-brain

**Multi-LLM perspective synthesis for OpenClaw agents.**

Give your AI agents cognitive diversity by automatically generating perspectives from a secondary LLM (different from the primary model) on every user message. The primary agent reads both viewpoints before responding — like having two brains instead of one.

## Why?

**Single-model agents have blind spots.** Different LLMs have different strengths, training data, and reasoning patterns. By synthesizing perspectives from two models, agents get:

- **Broader coverage** - One model catches what the other misses
- **Bias mitigation** - Different training = different biases
- **Quality assurance** - Second opinion validates reasoning
- **Cognitive diversity** - Like pair programming for AI

## Features

✅ **Provider-agnostic** - Supports Ollama (local), Moonshot/Kimi, OpenAI, Groq  
✅ **Zero agent overhead** - Background daemon, <1s latency  
✅ **Plug-and-play** - Works with any OpenClaw agent  
✅ **Engram integration** - Optional semantic memory storage  
✅ **System service** - Install as launchd (macOS) or systemd (Linux)  
✅ **Plain JavaScript** - No TypeScript, no build step  

## Architecture

```
┌─────────────┐
│ User Message │
└──────┬──────┘
       │
       ▼
┌───────────────────────┐
│ OpenClaw Session      │
│ (~/.openclaw/agents/  │
│  */sessions/*.jsonl)  │
└──────┬────────────────┘
       │
       │ (daemon polls every 10s)
       │
       ▼
┌────────────────────────┐
│ Dual-Brain Daemon      │
│ - Detects new messages │
│ - Calls secondary LLM  │
└──────┬─────────────────┘
       │
       ▼
┌────────────────────────────┐
│ Secondary LLM Provider     │
│ • Ollama (local, free)     │
│ • Moonshot/Kimi            │
│ • OpenAI (GPT-4o)          │
│ • Groq (fast Llama)        │
└──────┬─────────────────────┘
       │
       ▼ (2-3 sentence perspective)
       │
┌──────────────────────────────┐
│ ~/.dual-brain/perspectives/  │
│   main-latest.md             │
│   strategis...