README.Vi

<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 là một dự án mã nguồn mở độc lập do Sipeed khởi xướng, được viết hoàn toàn bằng Go từ đầu — không phải fork của OpenClaw, NanoBot hay bất kỳ dự án nào khác.

PicoClaw là trợ lý AI cá nhân siêu nhẹ lấy cảm hứng từ NanoBot. Nó được xây dựng lại từ đầu bằng Go thông qua quá trình "tự khởi động" — chính AI Agent đã dẫn dắt quá trình di chuyển kiến trúc và tối ưu hóa mã nguồn.

Chạy trên phần cứng $10 với <10MB RAM — ít hơn 99% bộ nhớ so với OpenClaw và rẻ hơn 98% so với Mac mini!

[!CAUTION] Thông báo Bảo mật

• KHÔNG CÓ CRYPTO: PicoClaw chưa phát hành bất kỳ token hay tiền điện tử chính thức nào. Mọi thông tin trên pump.fun hoặc các nền tảng giao dịch khác đều là lừa đảo.
• DOMAIN CHÍNH THỨC: Website chính thức DUY NHẤT là picoclaw.io, và website công ty là sipeed.com
• CẢNH BÁO: Nhiều domain .ai/.org/.com/.net/... đã bị bên thứ ba đăng ký. Đừng tin tưởng chúng.
• LƯU Ý: PicoClaw đang trong giai đoạn phát triển nhanh. Có thể còn các vấn đề bảo mật chưa được giải quyết. Không triển khai lên môi trường production trước v1.0.
• LƯU Ý: PicoClaw gần đây đã merge nhiều PR. Các bản build gần đây có thể dùng 10-20MB RAM. Tối ưu hóa tài nguyên được lên kế hoạch sau khi tính năng ổn định.

📢 Tin tức

2026-03-31 📱 Hỗ trợ Android! PicoClaw giờ chạy trên Android! Tải APK tại picoclaw.io

2026-03-25 🚀 v0.2.4 đã phát hành! Tái cấu trúc kiến trúc Agent (SubTurn, Hooks, Steering, EventBus), tích hợp WeChat/WeCom, tăng cường bảo mật (.security.yml, lọc dữ liệu nhạy cảm), provider mới (AWS Bedrock, Azure, Xiaomi MiMo) và 35 bản vá lỗi. PicoClaw đã đạt 26K Stars!

2026-03-17 🚀 v0.2.3 đã phát hành! Giao diện system tray (Windows & Linux), truy vấn trạng thái sub-agent (spawn_status), thử nghiệm Gateway hot-reload, bảo mật Cron, và 2 bản vá bảo mật. PicoClaw đã đạt 25K Stars!

2026-03-09 🎉 v0.2.1 — Bản cập nhật lớn nhất từ trước đến nay! Hỗ trợ giao thức MCP, 4 Channel mới (Matrix/IRC/WeCom/Discord Proxy), 3 Provider mới (Kimi/Minimax/Avian), pipeline thị giác, bộ nhớ JSONL, định tuyến mô hình.

2026-02-28 📦 v0.2.0 phát hành với hỗ trợ Docker Compose và Web UI Launcher.

2026-02-26 🎉 PicoClaw đạt 20K Stars chỉ trong 17 ngày! Tự động điều phối Channel và giao diện khả năng đã hoạt động.

2026-02-16 🎉 PicoClaw vượt 12K Stars trong một tuần! Vai trò người duy trì cộng đồng và Lộ trình chính thức ra mắt.

2026-02-13 🎉 PicoClaw vượt 5000 Stars trong 4 ngày! Lộ trình dự án và nhóm nhà phát triển đang được xây dựng.

2026-02-09 🎉 PicoClaw ra mắt! Được xây dựng trong 1 ngày để đưa AI Agent lên phần cứng $10 với <10MB RAM. Let's Go, PicoClaw!

✨ Tính năng

🪶 Siêu nhẹ: Bộ nhớ lõi <10MB — nhỏ hơn 99% so với OpenClaw.*

💰 Chi phí tối thiểu: Đủ hiệu quả để chạy trên phần cứng $10 — rẻ hơn 98% so với Mac mini.

⚡️ Khởi động cực nhanh: Khởi động nhanh hơn 400 lần. Khởi động trong <1 giây ngay cả trên bộ xử lý đơn nhân 0.6GHz.

🌍 Thực sự di động: Một binary duy nhất cho các kiến trúc RISC-V, ARM, MIPS và x86. Một binary, chạy mọi nơi!

🤖 Được AI khởi động: Triển khai Go thuần túy — 95% mã lõi được tạo bởi Agent và tinh chỉnh qua quy trình human-in-the-loop.

🔌 Hỗ trợ MCP: Tích hợp Model Context Protocol gốc — kết nối bất kỳ MCP server nào để mở rộng khả năng Agent.

👁️ Pipeline thị giác: Gửi hình ảnh và tệp trực tiếp đến Agent — tự động mã hóa base64 cho LLM đa phương thức.

🧠 Định tuyến thông minh: Định tuyến mô hình dựa trên quy tắc — các truy vấn đơn giản đến mô hình nhẹ, tiết kiệm chi phí API.

*Các bản build gần đây có thể dùng 10-20MB do merge PR nhanh. Tối ưu hóa tài nguyên đang được lên kế hoạch. So sánh tốc độ khởi động dựa trên benchmark lõi đơn 0.8GHz (xem bảng bên dưới).

Danh sách Tương thích Phần cứng — Xem tất cả các board đã được kiểm tra, từ RISC-V $5 đến Raspberry Pi đến điện thoại Android. Board của bạn chưa có trong danh sách? Gửi PR!

🦾 Minh họa

🛠️ Quy trình Trợ lý Tiêu chuẩn

🐜 Triển khai Sáng tạo với Dấu chân Nhỏ

PicoClaw có thể được triển khai trên hầu hết mọi thiết bị Linux!

• $9.9 LicheeRV-Nano phiên bản E(Ethernet) hoặc W(WiFi6), cho trợ lý gia đình tối giản
• $30~50 NanoKVM, hoặc $100 NanoKVM-Pro, cho vận hành máy chủ tự động
• $50 MaixCAM hoặc $100 MaixCAM2, cho giám sát thông minh

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

🌟 Còn nhiều trường hợp triển khai đang chờ đón!

📦 Cài đặt

Tải xuống từ picoclaw.io (Khuyến nghị)

Truy cập picoclaw.io — website chính thức tự động phát hiện nền tảng của bạn và cung cấp tải xuống một cú nhấp. Không cần chọn kiến trúc thủ công.

Tải xuống binary đã biên dịch sẵn

Ngoài ra, tải binary cho nền tảng của bạn từ trang GitHub Releases.

Xây dựng từ mã nguồn (để phát triển)

Yêu cầu:

• Go 1.25+
• Node.js 22+ và pnpm 10.33.0+ cho các bản build Web UI / launcher

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

cd picoclaw
make deps

# Cài đặt dependencies frontend
(cd web/frontend && pnpm install --frozen-lockfile)

# Build binary lõi
make build

# Build Web UI Launcher (cần cho chế độ WebUI)
make build-launcher

# Build các binary lõi cho mọi nền tảng do Makefile quản lý
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: Sử dụng binary phù hợp với hệ điều hành của bạn: Raspberry Pi OS 32-bit -> make build-linux-arm; 64-bit -> make build-linux-arm64. Hoặc chạy make build-pi-zero để xây dựng cả hai.

🚀 Hướng dẫn Khởi động Nhanh

🌐 WebUI Launcher (Khuyến nghị cho Desktop)

WebUI Launcher cung cấp giao diện dựa trên trình duyệt để cấu hình và trò chuyện. Đây là cách dễ nhất để bắt đầu — không cần kiến thức dòng lệnh.

Tùy chọn 1: Nhấp đúp (Desktop)

Sau khi tải xuống từ picoclaw.io, nhấp đúp vào picoclaw-launcher (hoặc picoclaw-launcher.exe trên Windows). Trình duyệt của bạn sẽ tự động mở tại http://localhost:18800.

Tùy chọn 2: Dòng lệnh

picoclaw-launcher
# Mở http://localhost:18800 trong trình duyệt của bạn

[!TIP] Truy cập từ xa / Docker / VM: Thêm cờ -public để lắng nghe trên tất cả giao diện:

bashCopy

picoclaw-launcher -public

Bắt đầu:

Mở WebUI, sau đó: 1) Cấu hình Provider (thêm API key LLM của bạn) -> 2) Cấu hình Channel (ví dụ: Telegram) -> 3) Khởi động Gateway -> 4) Trò chuyện!

Để biết tài liệu WebUI chi tiết, xem docs.picoclaw.io.

# 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

Người dùng Docker / VM: Gateway lắng nghe trên 127.0.0.1 theo mặc định. Đặt PICOCLAW_GATEWAY_HOST=0.0.0.0 hoặc dùng cờ -public để có thể truy cập từ 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 có thể chặn picoclaw-launcher khi khởi chạy lần đầu vì nó được tải từ internet và chưa được công chứng qua Mac App Store.

Bước 1: Nhấp đúp vào picoclaw-launcher. Bạn sẽ thấy cảnh báo bảo mật:

"picoclaw-launcher" Không Mở Được — Apple không thể xác minh "picoclaw-launcher" không chứa phần mềm độc hại có thể gây hại cho Mac hoặc xâm phạm quyền riêng tư của bạn.

Bước 2: Mở Cài đặt Hệ thống → Quyền riêng tư & Bảo mật → cuộn xuống phần Bảo mật → nhấp Vẫn Mở → xác nhận bằng cách nhấp Vẫn Mở trong hộp thoại.

Sau bước này, picoclaw-launcher sẽ mở bình thường trong các lần khởi chạy tiếp theo.

<a id="-run-on-old-android-phones"></a>

📱 Android

Hãy cho chiếc điện thoại cũ của bạn một cuộc sống mới! Biến nó thành Trợ lý AI thông minh với PicoClaw.

Tùy chọn 1: Cài đặt APK

Xem trước:

Tải APK từ picoclaw.io và cài đặt trực tiếp. Không cần Termux!

Tùy chọn 2: Termux

1. Cài đặt Termux (tải từ GitHub Releases, hoặc tìm kiếm trong F-Droid / Google Play)
2. Chạy các lệnh sau:

# Download the latest release
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 provides a standard Linux filesystem layout

Sau đó làm theo phần Terminal Launcher bên dưới để hoàn tất cấu hình.

Đối với các môi trường tối giản chỉ có binary lõi picoclaw (không có Launcher UI), bạn có thể cấu hình mọi thứ qua dòng lệnh và tệp cấu hình JSON.

1. Khởi tạo

picoclaw onboard

Lệnh này tạo ~/.picoclaw/config.json và thư mục workspace.

2. Cấu hình (~/.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"
    }
  ]
}

Xem config/config.example.json trong repo để có mẫu cấu hình đầy đủ với tất cả các tùy chọn có sẵn.

3. Trò chuyện

# One-shot question
picoclaw agent -m "What is 2+2?"

# Interactive mode
picoclaw agent

# Start gateway for chat app integration
picoclaw gateway

🔌 Providers (LLM)

PicoClaw hỗ trợ 30+ Provider LLM thông qua cấu hình model_list. Sử dụng định dạng 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"
    }
  ]
}

Để biết chi tiết cấu hình provider đầy đủ, xem Providers & Models.

💬 Channels (Ứng dụng Chat)

Trò chuyện với PicoClaw của bạn qua 17+ nền tảng nhắn tin:

Tất cả các Channel dựa trên webhook dùng chung một Gateway HTTP server (gateway.host:gateway.port, mặc định 127.0.0.1:18790). Feishu sử dụng chế độ WebSocket/SDK và không dùng HTTP server chung.

Mức độ chi tiết log được kiểm soát bởi gateway.log_level (mặc định: warn). Các giá trị được hỗ trợ: debug, info, warn, error, fatal. Cũng có thể đặt qua PICOCLAW_LOG_LEVEL. Xem Cấu hình để biết thêm chi tiết.

Để biết hướng dẫn thiết lập Channel chi tiết, xem Cấu hình Ứng dụng Chat.

🔧 Tools

🔍 Tìm kiếm Web

PicoClaw có thể tìm kiếm web để cung cấp thông tin cập nhật. Cấu hình trong tools.web:

⚙️ Các Tools Khác

PicoClaw bao gồm các tool tích hợp sẵn cho thao tác tệp, thực thi mã, lên lịch và nhiều hơn nữa. Xem Cấu hình Tools để biết chi tiết.

🎯 Skills

Skills là các khả năng mô-đun mở rộng Agent của bạn. Chúng được tải từ các tệp SKILL.md trong workspace của bạn.

Cài đặt Skills từ ClawHub:

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

Cấu hình token ClawHub (tùy chọn, để có giới hạn tốc độ cao hơn):

Thêm vào config.json của bạn:

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

Để biết thêm chi tiết, xem Cấu hình Tools - Skills.

🔗 MCP (Model Context Protocol)

PicoClaw hỗ trợ MCP gốc — kết nối bất kỳ MCP server nào để mở rộng khả năng Agent của bạn với các tool và nguồn dữ liệu bên ngoài.

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

Để biết cấu hình MCP đầy đủ (stdio, SSE, HTTP transports, Tool Discovery), xem Cấu hình Tools - MCP.

Tham gia Mạng xã hội Agent

Kết nối PicoClaw với Mạng xã hội Agent chỉ bằng cách gửi một tin nhắn duy nhất qua CLI hoặc bất kỳ Ứng dụng Chat nào đã tích hợp.

Đọc https://clawdchat.ai/skill.md và làm theo hướng dẫn để tham gia ClawdChat.ai

🖥️ Tham chiếu CLI

⏰ Tác vụ Đã lên lịch / Nhắc nhở

PicoClaw hỗ trợ nhắc nhở đã lên lịch và tác vụ định kỳ thông qua tool cron:

• Nhắc nhở một lần: "Nhắc tôi sau 10 phút" -> kích hoạt một lần sau 10 phút
• Tác vụ định kỳ: "Nhắc tôi mỗi 2 giờ" -> kích hoạt mỗi 2 giờ
• Biểu thức Cron: "Nhắc tôi lúc 9 giờ sáng hàng ngày" -> sử dụng biểu thức cron

📚 Tài liệu

Để biết các hướng dẫn chi tiết ngoài README này:

🤝 Đóng góp & Lộ trình

PR luôn được chào đón! Codebase được thiết kế nhỏ gọn và dễ đọc.

Xem Lộ trình Cộng đồng và CONTRIBUTING.md để biết hướng dẫn.

Nhóm nhà phát triển đang được xây dựng, tham gia sau khi PR đầu tiên của bạn được merge!

Nhóm Người dùng:

Discord: https://discord.gg/V4sAZ9XWpN

WeChat: