Hướng dẫn cài đặt OpenClaw với Claude Code và Gemini 3 chi tiết cho người mới

Sau khi thử cài đặt và chạy thử OpenClaw với Claude Code và Gemini 3 trong môi trường thực tế, mình nhận thấy việc thiết lập ban đầu không quá phức tạp nếu thực hiện đúng quy trình. Khi cấu hình xong, bạn có thể nhanh chóng gửi lệnh cho AI và theo dõi tác vụ trực tiếp từ các nền tảng nhắn tin quen thuộc mà không cần mở terminal liên tục. Trong bài viết này, mình sẽ chia sẻ lại toàn bộ các bước cài đặt OpenClaw với Claude Code và Gemini 3 chi tiết, giúp bạn có thể triển khai lại một cách dễ dàng ngay từ lần đầu.

Những điểm chính

Sau khi thử triển khai OpenClaw trong thực tế, mình nhận thấy việc kết nối Claude Code hoặc Gemini với các nền tảng nhắn tin quen thuộc giúp tương tác và quản lý tác vụ linh hoạt hơn nhiều, đặc biệt khi không phải lúc nào bạn cũng làm việc trực tiếp trên terminal. Trong bài viết này mình sẽ cung cấp thêm các thông tin liên quan chủ đề này như sau:

• Lý do cần cài đặt OpenClaw với Claude Code và Gemini 3: Hiểu được vì sao OpenClaw trở thành cầu nối giúp bạn tương tác với các mô hình AI mạnh mẽ như Claude Code và Gemini 3 thông qua các nền tảng nhắn tin quen thuộc.
• Hướng dẫn cài đặt OpenClaw: Nắm được các bước cài đặt OpenClaw cơ bản để thiết lập hệ thống AI agent hoạt động trên máy của bạn.
• Cấu hình Claude Code và Gemini 3 Pro: Biết cách kết nối OpenClaw với hai nền tảng AI phổ biến thông qua API, cấu trúc tệp cấu hình và chiến lược lựa chọn mô hình phù hợp với từng nhu cầu sử dụng.
• Thiết lập các kênh nhắn tin trong OpenClaw: Hiểu cách tích hợp các nền tảng như Telegram hoặc WhatsApp để gửi lệnh và nhận phản hồi từ AI trực tiếp qua giao diện trò chuyện.
• Quản lý tác nhân AI OpenClaw: Biết cách sử dụng các lệnh quản lý, kỹ năng mở rộng, bảng điều khiển web và cơ chế bộ nhớ để kiểm soát hoạt động của AI agent.
• Các mẫu lệnh OpenClaw nâng cao: Khám phá những cú pháp và mẫu lệnh giúp bạn khai thác tối đa khả năng tự động hóa và suy luận của OpenClaw.
• Biết thêm Vietnix là nhà cung cấp dịch vụ VPS tốc độ cao tối ưu cho các mô hình ứng dụng AI.
• Câu hỏi thường gặp: Giải đáp các thắc mắc liên quan đến cài đặt OpenClaw với Claude Code và Gemini 3.

Lý do cần cài đặt OpenClaw với Claude Code và Gemini 3

Để hiểu vì sao nên cài đặt OpenClaw cùng Claude Code và Gemini 3, bạn có thể xem các lý do chính sau:

• Khắc phục giới hạn của terminal hoặc trình duyệt: Claude Code và Gemini 3 Pro thường chỉ hoạt động trong môi trường terminal hoặc browser, khiến việc tương tác bị giới hạn khi không ở trước máy tính.
• Tương tác với AI mọi lúc, mọi nơi: OpenClaw tạo cầu nối giữa AI và các ứng dụng nhắn tin, cho phép bạn gửi lệnh hoặc kiểm tra trạng thái từ xa.
• Kết nối nhiều nền tảng chat phổ biến: Công cụ có thể chuyển tiếp tin nhắn qua Telegram, WhatsApp, Discord hoặc Slack.
• Tối ưu quy trình làm việc với AI: Bạn có thể giao nhiệm vụ và quản lý AI thông qua giao diện chat quen thuộc thay vì phải thao tác trực tiếp trên terminal.

Hướng dẫn cài đặt OpenClaw chi tiết

OpenClaw yêu cầu Node.js phiên bản 22 trở lên. Trước tiên, bạn hãy kiểm tra phiên bản Node.js đang được cài đặt trên hệ thống bằng lệnh:

node -v

Nếu đã đáp ứng yêu cầu, bạn có thể cài đặt OpenClaw bằng trình cài đặt chính thức bằng lệnh:

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

