MCPcopy
hub / github.com/sipeed/picoclaw

github.com/sipeed/picoclaw @v0.3.1 sqlite

repository ↗ · DeepWiki ↗ · release v0.3.1 ↗
11,306 symbols 60,663 edges 1,037 files 2,381 documented · 21%
README

PicoClaw

PicoClaw: Ultra-Efficient AI Assistant in Go

$10 Hardware · 10MB RAM · ms Boot · Let's Go, PicoClaw!

<img src="https://img.shields.io/badge/Go-1.25+-00ADD8?style=flat&logo=go&logoColor=white" alt="Go">
<img src="https://img.shields.io/badge/Arch-x86__64%2C%20ARM64%2C%20MIPS%2C%20RISC--V%2C%20LoongArch-blue" alt="Hardware">
<img src="https://img.shields.io/badge/license-MIT-green" alt="License">



<a href="https://picoclaw.io"><img src="https://img.shields.io/badge/Website-picoclaw.io-blue?style=flat&logo=google-chrome&logoColor=white" alt="Website"></a>
<a href="https://docs.picoclaw.io/"><img src="https://img.shields.io/badge/Docs-Official-007acc?style=flat&logo=read-the-docs&logoColor=white" alt="Docs"></a>
<a href="https://deepwiki.com/sipeed/picoclaw"><img src="https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat&logo=wikipedia&logoColor=white" alt="Wiki"></a>



<a href="https://x.com/SipeedIO"><img src="https://img.shields.io/badge/X_(Twitter)-SipeedIO-black?style=flat&logo=x&logoColor=white" alt="Twitter"></a>
<a href="https://github.com/sipeed/picoclaw/raw/v0.3.1/assets/wechat.png"><img src="https://img.shields.io/badge/WeChat-Group-41d56b?style=flat&logo=wechat&logoColor=white"></a>
<a href="https://discord.gg/V4sAZ9XWpN"><img src="https://img.shields.io/badge/Discord-Community-4c60eb?style=flat&logo=discord&logoColor=white" alt="Discord"></a>

中文 | 日本語 | 한국어 | Português | Tiếng Việt | Français | Italiano | Bahasa Indonesia | Malay | English

PicoPaw AI: Your AI Desktop Buddy

PicoPaw AI is now live at picopaw.ai.

Create, preview, and share playful AI companions for the PicoClaw ecosystem.


PicoClaw is an independent open-source project initiated by Sipeed, written entirely in Go from scratch — not a fork of OpenClaw, NanoBot, or any other project.

PicoClaw is an ultra-lightweight personal AI assistant inspired by NanoBot. It was rebuilt from the ground up in Go through a "self-bootstrapping" process — the AI Agent itself drove the architecture migration and code optimization.

Runs on $10 hardware with <10MB RAM — that's 99% less memory than OpenClaw and 98% cheaper than a Mac mini!

[!CAUTION] Security Notice

  • NO CRYPTO: PicoClaw has not issued any official tokens or cryptocurrency. All claims on pump.fun or other trading platforms are scams.
  • OFFICIAL DOMAIN: The ONLY official PicoClaw website is picoclaw.io, and company website is sipeed.com
  • BEWARE: Many lookalike .ai/.org/.com/.net/... domains have been registered by third parties. Only trust domains explicitly linked from this README.
  • NOTE: PicoClaw is in early rapid development. There may be unresolved security issues. Do not deploy to production before v1.0.
  • NOTE: PicoClaw has recently merged many PRs. Recent builds may use 10-20MB RAM. Resource optimization is planned after feature stabilization.

📢 News

2026-06-11 🐾 PicoPaw AI is live! Explore the new PicoPaw companion experience at picopaw.ai, with animated AI pet previews and ecosystem updates for PicoClaw users.

2026-05-11 🛒 LicheeRV-Claw on AliExpress! You can now purchase LicheeRV-Claw from AliExpress, making it easier to try PicoClaw on compact RISC-V hardware.

LicheeRV-Claw on AliExpress

2026-05-28 🚀 v0.2.9 Released! MCP server management in Web UI, configurable Sogou-backed web search, tool feedback animation in channels, pretty_print and disable_escape_html defaults, and numerous bug fixes across providers and channels.

2026-05-14 🚀 v0.2.8 Released! MCP CLI commands (show, add, list, remove, test, edit), empty object instead of null for MCP tool parameters, and build fixes.

2026-05-07 🚀 v0.2.7 Released! Configurable Sogou-backed web search, channel tool feedback animation, linter fixes.

2026-04-23 🚀 v0.2.6 Released! Hooks with respond action and comprehensive documentation, isolation support, help banner fix.

2026-04-11 🚀 v0.2.5 Released! Zoneinfo from TZ/ZONEINFO env, Matrix CommonMark rendering alignment, read_file by lines.

2026-03-31 📱 Android Support! PicoClaw now runs on Android! Download the APK at picoclaw.io

