Triển khai OpenClaw trên Raspberry Pi có thể thực hiện theo hai cách: cài nhanh bằng lệnh đơn giản dành cho người mới, hoặc cài đặt thủ công để kiểm soát chi tiết và bảo mật cao hơn.

Cách 1: Cài đặt tự động (dành cho người dùng phổ thông)

Phương pháp này phù hợp để trải nghiệm nhanh mà không cần cấu hình phức tạp.

1. Chuẩn bị hệ điều hành: Dùng công cụ Raspberry Pi Imager để ghi bản Raspberry Pi OS (64-bit) lên thẻ nhớ. Nên chọn Raspberry Pi 5 với RAM 8GB và dùng SSD để đạt hiệu năng tối ưu.
2. Chạy lệnh cài đặt: Sau khi khởi động thiết bị, mở terminal và chạy lệnh sau:

   curl -fsSL https://openclaw.ai/install.sh | bash

   Script sẽ tự động cài Node.js cùng các thư viện phụ thuộc.
3. Cấu hình tương tác: Sau khi cài xong, hệ thống sẽ hướng dẫn bạn:
   • Xác nhận cảnh báo bảo mật.
   • Chọn nhà cung cấp AI (ví dụ Anthropic) và nhập API key.
   • Kết nối nền tảng chat như Telegram hoặc Discord (có thể bỏ qua).
   • Bắt đầu trò chuyện với trợ lý AI ngay trong terminal.

Cách 2: Cài đặt thủ công (dành cho môi trường sản xuất)

Dành cho người dùng muốn tùy chỉnh sâu và vận hành dịch vụ ổn định lâu dài.

1. Chuẩn bị phần cứng và hệ điều hành:
   • Thiết bị: Raspberry Pi 4 (RAM ≥4GB) hoặc Pi 5 (8GB là lý tưởng).
   • Lưu trữ: Ưu tiên SSD NVMe để tăng độ bền và tốc độ.
   • Hệ điều hành: Cài Raspberry Pi OS Lite (64-bit) hoặc Ubuntu Server 24.04 ARM64.
2. Cập nhật hệ thống và cài gói cần thiết:

   sudo apt update && sudo apt upgrade -y
   sudo apt install -y git curl wget jq build-essential pkg-config \
   python3 python3-venv python3-pip nodejs npm redis-server sqlite3

   Redis hỗ trợ hàng đợi hiệu năng cao, SQLite lưu dữ liệu cục bộ.
3. Tạo tài khoản riêng biệt:

   sudo useradd -m -s /bin/bash aiagent
   sudo mkdir -p /srv/aiagent
   sudo chown -R aiagent:aiagent /srv/aiagent

   Không nên chạy dịch vụ dưới quyền root hoặc tài khoản mặc định.
4. Clone mã nguồn và thiết lập môi trường:

   sudo su - aiagent
   cd /srv/aiagent
   git clone <URL_CHÍNH_THỨC> core
   cd core
   python3 -m venv sandbox
   source sandbox/bin/activate
   pip install -r requirements.txt
   cp config.env.example .env
   nano .env

   Trong file .env, điền các thông số như địa chỉ host, URL Redis, API key... Sau đó bảo vệ file bằng lệnh chmod 600 .env.
5. Đăng ký dịch vụ hệ thống: Tạo file systemd tại /etc/systemd/system/aiagent.service:

   [Unit]
   Description=AI Agent Service
   After=network.target redis-server.service
   
   [Service]
   Type=simple
   User=aiagent
   WorkingDirectory=/srv/aiagent/core
   Environment="PYTHONUNBUFFERED=1"
   ExecStart=/srv/aiagent/core/sandbox/bin/python -m agent.main
   Restart=always
   RestartSec=5
   
   NoNewPrivileges=true
   PrivateTmp=true
   ProtectSystem=strict
   ProtectHome=read-only
   ReadWritePaths=/srv/aiagent/core/storage
   
   [Install]
   WantedBy=multi-user.target

   Kích hoạt dịch vụ:

   sudo systemctl daemon-reload
   sudo systemctl enable aiagent
   sudo systemctl start aiagent

Lưu ý bảo mật quan trọng

• Tấn công prompt injection: Tỷ lệ thành công của kỹ thuật này có thể lên tới 91%. Luôn kiểm tra kỹ nội dung đầu vào từ người dùng hoặc nguồn bên ngoài.
• Rò rỉ dữ liệu: Các tệp nhật ký, lịch sử hội thoại và file MEMORY.md có thể chứa thông tin nhạy cảm.
• Giảm thiểu rủi ro:
  • Dùng mạng riêng ảo (VPN) như Tailscale để giới hạn truy cập.
  • Giới hạn quyền truy cập file và lệnh thực thi qua biến môi trường như TOOL_ALLOWED_PATHS.
  • Chọn nhà cung cấp AI cam kết không lưu trữ lịch sử hội thoại.
  • Thiết lập kiểm tra sức khỏe trước khi gọi mô hình để tiết kiệm tài nguyên.

Tài nguyên bổ sung

• Kiểm tra trạng thái dịch vụ: http://<địa_chỉ_IP>:8080/healthz
• Kết nối cảm biến hoặc đèn LED để điều khiển bằng giọng nói hoặc văn bản tự nhiên.
• Tham khảo tài liệu chính thức để cập nhật tính năng và hướng dẫn bảo mật chuyên sâu.