Hướng dẫn cài Open Claw trên Raspberry Pi 5 (Chi tiết A – Z)

OpenClaw là một framework cho phép xây dựng AI agent tự động thực hiện tác vụ (gọi tool, truy cập hệ thống, xử lý workflow). Nó tập trung vào khả năng điều phối: kết nối LLM với các công cụ như shell, API, database để tạo agent “hành động được”. Điểm nổi bật là tính linh hoạt, chạy nội bộ hoặc trực tuyến, và hướng đến tự động hóa quy trình phức tạp thay vì chỉ chat thông thường.

Trong bài viết này, Cytron Việt Nam sẽ hướng dẫn cách cài đặt Open Claw trên Raspberry Pi 5. Cách làm tương tự nếu bạn định cài đặt Open Claw trên Raspberry Pi 4 hoặc cài Open Claw trên Compute Module 5. Bài viết này hướng đến người mới bắt đầu sử dụng Raspberry Pi, vì vậy nội dung được viết khá chi tiết và đầy đủ các bước. Nếu bạn đã có kinh nghiệm sử dụng Raspberry Pi và OpenClaw, bạn có thể bỏ qua những bước không cần thiết, ví dụ như thêm channel hoặc approve/pair (nếu không dùng chat để tương tác với OpenClaw).

Phần 1. Cài đặt Open Claw với một dòng lệnh

Chúng ta cần kết nối SSH tới Raspberry Pi 5 sử dụng Command Line Prompt, Putty hoặc nhập lệnh trực tiếp bằng chuột & bàn phím (trên Terminal).

Sau đó cập nhật hệ thống lên phiên bản mới nhất với

sudo apt update && sudo apt upgrade

Sau khi hoàn tất, chúng ta có thể cài Open Claw với một dòng lệnh duy nhất:

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

Lệnh này cũng sẽ cài các ứng dụng cần thiết, ví dụ như NodeJS.

Phần 2. Onboard (Cấu hình) Open Claw trên Raspberry Pi

Sau khi cài đặt xong, ứng dụng sẽ tự chuyển đến cửa số cấu hình lần đầu cho Open Claw

Hãy dùng phím di chuyển trên bàn phím để di chuyển qua Yes, nhấn Enter để sang các bước cấu hình tiếp theo.

• Onboarding: Manual
• What do you want to setup: Local gateway
• Workspace directory: Để mặc định và nhấn Enter
• Model/auth provider: Tại đây, bạn có thể sử dụng các model AI trả phí hoặc miễn phí qua API. Một nhà cung cấp có thể kể đến như OpenAI, Google hoặc chọn llama/Ollama nếu bạn có phần cứng phù hợp để chạy LLM local. Ở đây, mình sẽ dùng OpenAI (gpt).

OpenAI auth method: Đây là phương thức xác thực, chọn OpenAI API key, và nhập key bạn đã tạo vào cửa sổ.

Để tạo được key cho OpenAI, bạn cần vào platform.openai.com, tạo dự án, nạp tiền và tạo Key tại mục Project.

Default model: chọn model mặc định, theo đề xuất, gpt-4o-mini là đủ cho các tác vụ cơ bản. Nó cân bằng giữa chi phí và hiệu năng.

Những mục còn lại bạn có thể tham khảo cài đặt của Cytron Việt Nam để tiến hành. Tại phần Gateway auth, mình chọn Password để tiện truy cập nội bộ.

Ở phần Channel, bạn có thể kết nối OpenClaw tới các nền tảng nhắn tin như Telegram, Zalo, discord, v.v.

Trong bài viết này, mình sẽ dùng Telegram.

Để có được Telegram BotAPI (token), hãy chat với BotFather trên Telegram, nhập lệnh /newbot để tạo mới bot, cũng như lấy token.

Token thường có dạng 13198398129:ABBBBJjbwqjejhqwhejqw

Lưu ý: Đừng bao giờ chia sẻ Bot Token hoăc Pairing code với bất kỳ ai.

Sau khi nhập token vào cửa sổ cấu hình OpenClaw, chúng ta sẽ sang các bước tiếp theo. Ở đây, mình sẽ cài thêm clawhub.

Lưu ý chọn Yes cho Install Gatewat service.

Và enable bash shell completion for openclaw để cấp quyền thực thi các lệnh liên quan đến shell. Hãy thận trọng khi bạn chọn yes.

Tới đây, quá trình cấu hình OpenClaw gần như đã xong.

Bây giờ chúng ta sẽ pair Telegram với OpenClaw để có thể tương tác với nó qua Telegram.

Hãy chat với con bot bạn vừa tạo trên Telegram và nhấn /start

Ở đây, bạn sẽ thấy chữ Pairing Code: SJxxxxxx

Lưu ý: Đừng bao giờ chia sẻ Bot Token hoăc Pairing code với bất kỳ ai.

Trên Raspberry Pi, hãy chạy dòng lệnh sau để tiến hành ghép đôi:

openclaw pairing approve telegram PAIRING-CODE-CUA-BAN

Nếu thấy dòng chữ bên dưới, quá trình Paring đã hoàn tất và bạn có thể giao tiếp với OpenClaw qua Telegram rồi!

Ở đây, mình đã thử kiểm tra nhiệt độ CPU của Raspberry Pi 5, cũng như truy vấn dung lượng đĩa trống.

Ngoài Telegram, bạn có thể kết nối với Zalo, discord và các nền tảng khác. Đồng thời, bạn có thể cài đặt thêm các kỹ năng “skill” để OpenClaw có thể xử lý các tác vụ như đọc email, lướt web, xử lý file, v.v

Bạn có thể truy cập tài liệu chính thức từ OpenClaw để biết thêm thông tin.

https://docs.openclaw.ai/install/raspberry-pi

Chúc bạn thành công!