README.Id

<a href="https://picoclaw.io"></a>
<a href="https://docs.picoclaw.io/"></a>
<a href="https://deepwiki.com/sipeed/picoclaw"></a>


<a href="https://x.com/SipeedIO"></a>
<a href="../../assets/wechat.png"></a>
<a href="https://discord.gg/V4sAZ9XWpN"></a>

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

PicoClaw adalah proyek open-source independen yang diinisiasi oleh Sipeed, ditulis sepenuhnya dalam Go — bukan fork dari OpenClaw, NanoBot, atau proyek lainnya.

PicoClaw adalah asisten AI pribadi yang super ringan, terinspirasi dari NanoBot. Dibangun ulang dari awal dalam Go melalui proses "self-bootstrapping" — AI Agent itu sendiri yang memandu migrasi arsitektur dan optimasi kode.

Berjalan di perangkat keras $10 dengan RAM <10MB — hemat 99% memori dibanding OpenClaw dan 98% lebih murah dari Mac mini!

[!CAUTION] Peringatan Keamanan

• TANPA KRIPTO: PicoClaw tidak menerbitkan token atau cryptocurrency resmi apa pun. Semua klaim di pump.fun atau platform trading lainnya adalah penipuan.
• DOMAIN RESMI: Satu-satunya website resmi adalah picoclaw.io, dan website perusahaan adalah sipeed.com
• WASPADA: Banyak domain .ai/.org/.com/.net/... telah didaftarkan oleh pihak ketiga. Jangan percaya mereka.
• CATATAN: PicoClaw masih dalam tahap pengembangan awal yang cepat. Mungkin ada masalah keamanan yang belum terselesaikan. Jangan deploy ke produksi sebelum v1.0.
• CATATAN: PicoClaw baru-baru ini menggabungkan banyak PR. Build terbaru mungkin menggunakan RAM 10-20MB. Optimasi sumber daya direncanakan setelah fitur stabil.

📢 Berita

2026-03-31 📱 Dukungan Android! PicoClaw sekarang berjalan di Android! Unduh APK di picoclaw.io

2026-03-25 🚀 v0.2.4 Dirilis! Perombakan arsitektur Agent (SubTurn, Hooks, Steering, EventBus), integrasi WeChat/WeCom, penguatan keamanan (.security.yml, penyaringan data sensitif), provider baru (AWS Bedrock, Azure, Xiaomi MiMo), dan 35 perbaikan bug. PicoClaw telah mencapai 26K Stars!

2026-03-17 🚀 v0.2.3 Dirilis! UI system tray (Windows & Linux), pelacakan status sub-agent (spawn_status), eksperimental Gateway hot-reload, gerbang keamanan Cron, dan 2 perbaikan keamanan. PicoClaw telah mencapai 25K Stars!

2026-03-09 🎉 v0.2.1 — Pembaruan terbesar sejauh ini! Dukungan protokol MCP, 4 channel baru (Matrix/IRC/WeCom/Discord Proxy), 3 provider baru (Kimi/Minimax/Avian), pipeline visi, penyimpanan memori JSONL, perutean model.

2026-02-28 📦 v0.2.0 dirilis dengan dukungan Docker Compose dan Web UI Launcher.

2026-02-26 🎉 PicoClaw mencapai 20K Stars hanya dalam 17 hari! Orkestrasi channel otomatis dan antarmuka kapabilitas kini aktif.

2026-02-16 🎉 PicoClaw menembus 12K Stars dalam satu minggu! Peran maintainer komunitas dan Roadmap resmi diluncurkan.

2026-02-13 🎉 PicoClaw menembus 5000 Stars dalam 4 hari! Roadmap proyek dan grup pengembang sedang dalam proses.

2026-02-09 🎉 PicoClaw Diluncurkan! Dibangun dalam 1 hari untuk menghadirkan AI Agent ke perangkat keras $10 dengan RAM <10MB. Let's Go, PicoClaw!

✨ Fitur

🪶 Super Ringan: Penggunaan memori inti <10MB — 99% lebih kecil dari OpenClaw.*