Trình cài đặt sẽ tự động phát hiện hệ điều hành, kiểm tra các phụ thuộc cần thiết và thực hiện toàn bộ quá trình thiết lập. Vì vậy, bạn không cần sao chép kho mã nguồn hay cấu hình thủ công. Đối với người dùng Windows, bạn hãy chạy lệnh PowerShell tương đương:

iwr -useb https://openclaw.ai/install.ps1 | iex

Sau khi cài đặt hoàn tất, OpenClaw sẽ khởi chạy giao diện terminal tương tác (TUI). Giao diện này được thiết kế theo hướng hội thoại, cho phép bạn thiết lập hệ thống thông qua các lời nhắc ngôn ngữ tự nhiên thay vì phải chỉnh sửa các tệp cấu hình phức tạp.

Sau khi hoàn tất quá trình cài đặt, bạn nên kiểm tra lại bằng cách xem phiên bản OpenClaw bằng lệnh:

openclaw --version

Terminal sẽ hiển thị số phiên bản hiện tại nếu OpenClaw được cài đặt thành công. Nếu xuất hiện lỗi command not found, bạn hãy kiểm tra lại xem Node.js đã được thêm vào biến môi trường PATH hay chưa và thử khởi động lại terminal. Thông thường, trình cài đặt sẽ tự động thêm OpenClaw vào đường dẫn thực thi của hệ thống, nhưng một số shell có thể cần khởi động lại để nhận diện các lệnh mới.

OpenClaw hỗ trợ nhiều nhà cung cấp AI, trong đó phổ biến nhất là Claude Code thông qua API của Anthropic và Gemini 3 Pro thông qua API của Google. Bạn có thể lựa chọn nhà cung cấp phù hợp dựa trên thông tin xác thực API mà mình đang sử dụng:

1. Đối với Gemini 3 Pro (Google)

Đầu tiên, bạn chọn Google làm nhà cung cấp mô hình khi thiết lập OpenClaw. Sau đó, bạn chọn một trong các phương thức xác thực sau:

• Google Gemini API Key: Xác thực trực tiếp bằng khóa API.
• Google Antigravity OAuth: Sử dụng plugin xác thực đi kèm.
• Google Gemini CLI OAuth: Xác thực thông qua luồng OAuth dòng lệnh.

Trong đó, phương thức API Key có thể sử dụng ngay nếu bạn đã có khóa từ Google AI Studio. Các tùy chọn OAuth yêu cầu đăng nhập và xác thực qua trình duyệt nhưng cung cấp mức bảo mật cao hơn.

2. Đối với Claude Code (Anthropic)

Trong quá trình thiết lập ban đầu (onboarding wizard), bạn chọn Anthropic làm nhà cung cấp mô hình và nhập khóa API khi được yêu cầu:

openclaw onboard
# Chọn: Anthropic API Key
# Nhập: sk-ant-api03-your-key-here

Các khóa API của Anthropic có sẵn tại console.anthropic.com. OpenClaw lưu trữ khóa của bạn một cách an toàn trong ~/.openclaw/openclaw.json.

3. Cấu trúc tệp cấu hình

Sau khi thiết lập, các tùy chọn sẽ được lưu trong tệp: ~/.openclaw/openclaw.json. Ví dụ cấu hình:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-5"
      }
    }
  },
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-..."
  }
}

Bạn có thể thay đổi mô hình bất cứ lúc nào bằng cách chỉnh sửa tệp này hoặc chạy lại lệnh:

openclaw onboard

4. Chiến lược lựa chọn mô hình

Việc chọn mô hình chính nên dựa trên yêu cầu của tác vụ:

• Claude Code phù hợp với các bài toán suy luận phức tạp, sinh code và các workflow dạng agent cần sử dụng nhiều công cụ.
• Gemini 3 Pro có tốc độ phản hồi nhanh hơn và hỗ trợ đa phương thức mạnh, đặc biệt hiệu quả với các tác vụ liên quan đến hình ảnh.

Cả hai mô hình đều hỗ trợ gọi hàm (function calling) và cửa sổ ngữ cảnh lớn. Bạn cũng có thể cấu hình mô hình dự phòng để đảm bảo hệ thống luôn hoạt động ổn định.

Ví dụ:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-5",
        "fallback": "google/gemini-3-pro"
      }
    }
  }
}

Khi mô hình chính gặp lỗi hoặc vượt giới hạn tốc độ, OpenClaw sẽ tự động chuyển sang mô hình dự phòng để duy trì hoạt động.

5. Bộ nhớ đệm nhắc nhở (chỉ áp dụng cho Anthropic)

OpenClaw tự động bật prompt caching khi sử dụng các mô hình của Anthropic nhằm giảm chi phí xử lý cho các prompt lặp lại. Thời gian lưu cache mặc định là 5 phút. Nếu cần kéo dài thời gian lưu trữ lên 1 giờ, bạn có thể thêm cờ beta sau vào cấu hình – Tính năng này đặc biệt hữu ích khi hệ thống thường xuyên gửi các yêu cầu tương tự trong thời gian ngắn:

extended-cache-ttl-2025-04-11

OpenClaw hỗ trợ 8 nền tảng nhắn tin khác nhau. Trong đó, Telegram và WhatsApp là hai lựa chọn phổ biến nhờ quy trình thiết lập đơn giản và giao diện trò chuyện quen thuộc, phù hợp với người dùng không muốn thao tác trực tiếp trên terminal.

1. Thiết lập Telegram

Telegram sử dụng Bot API, cho phép xác thực rõ ràng mà không cần quét mã QR. Bạn có thể tạo bot thông qua @BotFather bằng các bước sau:

• Mở Telegram và tìm kiếm @BotFather.
• Gửi lệnh /newbot và làm theo hướng dẫn.
• Chọn tên cho bot (ví dụ: Trợ lý OpenClaw của tôi).
• Chọn username kết thúc bằng bot (ví dụ: myclawbot).
• Sao chép API token mà BotFather cung cấp.

Trong quá trình thiết lập ban đầu của OpenClaw, bạn hãy dán token này khi được yêu cầu. Sau đó, hệ thống sẽ kết nối và hiển thị thông báo xác nhận.

2. Thiết lập WhatsApp

WhatsApp sử dụng cơ chế ghép nối mã QR thông qua giao thức WhatsApp Web. Bạn chạy lệnh đăng nhập kênh như sau:

openclaw channels login

Sau khi thực thi, một mã QR sẽ hiển thị trong terminal. Bạn thực hiện quét mã bằng điện thoại rồi thực hiện các bước sau:

• Mở WhatsApp > Cài đặt > Thiết bị được liên kết.
• Chọn Liên kết thiết bị.
• Quét mã QR hiển thị trên terminal.

Kết nối sẽ được duy trì cho đến khi bạn chủ động hủy liên kết thiết bị. Bạn nên sử dụng một số điện thoại riêng cho OpenClaw thay vì số cá nhân, nhằm tránh rủi ro lộ tin nhắn riêng nếu bot gặp sự cố.

3. Bảo mật: Ghép nối kênh

Khi người dùng gửi tin nhắn cho bot lần đầu, OpenClaw sẽ tạo mã ghép nối (pairing code). Bạn cần phê duyệt quyền truy cập thông qua CLI:

openclaw pairing approve telegram <CODE>

Cơ chế này giúp ngăn chặn truy cập trái phép, ngay cả khi người khác biết username bot của bạn. Nếu muốn, bạn có thể cấu hình tự động phê duyệt cho các liên hệ đáng tin cậy trong file:

~/.openclaw/openclaw.json

4. Sử dụng nhiều kênh cùng lúc

OpenClaw có thể hoạt động đồng thời trên nhiều nền tảng nhắn tin. Ví dụ, bạn có thể:

• Gửi lệnh qua Telegram.
• Nhận thông báo qua WhatsApp.
• Theo dõi trạng thái trên Discord.

Tất cả đều kết nối với cùng một backend AI. Mỗi kênh sẽ có trạng thái ghép nối và quyền truy cập riêng biệt.

5. Cấu hình bảo mật kênh

Để kiểm soát ai có thể tương tác với trợ lý AI, bạn nên sử dụng allowlist. Cấu hình được thiết lập trong file:

~/.openclaw/openclaw.json

• Allowlist cho Telegram:

{
  "channels": {
    "telegram": {
      "token": "YOUR_BOT_TOKEN",
      "allowedChatIds": [123456789, 987654321]
    }
  }
}

• Allowlist cho WhatsApp:

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+1234567890", "+0987654321"]
    }
  }
}

Việc giới hạn quyền truy cập giúp ngăn người lạ gửi tin nhắn đến bot, từ đó tránh tình trạng tiêu tốn hạn mức API hoặc truy cập trái phép vào trợ lý AI của bạn. Nếu không thiết lập allowlist, bất kỳ ai biết username bot đều có thể gửi tin nhắn và kích hoạt các yêu cầu AI.

Sau khi hoàn tất cấu hình, bạn có thể tương tác với tác nhân AI của mình thông qua các tin nhắn ngôn ngữ tự nhiên. OpenClaw sẽ xử lý nội dung bạn gửi, chuyển yêu cầu đến Claude Code hoặc Gemini 3 Pro và trả lại phản hồi thông qua nền tảng nhắn tin đã kết nối.

