Hướng Dẫn Cài Đặt OpenClaw Với Claude Code và Gemini 3 Pro (Nhanh Chóng, Dễ Dàng)

Ashley Goolam

Ashley Goolam

4 tháng 2 2026

Hướng Dẫn Cài Đặt OpenClaw Với Claude Code và Gemini 3 Pro (Nhanh Chóng, Dễ Dàng)

Điều gì sẽ xảy ra nếu bạn có thể điều khiển Claude Code hoặc Gemini 3 Pro từ WhatsApp hoặc Telegram mà không cần chạm vào terminal? OpenClaw biến điều này thành hiện thực, biến các mô hình AI yêu thích của bạn thành các trợ lý dựa trên tin nhắn mà bạn có thể trò chuyện từ bất cứ đâu.

Vấn đề: Truy cập AI bị khóa vào Terminal

Claude Code và Gemini 3 Pro chạy các mô hình AI mạnh mẽ, nhưng chúng lại ràng buộc bạn vào một cửa sổ terminal hoặc trình duyệt. Bạn không thể gửi lệnh khi không ở bàn làm việc. Bạn không thể kiểm tra trạng thái khi đang đi lại. Bạn không thể giao nhiệm vụ mà không ngồi trước bàn phím.

OpenClaw giải quyết vấn đề này bằng cách tạo ra một cổng kết nối giữa các mô hình AI và các nền tảng nhắn tin. Nó chạy cục bộ trên máy của bạn, kết nối với Claude Code hoặc Gemini 3 Pro bằng thông tin xác thực API hiện có của bạn và chuyển tiếp tin nhắn qua Telegram, WhatsApp, Discord hoặc Slack. Bạn sẽ nhận được đầy đủ khả năng AI thông qua các giao diện trò chuyện quen thuộc.

💡
Bạn muốn một công cụ kiểm thử API tuyệt vời tạo ra Tài liệu API đẹp mắt?

Bạn muốn một nền tảng tích hợp, tất cả trong một cho Nhóm phát triển của mình để làm việc cùng nhau với năng suất tối đa?

Apidog đáp ứng mọi yêu cầu của bạn và thay thế Postman với mức giá phải chăng hơn nhiều!
nút

Cài đặt OpenClaw

OpenClaw yêu cầu Node.js 22 trở lên. Hãy xác minh cài đặt của bạn:

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

Trình cài đặt tự động phát hiện hệ điều hành của bạn, xác minh các phụ thuộc và xử lý thiết lập. Không cần sao chép kho lưu trữ hay cấu hình thủ công.

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

Sau khi cài đặt hoàn tất, OpenClaw khởi chạy giao diện người dùng terminal tương tác (TUI). Giao diện ưu tiên hội thoại này sẽ hướng dẫn bạn thiết lập bằng các lời nhắc ngôn ngữ tự nhiên thay vì các tệp cấu hình phức tạp.

install openclaw

Xác minh sau cài đặt

Xác minh OpenClaw đã được cài đặt đúng cách bằng cách kiểm tra phiên bản của nó:

openclaw --version

Terminal sẽ hiển thị số phiên bản hiện tại. Nếu bạn thấy lỗi "command not found", hãy đảm bảo Node.js nằm trong PATH của bạn và khởi động lại terminal. Trình cài đặt tự động thêm OpenClaw vào đường dẫn thực thi của hệ thống, nhưng một số shell yêu cầu khởi động lại để nhận diện các lệnh mới.

Cấu hình Claude Code và Gemini 3 Pro

OpenClaw hỗ trợ nhiều nhà cung cấp AI. Bạn có thể sử dụng Claude Code thông qua API của Anthropic hoặc Gemini 3 Pro thông qua API của Google—tùy theo thông tin xác thực bạn đã có.

Đối với Gemini 3 Pro (Google):

Chọn "Google" (đối với Google Gemini 3 Pro) từ danh sách nhà cung cấp mô hình. Chọn phương thức xác thực của bạn:

