picoclaw/docs/project/README.ms.md

PicoClaw: Pembantu AI Ultra-Cekap dalam Go

Perkakasan $10 · RAM 10MB · Boot ms · Jom, PicoClaw!

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

---

PicoClaw adalah projek sumber terbuka bebas yang dilancarkan oleh Sipeed, ditulis sepenuhnya dalam Go dari awal — bukan cabang OpenClaw, NanoBot, atau projek lain.

PicoClaw adalah pembantu AI peribadi ultra-ringan yang terinspirasi oleh NanoBot. Ia dibina semula dari awal dalam Go melalui proses "self-bootstrapping" — AI Agent itu sendiri yang memacu migrasi seni bina dan pengoptimuman kod.

Berjalan pada perkakasan $10 dengan RAM <10MB — 99% lebih sedikit memori daripada OpenClaw dan 98% lebih murah daripada Mac mini!

Caution

Notis Keselamatan

• TIADA KRIPTO: PicoClaw tidak mengeluarkan sebarang token atau mata wang kripto rasmi. Semua tuntutan di pump.fun atau platform dagangan lain adalah penipuan.
• DOMAIN RASMI: Satu-satunya laman web rasmi ialah picoclaw.io, dan laman web syarikat ialah sipeed.com
• BERHATI-HATI: Banyak domain .ai/.org/.com/.net/... telah didaftarkan oleh pihak ketiga. Jangan percayai mereka.
• NOTA: PicoClaw dalam pembangunan pesat awal. Mungkin terdapat isu keselamatan yang belum diselesaikan. Jangan deploy ke pengeluaran sebelum v1.0.

📢 Berita

2026-03-31 📱 Sokongan Android! PicoClaw sekarang berjalan di Android! Muat turun APK di picoclaw.io

2026-03-25 🚀 v0.2.4 Dikeluarkan! Penstrukturan semula seni bina Agent (SubTurn, Hooks, Steering, EventBus), integrasi WeChat/WeCom, penguatan keselamatan (.security.yml, penapisan data sensitif), penyedia baharu (AWS Bedrock, Azure, Xiaomi MiMo), dan 35 pembetulan pepijat. PicoClaw mencapai 26K Stars!

2026-03-17 🚀 v0.2.3 Dikeluarkan! UI dulang sistem (Windows & Linux), pertanyaan status sub-agent (spawn_status), muat semula panas Gateway eksperimental, kawalan keselamatan Cron, dan 2 pembetulan keselamatan. PicoClaw mencapai 25K Stars!

2026-03-09 🎉 v0.2.1 — Kemas kini terbesar setakat ini! Sokongan protokol MCP, 4 saluran baharu (Matrix/IRC/WeCom/Discord Proxy), 3 penyedia baharu (Kimi/Minimax/Avian), saluran paip visi, storan memori JSONL, penghalaan model.

2026-02-28 📦 v0.2.0 dikeluarkan dengan sokongan Docker Compose dan Pelancar Web UI.

Berita terdahulu...

2026-02-26 🎉 PicoClaw mencapai 20K Stars hanya dalam 17 hari! Orkestrasi saluran automatik dan antara muka keupayaan kini aktif.

2026-02-16 🎉 PicoClaw melepasi 12K Stars dalam seminggu! Peranan penyelenggara komuniti dan Peta Jalan dilancarkan secara rasmi.

2026-02-13 🎉 PicoClaw melepasi 5000 Stars dalam 4 hari! Peta jalan projek dan kumpulan pembangun sedang dalam proses.

2026-02-09 🎉 PicoClaw Dikeluarkan! Dibina dalam 1 hari untuk membawa AI Agent ke perkakasan $10 dengan RAM <10MB. Jom, PicoClaw!

✨ Ciri-ciri

🪶 Ultra-ringan: Jejak memori teras <10MB — 99% lebih kecil daripada OpenClaw.*

💰 Kos minimum: Cukup cekap untuk berjalan pada perkakasan $10 — 98% lebih murah daripada Mac mini.