1. Các lệnh cơ bản

Bạn có thể sử dụng một số lệnh phổ biến sau để làm việc với OpenClaw:

• Gửi yêu cầu trực tiếp cho AI:

Analyze the code in ~/projects/myapp and suggest optimizations

• Kiểm tra trạng thái hệ thống:

/status

Lệnh này hiển thị mô hình đang hoạt động, lượng token đã sử dụng và chi phí hiện tại.

2. Kỹ năng và tiện ích mở rộng

OpenClaw sử dụng các skill tập hợp các thư mục công cụ giúp mở rộng khả năng của AI. Bạn có thể kích hoạt chúng trong quá trình thiết lập ban đầu hoặc bổ sung sau. Một số kỹ năng phổ biến gồm:

• Truy cập hệ thống tệp – đọc, ghi và quản lý file.
• Tự động hóa trình duyệt – điều hướng website và trích xuất dữ liệu.
• Tìm kiếm web – truy vấn công cụ tìm kiếm và tóm tắt kết quả.
• Tích hợp email – gửi và nhận email trực tiếp.
• Truy cập lịch – tạo, cập nhật và truy xuất sự kiện.

Khi được kích hoạt, các kỹ năng sẽ tự động cấu hình. Bot sẽ nhận diện công cụ khả dụng và sử dụng chúng dựa trên yêu cầu ngôn ngữ tự nhiên của bạn.

3. Bảng điều khiển web

Bạn có thể truy cập giao diện quản trị tại: http://localhost:18789 (hoặc cổng tùy chỉnh nếu đã thay đổi cấu hình). Bảng điều khiển cung cấp các chức năng:

• Theo dõi kết nối kênh đang hoạt động.
• Xem lịch sử tin nhắn và nhật ký hệ thống.
• Chuyển đổi hoặc cấu hình mô hình AI.
• Theo dõi mức sử dụng token và chi phí.
• Quản lý các kỹ năng đang bật.

Giao diện này đặc biệt hữu ích với người dùng thích thao tác bằng GUI thay vì terminal.

4. Bộ nhớ liên tục

Không giống các chatbot không trạng thái, OpenClaw có khả năng duy trì ngữ cảnh xuyên suốt các cuộc trò chuyện. Hệ thống lưu trữ lịch sử chat, tùy chọn người dùng và các mẫu đã học trong cơ sở dữ liệu SQLite cục bộ, giúp trợ lý ghi nhớ các cuộc thảo luận trước đó và cải thiện phản hồi theo thời gian.

Cấu hình thời gian lưu giữ (retention) trong file ~/.openclaw/openclaw.json:

{
  "memory": {
    "enabled": true,
    "database": "./data/openclaw.db",
    "retention_days": 90
  }
}

5. Các lệnh quản lý bộ nhớ

Một số lệnh giúp quản lý dữ liệu bộ nhớ của OpenClaw:

• Xóa lịch sử trò chuyện:

openclaw memory clear

• Xuất dữ liệu bộ nhớ để sao lưu:

openclaw memory export > backup.json

• Nhập lại bộ nhớ đã sao lưu:

openclaw memory import backup.json

Các tệp bộ nhớ chứa lịch sử hội thoại và tùy chọn đã học, vì vậy cần lưu trữ cẩn thận để tránh lộ thông tin nhạy cảm.

6. Yêu cầu ngữ cảnh

OpenClaw yêu cầu mô hình AI có độ dài ngữ cảnh tối thiểu 64K token. Claude Code và Gemini 3 Pro đều đáp ứng tốt yêu cầu này. Nếu sử dụng mô hình cục bộ thông qua Ollama, bạn có thể kiểm tra cấu hình bằng lệnh:

ollama show <model> --modelfile

Nếu cần tăng giới hạn ngữ cảnh, bạn hãy tạo Modelfile tùy chỉnh:

FROM <model>
PARAMETER num_ctx 65536

7. Chạy OpenClaw dưới dạng dịch vụ

Bạn có thể thiết lập OpenClaw chạy tự động khi hệ thống khởi động bằng cách cài đặt daemon trong bước onboarding:

openclaw onboard --install-daemon

Hoặc khởi chạy thủ công:

openclaw gateway --port 18789 --verbose

Cổng gateway sẽ chạy liên tục để xử lý tin nhắn và duy trì kết nối với các kênh chat. Để kiểm tra trạng thái dịch vụ bạn dùng lệnh sau:

openclaw gateway status

8. Cân nhắc bảo mật

Để đảm bảo an toàn hệ thống, bạn nên áp dụng một số biện pháp sau:

• Chạy OpenClaw bằng tài khoản không có đặc quyền.
• Nếu có thể, triển khai trên VPS hoặc máy chuyên dụng.
• Kiểm tra quyền truy cập của từng skill trước khi kích hoạt.
• Lưu trữ API key trong biến môi trường hoặc cấu hình bảo mật.
• Không đưa khóa API vào hệ thống quản lý mã nguồn.
• Thay đổi khóa định kỳ và theo dõi bảng điều khiển để phát hiện hoạt động bất thường.

9. Cập nhật OpenClaw

Để nhận các bản vá bảo mật và tính năng mới, bạn nên cập nhật OpenClaw thường xuyên. Cập nhật bằng npm:

npm update -g openclaw

Hoặc chạy lại script cài đặt:

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

Trước khi nâng cấp các phiên bản lớn, bạn nên xem lại changelog để kiểm tra các thay đổi cấu hình cần thiết.

Các mẫu lệnh OpenClaw nâng cao

OpenClaw cung cấp nhiều lệnh nâng cao giúp bạn kiểm soát hành vi của hệ thống trực tiếp trong cuộc trò chuyện. Dưới đây là một số cách sử dụng phổ biến:

• Thực thi kỹ năng hoặc quy trình có sẵn

Bạn có thể sử dụng các lệnh dấu gạch chéo để gọi trực tiếp một kỹ năng hoặc workflow đã được định nghĩa trước:

/run default "Analyze this codebase"

Lệnh này kích hoạt một kỹ năng hoặc công thức cụ thể. Trong đó, công thức là các quy trình làm việc được thiết lập sẵn, kết hợp nhiều kỹ năng như kiểm tra email, tóm tắt sự kiện trong lịch hoặc tạo bản tổng hợp hoạt động hằng ngày.

• Thiết lập mức độ suy luận của AI

OpenClaw cho phép điều chỉnh mức độ suy luận tùy theo độ phức tạp của tác vụ bằng lệnh:

Ship checklist /think high

Tùy chọn /think high kích hoạt chế độ suy luận mở rộng để xử lý các vấn đề phức tạp. Ngược lại, /think low phù hợp với các truy vấn đơn giản, giúp giảm thời gian phản hồi và tiết kiệm token.

• Tự động hóa tác vụ trên trình duyệt

Bạn cũng có thể yêu cầu OpenClaw thực hiện các tác vụ trực tuyến, ví dụ:

Book the cheapest flight to Berlin next month

Khi nhận yêu cầu, OpenClaw sẽ mở trình duyệt, tìm kiếm các công cụ tổng hợp chuyến bay, so sánh mức giá và trả về lựa chọn tốt nhất kèm theo liên kết đặt vé.

Vietnix – Nhà cung cấp dịch vụ VPS tốc độ cao tối ưu cho các mô hình ứng dụng AI

Vietnix là nhà cung cấp dịch vụ cho thuê VPS tốc độ cao được nhiều doanh nghiệp và lập trình viên lựa chọn để triển khai các ứng dụng AI, tự động hóa và hệ thống backend hiện đại. Hạ tầng máy chủ được tối ưu về hiệu suất, băng thông ổn định và khả năng mở rộng linh hoạt, giúp các mô hình AI, công cụ lập trình tự động hoặc agent như OpenClaw hoạt động mượt mà và ổn định. Bên cạnh đó, đội ngũ kỹ thuật hỗ trợ 24/7 cùng hệ thống quản trị thân thiện giúp người dùng dễ dàng triển khai, quản lý và tối ưu môi trường chạy AI ngay từ đầu!

Thông tin liên hệ:

• Website: https://vietnix.vn/
• Hotline: 1800 1093
• Email: sales@vietnix.com.vn
• Địa chỉ: 265 Hồng Lạc, Phường Bảy Hiền, Thành Phố Hồ Chí Minh

Sau khi hoàn tất các bước cài đặt, bạn có thể bắt đầu sử dụng OpenClaw cùng Claude Code và Gemini 3 để gửi lệnh, quản lý tác vụ và khai thác sức mạnh AI trực tiếp từ các nền tảng nhắn tin quen thuộc. Việc thiết lập đúng ngay từ đầu sẽ giúp hệ thống hoạt động ổn định và tận dụng tốt các tính năng tự động hóa mà OpenClaw mang lại. Hy vọng hướng dẫn trên sẽ giúp bạn triển khai OpenClaw thành công và dễ dàng tích hợp AI vào quy trình làm việc hằng ngày.