💰 Biaya Minimal: Cukup efisien untuk berjalan di perangkat keras $10 — 98% lebih murah dari Mac mini.

⚡️ Boot Secepat Kilat: Startup 400x lebih cepat. Boot dalam <1 detik bahkan di prosesor single-core 0,6GHz.

🌍 Portabilitas Sejati: Satu binary untuk RISC-V, ARM, MIPS, dan x86. Satu binary, jalan di mana saja!

🤖 AI-Bootstrapped: Implementasi Go native murni — 95% kode inti dihasilkan oleh Agent dengan penyempurnaan human-in-the-loop.

🔌 Dukungan MCP: Integrasi Model Context Protocol native — hubungkan server MCP mana pun untuk memperluas kapabilitas Agent.

👁️ Pipeline Vision: Kirim gambar dan file langsung ke Agent — encoding base64 otomatis untuk LLM multimodal.

🧠 Routing Cerdas: Routing model berbasis aturan — kueri sederhana diarahkan ke model ringan, menghemat biaya API.

*Build terbaru mungkin menggunakan 10-20MB karena penggabungan PR yang cepat. Optimasi sumber daya direncanakan. Perbandingan kecepatan boot berdasarkan benchmark single-core 0,8GHz (lihat tabel di bawah).

Daftar Kompatibilitas Hardware — Lihat semua board yang telah diuji, dari RISC-V $5 hingga Raspberry Pi hingga ponsel Android. Board Anda belum terdaftar? Kirim PR!

🦾 Demonstrasi

🛠️ Alur Kerja Asisten Standar

🐜 Deploy Inovatif dengan Footprint Rendah

PicoClaw dapat di-deploy di hampir semua perangkat Linux!

• $9,9 LicheeRV-Nano versi E(Ethernet) atau W(WiFi6), untuk home assistant minimal
• $30~50 NanoKVM, atau $100 NanoKVM-Pro, untuk operasi server otomatis
• $50 MaixCAM atau $100 MaixCAM2, untuk pengawasan cerdas

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

🌟 Lebih Banyak Kasus Deploy Menanti!

📦 Instalasi

Unduh dari picoclaw.io (Direkomendasikan)

Kunjungi picoclaw.io — website resmi mendeteksi platform Anda secara otomatis dan menyediakan unduhan satu klik. Tidak perlu memilih arsitektur secara manual.

Unduh binary yang sudah dikompilasi

Atau, unduh binary untuk platform Anda dari halaman GitHub Releases.

Build dari source (untuk pengembangan)

Prasyarat:

• Go 1.25+
• Node.js 22+ dan pnpm 10.33.0+ untuk build Web UI / launcher

git clone https://github.com/sipeed/picoclaw.git

cd picoclaw
make deps

# Instal dependensi frontend
(cd web/frontend && pnpm install --frozen-lockfile)

# Build binary inti
make build

# Build Web UI Launcher (diperlukan untuk mode WebUI)
make build-launcher

# Build binary inti untuk semua platform yang dikelola Makefile
make build-all

# Build untuk Raspberry Pi Zero 2 W (32-bit: make build-linux-arm; 64-bit: make build-linux-arm64)
make build-pi-zero

# Build dan instal
make install

Raspberry Pi Zero 2 W: Gunakan binary yang sesuai dengan OS Anda: Raspberry Pi OS 32-bit -> make build-linux-arm; 64-bit -> make build-linux-arm64. Atau jalankan make build-pi-zero untuk build keduanya.

🚀 Panduan Memulai Cepat

🌐 WebUI Launcher (Direkomendasikan untuk Desktop)

WebUI Launcher menyediakan antarmuka berbasis browser untuk konfigurasi dan chat. Ini adalah cara termudah untuk memulai — tidak perlu pengetahuan command-line.

Opsi 1: Klik dua kali (Desktop)

Setelah mengunduh dari picoclaw.io, klik dua kali picoclaw-launcher (atau picoclaw-launcher.exe di Windows). Browser Anda akan terbuka otomatis di http://localhost:18800.

Opsi 2: Command line