Tùy chọn khóa API Gemini hoạt động ngay lập tức nếu bạn có khóa từ Google AI Studio. Các tùy chọn OAuth yêu cầu xác thực trình duyệt nhưng cung cấp bảo mật nâng cao.

configure openclaw with google gemini 3 pro

Đối với Claude Code (Anthropic):

Trong quá trình hướng dẫn ban đầu (onboarding wizard), chọn "Anthropic" (đối với Claude Code) làm nhà cung cấp mô hình của bạn. Nhập khóa API của bạn 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.

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

Các lựa chọn của bạn được lưu trong ~/.openclaw/openclaw.json:

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

Chuyển đổ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 openclaw onboard.

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

Chọn mô hình chính của bạn dựa trên yêu cầu nhiệm vụ. Claude Code vượt trội trong suy luận phức tạp, tạo mã và các quy trình làm việc theo kiểu tác nhân (agentic workflows) yêu cầu sử dụng công cụ. Gemini 3 Pro cung cấp thời gian phản hồi nhanh hơn và khả năng đa phương thức mạnh mẽ hơn cho các tác vụ thị giác. Cả hai mô hình đều hỗ trợ gọi hàm và cửa sổ ngữ cảnh mở rộng. Bạn có thể cấu hình các mô hình dự phòng trong cùng một tệp cấu hình. Nếu mô hình chính của bạn gặp giới hạn tốc độ hoặc lỗi, OpenClaw sẽ tự động chuyển sang mô hình dự phòng:

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

Điều này đảm bảo hoạt động liên tục ngay cả khi một nhà cung cấp gặp sự cố.

Bộ nhớ đệm nhắc nhở (Chỉ Anthropic)

OpenClaw tự động bật bộ nhớ đệm nhắc nhở cho các mô hình Anthropic. Điều này giúp giảm chi phí cho các nhắc nhở tương tự được lặp lại. Thời lượng bộ nhớ đệm mặc định là 5 phút (duy trì short). Kéo dài đến 1 giờ bằng cách thêm cờ beta extended-cache-ttl-2025-04-11 vào cấu hình của bạn.

Thiết lập các kênh nhắn tin trong OpenClaw

OpenClaw hỗ trợ tám nền tảng nhắn tin. Telegram và WhatsApp cung cấp thiết lập đơn giản nhất cho người dùng ưu tiên giao diện trò chuyện hơn terminal.

set up messaging channels in openclaw

Thiết lập Telegram

Telegram sử dụng Bot API, cung cấp xác thực rõ ràng mà không cần mã QR.

Tạo một bot thông qua @BotFather của Telegram:

  1. Mở Telegram và tìm kiếm @BotFather
  2. Gửi /newbot và làm theo hướng dẫn
  3. Chọn một tên (ví dụ: "Trợ lý OpenClaw của tôi")
  4. Chọn một tên người dùng kết thúc bằng "bot" (ví dụ: "myclawbot")
  5. Sao chép mã token API được cung cấp

Trong quá trình hướng dẫn ban đầu của OpenClaw, dán mã token này khi được yêu cầu. Cổng sẽ kết nối ngay lập tức và hiển thị thông báo xác nhận.

Thiết lập WhatsApp

WhatsApp sử dụng ghép nối mã QR thông qua giao thức WhatsApp Web.

Chạy lệnh đăng nhập kênh:

openclaw channels login

Một mã QR sẽ xuất hiện trong terminal của bạn. Hãy quét nó bằng điện thoại của bạn:

  1. Mở WhatsApp → Cài đặt → Thiết bị được liên kết
  2. Chạm vào "Liên kết thiết bị"
  3. Quét mã QR hiển thị

Kết nối sẽ duy trì cho đến khi bạn ngắt liên kết thiết bị theo cách thủ công. Hãy sử dụng một số điện thoại chuyên dụng cho OpenClaw thay vì số cá nhân của bạn—điều này bảo vệ tin nhắn riêng tư của bạn nếu bot hoạt động không đúng cách.

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

Khi ai đó nhắn tin cho bot của bạn lần đầu tiên, OpenClaw sẽ gửi một mã ghép nối. Chấp thuận quyền truy cập qua CLI:

openclaw pairing approve telegram <CODE>

Điều này ngăn chặn truy cập trái phép ngay cả khi ai đó phát hiện ra tên người dùng bot của bạn. Cấu hình tự động phê duyệt cho các liên hệ đáng tin cậy trong ~/.openclaw/openclaw.json nếu bạn muốn.

Nhiều kênh

OpenClaw hoạt động đồng thời trên nhiều nền tảng. Gửi lệnh qua Telegram, nhận thông báo qua WhatsApp và theo dõi trạng thái qua Discord—tất cả đều kết nối với cùng một backend AI. Mỗi kênh duy trì các kiểm soát truy cập và trạng thái ghép nối riêng biệt.

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 của bạn bằng cách sử dụng danh sách cho phép (allowlists). Cấu hình chúng trong ~/.openclaw/openclaw.json:

Danh sách cho phép Telegram (Telegram Allowlist):

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

Danh sách cho phép WhatsApp (WhatsApp Allowlist):

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

Hạn chế quyền truy cập ngăn chặn người dùng trái phép tiêu thụ hạn ngạch API của bạn hoặc truy cập trợ lý AI của bạn. Nếu không có danh sách cho phép, bất kỳ ai phát hiện tên người dùng bot của bạn đều có thể gửi tin nhắn và kích hoạt các yêu cầu AI.

Quản lý tác nhân AI OpenClaw của bạn

Sau khi 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 xử lý văn bản của bạn, gửi nó đến Claude Code hoặc Gemini 3 Pro và trả về phản hồi thông qua nền tảng nhắn tin của bạn.

Các lệnh cơ bản

Gửi bất kỳ lời nhắc nào trực tiếp:

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

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

/status

Điều này hiển thị mô hình đang hoạt động, mức sử dụng token và chi phí hiện tại.

using openclaw with the terminal interface

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

OpenClaw sử dụng "kỹ năng" (skills)—các thư mục công cụ mở rộng khả năng. Bật các kỹ năng trong quá trình hướng dẫn ban đầu hoặc thêm chúng sau:

Các kỹ năng tự động cấu hình khi bạn bật chúng. Bot sẽ học các công cụ có sẵn và gọi chúng dựa trên các yêu cầu ngôn ngữ tự nhiên của bạn.

configure openclaw skills

Bảng điều khiển web

Truy cập giao diện quản lý tại http://localhost:18789 (hoặc cổng đã cấu hình của bạn). Bảng điều khiển hiển thị:

Điều này cung cấp một giải pháp thay thế cho việc quản lý bằng terminal đối với những người dùng ưa thích giao diện đồ họa.

openclaw web inteface

Bộ nhớ liên tục

Không giống như các chatbot không trạng thái, OpenClaw duy trì ngữ cảnh xuyên suốt các cuộc trò chuyện. Nó lưu trữ lịch sử trò chuyện, tùy chọn người dùng và các mẫu đã học cục bộ bằng SQLite. Trợ lý của bạn 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 ~/.openclaw/openclaw.json:

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

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

Xóa lịch sử trò chuyện nếu các phản hồi trở nên không nhất quán hoặc bạn muốn bắt đầu lại: openclaw memory clear

Xuất bộ nhớ để sao lưu hoặc phân tích: openclaw memory export > backup.json

Nhập các bộ nhớ đã xuất trước đó: openclaw memory import backup.json

Các tệp bộ nhớ chứa lịch sử trò chuyện và các tùy chọn đã học. Lưu trữ các bản sao lưu một cách an toàn—chúng có thể chứa thông tin nhạy cảm từ các tương tác trước đó.

Yêu cầu ngữ cảnh

OpenClaw yêu cầu các mô hình có độ dài ngữ cảnh token ít nhất 64K. Claude Code và Gemini 3 Pro đều vượt quá yêu cầu này. Nếu sử dụng các mô hình cục bộ thông qua Ollama, hãy xác minh độ dài ngữ cảnh:

ollama show <model> --modelfile

Tăng lên với một Modelfile tùy chỉnh nếu cần:

FROM <model>
PARAMETER num_ctx 65536

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

Bật tự động khởi động khi khởi động bằng cách cài đặt daemon trong quá trình hướng dẫn ban đầu:

openclaw onboard --install-daemon

Hoặc khởi động thủ công:

openclaw gateway --port 18789 --verbose

Cổng chạy liên tục, xử lý tin nhắn và duy trì kết nối kênh. Kiểm tra trạng thái bất cứ lúc nào:

openclaw gateway status

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

Chạy OpenClaw dưới quyền người dùng không có đặc quyền. Nếu có thể, hãy cách ly nó trên một VPS hoặc máy chuyên dụng. Xem xét quyền của kỹ năng trước khi bật—quyền truy cập hệ thống tệp cho phép bot đọc và ghi tệp ở bất cứ đâu người dùng của bạn có quyền.

Lưu trữ khóa API trong các biến môi trường hoặc cấu hình bảo mật của OpenClaw, không bao giờ đưa vào kiểm soát phiên bản. Xoay vòng khóa hàng quý. Theo dõi bảng điều khiển để phát hiện hoạt động bất thường.

Cập nhật OpenClaw

Luôn cập nhật OpenClaw để nhận các bản vá bảo mật và tính năng mới:

npm update -g openclaw

Hoặc chạy lại trình cài đặt:

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

Xem lại nhật ký thay đổi trước khi cập nhật lớn. Các tệp cấu hình vẫn tương thích giữa các phiên bản, nhưng các tính năng mới có thể yêu cầu điều chỉnh cấu hình.

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

Sử dụng các lệnh dấu gạch chéo để điều khiển hành vi của OpenClaw trực tiếp từ cuộc trò chuyện: /run default "Analyze this codebase"

Điều này thực thi một kỹ năng hoặc công thức cụ thể. Các công thức là các quy trình làm việc được xác định trước kết hợp nhiều kỹ năng—như kiểm tra email, tóm tắt sự kiện lịch và tạo bản tóm tắt hàng ngày.

Buộc các mức độ suy luận cụ thể: Ship checklist /think high

Cờ /think high kích hoạt chế độ suy luận mở rộng cho các vấn đề phức tạp. Sử dụng /think low cho các truy vấn đơn giản để giảm thời gian phản hồi và tiêu thụ token.

Kích hoạt tự động hóa trình duyệt: Book the cheapest flight to Berlin next month

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

Kết luận

OpenClaw biến Claude Code và Gemini 3 Pro từ các công cụ bị ràng buộc bởi terminal thành các trợ lý nhắn tin dễ tiếp cận. Bạn cấu hình một lần bằng thông tin xác thực API hiện có, kết nối nền tảng nhắn tin yêu thích của mình và tương tác thông qua trò chuyện tự nhiên. AI của bạn xử lý các tác vụ phức tạp trong khi bạn vẫn di động.

Khi xây dựng các tích hợp API—cho dù là kiểm thử các endpoint của OpenClaw, gỡ lỗi luồng xác thực hay quản lý nhiều cấu hình nhà cung cấp—hãy tối ưu hóa quá trình phát triển của bạn với Apidog. Nó cung cấp tính năng kiểm thử API trực quan, tạo tài liệu tự động và các công cụ gỡ lỗi cộng tác bổ trợ cho quy trình làm việc của trợ lý AI của bạn.

nút

Thực hành thiết kế API trong Apidog

Khám phá cách dễ dàng hơn để xây dựng và sử dụng API