2026-03-25 🚀 v0.2.4 Released! Agent architecture overhaul (SubTurn, Hooks, Steering, EventBus), WeChat/WeCom integration, security hardening (.security.yml, sensitive data filtering), new providers (AWS Bedrock, Azure, Xiaomi MiMo), and 35 bug fixes. PicoClaw has reached 26K Stars!

2026-03-17 🚀 v0.2.3 Released! System tray UI (Windows & Linux), sub-agent status query (spawn_status), experimental Gateway hot-reload, Cron security gating, and 2 security fixes. PicoClaw has reached 25K Stars!

2026-03-09 🎉 v0.2.1 — Biggest update yet! MCP protocol support, 4 new channels (Matrix/IRC/WeCom/Discord Proxy), 3 new providers (Kimi/Minimax/Avian), vision pipeline, JSONL memory store, model routing.

2026-02-28 📦 v0.2.0 released with Docker Compose and Web UI Launcher support.

Earlier news...

2026-02-26 🎉 PicoClaw hits 20K Stars in just 17 days! Channel auto-orchestration and capability interfaces are live.

2026-02-16 🎉 PicoClaw breaks 12K Stars in one week! Community maintainer roles and Roadmap officially launched.

2026-02-13 🎉 PicoClaw breaks 5000 Stars in 4 days! Project roadmap and developer groups in progress.

2026-02-09 🎉 PicoClaw Released! Built in 1 day to bring AI Agents to $10 hardware with <10MB RAM. Let's Go, PicoClaw!

✨ Features

🪶 Ultra-lightweight: Core memory footprint <10MB — 99% smaller than OpenClaw.*

💰 Minimal cost: Efficient enough to run on $10 hardware — 98% cheaper than a Mac mini.

⚡️ Lightning-fast boot: 400x faster startup. Boots in <1s even on a 0.6GHz single-core processor.

🌍 Truly portable: Single binary across RISC-V, ARM, MIPS, and x86 architectures. One binary, runs everywhere!

🤖 AI-bootstrapped: Pure Go native implementation — 95% of core code was generated by an Agent and fine-tuned through human-in-the-loop review.

🔌 MCP support: Native Model Context Protocol integration — connect any MCP server to extend Agent capabilities.

👁️ Vision pipeline: Send images and files directly to the Agent — automatic base64 encoding for multimodal LLMs.

🧠 Smart routing: Rule-based model routing — simple queries go to lightweight models, saving API costs.

*Recent builds may use 10-20MB due to rapid PR merges. Resource optimization is planned. Boot speed comparison based on 0.8GHz single-core benchmarks (see table below).

OpenClaw NanoBot PicoClaw
Language TypeScript Python Go
RAM >1GB >100MB < 10MB*
Boot time

(0.8GHz core) | >500s | >30s | <1s | | Cost | Mac Mini $599 | Most Linux boards ~$50 | Any Linux board

from $10 |

PicoClaw

Hardware Compatibility List — See all tested boards, from $5 RISC-V to Raspberry Pi to Android phones. Your board not listed? Submit a PR!

PicoClaw Hardware Compatibility

🦾 Demonstration

🛠️ Standard Assistant Workflows

Full-Stack Engineer Mode Logging & Planning Web Search & Learning
Develop · Deploy · Scale Schedule · Automate · Remember Discover · Insights · Trends

🐜 Innovative Low-Footprint Deployment

PicoClaw can be deployed on virtually any Linux device!

https://private-user-images.githubusercontent.com/83055338/547056448-e7b031ff-d6f5-4468-bcca-5726b6fecb5c.mp4

🌟 More Deployment Cases Await!

📦 Install

Download from picoclaw.io (Recommended)

Visit picoclaw.io — the official website auto-detects your platform and provides one-click download. No need to manually pick an architecture.

Download precompiled binary

Alternatively, download the binary for your platform from the GitHub Releases page.

Build from source (for development)

Prerequisites:

  • Go 1.25+
  • Node.js 22+ and pnpm 10.33.0+ for Web UI / launcher builds
git clone https://github.com/sipeed/picoclaw.git

cd picoclaw
make deps

# Install frontend dependencies
(cd web/frontend && pnpm install --frozen-lockfile)

# Build the core binary for the current platform
make build

# Build the Web UI Launcher (required for WebUI mode)
make build-launcher

# Build core binaries for all Makefile-managed platforms
make build-all

# Build for Raspberry Pi Zero 2 W
# 32-bit: make build-linux-arm
# 64-bit: make build-linux-arm64
make build-pi-zero

# Build and install
make install

Raspberry Pi Zero 2 W: Use the binary that matches your OS: 32-bit Raspberry Pi OS -> make build-linux-arm; 64-bit -> make build-linux-arm64. Or run make build-pi-zero to build both.

🚀 Quick Start Guide

🌐 WebUI Launcher (Recommended for Desktop)

The WebUI Launcher provides a browser-based interface for configuration and chat. This is the easiest way to get started — no command-line knowledge required.

Option 1: Double-click (Desktop)

After downloading from picoclaw.io, double-click picoclaw-launcher (or picoclaw-launcher.exe on Windows). Your browser will open automatically at http://localhost:18800.

Option 2: Command line

picoclaw-launcher
# Open http://localhost:18800 in your browser

[!TIP] Remote access / Docker / VM: Add the -public flag to listen on all interfaces: bash picoclaw-launcher -public

WebUI Launcher

Getting started:

Open the WebUI, then: 1) Configure a Provider (add your LLM API key) -> 2) Configure a Channel (e.g., Telegram) -> 3) Start the Gateway -> 4) Chat!

For detailed WebUI documentation, see docs.picoclaw.io.

Docker (alternative)

# 1. Clone this repo
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw

# 2. First run — auto-generates docker/data/config.json then exits
#    (only triggers when both config.json and workspace/ are missing)
docker compose -f docker/docker-compose.yml --profile launcher up
# The container prints "First-run setup complete." and stops.

# 3. Set your API keys
vim docker/data/config.json

# 4. Start
docker compose -f docker/docker-compose.yml --profile launcher up -d
# Open http://localhost:18800

Docker / VM users: The Gateway listens on 127.0.0.1 by default. Set PICOCLAW_GATEWAY_HOST=0.0.0.0 or use the -public flag to make it accessible from the host.

# Check logs
docker compose -f docker/docker-compose.yml logs -f

# Stop
docker compose -f docker/docker-compose.yml --profile launcher down

# Update
docker compose -f docker/docker-compose.yml pull
docker compose -f docker/docker-compose.yml --profile launcher up -d

macOS — First Launch Security Warning

Extension points exported contracts — how you extend this code

Tool (Interface)
Tool is the interface that all tools must implement. [45 implementers]
pkg/tools/shared/base.go
StreamingProvider (Interface)
StreamingProvider is an optional interface for providers that support token streaming. onChunk receives the accumulated [6 …
pkg/providers/types.go
VoiceCapabilityProvider (Interface)
VoiceCapabilityProvider is an optional interface for channels that want to explicitly declare their ASR/TTS support. [9 …
pkg/channels/voice_capabilities.go
SkillRegistry (Interface)
SkillRegistry is the interface that all skill registries must implement. Each registry represents a different source of [7 …
pkg/skills/registry.go
Streamer (Interface)
Streamer pushes incremental content to a streaming-capable channel. Defined here so the agent loop can use it without im [8 …
pkg/bus/bus.go
DraftGenerator (Interface)
(no doc) [6 implementers]
pkg/evolution/drafts.go
ContextManager (Interface)
ContextManager manages conversation context via a pluggable strategy. Exactly ONE ContextManager is active per AgentLoop [4 …
pkg/agent/context_manager.go
Transcriber (Interface)
(no doc) [5 implementers]
pkg/audio/asr/asr.go

Core symbols most depended-on inside this repo

Fatalf
called by 7554
pkg/logger/logger_3rd_party.go
Errorf
called by 3635
pkg/logger/logger_3rd_party.go
Contains
called by 1247
pkg/utils/http_guard.go
Error
called by 908
pkg/providers/types.go
String
called by 511
pkg/events/types.go
Set
called by 488
pkg/config/config_struct.go
WriteFile
called by 413
pkg/tools/fs/filesystem.go
Run
called by 388
pkg/agent/agent.go

Shape

Function 7,057
Method 2,756
Struct 1,156
Interface 250
TypeAlias 57
FuncType 30

Languages

Go93%
TypeScript7%

Modules by API surface

pkg/agent/agent_test.go290 symbols
pkg/config/config.go147 symbols
pkg/channels/manager_test.go132 symbols
pkg/config/config_test.go112 symbols
pkg/channels/manager.go106 symbols
pkg/migrate/sources/openclaw/openclaw_config.go86 symbols
pkg/tools/integration/web.go83 symbols
pkg/tools/integration/web_test.go79 symbols
pkg/agent/hooks_test.go79 symbols
pkg/providers/openai_compat/provider_test.go74 symbols
pkg/channels/telegram/telegram_test.go72 symbols
web/backend/api/gateway_test.go70 symbols

Dependencies from manifests, versioned

aead.dev/minisignv0.2.0 · 1×
filippo.io/edwards25519v1.2.0 · 1×
fyne.io/systrayv1.12.2 · 1×
github.com/Azure/azure-sdk-for-go/sdk/azcorev1.22.0 · 1×
github.com/Azure/azure-sdk-for-go/sdk/azidentityv1.14.0 · 1×
github.com/Azure/azure-sdk-for-go/sdk/internalv1.12.0 · 1×
github.com/AzureAD/microsoft-authentication-library-for-gov1.7.2 · 1×
github.com/SevereCloud/vksdk/v3v3.3.1 · 1×
github.com/adhocore/gronxv1.20.0 · 1×
github.com/andybalholm/brotliv1.2.1 · 1×
github.com/anthropics/anthropic-sdk-gov1.50.2 · 1×
github.com/atc0005/go-teams-notify/v2v2.14.0 · 1×

Datastores touched

dbnameDatabase · 1 repos
dbDatabase · 1 repos

For agents

$ claude mcp add picoclaw \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact