README.md

metadata

title: zeroclaw
emoji: 🦞
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: false
app_port: 7860

PicoClaw: Autonomous Distributed Systems Engineer

$10 Hardware · 10MB RAM · Voice-Enabled · Autonomous

中文 | 日本語 | English

---

🦐 PicoClaw is an ultra-lightweight, autonomous personal AI agent written in Go. Designed as a Distributed Systems Engineer, it combines the speed of Go with the intelligence of modern LLMs to handle complex tasks like Docker management, network debugging, and system monitoring with minimal resource footprint.

It runs on $10 hardware (like LicheeRV Nano) with <10MB RAM, making it 99% more efficient than Python-based alternatives.

🚨 SECURITY & OFFICIAL CHANNELS

• NO CRYPTO: PicoClaw has NO official token/coin. All claims on pump.fun or other trading platforms are SCAMS.
• OFFICIAL DOMAIN: The ONLY official website is picoclaw.io.
• Warning: PicoClaw is in Alpha. Do not deploy to critical production environments without review.

🚀 Capabilities

PicoClaw is more than just a chatbot. It's an autonomous engineer with specialized skills:

• 🗣️ Voice Interaction: Speaks directly to you using Google TTS (Auto-configured).
• 🐳 Docker Management: List, inspect, and manage containers via CLI.
• 🔬 AI Research: Search ArXiv for papers and summarize findings.
• 🛠️ Go Development: Assist with Go code, compilation, and debugging.
• 📊 Visualization: Generate system architecture diagrams using Mermaid JS.
• 🌐 Network Utilities: Debug DNS, ping hosts, and trace routes.
• 🛡️ Security Audit: Scan code for secrets and vulnerabilities.
• 🧠 Memory & Planning: Remembers context across sessions and plans complex tasks.

📦 Installation

curl -fsSL https://picoclaw.io/install.sh | sh

Or build from source:

git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
make install

🛠️ Usage

Quick Start

Start the interactive agent. It will automatically set up required skills (Voice, etc.) on first run.

picoclaw agent -m "Hello, who are you?"

Voice Mode

PicoClaw can speak its responses! Ensure you have speakers connected.

# It will use the 'voice-tts' skill automatically when appropriate
picoclaw agent -m "Please introduce yourself in a voice message."

Run as a Daemon (Gateway)

Run PicoClaw as a background service to handle heartbeats, cron jobs, and multi-channel messages (Telegram/Discord/etc).

picoclaw gateway

🐳 Docker Support

PicoClaw is available as a Docker image.

# Run agent
docker compose run --rm picoclaw-agent -m "Hello"

# Run gateway
docker compose up -d picoclaw-gateway

Note: To use Voice or Docker skills within the container, you may need to mount /dev/snd or /var/run/docker.sock.

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for details.

📄 License

MIT License