⚡️ Boot kilat: 400x lebih pantas. Boot dalam <1s walaupun pada pemproses teras tunggal 0.6GHz.

🌍 Benar-benar mudah alih: Binari tunggal merentasi seni bina RISC-V, ARM, MIPS, dan x86.

🤖 Dibantu AI: Pelaksanaan Go tulen — 95% kod teras dijana oleh Agent dan diperhalusi melalui semakan manusia.

🔌 Sokongan MCP: Integrasi Model Context Protocol natif.

👁️ Saluran paip visi: Hantar imej dan fail terus ke Agent — pengekodan base64 automatik untuk LLM multimodal.

🧠 Penghalaan pintar: Penghalaan model berasaskan peraturan — pertanyaan mudah ke model ringan, menjimatkan kos API.

*Binaan terkini mungkin menggunakan 10-20MB disebabkan penggabungan PR yang pesat. Pengoptimuman sumber dirancang. Perbandingan kelajuan boot berdasarkan penanda aras teras tunggal 0.8GHz (lihat jadual di bawah).

	OpenClaw	NanoBot	PicoClaw
Bahasa	TypeScript	Python	Go
RAM	>1GB	>100MB	< 10MB*
Masa Boot (teras 0.8GHz)	>500s	>30s	<1s
Kos	Mac Mini $599	Kebanyakan papan Linux ~$50	Mana-mana papan Linux dari $10

Senarai Keserasian Perkakasan — Lihat semua papan yang diuji, dari RISC-V $5 hingga Raspberry Pi hingga telefon Android.

🦾 Demonstrasi

🛠️ Aliran Kerja Pembantu Standard

Mod Jurutera Full-Stack	Pengelogan & Perancangan	Carian Web & Pembelajaran
Bangun · Deploy · Skala	Jadual · Automatik · Ingat	Temui · Wawasan · Trend

🐜 Deployment Jejak Rendah yang Inovatif

PicoClaw boleh digunakan pada hampir mana-mana peranti Linux!

• $9.9 LicheeRV-Nano untuk pembantu rumah minimal
• $30~50 NanoKVM untuk operasi pelayan automatik
• $50 MaixCAM untuk pengawasan pintar

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

🌟 Lebih Banyak Kes Deployment Menanti!

📦 Pemasangan

Muat turun dari picoclaw.io (Disyorkan)

Lawati picoclaw.io — laman web rasmi mengesan platform anda secara automatik dan menyediakan muat turun satu klik.

Muat turun binari pra-kompil

Muat turun binari untuk platform anda dari halaman GitHub Releases.

Bina dari sumber (untuk pembangunan)

Prasyarat:

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

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

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

# Bina binari teras
make build

# Bina Pelancar Web UI (diperlukan untuk mod WebUI)
make build-launcher

# Bina binari teras untuk semua platform yang diuruskan oleh Makefile
make build-all

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

# Bina dan pasang
make install

Raspberry Pi Zero 2 W: Gunakan binari yang sepadan 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 membina kedua-duanya.

🚀 Panduan Permulaan Pantas

🌐 Pelancar WebUI (Disyorkan untuk Desktop)

Pelancar WebUI menyediakan antara muka berasaskan pelayar untuk konfigurasi dan sembang. Ini adalah cara termudah untuk bermula — tiada pengetahuan baris arahan diperlukan.

Pilihan 1: Klik dua kali (Desktop)

Selepas memuat turun dari picoclaw.io, klik dua kali picoclaw-launcher (atau picoclaw-launcher.exe pada Windows). Pelayar anda akan dibuka secara automatik di http://localhost:18800.

Pilihan 2: Baris arahan

picoclaw-launcher
# Buka http://localhost:18800 dalam pelayar anda

Tip

Akses jauh / Docker / VM: Tambah bendera -public untuk mendengar pada semua antara muka:

picoclaw-launcher -public

Memulakan: Buka WebUI, kemudian: 1) Konfigurasikan Penyedia (tambah kunci API LLM) -> 2) Konfigurasikan Saluran (cth. Telegram) -> 3) Mulakan Gateway -> 4) Sembang!

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

