Paw

Paws

Brain

Package	Description	npm
@openvole/paw-brain	Unified multi-provider brain (Anthropic, OpenAI, Gemini, xAI, Ollama)
@openvole/paw-ollama	(deprecated) Local LLM via Ollama
@openvole/paw-claude	(deprecated) Anthropic Claude
@openvole/paw-openai	(deprecated) OpenAI GPT
@openvole/paw-gemini	(deprecated) Google Gemini
@openvole/paw-xai	(deprecated) xAI Grok

Channel Paws (6)

Package	Description	npm
@openvole/paw-telegram	Telegram bot
@openvole/paw-slack	Slack bot
@openvole/paw-discord	Discord bot
@openvole/paw-whatsapp	WhatsApp
@openvole/paw-msteams	Microsoft Teams
@openvole/paw-voice-call	Voice calls (Twilio)

Tool Paws

Package	Description	npm
@openvole/paw-browser	Browser automation (Puppeteer)
@openvole/paw-shell	Shell command execution
@openvole/paw-filesystem	File system operations
@openvole/paw-mcp	MCP server bridge
@openvole/paw-email	Email (SMTP/IMAP)
@openvole/paw-resend	Email via Resend API
@openvole/paw-github	GitHub API
@openvole/paw-calendar	Google Calendar
@openvole/paw-tts	Text-to-speech (ElevenLabs, OpenAI)
@openvole/paw-stt	Speech-to-text (OpenAI Whisper)
@openvole/paw-computer	Desktop automation (mouse, keyboard, screen)
@openvole/paw-database	PostgreSQL, MySQL, SQLite queries
@openvole/paw-scraper	Structured web data extraction (cheerio)
@openvole/paw-pdf	Read, merge, split PDFs (pdf-lib)
@openvole/paw-image	Resize, crop, watermark, compress images (sharp)
@openvole/paw-social	Twitter/X and LinkedIn posting

Infrastructure Paws

Package	Description	npm
@openvole/paw-memory	Persistent memory — hybrid semantic + keyword search
@openvole/paw-session	Session/conversation management
@openvole/paw-compact	Context compaction — heuristic + optional LLM summarization
@openvole/paw-dashboard	Real-time web dashboard

Install

npm install @openvole/paw-brain @openvole/paw-memory @openvole/paw-dashboard

Then add to vole.config.json:

{
  "brain": "@openvole/paw-brain",
  "paws": [
    { "name": "@openvole/paw-brain", "allow": { "network": ["*"], "env": ["BRAIN_PROVIDER", "BRAIN_API_KEY", "BRAIN_MODEL", "OLLAMA_HOST", "OLLAMA_MODEL", "GEMINI_API_KEY", "GEMINI_MODEL"] } },
    { "name": "@openvole/paw-memory", "allow": { "network": ["*"], "env": ["VOLE_MEMORY_DIR", "OLLAMA_HOST"] } },
    { "name": "@openvole/paw-dashboard", "allow": { "listen": [3001] } }
  ]
}

VoleNet Compatibility

Several paws have built-in VoleNet support for distributed deployments:

• paw-dashboard — VoleNet panel showing connected peers, leader status, and remote tool execution feed
• paw-memory — Cross-peer memory sync (write propagation + remote search)
• paw-session — Session transcript replication across devices

Any paw's tools can be shared across VoleNet instances — remote tools appear in the coordinator's registry and work transparently.

How Paws Work

When a Paw is loaded, its tools are registered into the Tool Registry — a flat list that the Brain sees alongside core tools and MCP tools. The Brain calls them by name without knowing which Paw provides them.

vole> summarize my unread emails

Brain sees:
  email_search (paw-email) → searches inbox
  email_read (paw-email) → reads each email
  browser_navigate (paw-browser) → if needed
  memory_write (paw-memory) → saves summary

You can also call any registered tool directly from the CLI — no Brain involved:

npx vole tool call email_search '{"query":"is:unread","limit":5}'
npx vole tool call github_create_issue '{"repo":"myorg/myrepo","title":"Bug","body":"..."}'
npx vole tool call calendar_list_events '{"days":7}'

Building a Paw

A Paw is a Node.js package that provides tools to the agent. See the Paw Development Guide in the main repo.

import { definePaw, z } from '@openvole/paw-sdk'

export default definePaw({
  name: 'my-paw',
  version: '0.1.0',
  description: 'My custom paw',
  tools: [
    {
      name: 'my_tool',
      description: 'Does something useful',
      parameters: z.object({ input: z.string() }),
      execute: async ({ input }) => ({ result: input.toUpperCase() }),
    },
  ],
})

Contributing

We welcome new Paws! See CONTRIBUTING.md for guidelines on creating and submitting Paws.

License

MIT