picoclaw-launcher
# Buka http://localhost:18800 di browser Anda

[!TIP] Akses jarak jauh / Docker / VM: Tambahkan flag -public untuk mendengarkan di semua antarmuka:

bashCopy

picoclaw-launcher -public

Memulai:

Buka WebUI, lalu: 1) Konfigurasi Provider (tambahkan API key LLM Anda) -> 2) Konfigurasi Channel (mis. Telegram) -> 3) Mulai Gateway -> 4) Chat!

Untuk dokumentasi WebUI lengkap, lihat docs.picoclaw.io.

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

# 2. Jalankan pertama kali — otomatis membuat docker/data/config.json lalu keluar
#    (hanya terpicu ketika config.json dan workspace/ keduanya tidak ada)
docker compose -f docker/docker-compose.yml --profile launcher up
# Container mencetak "First-run setup complete." dan berhenti.

# 3. Atur API key Anda
vim docker/data/config.json

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

Pengguna Docker / VM: Gateway mendengarkan di 127.0.0.1 secara default. Atur PICOCLAW_GATEWAY_HOST=0.0.0.0 atau gunakan flag -public agar dapat diakses dari host.

# Cek log
docker compose -f docker/docker-compose.yml logs -f

# Hentikan
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 mungkin memblokir picoclaw-launcher saat pertama kali diluncurkan karena diunduh dari internet dan tidak dinotarisasi melalui Mac App Store.

Langkah 1: Klik dua kali picoclaw-launcher. Anda akan melihat peringatan keamanan:

"picoclaw-launcher" Tidak Dapat Dibuka — Apple tidak dapat memverifikasi bahwa "picoclaw-launcher" bebas dari malware yang dapat membahayakan Mac Anda atau mengancam privasi Anda.

Langkah 2: Buka Pengaturan Sistem → Privasi & Keamanan → gulir ke bawah ke bagian Keamanan → klik Tetap Buka → konfirmasi dengan mengklik Tetap Buka pada dialog.

Setelah langkah satu kali ini, picoclaw-launcher akan terbuka secara normal pada peluncuran berikutnya.

📱 Android

Berikan kehidupan kedua untuk ponsel lama Anda! Ubah menjadi Asisten AI pintar dengan PicoClaw.

Opsi 1: Instal APK

Pratinjau:

Unduh APK dari picoclaw.io dan instal langsung. Tanpa Termux!

Opsi 2: Termux

1. Instal Termux (unduh dari GitHub Releases, atau cari di F-Droid / Google Play)
2. Jalankan perintah berikut:

# Unduh rilis terbaru
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw_Linux_arm64.tar.gz
tar xzf picoclaw_Linux_arm64.tar.gz
pkg install proot
termux-chroot ./picoclaw onboard   # chroot menyediakan tata letak filesystem Linux standar

Kemudian ikuti bagian Terminal Launcher di bawah untuk menyelesaikan konfigurasi.

Untuk lingkungan minimal di mana hanya binary inti picoclaw yang tersedia (tanpa Launcher UI), Anda dapat mengonfigurasi semuanya melalui command line dan file konfigurasi JSON.

1. Inisialisasi

picoclaw onboard

Ini membuat ~/.picoclaw/config.json dan direktori workspace.

2. Konfigurasi (~/.picoclaw/config.json)

{
  "agents": {
    "defaults": {
      "model_name": "gpt-5.4"
    }
  },
  "model_list": [
    {
      "model_name": "gpt-5.4",
      "model": "openai/gpt-5.4",
      "api_key": "sk-your-api-key"
    }
  ]
}

Lihat config/config.example.json di repo untuk template konfigurasi lengkap dengan semua opsi yang tersedia.

3. Chat

# Pertanyaan satu kali
picoclaw agent -m "What is 2+2?"

# Mode interaktif
picoclaw agent

# Mulai gateway untuk integrasi aplikasi chat
picoclaw gateway

🔌 Providers (LLM)

PicoClaw mendukung 30+ provider LLM melalui konfigurasi model_list. Gunakan format protocol/model:

Ollama:

{
  "model_list": [
    {
      "model_name": "local-llama",
      "model": "ollama/llama3.1:8b",
      "api_base": "http://localhost:11434/v1"
    }
  ]
}

vLLM:

{
  "model_list": [
    {
      "model_name": "local-vllm",
      "model": "vllm/your-model",
      "api_base": "http://localhost:8000/v1"
    }
  ]
}

Untuk detail konfigurasi provider lengkap, lihat Providers & Models.

💬 Channels (Aplikasi Chat)

Bicara dengan PicoClaw Anda melalui 17+ platform pesan:

Semua channel berbasis webhook berbagi satu server HTTP Gateway (gateway.host:gateway.port, default 127.0.0.1:18790). Feishu menggunakan mode WebSocket/SDK dan tidak menggunakan server HTTP bersama.

Verbositas log dikontrol oleh gateway.log_level (default: warn). Nilai yang didukung: debug, info, warn, error, fatal. Juga dapat diatur melalui PICOCLAW_LOG_LEVEL. Lihat Konfigurasi untuk detail.

Untuk instruksi pengaturan channel lengkap, lihat Konfigurasi Aplikasi Chat.

🔧 Tools

🔍 Pencarian Web

PicoClaw dapat mencari web untuk memberikan informasi terkini. Konfigurasi di tools.web:

⚙️ Tools Lainnya

PicoClaw menyertakan tools bawaan untuk operasi file, eksekusi kode, penjadwalan, dan lainnya. Lihat Konfigurasi Tools untuk detail.

🎯 Skills

Skills adalah kapabilitas modular yang memperluas Agent Anda. Dimuat dari file SKILL.md di workspace Anda.

Instal skills dari ClawHub:

picoclaw skills search "web scraping"
picoclaw skills install <skill-name>

Konfigurasi token ClawHub (opsional, untuk rate limit lebih tinggi):

Tambahkan ke config.json Anda:

{
  "tools": {
    "skills": {
      "registries": {
        "clawhub": {
          "auth_token": "your-clawhub-token"
        }
      }
    }
  }
}

Untuk detail lebih lanjut, lihat Konfigurasi Tools - Skills.

🔗 MCP (Model Context Protocol)

PicoClaw mendukung MCP secara native — hubungkan server MCP mana pun untuk memperluas kapabilitas Agent Anda dengan tools dan sumber data eksternal.

{
  "tools": {
    "mcp": {
      "enabled": true,
      "servers": {
        "filesystem": {
          "enabled": true,
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
        }
      }
    }
  }
}

Untuk konfigurasi MCP lengkap (transport stdio, SSE, HTTP, Tool Discovery), lihat Konfigurasi Tools - MCP.

Bergabung dengan Jaringan Sosial Agent

Hubungkan PicoClaw ke Jaringan Sosial Agent hanya dengan mengirim satu pesan melalui CLI atau Aplikasi Chat terintegrasi mana pun.

Baca https://clawdchat.ai/skill.md dan ikuti instruksi untuk bergabung dengan ClawdChat.ai

🖥️ Referensi CLI

⏰ Tugas Terjadwal / Pengingat

PicoClaw mendukung pengingat terjadwal dan tugas berulang melalui tool cron:

• Pengingat satu kali: "Ingatkan saya dalam 10 menit" -> terpicu sekali setelah 10 menit
• Tugas berulang: "Ingatkan saya setiap 2 jam" -> terpicu setiap 2 jam
• Ekspresi cron: "Ingatkan saya jam 9 pagi setiap hari" -> menggunakan ekspresi cron

📚 Dokumentasi

Untuk panduan lengkap di luar README ini:

🤝 Kontribusi & Roadmap

PR sangat diterima! Codebase sengaja dibuat kecil dan mudah dibaca.

Lihat Roadmap Komunitas dan CONTRIBUTING.md untuk panduan.

Grup pengembang sedang dibangun, bergabunglah setelah PR pertama Anda di-merge!

Grup Pengguna:

Discord: https://discord.gg/V4sAZ9XWpN

WeChat: