Intelligence

Name: Intelligence
Rating: 3.5 (1 reviews)
Author: brewmaister

By brewmaister 👁 34 views ▲ 0 votes

Brewing intelligence plugin for OpenClaw with native Telegram HUD buttons

GitHub

Install

npm install

#

Configuration Example

{
  "plugins": {
    "intelligence-plugin": {
      "enabled": true,
      "path": "~/.openclaw/plugins/intelligence-plugin",
      "config": {
        "defaultSize": "medium",
        "autoCleanup": true
      }
    }
  }
}

README

# OpenClaw Intelligence Plugin

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![OpenClaw](https://img.shields.io/badge/OpenClaw-Plugin-blue)](https://openclaw.ai)

A powerful OpenClaw plugin for brewing intelligence operations with native Telegram HUD buttons.

![Plugin HUD](assets/hud-demo.png)

## ✨ Features

- 🎮 **Native Telegram Inline Keyboard** - Real clickable buttons like `/models`
- 🔍 **AI-Powered Search** - Quick and full search modes
- 🔬 **NotebookLM Integration** - Deep research workflows
- 📊 **System Status** - Monitor extraction, wiki, and graph health
- 🧠 **Smart Prompting** - Asks for missing arguments automatically

## 🚀 Quick Start

### Installation

```bash
# Clone to OpenClaw plugins directory
git clone https://github.com/brewmaister/openclaw-intelligence-plugin.git ~/.openclaw/plugins/intelligence-plugin

# Enable in OpenClaw config
echo '{
  "plugins": {
    "intelligence-plugin": {
      "enabled": true,
      "path": "~/.openclaw/plugins/intelligence-plugin"
    }
  }
}' >> ~/.openclaw/config.json

# Restart gateway
openclaw gateway restart
```

### Usage

Type `/intelligence` to see the HUD:

```
🔍 Intelligence Operations

[🔍 Search (Quick)]  [🔎 Search (Full)]
[🔬 Research]          [📊 System Status]
```

**Commands:**
- `/intelligence` - Show interactive HUD with buttons
- `/intel-search <topic>` - AI-powered search
- `/intel-research <topic>` - Deep research via NotebookLM
- `/intel-status` - System health check

## 📖 Commands Reference

### `/intelligence`
Shows the main HUD with 4 inline keyboard buttons on Telegram.

**Button Actions:**
- **🔍 Search (Quick)** - ~1000 char fast lookup
- **🔎 Search (Full)** - ~3000 char comprehensive analysis
- **🔬 Research** - Prepares NotebookLM deep dive
- **📊 Status** - Shows extraction progress and system health

### `/intel-search <topic> [--size short|medium|large]`
AI-powered search across your brewing knowledge base.

**Examples:**
```
/intel-search Citra hops
/intel-search "NEIPA water profile" --size large
/intel-search diacetyl --size short
```

**Sources searched:**
- Knowledge Graph entities & relations
- Source documents (books, Discord, Forum, HBT)
- Miniflux RSS feeds

### `/intel-research <topic>`
Prepares a deep research session in NotebookLM.

**Example:**
```
/intel-research "Cold IPA brewing techniques"
```

**Output:**
- Collects relevant wiki pages and source docs
- Creates `Research_<topic>_<date>.md` session file
- Shows notebooklm commands to execute

### `/intel-status`
Shows comprehensive system health:

```
📚 BOOK EXTRACTION
  Completed: 5 books
  Status: 🔄 ACTIVE

📝 WIKI LAYER
  Pages: 0 (generating...)

📊 KNOWLEDGE GRAPH
  Entities: 2,847
  Relations: 1,532

💬 HARVESTS
  Discord: 31 files
  Forum: 9 threads
  HBT: 11 files

📰 MINIFLUX
  Entries: 5,885

📖 CALIBRE
  Books: 161
```

## 🏗️ Architecture

```
┌─────────────────────────────────────┐
│         Telegram User               │
│         Types /intelligence         │
└─────────────────┬───────────────────┘
                  │
┌─────────────────▼───────────────────┐
│    OpenClaw Gateway                 │
│    Routes to Plugin                 │
└─────────────────┬───────────────────┘
                  │
┌─────────────────▼───────────────────┐
│  Intelligence Plugin                  │
│  - Shows inline keyboard             │
│  - Handles callbacks                 │
│  - Routes to commands                │
└─────────────────┬───────────────────┘
                  │
┌─────────────────▼───────────────────┐
│  intel Python Tool                   │
│  ~/.openclaw/workspace/scripts/intel │
│  - Searches Graph/docs/              │
│  - Calls AI via OpenClaw proxy       │
│  - Formats results                   │
└─────────────────┬───────────────────┘
                  │
┌─────────────────▼───────────────────┐
│  Knowledge Sources                   │
│  - Graph/docs/books/                 │
│  - Graph/docs/discord/               │
│  - Graph/docs/forum/                 │
│  - Graph/docs/hbt/                   │
│  - Miniflux RSS                      │
└─────────────────────────────────────┘
```

## 🔧 Configuration

### Plugin Config (in `~/.openclaw/config.json`)

```json
{
  "plugins": {
    "intelligence-plugin": {
      "enabled": true,
      "path": "~/.openclaw/plugins/intelligence-plugin",
      "config": {
        "defaultSize": "medium",
        "autoCleanup": true
      }
    }
  }
}
```

### Required Setup

1. **Intel tool must exist:**
   `~/.openclaw/workspace/scripts/intel`

2. **Knowledge Graph structure:**
   - `~/Documents/Obsidian/MADBRAUER/Intelligence/Graph/docs/`
   - Extracted books, harvests in subdirectories

3. **Miniflux (optional):**
   - Running at `http://localhost:8080`
   - API key in `pass miniflux/api_key`

## 🛠️ Development

```bash
# Clone repo
git clone https://github.com/lagerboy/openclaw-intelligence-plugin.git
cd openclaw-intelligence-plugin

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run watch

# Test locally
# Copy to ~/.openclaw/plugins/intelligence-plugin
# Restart gateway
```

### Project Structure

```
├── src/
│   ├── commands/
│   │   ├── intelligence.ts      # HUD command
│   │   ├── intel-search.ts      # Search command
│   │   ├── intel-research.ts    # Research command
│   │   └── intel-status.ts      # Status command
│   └── handlers/
│       └── callbacks.ts         # Button click handlers
├── dist/                        # Compiled JavaScript
├── openclaw.plugin.json         # Plugin manifest
└── package.json
```

## 🤝 Contributing

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

## 📜 License

MIT License - see [LICENSE](LICENSE) file

## 🙏 Acknowledgments

- Built for [OpenClaw](https://openclaw.ai)
- Brewing intelligence system inspired by [Andrej Karpathy's llm-wiki pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)
- Thanks to The Modern Brewhouse community

## 🔗 Links

- [OpenClaw Docs](https://docs.openclaw.ai)
- [ClawHub Skills](https://clawhub.ai)
- [Report Issues](https://github.com/lagerboy/openclaw-intelligence-plugin/issues)

channels