Docker (alternatif)

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

# 2. Jalankan pertama kali — jana docker/data/config.json secara automatik kemudian keluar
docker compose -f docker/docker-compose.yml --profile launcher up

# 3. Tetapkan kunci API anda
vim docker/data/config.json

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

Pengguna Docker / VM: Gateway mendengar pada 127.0.0.1 secara lalai. Tetapkan PICOCLAW_GATEWAY_HOST=0.0.0.0 atau gunakan bendera -public untuk membolehkan akses dari hos.

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

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

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

macOS — Amaran Keselamatan Pelancaran Pertama

macOS mungkin menyekat picoclaw-launcher pada pelancaran pertama kerana ia dimuat turun dari internet dan tidak disahkan melalui Mac App Store.

Langkah 1: Klik dua kali picoclaw-launcher. Anda akan melihat amaran keselamatan:

"picoclaw-launcher" Tidak Dibuka — Apple tidak dapat mengesahkan "picoclaw-launcher" bebas daripada perisian hasad yang mungkin membahayakan Mac anda atau menjejaskan privasi anda.

Langkah 2: Buka Tetapan Sistem → Privasi & Keselamatan → tatal ke bawah ke bahagian Keselamatan → klik Buka Juga → sahkan dengan mengklik Buka Juga dalam dialog.

Selepas langkah sekali ini, picoclaw-launcher akan dibuka secara normal pada pelancaran seterusnya.

📱 Android

Berikan telefon lama anda kehidupan baru! Jadikannya Pembantu AI pintar dengan PicoClaw.

Pilihan 1: Pasang APK

Pratonton:

Muat turun APK dari picoclaw.io dan pasang secara langsung. Tiada Termux diperlukan!

Pilihan 2: Termux

Pelancar Terminal (untuk persekitaran terhad sumber)

1. Pasang Termux (muat turun dari GitHub Releases, atau cari di F-Droid / Google Play)
2. Jalankan arahan berikut:

# Muat turun keluaran terkini
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 susun atur sistem fail Linux standard

Kemudian ikuti bahagian Pelancar Terminal di bawah untuk melengkapkan konfigurasi.

Untuk persekitaran minimal di mana hanya binari teras picoclaw tersedia (tiada UI Pelancar), anda boleh mengkonfigurasi semua melalui baris arahan dan fail konfigurasi JSON.

1. Mulakan

picoclaw onboard

Ini mencipta ~/.picoclaw/config.json dan direktori ruang kerja.

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

{
  "agents": {
    "defaults": {
      "model_name": "gpt-5.4"
    }
  },
  "model_list": [
    {
      "model_name": "gpt-5.4",
      "model": "openai/gpt-5.4"
    }
  ]
}

Lihat config/config.example.json dalam repo untuk templat konfigurasi lengkap. Nota: kunci API kini disimpan dalam .security.yml, bukan config.json.

3. Sembang

picoclaw agent -m "Apa itu 2+2?"

# Mod interaktif
picoclaw agent

# Mulakan gateway untuk integrasi aplikasi sembang
picoclaw gateway

🔌 Penyedia (LLM)

PicoClaw menyokong 30+ penyedia LLM melalui konfigurasi model_list. Gunakan format protokol/model:

Penyedia	Protokol	Kunci API	Nota
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 bersatu
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	Inferens pantas (Llama, Mixtral)
Moonshot (Kimi)	moonshot/	Diperlukan	Model Kimi
Minimax	minimax/	Diperlukan	Model MiniMax
Mistral	mistral/	Diperlukan	Mistral Large, Codestral
NVIDIA NIM	nvidia/	Diperlukan	Model hos NVIDIA
Cerebras	cerebras/	Diperlukan	Inferens pantas
Novita AI	novita/	Diperlukan	Pelbagai model terbuka
Xiaomi MiMo	mimo/	Diperlukan	Model MiMo
Ollama	ollama/	Tidak perlu	Model tempatan, self-hosted
vLLM	vllm/	Tidak perlu	Deployment tempatan, serasi OpenAI
LiteLLM	litellm/	Berbeza	Proksi untuk 100+ penyedia
Azure OpenAI	azure/	Diperlukan	Deployment Azure perusahaan
GitHub Copilot	github-copilot/	OAuth	Log masuk kod peranti
Antigravity	antigravity/	OAuth	Google Cloud AI
AWS Bedrock*	bedrock/	Kelayakan AWS	Claude, Llama, Mistral pada AWS

