Openpawz

Your AI, your rules.

A native desktop AI platform that runs fully offline, connects to any provider, and puts you in control.

[](https://github.com/OpenPawz/openpawz/actions/workflows/ci.yml) [](LICENSE) [](https://discord.gg/wVvmgrMV) [](https://x.com/openpawzai) [](https://www.instagram.com/openpawz)

Private by default. Powerful by design. Extensible by nature.

[English](README.md) · [简体中文](README.zh-CN.md)

---

Paws Overview

Pawz In Action

https://github.com/user-attachments/assets/9bee2c08-ca86-4483-89a1-3eae847054b4

Engram Memory — Interactive knowledge graph with force-directed layout, flowing edge particles, and memory recall

https://github.com/user-attachments/assets/60b0f351-180e-49ed-a70b-e31556743949

Integration Hub — Community services via MCP Bridge, with category filters, connection health, and quick setup

Fleet Command — Manage agents, deploy templates, and monitor fleet activity

Chat — Session metrics, active jobs, quick actions, and automations

Pawz CLI — Full engine access from the terminal with zero network overhead

---

Why OpenPawz?

OpenPawz is a native Tauri v2 application with a pure Rust backend engine. It runs fully offline with Ollama, connects to any OpenAI-compatible provider, and gives you complete control over your AI agents, data, and tools.

• Private — No cloud, no telemetry, no open ports. Credentials encrypted with AES-256-GCM in your OS keychain.
• Powerful — Multi-agent orchestration, 11 channel bridges, hybrid memory, DeFi trading, browser automation, research workflows.
• Extensible — Comm integrations via embedded MCP bridge to n8n's community node ecosystem, unlimited providers, community skills via PawzHub, local Ollama workers, modular architecture.
• Tiny — ~5 MB native binary. Not a 200 MB Electron wrapper.

---

The Integration Inversion

Every other automation platform locks integrations inside workflows. You must build a workflow before any tool is usable. OpenPawz inverts this — every integration is simultaneously a direct agent tool and a visual workflow node.

| | Zapier / Make / n8n (standalone) | OpenPawz | |---|---|---| | Tool availability | Locked inside workflows | Available directly in chat AND in workflows | | To use a tool | Build trigger → action chain first | Just ask your agent | | AI's role | One node inside the pipeline | The pipeline lives inside the agent | | Install a new package | Workflow node only | Instant chat tool + workflow node | | Community nodes | Manual sequential automation | AI-orchestrable via MCP bridge |

Install "@n8n/n8n-nodes-slack":

  n8n standalone:  available as a workflow node → must build a workflow to use it
  OpenPawz:        auto-deploys a workflow + indexes it for agent discovery
                   → "Hey Pawz, send hello to #general" — done

How it works: OpenPawz embeds n8n as an MCP server. n8n's MCP exposes three workflow-level tools: search_workflows, execute_workflow, and get_workflow_details. When you install a community package, Paw auto-deploys a per-service workflow (e.g. "OpenPawz MCP — Slack") that encapsulates the integration logic. The agent discovers workflows via semantic search and executes them via execute_workflow — all through the MCP bridge.

The insight: n8n's community nodes were designed for manual automation. OpenPawz makes them AI-native — Paw auto-deploys workflows that compose n8n nodes with credential binding, error handling, and retries. The agent decides which workflow to execute based on your intent, and only needs the visual Flow Builder when you want multi-step orchestration with branching, loops, or scheduling.

---

Original Research

OpenPawz introduces three novel methods for scaling AI agent tool usage and workflow execution. All are open source under the MIT License.

The Librarian Method — Intent-Stated Tool Discovery

Problem: AI agents break when they have too many tools. Loading thousands of workflow definitions into context is impossible, and keyword pre-filters guess wrong because they lack intent.

Solution: The agent itself requests tools after understanding the user's intent. An embedding model performs semantic search over the workflow index and returns only the relevant workflows — on demand, per round. We recommend a local Ollama model like nomic-embed-text for zero cost, but any embedding model works.

User: "Email John about the quarterly report"
  → Agent calls request_tools("email sending capabilities")   ← agent has intent
  → Librarian (embedding model): embeds query → cosine search → email_send, email_read
  → Only relevant tools loaded instead of every available definition

Key insight: The LLM forms the search query (it has parsed intent). A pre-filter on the raw user message would have to guess — the agent knows.

📄 [Full case study: The Librarian Method](reference/librarian-method.mdx)

The Foreman Protocol — Low-Cost Tool Execution

Problem: When a cloud LLM executes tools, the reasoning around formatting and calling them burns expensive tokens. The actual API calls (Slack, Trello, etc.) are free or cheap — but the LLM processing around them is not.

Solution: A cheaper worker model executes all MCP tool calls instead of the expensive Architect model. The critical enabler is MCP's self-describing schemas — the MCP server tells the worker model exactly how to call each tool. No pre-training. No configuration. Any new n8n community node is instantly executable. We recommend a local Ollama model like qwen2.5-coder:7b for zero cost, but any model from any provider works.

Architect (Cloud LLM): "Send hello to #general" → calls mcp_slack_send_message
  → Engine intercepts mcp_* call
  → Foreman (worker model): executes via MCP → n8n → Slack API
  → Tool execution handled by the cheapest capable model in the stack

Key insight: MCP servers are self-describing. The worker model doesn't need to know how to use community integrations — MCP tells it at runtime.

📄 [Full case study: The Foreman Protocol](reference/foreman-protocol.mdx)

The Conductor Protocol — AI-Compiled Flow Execution

Problem: Every workflow platform — n8n, Zapier, Make, Airflow — walks the graph node by node: sequential, synchronous, one LLM call per agent step. A 10-node AI pipeline with 6 agent steps takes 24+ seconds and 6 LLM calls. Cycles (feedback loops, agent debates) are structurally impossible — all require DAGs.

Solution: The Conductor treats flow graphs as blueprints of intent and compiles them into optimized execution strategies before a single node runs. Five primitives — Collapse (merge N agents → 1 LLM call), Extract (deterministic nodes bypass LLM entirely), Parallelize (independent branches run concurrently), Converge (cyclic subgraphs iterate until outputs stabilize), and Tesseract (partition graphs into parallel cells with per-cell memory isolation, synchronized at event horizons) — reduce a 10-node flow from 24s/6 calls to 4–8s/2–3 calls.

10-node flow, 6 agent steps:
  n8n / Zapier / Make: sequential walk → 24s+, 6 LLM calls
  OpenPawz Conductor:  compiled strategy → 4–8s, 2–3 LLM calls

Convergent Mesh (agent debate until consensus):
  n8n / Zapier / Make: impossible — DAG required
  OpenPawz Conductor:  bidirectional edges → iterative rounds → convergence

Key insight: n8n community nodes were designed for manual sequential automation. The Conductor makes them AI-orchestrable — describe a workflow in natural language, the NLP parser builds the graph, the Conductor compiles it, and the agents execute it. The entire n8n ecosystem becomes an AI-native automation engine.

📄 [Full case study: The Conductor Protocol](reference/conductor-protocol.mdx)

Agent Execution Architecture — 5-Phase Optimization Pipeline

OpenPawz implements a 5-phase execution optimization pipeline that eliminates waste from the standard agent loop. Each phase is built, tested (162 dedicated tests), and wired into the live agent loop.

| Phase | Name | What It Does | Impact | |-------|------|-------------|--------| | 0 | Action DAG Planning | Model outputs a complete execution plan in one inference call; engine runs independent steps in parallel | 3–5× fewer inference calls | | 1 | Constrained Decoding | Provider-specific schema enforcement (OpenAI strict, Anthropic tool_choice, Gemini tool_config, Ollama format: json) | 0% parse failures | | 2 | Embedding-Indexed Tool Registry | Persistent SQLite tool embeddings with four-tier search failover (Vector → BM25 → Domain → Keyword) | `, zeroed from RAM on drop. Parameterized query sanitization and prompt injection scanning on all recalled content

Why This Matters

• No plaintext secrets — Credentials are encrypted at rest with per-field IVs. If the keychain is unavailable, the app blocks credential storage entirely rather than falling back to plaintext.
• Agents can't go rogue — Dangerous commands (sudo, rm -rf, curl | bash, chmod 777) are auto-denied or require explicit approval. Even in "allow all" session override mode, privilege escalation remains blocked.
• 90+ safe command patterns — Common dev commands (git status, ls, cat, npm test) are auto-approved so you're not clicking "Allow" on every harmless action.
• Financial guardrails — Trading tools (swaps, transfers) have configurable per-transaction caps, daily loss limits, and pair whitelists. Read-only trading (balances, prices) is always auto-approved.
• Filesystem sandboxing — 20+ sensitive paths blocked (~/.ssh, ~/.aws, ~/.gnupg, /etc, /root). Path traversal blocked. Optional read-only mode disables all agent writes.
• Channel access control — Every channel bridge supports DM pairing, user allowlists, and per-agent routing. No open relay.
• Full audit trail — Every security event logged with risk level, tool name, decision, and matched pattern. Filterable dashboard with JSON/CSV export.
• Skill vetting — Community skills are checked against npm registry risk intelligence (download count, maintainer count, deprecation status) with a risk score before install.

See [SECURITY.md](SECURITY.md) for the complete security architecture.

---

Features

Multi-Agent System

• Unlimited agents with custom personalities, models, and tool policies
• Boss/worker orchestration — agents delegate tasks and spawn sub-agents at runtime
• Inter-agent communication — direct messages, broadcast channels, and agent squads
• Agent squads — team formation with coordinator roles for collaborative tasks
• Per-agent chat sessions with persistent history and mini-chat popups
• Agent dock with avatars (50 custom Pawz Boi sprites)

Community Integrations — Zero-Gap Automation

OpenPawz ships with 400+ built-in integrations compiled into the Rust binary. But the real breakthrough is the MCP Bridge — an embedded n8n engine that connects your agents to Community integrations via the Model Context Protocol. No plugins to install, no marketplace to browse. Your agent discovers and installs integrations at runtime, auto-deploys per-service workflows, and executes them on demand.

How It Works

User: "Generate a QR code for my website"
  → Agent calls request_tools("QR code generation")
  → Librarian (embedding model) finds n8n-nodes-base.qrCode
  → Auto-installs n8n community package (if needed)
  → Executes via MCP bridge
  → Returns QR code to user

Built-in (400+ native, compiled into binary)

| Category | Count | Examples | |----------|-------|----------| | Productivity | 40+ | Notion, Trello, Obsidian, Linear, Jira, Asana, Todoist, Google Workspace | | Communication | 30+ | Slack, Discord, Telegram, WhatsApp, Teams, Email (IMAP/SMTP) | | Development | 50+ | GitHub, GitLab, Bitbucket, Docker, Kubernetes, Vercel, Netlify, AWS | | Data & Analytics | 35+ | PostgreSQL, MongoDB, Redis, Elasticsearch, BigQuery, Snowflake | | Media & Content | 25+ | Spotify, YouTube, Whisper, ElevenLabs, Image Gen, DALL-E | | Smart Home & IoT | 20+ | Philips Hue, Sonos, Home Assistant, MQTT, Zigbee | | Finance & Trading | 30+ | Coinbase, Solana DEX, Ethereum DEX, Stripe, PayPal, QuickBooks | | Cloud & Infrastructure | 40+ | AWS, GCP, Azure, Cloudflare, DigitalOcean, Terraform | | Security & Monitoring | 25+ | 1Password, Vault, Datadog, PagerDuty, Sentry, Grafana | | AI & ML | 20+ | Hugging Face, Replicate, Stability AI, Pinecone, Weaviate | | CRM & Marketing | 30+ | Salesforce, HubSpot, Mailchimp, SendGrid, Intercom | | Miscellaneous | 55+ | Weather, RSS, Web Scraping, PDF, OCR, QR codes, Maps |

MCP Bridge (Nodes via embedded n8n)

| Layer | What It Does | |-------|-------------| | Embedded n8n | Auto-provisioned via Docker or npx — starts at launch, zero config | | MCP Transport | Streamable HTTP at /mcp-server/http with JWT auth | | Workflow-Level MCP | Three tools: search_workflows, execute_workflow, get_workflow_details | | Auto-Deploy | Per-service workflows created automatically when community packages are installed | | Workflow RAG | Embedding model discovers the right workflow via semantic search (local Ollama recommended) | | Local Worker | Ollama qwen2.5-coder:7b executes MCP tool calls — no cloud costs |

10 AI Providers

| Provider | Models | |----------|--------| | Ollama | Any local model (auto-detected, fully offline) | | OpenAI | GPT-4.1, GPT-4.1 mini, GPT-4.1 nano, o3, o4-mini | | Anthropic | Claude Opus 4, Sonnet 4, Sonnet 4 Thinking, Haiku 3.5 | | Google Gemini | Gemini 3.1 Pro, 3 Pro, 3 Flash (Preview), 2.5 Pro/Flash/Flash-Lite | | OpenRouter | Meta-provider routing (100+ models) | | DeepSeek | deepseek-chat, deepseek-reasoner | | xAI (Grok) | grok-3, grok-3-mini | | Mistral | mistral-large, codestral, pixtral-large | | Moonshot/Kimi | moonshot-v1 models | | Custom | Any OpenAI-compatible endpoint |

11 Channel Bridges

Telegram · Discord · IRC · Slack · Matrix · Mattermost · Nextcloud Talk · Nostr · Twitch · WebChat · WhatsApp

Each bridge includes user approval flows, per-agent routing, and uniform start/stop/config commands. The same agent brain, memory, and tools work across every platform.

Memory System — Project Engram

• Three-tier architecture — Sensory buffer (ring buffer for current turn) → Working memory (priority-evicted slots) → Long-term graph (episodic, knowledge, procedural stores)
• Hybrid search — BM25 full-text + vector similarity with reciprocal rank fusion and spreading activation across memory graph edges
• Automatic consolidation — Background engine runs pattern clustering, contradiction detection, Ebbinghaus strength decay, and garbage collection on a 5-minute cycle
• 18 memory categories — Unified across Rust backend, agent tools, and frontend UI (general, preference, fact, project, person, technical, insight, procedure, etc.)
• PII-aware encryption — Two-layer defense: 17 regex patterns (emails, SSNs, credit cards, JWTs, AWS keys, private keys, etc.) plus LLM-assisted secondary scan for context-dependent PII. Field-level AES-256-GCM encryption before storage with separate keychain key from credential vault
• Inter-agent memory trust — Capability-scoped publishing on the memory bus, publish-side injection scanning, and trust-weighted contradiction resolution prevent cross-agent memory poisoning
• Memory lifecycle — Auto-recall injects relevant memories before agent turns; auto-capture stores results after task/orchestrator/compaction completion
• Channel-scoped memories — Memories from Discord, Slack, Telegram etc. are tagged with channel + user scope for isolated recall
• GDPR Article 17 — Right-to-erasure API securely purges all memories for given user identifiers
• Context budget — Token-aware ContextBuilder packs memories into available context window with prior

…

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: OpenPawz
• Source: OpenPawz/openpawz
• License: MIT
• Homepage: https://openpawz.ai

Install and usage instructions live in the source repository linked above.