picoclaw/docs/project/README.id.md

PicoClaw: Asisten AI Super Ringan berbasis Go

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

中文 | 日本語 | 한국어 | 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.

Berita sebelumnya...

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).

	OpenClaw	NanoBot	PicoClaw
Bahasa	TypeScript	Python	Go
RAM	>1GB	>100MB	< 10MB*
Waktu Boot (core 0,8GHz)	>500d	>30d	<1d
Biaya	Mac Mini $599	Kebanyakan board Linux ~$50	Board Linux mana pun mulai $10

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

Mode Full-Stack Engineer	Pencatatan & Perencanaan	Pencarian Web & Pembelajaran
Develop · Deploy · Scale	Jadwal · Otomasi · Ingat	Temukan · Wawasan · Tren

🐜 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:

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.

Docker (alternatif)

# 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 — Peringatan Keamanan saat Pertama Kali Diluncurkan

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

Terminal Launcher (untuk lingkungan dengan sumber daya terbatas)

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:

Provider	Protocol	API Key	Catatan
OpenAI	openai/	Diperlukan	GPT-5.4, GPT-4o, o3, dll.
Anthropic	anthropic/	Diperlukan	Claude Opus 4.6, Sonnet 4.6, dll.
Google Gemini	gemini/	Diperlukan	Gemini 3 Flash, 2.5 Pro, dll.
OpenRouter	openrouter/	Diperlukan	200+ model, API terpadu
Zhipu (GLM)	zhipu/	Diperlukan	GLM-4.7, GLM-5, dll.
DeepSeek	deepseek/	Diperlukan	DeepSeek-V3, DeepSeek-R1
Volcengine	volcengine/	Diperlukan	Doubao, model Ark
Qwen	qwen/	Diperlukan	Qwen3, Qwen-Max, dll.
Groq	groq/	Diperlukan	Inferensi cepat (Llama, Mixtral)
Moonshot (Kimi)	moonshot/	Diperlukan	Model Kimi
Minimax	minimax/	Diperlukan	Model MiniMax
Mistral	mistral/	Diperlukan	Mistral Large, Codestral
NVIDIA NIM	nvidia/	Diperlukan	Model yang di-host NVIDIA
Cerebras	cerebras/	Diperlukan	Inferensi cepat
Novita AI	novita/	Diperlukan	Berbagai model open
Xiaomi MiMo	mimo/	Diperlukan	Model MiMo
Ollama	ollama/	Tidak perlu	Model lokal, self-hosted
vLLM	vllm/	Tidak perlu	Deploy lokal, kompatibel OpenAI
LiteLLM	litellm/	Bervariasi	Proxy untuk 100+ provider
Azure OpenAI	azure/	Diperlukan	Deploy Azure enterprise
GitHub Copilot	github-copilot/	OAuth	Login dengan device code
Antigravity	antigravity/	OAuth	Google Cloud AI

Deploy lokal (Ollama, vLLM, dll.)

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:

Channel	Pengaturan	Protocol	Dokumentasi
Telegram	Mudah (bot token)	Long polling	Panduan
Discord	Mudah (bot token + intents)	WebSocket	Panduan
WhatsApp	Mudah (scan QR atau bridge URL)	Native / Bridge	Panduan
Weixin	Mudah (scan QR native)	iLink API	Panduan
QQ	Mudah (AppID + AppSecret)	WebSocket	Panduan
Slack	Mudah (bot + app token)	Socket Mode	Panduan
Matrix	Sedang (homeserver + token)	Sync API	Panduan
DingTalk	Sedang (client credentials)	Stream	Panduan
Feishu / Lark	Sedang (App ID + Secret)	WebSocket/SDK	Panduan
LINE	Sedang (credentials + webhook)	Webhook	Panduan
WeCom	Mudah (login QR atau manual)	WebSocket	Panduan
IRC	Sedang (server + nick)	IRC protocol	Panduan
OneBot	Sedang (WebSocket URL)	OneBot v11	Panduan
MaixCam	Mudah (aktifkan)	TCP socket	Panduan
Pico	Mudah (aktifkan)	Native protocol	Bawaan
Pico Client	Mudah (WebSocket URL)	WebSocket	Bawaan

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:

Mesin Pencari	API Key	Tier Gratis	Tautan
DuckDuckGo	Tidak perlu	Tidak terbatas	Fallback bawaan
Baidu Search	Diperlukan	1000 kueri/hari	Bertenaga AI, dioptimalkan untuk bahasa Mandarin
Tavily	Diperlukan	1000 kueri/bulan	Dioptimalkan untuk AI Agent
Brave Search	Diperlukan	2000 kueri/bulan	Cepat dan privat
Perplexity	Diperlukan	Berbayar	Pencarian bertenaga AI
SearXNG	Tidak perlu	Self-hosted	Mesin metasearch gratis
GLM Search	Diperlukan	Bervariasi	Pencarian web Zhipu

⚙️ 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

Perintah	Deskripsi
picoclaw onboard	Inisialisasi konfigurasi & workspace
picoclaw auth weixin	Hubungkan akun WeChat via QR
picoclaw agent -m "..."	Chat dengan agent
picoclaw agent	Mode chat interaktif
picoclaw gateway	Mulai gateway
picoclaw status	Tampilkan status
picoclaw version	Tampilkan info versi
picoclaw model	Lihat atau ganti model default
picoclaw cron list	Daftar semua tugas terjadwal
picoclaw cron add ...	Tambah tugas terjadwal
picoclaw cron disable	Nonaktifkan tugas terjadwal
picoclaw cron remove	Hapus tugas terjadwal
picoclaw skills list	Daftar skill yang terinstal
picoclaw skills install	Instal skill
picoclaw migrate	Migrasi data dari versi lama
picoclaw auth login	Autentikasi dengan provider

⏰ 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:

Topik	Deskripsi
Docker & Panduan Cepat	Pengaturan Docker Compose, mode Launcher/Agent
Aplikasi Chat	Semua 17+ panduan pengaturan channel
Konfigurasi	Variabel environment, tata letak workspace, sandbox keamanan
Providers & Models	30+ provider LLM, routing model, konfigurasi model_list
Spawn & Tugas Async	Tugas cepat, tugas panjang dengan spawn, orkestrasi sub-agent async
Hooks	Sistem hook berbasis event: observer, interceptor, approval hook
Steering	Menyuntikkan pesan ke dalam loop agent yang sedang berjalan
SubTurn	Koordinasi subagent, kontrol konkurensi, siklus hidup
Pemecahan Masalah	Masalah umum dan solusinya
Konfigurasi Tools	Aktifkan/nonaktifkan per-tool, kebijakan exec, MCP, Skills
Kompatibilitas Hardware	Board yang telah diuji, persyaratan minimum

🤝 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: