picoclaw/docs/project/README.vi.md

PicoClaw: Trợ lý AI Siêu Nhẹ viết bằng Go

Phần cứng $10 · RAM 10MB · Khởi động ms · Let's Go, PicoClaw!

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

Tin tức trước đó...

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

	OpenClaw	NanoBot	PicoClaw
Ngôn ngữ	TypeScript	Python	Go
RAM	>1GB	>100MB	< 10MB*
Thời gian khởi động (lõi 0.8GHz)	>500s	>30s	<1s
Chi phí	Mac Mini $599	Hầu hết board Linux ~$50	Bất kỳ board Linux từ $10

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

Chế độ Kỹ sư Full-Stack	Ghi nhật ký & Lập kế hoạch	Tìm kiếm Web & Học tập
Phát triển · Triển khai · Mở rộng	Lên lịch · Tự động hóa · Ghi nhớ	Khám phá · Thông tin · Xu hướng

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

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.

Docker (thay thế)

# 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ảnh báo bảo mật khi khởi chạy lần đầu

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.

📱 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

Terminal Launcher (cho môi trường hạn chế tài nguyên)

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:

Provider	Protocol	API Key	Ghi chú
OpenAI	openai/	Bắt buộc	GPT-5.4, GPT-4o, o3, v.v.
Anthropic	anthropic/	Bắt buộc	Claude Opus 4.6, Sonnet 4.6, v.v.
Google Gemini	gemini/	Bắt buộc	Gemini 3 Flash, 2.5 Pro, v.v.
OpenRouter	openrouter/	Bắt buộc	200+ mô hình, API thống nhất
Zhipu (GLM)	zhipu/	Bắt buộc	GLM-4.7, GLM-5, v.v.
DeepSeek	deepseek/	Bắt buộc	DeepSeek-V3, DeepSeek-R1
Volcengine	volcengine/	Bắt buộc	Doubao, Ark models
Qwen	qwen/	Bắt buộc	Qwen3, Qwen-Max, v.v.
Groq	groq/	Bắt buộc	Suy luận nhanh (Llama, Mixtral)
Moonshot (Kimi)	moonshot/	Bắt buộc	Kimi models
Minimax	minimax/	Bắt buộc	MiniMax models
Mistral	mistral/	Bắt buộc	Mistral Large, Codestral
NVIDIA NIM	nvidia/	Bắt buộc	Mô hình do NVIDIA lưu trữ
Cerebras	cerebras/	Bắt buộc	Suy luận nhanh
Novita AI	novita/	Bắt buộc	Nhiều mô hình mở
Xiaomi MiMo	mimo/	Bắt buộc	Mô hình MiMo
Ollama	ollama/	Không cần	Mô hình cục bộ, tự lưu trữ
vLLM	vllm/	Không cần	Triển khai cục bộ, tương thích OpenAI
LiteLLM	litellm/	Tùy	Proxy cho 100+ provider
Azure OpenAI	azure/	Bắt buộc	Triển khai Azure doanh nghiệp
GitHub Copilot	github-copilot/	OAuth	Đăng nhập bằng device code
Antigravity	antigravity/	OAuth	Google Cloud AI

Triển khai cục bộ (Ollama, vLLM, v.v.)

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:

Channel	Thiết lập	Protocol	Tài liệu
Telegram	Dễ (bot token)	Long polling	Hướng dẫn
Discord	Dễ (bot token + intents)	WebSocket	Hướng dẫn
WhatsApp	Dễ (quét QR hoặc bridge URL)	Native / Bridge	Hướng dẫn
Weixin	Dễ (quét QR gốc)	iLink API	Hướng dẫn
QQ	Dễ (AppID + AppSecret)	WebSocket	Hướng dẫn
Slack	Dễ (bot + app token)	Socket Mode	Hướng dẫn
Matrix	Trung bình (homeserver + token)	Sync API	Hướng dẫn
DingTalk	Trung bình (client credentials)	Stream	Hướng dẫn
Feishu / Lark	Trung bình (App ID + Secret)	WebSocket/SDK	Hướng dẫn
LINE	Trung bình (credentials + webhook)	Webhook	Hướng dẫn
WeCom	Dễ (đăng nhập QR hoặc thủ công)	WebSocket	Hướng dẫn
IRC	Trung bình (server + nick)	IRC protocol	Hướng dẫn
OneBot	Trung bình (WebSocket URL)	OneBot v11	Hướng dẫn
MaixCam	Dễ (bật)	TCP socket	Hướng dẫn
Pico	Dễ (bật)	Native protocol	Tích hợp sẵn
Pico Client	Dễ (WebSocket URL)	WebSocket	Tích hợp sẵn

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ông cụ Tìm kiếm	API Key	Gói miễn phí	Liên kết
DuckDuckGo	Không cần	Không giới hạn	Dự phòng tích hợp sẵn
Baidu Search	Bắt buộc	1000 truy vấn/ngày	AI, tối ưu cho tiếng Trung
Tavily	Bắt buộc	1000 truy vấn/tháng	Tối ưu cho AI Agent
Brave Search	Bắt buộc	2000 truy vấn/tháng	Nhanh và riêng tư
Perplexity	Bắt buộc	Trả phí	Tìm kiếm hỗ trợ AI
SearXNG	Không cần	Tự lưu trữ	Metasearch engine miễn phí
GLM Search	Bắt buộc	Tùy	Tìm kiếm web Zhipu

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

Lệnh	Mô tả
picoclaw onboard	Khởi tạo cấu hình & workspace
picoclaw auth weixin	Kết nối tài khoản WeChat qua QR
picoclaw agent -m "..."	Trò chuyện với agent
picoclaw agent	Chế độ trò chuyện tương tác
picoclaw gateway	Khởi động gateway
picoclaw status	Hiển thị trạng thái
picoclaw version	Hiển thị thông tin phiên bản
picoclaw model	Xem hoặc chuyển đổi mô hình mặc định
picoclaw cron list	Liệt kê tất cả công việc đã lên lịch
picoclaw cron add ...	Thêm công việc đã lên lịch
picoclaw cron disable	Vô hiệu hóa công việc đã lên lịch
picoclaw cron remove	Xóa công việc đã lên lịch
picoclaw skills list	Liệt kê các Skill đã cài đặt
picoclaw skills install	Cài đặt một Skill
picoclaw migrate	Di chuyển dữ liệu từ các phiên bản cũ
picoclaw auth login	Xác thực với các provider

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

Chủ đề	Mô tả
Docker & Khởi động Nhanh	Thiết lập Docker Compose, chế độ Launcher/Agent
Ứng dụng Chat	Hướng dẫn thiết lập 17+ Channel
Cấu hình	Biến môi trường, bố cục workspace, sandbox bảo mật
Providers & Models	30+ Provider LLM, định tuyến mô hình, cấu hình model_list
Spawn & Tác vụ Bất đồng bộ	Tác vụ nhanh, tác vụ dài với spawn, điều phối sub-agent bất đồng bộ
Hooks	Hệ thống hook hướng sự kiện: observer, interceptor, approval hook
Steering	Chèn tin nhắn vào vòng lặp agent đang chạy
SubTurn	Điều phối subagent, kiểm soát đồng thời, vòng đời
Khắc phục sự cố	Các vấn đề thường gặp và giải pháp
Cấu hình Tools	Bật/tắt từng tool, chính sách exec, MCP, Skills
Tương thích Phần cứng	Các board đã kiểm tra, yêu cầu tối thiểu

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