Yêu cầu hệ thống
PicoClaw có yêu cầu phần cứng cực kỳ thấp:
- Hệ điều hành: Linux / macOS / Windows (WSL2)
- Hỗ trợ kiến trúc: x86_64 / ARM64 / RISC-V
- Bộ nhớ tối thiểu: 64MB (khuyến nghị từ 512MB trở lên)
- Phụ thuộc: LLM API Key (không thể sử dụng tính năng trò chuyện AI nếu không cấu hình)
Các nền tảng hỗ trợ: macOS, Linux, Windows (WSL2), Raspberry Pi, Docker
Bước 1: Sao chép kho lưu trữ (Clone repository)
Mở terminal và thực thi lệnh sau:
git clone https://github.com/sipeed/picoclaw.gitSau khi sao chép xong, truy cập vào thư mục dự án:
cd picoclawBước 2: Khởi tạo cấu hình
Chạy lệnh onboard để tiến hành khởi tạo:
picoclaw onboardHoàn tất cấu hình theo hướng dẫn:
- LLM API Key: Nhập API Key từ nhà cung cấp dịch vụ LLM của bạn
- Tùy chọn mô hình: Chọn mô hình AI mặc định muốn sử dụng
- Token nền tảng tin nhắn (tùy chọn): Nếu muốn kích hoạt tích hợp Telegram, Discord, QQ hoặc DingTalk, hãy nhập Bot Token tương ứng
Tệp cấu hình được lưu cục bộ, tất cả dữ liệu đều nằm trên thiết bị của người dùng và không bao giờ được tải lên đám mây.
Bước 3: Bắt đầu trò chuyện
Sau khi cấu hình xong, bạn có thể bắt đầu trò chuyện với AI.
Chế độ tương tác
picoclaw agentKhởi chạy giao diện trò chuyện tương tác, cho phép gửi tin nhắn liên tục và nhận phản hồi.
Chế độ truy vấn đơn lẻ
picoclaw agent -m "Xin chào, hãy giới thiệu về bản thân bạn"Gửi một tin nhắn duy nhất, nhận phản hồi rồi thoát, phù hợp để sử dụng trong các tập lệnh (script).
Khởi chạy dịch vụ Gateway
Nếu muốn sử dụng trên các nền tảng tin nhắn như Telegram, QQ:
picoclaw gatewaySau khi khởi chạy, bạn có thể tương tác với PicoClaw thông qua Bot trên các nền tảng tương ứng.
Cấu hình Bot đa nền tảng
Telegram Bot
Tìm @BotFather trên Telegram, gửi /newbot để tạo Bot và lấy Token, sau đó điền Token vào tệp cấu hình và khởi chạy picoclaw gateway.
Discord Bot
Tạo ứng dụng trong Discord Developer Portal, lấy Token trong phần cài đặt Bot, mời Bot vào máy chủ và điền Token vào cấu hình.
QQ Bot
Tham khảo tài liệu của nền tảng mở QQ để đăng ký Bot, lấy AppID và Token, sau đó điền vào tệp cấu hình.
DingTalk Bot
Tạo ứng dụng robot trên nền tảng mở DingTalk, lấy Webhook URL và khóa bí mật (secret), sau đó điền vào tệp cấu hình.
Triển khai Docker
PicoClaw hỗ trợ triển khai bằng Docker, phù hợp cho máy chủ hoặc môi trường không có giao diện đồ họa:
docker pull ghcr.io/sipeed/picoclaw:latestdocker run -d --name picoclaw -v /path/to/config:/config -e PICOCLAW_API_KEY=your_key ghcr.io/sipeed/picoclaw:latestCấu hình tác vụ định kỳ
PicoClaw tích hợp sẵn hỗ trợ cron, được quản lý thông qua tệp cấu hình.
Nhắc nhở một lần
tasks: - type: reminder time: "1h" message: "Nhắc nhở cuộc họp: Họp tuần của nhóm"Tác vụ định kỳ
tasks: - type: cron schedule: "0 8 * * *" message: "Tạo báo cáo tổng kết công việc hôm nay"Câu hỏi thường gặp
PicoClaw có cần kết nối Internet không?
Bản thân PicoClaw có thể chạy ngoại tuyến, nhưng việc gọi LLM API và tích hợp nền tảng tin nhắn yêu cầu kết nối Internet.
Hỗ trợ những nhà cung cấp LLM nào?
Hỗ trợ OpenRouter, Zhipu AI, Anthropic, OpenAI, DeepSeek, Groq, v.v., bạn có thể tự do chuyển đổi thông qua tệp cấu hình.
Làm thế nào để cập nhật PicoClaw?
Truy cập vào thư mục dự án, thực thi git pull để lấy mã nguồn mới nhất, sau đó biên dịch lại là xong.
Dữ liệu được lưu trữ ở đâu?
Tất cả lịch sử trò chuyện và dữ liệu cấu hình đều được lưu trữ trên hệ thống tệp cục bộ, hoàn toàn do người dùng kiểm soát.
Dung lượng ảnh Docker là bao nhiêu?
Ảnh Docker của PicoClaw chỉ khoảng 15MB, nhỏ hơn rất nhiều so với mức 350MB+ của các sản phẩm cạnh tranh.
Có thể chạy trên Raspberry Pi không?
Có, PicoClaw hỗ trợ kiến trúc ARM64, Raspberry Pi 4 (4GB+) là đủ để chạy mượt mà.
Làm thế nào để cấu hình nhiều Bot cùng lúc?
Chỉ cần thêm Token và cấu hình của từng nền tảng vào tệp cấu hình, sau đó khởi chạy picoclaw gateway để kích hoạt tất cả các Bot cùng lúc.