pocketpaw 0.4.3

The AI agent that runs on your laptop, not a datacenter. OpenClaw alternative with one-command install.

PocketPaw

Your AI agent. Modular. Secure. Everywhere.

 

Self-hosted, multi-agent AI platform. Web dashboard + Discord, Slack, WhatsApp, Telegram, and more.
No subscription. No cloud lock-in. Just you and your Paw.

Beta: This project is under active development. Expect breaking changes between versions.

---

Quick Start

Desktop App

Download the native app — includes auto-updates, system tray, and launches on startup.

Platform	Download
macOS (Apple Silicon)	PocketPaw-macOS-arm64.dmg
Windows	PocketPaw-Setup.exe

Install via Terminal

macOS / Linux

pip install pocketpaw && pocketpaw

Or use the install script:

curl -fsSL https://pocketpaw.xyz/install.sh | sh

Windows (PowerShell)

powershell -NoExit -Command "iwr -useb https://pocketpaw.xyz/install.ps1 | iex"

Or install manually with pip:

pip install pocketpaw
pocketpaw

Note: Some features (browser automation, shell tools) work best under WSL2. Native Windows support covers the web dashboard and all LLM chat features.

Other methods

pipx install pocketpaw && pocketpaw    # Isolated install
uvx pocketpaw                           # Run without installing

# From source
git clone https://github.com/pocketpaw/pocketpaw.git
cd pocketpaw && uv run pocketpaw

Docker

git clone https://github.com/pocketpaw/pocketpaw.git && cd pocketpaw
cp .env.example .env
docker compose up -d

Dashboard at http://localhost:8888. Get the access token:

docker exec pocketpaw cat /home/pocketpaw/.pocketpaw/access_token

Optional profiles: --profile ollama (local LLMs), --profile qdrant (vector memory).

That's it. The web dashboard opens automatically at http://localhost:8888. Connect Discord, Slack, WhatsApp, or Telegram and control your agent from anywhere.

---

Features

9+ Channels	Web Dashboard, Discord, Slack, WhatsApp, Telegram, Signal, Matrix, Teams, Google Chat
6 Agent Backends	Claude Agent SDK, OpenAI Agents, Google ADK, Codex CLI, OpenCode, Copilot SDK
50+ Tools	Browser, web search, image gen, voice/TTS/STT, OCR, research, delegation, skills
Integrations	Gmail, Calendar, Google Drive & Docs, Spotify, Reddit, MCP servers
Memory	Long-term facts, session history, smart compaction, Mem0 semantic search
Security	Guardian AI, injection scanner, tool policy, plan mode, audit log, self-audit daemon
Local-First	Runs on your machine. Ollama for fully offline operation. macOS / Windows / Linux.

Examples

You:  "Every Sunday evening, remind me which recycling bins to put out"
Paw:  Done. I'll check the recycling calendar and message you every Sunday at 6pm.

You:  "Find that memory leak, the app crashes after 2 hours"
Paw:  Found it. The WebSocket handler never closes connections. Here's the fix.

You:  "I need a competitor analysis report for our product launch"
Paw:  3 agents working on it. I'll ping you when it's ready.

---

Architecture

Event-driven message bus — all channels publish to a unified bus, consumed by the AgentLoop, which routes to one of 6 backends via a registry-based router. All backends implement the AgentBackend protocol and yield standardized AgentEvent objects.

Agent Backends

Backend	Key	Providers	MCP
Claude Agent SDK (Default)	claude_agent_sdk	Anthropic, Ollama	Yes
OpenAI Agents SDK	openai_agents	OpenAI, Ollama	No
Google ADK	google_adk	Google (Gemini)	Yes
Codex CLI	codex_cli	OpenAI	Yes
OpenCode	opencode	External server	No
Copilot SDK	copilot_sdk	Copilot, OpenAI, Azure, Anthropic	No

Security

Guardian AI safety checks, injection scanner, tool policy engine (profiles + allow/deny), plan mode approval, audit CLI (--security-audit), self-audit daemon, and append-only audit log. Learn more.

Detailed security architecture

---

Configuration

Config at ~/.pocketpaw/config.json, or use POCKETPAW_-prefixed env vars, or the dashboard Settings panel. API keys are encrypted at rest.

export POCKETPAW_ANTHROPIC_API_KEY="sk-ant-..."   # Required for Claude SDK backend
export POCKETPAW_AGENT_BACKEND="claude_agent_sdk"  # or openai_agents, google_adk, etc.

Note: An Anthropic API key from console.anthropic.com is required for the Claude SDK backend. OAuth tokens from Claude Free/Pro/Max plans are not permitted for third-party use. For free local inference, use Ollama instead.

See the full configuration reference for all settings.

---

Development

git clone https://github.com/pocketpaw/pocketpaw.git && cd pocketpaw
uv sync --dev               # Install with dev deps
uv run pocketpaw --dev      # Dashboard with auto-reload
uv run pytest               # Run tests (2000+)
uv run ruff check . && uv run ruff format .  # Lint & format

Optional extras

pip install pocketpaw[openai-agents]       # OpenAI Agents backend
pip install pocketpaw[google-adk]          # Google ADK backend
pip install pocketpaw[discord]             # Discord
pip install pocketpaw[slack]               # Slack
pip install pocketpaw[memory]              # Mem0 semantic memory
pip install pocketpaw[all]                 # Everything

---

Documentation

Full docs at docs.pocketpaw.xyz — getting started, backends, channels, tools, integrations, security, memory, API reference (50+ endpoints).

---

Star History

Contributors

---

Join the Pack

• Twitter: @PocketPawAI
• Discord: Coming Soon
• Email: [e-mail]

PRs welcome. Come build with us.

License

MIT © PocketPaw Team

Made with love for humans who want AI on their own terms