* AWS Bedrock memerlukan tag binaan: go build -tags bedrock. Tetapkan api_base kepada nama rantau (cth. us-east-1) untuk resolusi endpoint automatik merentasi semua partition AWS. Apabila menggunakan URL endpoint penuh, anda juga perlu mengkonfigurasi AWS_REGION melalui pemboleh ubah persekitaran.

Deployment tempatan (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 butiran konfigurasi penyedia penuh, lihat Penyedia & Model.

💬 Saluran (Aplikasi Sembang)

Bercakap dengan PicoClaw anda melalui 17+ platform pemesejan:

Saluran	Persediaan	Protokol	Dok
Telegram	Mudah (token bot)	Long polling	Panduan
Discord	Mudah (token bot + intents)	WebSocket	Panduan
WhatsApp	Mudah (imbas QR atau URL jambatan)	Natif / Jambatan	Panduan
Weixin	Mudah (imbas QR natif)	iLink API	Panduan
QQ	Mudah (AppID + AppSecret)	WebSocket	Panduan
Slack	Mudah (token bot + app)	Socket Mode	Panduan
Matrix	Sederhana (homeserver + token)	Sync API	Panduan
DingTalk	Sederhana (kelayakan klien)	Stream	Panduan
Feishu / Lark	Sederhana (App ID + Secret)	WebSocket/SDK	Panduan
LINE	Sederhana (kelayakan + webhook)	Webhook	Panduan
WeCom	Mudah (log masuk QR atau manual)	WebSocket	Panduan
IRC	Sederhana (pelayan + nick)	Protokol IRC	Panduan
OneBot	Sederhana (URL WebSocket)	OneBot v11	Panduan
MaixCam	Mudah (aktifkan)	TCP socket	Panduan
Pico	Mudah (aktifkan)	Protokol natif	Terbina dalam
Pico Client	Mudah (URL WebSocket)	WebSocket	Terbina dalam

Semua saluran berasaskan webhook berkongsi satu pelayan HTTP Gateway (gateway.host:gateway.port, lalai 127.0.0.1:18790). Feishu menggunakan mod WebSocket/SDK dan tidak menggunakan pelayan HTTP yang dikongsi.

Tahap perincian log dikawal oleh gateway.log_level (lalai: warn). Nilai yang disokong: debug, info, warn, error, fatal. Boleh juga ditetapkan melalui PICOCLAW_LOG_LEVEL. Lihat Konfigurasi untuk butiran.

Untuk arahan persediaan saluran terperinci, lihat Konfigurasi Aplikasi Sembang.

🔧 Alat

🔍 Carian Web

PicoClaw boleh mencari web untuk menyediakan maklumat terkini. Konfigurasikan dalam tools.web:

Enjin Carian	Kunci API	Peringkat Percuma	Pautan
DuckDuckGo	Tidak perlu	Tanpa had	Sandaran terbina dalam
Baidu Search	Diperlukan	1000 pertanyaan/hari	Dikuasai AI, dioptimumkan untuk China
Tavily	Diperlukan	1000 pertanyaan/bulan	Dioptimumkan untuk AI Agent
Brave Search	Diperlukan	2000 pertanyaan/bulan	Pantas dan peribadi
Perplexity	Diperlukan	Berbayar	Carian dikuasai AI
SearXNG	Tidak perlu	Self-hosted	Enjin metasearch percuma
GLM Search	Diperlukan	Berbeza	Carian web Zhipu

⚙️ Alat Lain

PicoClaw menyertakan alat terbina dalam untuk operasi fail, pelaksanaan kod, penjadualan, dan banyak lagi. Lihat Konfigurasi Alat untuk butiran.

🎯 Kemahiran

Kemahiran adalah keupayaan modular yang melanjutkan Agent anda. Ia dimuatkan dari fail SKILL.md dalam ruang kerja anda.

Pasang kemahiran dari ClawHub:

picoclaw skills search "web scraping"
picoclaw skills install <nama-kemahiran>

Konfigurasikan token ClawHub (pilihan, untuk had kadar lebih tinggi):

Tambah ke config.json anda:

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

Untuk butiran lanjut, lihat Konfigurasi Alat - Kemahiran.

🔗 MCP (Protokol Konteks Model)

PicoClaw menyokong MCP secara natif — sambungkan mana-mana pelayan MCP untuk melanjutkan keupayaan Agent anda dengan alat dan sumber data luaran.

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

Untuk konfigurasi MCP penuh (pengangkutan stdio, SSE, HTTP, Penemuan Alat), lihat Konfigurasi Alat - MCP.

Sertai Rangkaian Sosial Agent

Sambungkan PicoClaw ke Rangkaian Sosial Agent dengan menghantar satu mesej melalui CLI atau mana-mana Aplikasi Sembang yang disepadukan.

Baca https://clawdchat.ai/skill.md dan ikuti arahan untuk menyertai ClawdChat.ai

🖥️ Rujukan CLI

Arahan	Penerangan
picoclaw onboard	Mulakan konfigurasi & ruang kerja
picoclaw auth weixin	Sambungkan akaun WeChat melalui QR
picoclaw agent -m "..."	Sembang dengan agent
picoclaw agent	Mod sembang interaktif
picoclaw gateway	Mulakan gateway
picoclaw status	Tunjukkan status
picoclaw version	Tunjukkan maklumat versi
picoclaw model	Lihat atau tukar model lalai
picoclaw cron list	Senaraikan semua kerja berjadual
picoclaw cron add ...	Tambah kerja berjadual
picoclaw cron disable	Lumpuhkan kerja berjadual
picoclaw cron remove	Buang kerja berjadual
picoclaw skills list	Senaraikan kemahiran yang dipasang
picoclaw skills install	Pasang kemahiran
picoclaw migrate	Migrasi data dari versi lama
picoclaw auth login	Sahkan dengan penyedia

⏰ Tugasan Berjadual / Peringatan

PicoClaw menyokong peringatan berjadual dan tugasan berulang melalui alat cron:

• Peringatan sekali: "Ingatkan saya dalam 10 minit" -> pencetus sekali selepas 10 minit
• Tugasan berulang: "Ingatkan saya setiap 2 jam" -> pencetus setiap 2 jam
• Ungkapan Cron: "Ingatkan saya pada pukul 9 pagi setiap hari" -> menggunakan ungkapan cron

📚 Dokumentasi

Untuk panduan terperinci melebihi README ini:

Topik	Penerangan
Docker & Permulaan Pantas	Persediaan Docker Compose, mod Launcher/Agent
Aplikasi Sembang	Panduan persediaan 17+ saluran
Konfigurasi	Pemboleh ubah persekitaran, susun atur ruang kerja
Penyedia & Model	30+ penyedia LLM, penghalaan model
Spawn & Tugasan Async	Tugasan pantas, tugasan panjang dengan spawn
Penyelesaian Masalah	Isu biasa dan penyelesaian
Konfigurasi Alat	Aktif/nyahaktif alat, dasar exec, MCP, Kemahiran
Keserasian Perkakasan	Papan yang diuji, keperluan minimum

🤝 Sumbangan & Peta Jalan

PR dialu-alukan! Kod sumber sengaja dibuat kecil dan mudah dibaca.

Lihat Peta Jalan Komuniti dan CONTRIBUTING.md untuk panduan.

Kumpulan pembangun sedang dibina, sertai selepas PR pertama anda digabungkan!

Kumpulan Pengguna:

Discord: https://discord.gg/V4sAZ9XWpN

WeChat: