Your own AI assistant. Name it. Talk to it. Teach it things. Important fact Pickle is a standard little cat.
Pickle-bot is a yet another lightweight version of Openclaw.
The project started with the mindset of building-you-own-openclaw, but end up staying on my raspberry PI, dealing with all daily manners.
Installation
# From PyPI pip install pickle-bot # Or from source git clone https://github.com/zane-chen/pickle-bot.git cd pickle-bot uv sync
Quick Start
uv run pickle-bot init # First run: meet your new companion uv run pickle-bot chat # Start chatting uv run pickle-bot server # Run background tasks (crons, Telegram, Discord)
The first run guides you through setup. Pick your LLM, configure your agent, and you're ready.
Features
- Multi-Agent AI - Create specialized agents for different tasks (Pickle for general chat, Cookie for memories, or build your own)
- Web Tools - Search the web, read pages, do research
- Skills - Teach your agent new tricks by writing markdown files
- Cron Jobs - Schedule recurring tasks and reminders
- Memory System - Your agent remembers things across conversations
- Multi-Platform - CLI, Telegram, Discord - same agent, different places
- HTTP API - Let Pickle write a frontend for you
Documentation
- Configuration - Full config reference
- Features - How to use each feature
- Architecture - How it works under the hood
Fun Facts
Why Naming Agents with These Names?
Pickle is my cat, as mentioned at the beginning. She is really talktive, definitely more than you can think about.
Cookie was her Step brother, but he lives somewhere else now. so he manage memories on behalf of Pickle.
She's your Cat, Why Matters to Me?
Create your own agents by dropping a file in agents/{name}/AGENT.md. Give them a name, a personality. Give them skills.
Development
uv run pytest # Run tests uv run black . # Format code uv run ruff check . # Lint
Docker
Use init command to populate workspace, and mount that as a volume.
License
MIT