Bài viết này sẽ hướng dẫn bạn cách tải, cài đặt và thực hiện các cấu hình cơ bản (onboarding) cho OpenClaw để bắt đầu sử dụng.
1. Chuẩn bị (Prerequisites)
Trước khi cài đặt OpenClaw, nếu bạn dự định sử dụng mô hình ngôn ngữ chạy máy khách (Local LLM), khuyến nghị bạn nên chuẩn bị trước. Trong bài viết này, do mình sử dụng Ollama làm nhà cung cấp mô hình nên mình sẽ cài đặt sẵn Ollama và tải mô hình về máy trước khi bắt đầu.
Ví dụ, mở một terminal khác và chạy lệnh sau để tải mô hình Qwen (tùy chọn):
ollama pull qwen2.5:3b
2. Tải và cài đặt OpenClaw
Mở terminal của bạn và chạy câu lệnh dưới đây để tiến hành tải và cài đặt OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash
3. Thiết lập cấu hình ban đầu (Onboarding)
Sau khi quá trình cài đặt hoàn tất, chúng ta cần cấu hình môi trường cho OpenClaw. Chạy câu lệnh sau trong terminal:
openclaw onboard --install-daemon
Hệ thống sẽ hiển thị một giao diện TUI (Terminal User Interface) với các bước thiết lập như sau:
Bước 3.1: Xác nhận môi trường sử dụng Hệ thống sẽ hỏi bạn về việc bảo mật trong môi trường sử dụng chung.
- Chọn Yes để tiếp tục.
Lựa chọn cho mục đích dùng chung hoặc dùng một mình
Bước 3.2: Chọn Chế độ Onboarding
- Chọn QuickStart (Cấu hình nhanh, bạn có thể chỉnh sửa chi tiết sau).
Bước 3.3: Xử lý cấu hình cũ
- Nếu đây là lần đầu tiên, hệ thống sẽ bỏ qua bước này. Nếu bạn đã từng cài đặt, chọn Use existing values để giữ lại cấu hình cũ hoặc Reset để thiết lập lại.
Bước 3.4: Lựa chọn Nhà cung cấp mô hình (Model/Auth Provider) Hệ thống hiển thị danh sách các nhà cung cấp (OpenAI, Anthropic, Gemini, Ollama…).
- Trỏ xuống và chọn Ollama (Nếu bạn dùng mô hình Local) hoặc có thể chọn Skip for now nếu muốn thiết lập sau.
Bước 3.5: Chọn Mô hình (Model)
- Danh sách các mô hình hiện có trong máy (đã tải qua Ollama) sẽ hiện ra. Lựa chọn mô hình bạn muốn sử dụng (Ví dụ: ollama/qwen2.5:3b)
Và chọn mô hình bạn đã tải về
Bước 3.6: Tùy chọn Kênh giao tiếp, Web Search và Kỹ năng (Channels, Search & Skills)
- Hệ thống sẽ lần lượt hỏi bạn có muốn kết nối với các kênh chat (Telegram, Discord…), tích hợp công cụ tìm kiếm, và cài đặt các kỹ năng (Skills) hay không.
- Đối với thiết lập cơ bản: Bạn có thể chọn Skip for now (Bỏ qua) cho tất cả các phần này, bao gồm cả việc thiết lập API Key. Chúng ta có thể bổ sung sau khi cần.
ở đây mình sẽ skip
Tiếp theo sẽ là bạn có cho chatbot này websearch không.
Ở đây mình cũng sẽ skip vì mình không dùng.
Tiếp theo sẽ là nó sẽ hiện bạn có muốn config lại skill của bot không, ở đây mình bạn có thể chọn có hoặc không đều được.
Nếu có:
Nó sẽ yêu cầu bạn có dùng dependency nào thì sẽ bấm phím space để chọn, ở đây mình sẽ chọn là skip for now vì mình không có nhu cầu dùng.
Tiếp theo nó sẽ yêu cầu bạn set các API key cho các dependency mà bạn dùng, ở đây mình không dùng dependency nào mình sẽ chọn là no cho tất cả.
Bước 3.7: Thiết lập Hooks (Sự kiện hệ thống)
Đây là tính năng khá quan trọng. Bạn có thể chọn (bằng phím Space) các hooks sẽ kích hoạt khi agent khởi động:
Giải thích:
Boot.md : dùng như một startup scripts, kiểu sẽ run openclaw theo file boot để có thể tự động setup ban đầu và không phải nhập tay.
Bootstrap-extra-files: dùng như một file để tự động chèn các thêm các file cấu hình hoặc tài nguyên vào workspace khi agent khởi động.
Command-logger: là cơ chế ghi lại toàn bộ sự kiện liên quan đến lệnh mà agent đã thực thi trong hệ thống.
Session-memory: là cơ chế lưu lại ngữ cảnh của một phiên làm việc trước khi bạn tạo một phiên mới agent có thể sử dụng lại ngữ cảnh cũ mà không mất thông tin quan trọng giữa các phiên làm việc.
Khuyến nghị: Nên tick chọn command-logger và session-memory.
Bước 3.8: Khởi động Gateway Service
- Chọn Restart (Hoặc Install nếu cài lần đầu) để khởi động dịch vụ kết nối.
Bước 3.9: Chọn phương thức hiển thị (Hatch Bot) Hệ thống cho phép bạn chọn giao diện để tương tác với Bot:
1. Hatch in TUI (recommended): Chạy và tương tác trực tiếp trên giao diện Terminal (Rất phù hợp cho Developer).
2. Open the Web UI: Mở giao diện Web (Khuyên dùng nếu bạn thích giao diện trực quan, dễ nhìn hơn Terminal).
3. Do this later: Bỏ qua
Dưới đây là ví dụ khi chọn giao diện TUI:
Chúc mừng! Bạn đã hoàn thành các bước setup cơ bản và có thể bắt đầu sử dụng OpenClaw.