README.Ms

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

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

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

🦾 Demonstrasi

🛠️ Aliran Kerja Pembantu Standard

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

bashCopy

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.

# 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 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

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:

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

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:

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:

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

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

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