OpenClaw (Clawdbot): Hướng dẫn cài đặt & sử dụng trợ lý AI cá nhân đa nền tảng

Bạn có bao giờ mơ về một trợ lý AI thực sự – không phải là chatbot công cộng, mà là một người bạn công việc thông minh hiểu bạn, nhớ thói quen của bạn, và thực hiện những tác vụ phức tạp ngay trong các app chat quen thuộc?

OpenClaw (tên cũ là Clawdbot) chính là giải pháp đó.

Tại sao lại là OpenClaw?

Trong thời đại AI, hầu hết các trợ lý AI đều chạy trên cloud – dữ liệu của bạn được gửi lên máy chủ của công ty, được lưu trữ và phân tích để cải thiện mô hình của họ. OpenClaw đảo ngược mô hình này với triết lý local‑first Gateway:

• Chạy cục bộ (Local-first) – Gateway chạy trên máy tính của bạn (macOS, Windows, Linux hoặc WSL2). Dữ liệu và quyền truy cập nằm trong tay bạn.
• Đa nền tảng chat – OpenClaw là “multi‑provider inbox” cho WhatsApp, Telegram, Slack, Discord, Signal, iMessage, WebChat… nói chuyện với một trợ lý duy nhất từ mọi ứng dụng.
• Trí nhớ lâu dài – Agent có bộ nhớ bền vững, có thể ghi nhớ bối cảnh, sở thích và các “tiền lệ” bạn xây dựng theo thời gian.
• Toàn quyền kiểm soát – Mã nguồn mở, Gateway và agent do bạn tự chạy; bạn cấu hình nó được phép làm gì trên hệ thống.

Tính năng nổi bật của OpenClaw

Trường hợp sử dụng thực tế

OpenClaw không chỉ là chatbot – nó là một trợ lý tự động hóa mạnh mẽ xoay quanh agent + skills.

Quản lý công việc & email

• Tìm và tóm tắt email quan trọng (deadline, hợp đồng, booking) từ Gmail ngay trong chat.
• Tạo task trong Linear/GitHub Issues chỉ bằng một câu lệnh tự nhiên.
• Lập to‑do list, follow‑up list dựa trên luồng email gần đây.

Tự động hóa DevOps

• Chạy các loop code (test, fix, commit) từ Telegram/Discord thông qua skills DevOps.
• Theo dõi health server, xem logs, restart service từ xa bằng câu lệnh tự nhiên.
• Kết nối CI/CD để trigger build/deploy từ chat.

Web & content creation

• Dùng Browser tool để crawl, tóm tắt hoặc rút trích dữ liệu từ trang web.
• Hỗ trợ sinh nội dung, phác thảo landing page, rồi dùng skills DevOps để deploy.
• Quản lý CMS/issue tracker qua skills tương ứng (Notion, GitHub, v.v.).

Dữ liệu cá nhân & sức khỏe

• Kết nối các API fitness/health (như WHOOP hoặc dịch vụ tương tự nếu có skill) để lấy chỉ số hàng ngày.
• Đọc flight info từ email, tạo reminder, lịch trình di chuyển.
• Quản lý calendar và nhắc việc theo thói quen của bạn.

Smart home & lifestyle

• Điều khiển smart home thông qua Home Assistant hoặc API khác khi có cấu hình skill phù hợp.
• Tạo “morning briefing” gồm lịch, thời tiết, task, email quan trọng.
• Tùy biến workflow đời sống (coffee, shopping…) bằng việc nối các API dịch vụ bạn dùng.

Yêu cầu hệ thống & chuẩn bị

Yêu cầu bắt buộc

• Node.js phiên bản 22 trở lên (runtime chính thức).
• Git (nếu muốn chạy từ source).
• Tài khoản AI / provider:
  • Anthropic (Claude) – được khuyến nghị, wizard hỗ trợ OAuth/API key.
  • OpenAI (GPT‑4o, GPT‑4.1, v.v.) nếu bạn đã quen hệ sinh thái đó.

LƯU Ý:
OpenClaw định nghĩa provider/model qua config; tích hợp với runtime model local (Ollama, LM Studio) là có thể làm được qua skill/tool riêng, ae tham khảo cách mình config cho CLIProxy API phía dưới nhé.

Yêu cầu tuỳ chọn (cho từng nền tảng chat)

• WhatsApp: tài khoản WhatsApp và thiết bị để scan QR.
• Telegram: bot token từ @BotFather.
• Discord: bot token từ Discord Developer Portal.
• Slack: bot token + app token từ Slack workspace.
• Signal: tài khoản Signal nếu dùng provider Signal.

Tài nguyên máy

• Ổ cứng: ~2 GB cho code + UI + cache, tuỳ skills.
• RAM: 4 GB+ (8 GB+ khuyến nghị nếu dùng Browser tool & nhiều skills).
• CPU: CPU phổ thông là đủ; có thể chạy trên mini PC hoặc máy ảo riêng nếu muốn cô lập.

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

Bước 1: Cài đặt Node.js

Windows & macOS:

• Truy cập nodejs.org và tải Node.js v22+.
• Cài đặt theo hướng dẫn installer.

Linux (Ubuntu/Debian, ví dụ):

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs git

macOS (Homebrew):

brew install node git

Kiểm tra:

node --version   # v22.x.x
npm --version    # v10.x.x (tuỳ bản)

Bước 2: Cài OpenClaw CLI (khuyên dùng)

Cách đơn giản nhất là cài CLI toàn cục qua npm/pnpm.

npm install -g openclaw@latest
# hoặc
pnpm add -g openclaw@latest

Kiểm tra:

openclaw --help

Bước 3: Chạy Onboarding Wizard (RẤT QUAN TRỌNG)

CLI onboarding wizard là cách được khuyên dùng để đi từ “zero → first working chat”.

openclaw onboard --install-daemon

Wizard sẽ dẫn bạn qua:

1. Chọn Gateway – Local Gateway (mặc định) hoặc kết nối tới Gateway từ xa.
2. Model & auth – Chọn Anthropic, OpenAI, v.v. và thiết lập OAuth/API key.
3. Workspace – Chọn thư mục làm việc (mặc định ~/openclaw) và bootstrap file nhận dạng/bộ nhớ.
4. Gateway settings – Port, bind, auth, Tailscale (nếu muốn truy cập từ xa).
5. Providers – WhatsApp, Telegram, Discord, Signal… wizard sẽ hỏi bạn muốn bật cái nào.
6. Daemon (tùy chọn) – Cài service nền (LaunchAgent/systemd) để Gateway tự chạy background.
7. Skills – Chọn skill đề xuất và node manager (npm/pnpm) để cài dependencies.

Kết thúc wizard bạn sẽ nhận được một bản tóm tắt: Gateway port, model, workspace và các provider đã bật.

(Tuỳ chọn) Bước 4: Chạy từ source

Nếu bạn muốn clone repo để đọc code hoặc đóng góp:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # auto-installs UI deps on first run
pnpm build
openclaw onboard --install-daemon

Gateway (from this repo):

node openclaw.mjs gateway --port 18789 --verbose

Bước 5: Kết nối WhatsApp (nếu dùng)

OpenClaw dùng WhatsApp Web (Baileys) và login qua QR code.

1. Cấu hình WhatsApp cơ bản trong ~/.openclaw/openclaw.json (wizard có thể đã làm giúp bạn).
2. Đăng nhập:

openclaw channels login

Wizard/CLI sẽ mở một màn hình để bạn scan QR (Linked Devices).

Ví dụ config đơn giản:

{
  "whatsapp": {
    "dmPolicy": "allowlist",
    "allowFrom": ["+84123456789"]
  }
}

Bước 6: Kết nối Telegram

Thêm token bot vào ~/.openclaw/openclaw.json:

{
  "telegram": {
    "botToken": "123456:YOUR_BOT_TOKEN_HERE",
    "enabled": true
  }
}

Wizard cũng có bước hỏi Telegram Bot API token nếu bạn bật provider này trong quá trình onboard.

Bước 7: Khởi động Gateway

Gateway là “đầu não” – một control plane cho mọi session, provider, skills.

openclaw gateway --port 18789 --verbose

Bạn sẽ thấy dạng log:

✓ Gateway listening on ws://127.0.0.1:18789
✓ WebChat:    http://127.0.0.1:18789/chat

Giữ tiến trình này chạy (hoặc cài daemon theo hướng dẫn wizard).

Bước 8: Gửi tin nhắn đầu tiên

• Qua WhatsApp: nhắn vào cuộc chat với số/bot đã liên kết.
• Qua Telegram: nhắn vào bot mà bạn tạo qua BotFather.
• Qua WebChat: mở http://127.0.0.1:18789/chat trên trình duyệt.

Ví dụ:

Xin chào! Giới thiệu bản thân và giúp tôi lên kế hoạch cho ngày hôm nay.

OpenClaw sẽ trả lời bằng model bạn đã cấu hình (Claude, GPT‑4o, v.v.).

# BONUS: Cấu hình openclaw.json cho ai muốn dùng CLIProxy:

{
  "models": {
    "mode": "replace",
    "providers": {
      "cliproxy": {
        "baseUrl": "http://127.0.0.1:8317/v1",
        "apiKey": "sk-cliproxy-vnrom-net",
        "api": "openai-completions",
        "models": [
          {
            "id": "gemini-3-flash-preview",
            "name": "Gemini 3 Flash",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 1000000,
            "maxTokens": 8192
          },
          {
            "id": "gemini-3-pro-preview",
            "name": "Gemini 3 Pro",
            "reasoning": true,
            "input": [
              "text",
              "image"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 1000000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "list": [
      {
        "id": "default",
        "identity": {
          "name": "vnROM",
          "theme": "Friendly and fresh",
          "emoji": "👨🏻‍💻"
        }
      }
    ],
    "defaults": {
      "model": {
        "primary": "cliproxy/gemini-3-flash-preview",
        "fallbacks": []
      }
    }
  },
...
}

Cấu hình & sử dụng cơ bản

Tệp cấu hình chính

Tệp cấu hình nằm tại: ~/.openclaw/openclaw.json

Ví dụ cấu hình đơn giản:

{
  "agent": {
    "model": "anthropic/claude-3.5-sonnet"
  },
  "gateway": {
    "port": 18789,
    "bind": "127.0.0.1"
  },
  "whatsapp": {
    "dmPolicy": "allowlist",
    "allowFrom": ["+84123456789"]
  },
  "telegram": {
    "botToken": "YOUR_TELEGRAM_BOT_TOKEN",
    "enabled": true
  },
  "discord": {
    "token": "YOUR_DISCORD_BOT_TOKEN"
  }
}

Các lệnh chat hữu ích

(Tên cụ thể có thể thay đổi tuỳ agent/skill, nhưng pattern slash command là phổ biến trong bots.)

Ví dụ sử dụng

Bạn: “Tìm email từ boss gần đây nhất về deadline Q1”

→ OpenClaw dùng skill Gmail, tìm email liên quan và gửi lại nội dung/tóm tắt cho bạn.

Bạn: “Tạo issue mới trên GitHub: ‘Fix bug login trên mobile’”

→ OpenClaw gọi GitHub API qua skill, tạo issue và trả về link.

Bạn: “Lấy thống kê WHOOP hôm nay” (nếu có skill WHOOP)

→ OpenClaw gọi WHOOP API, lấy sleep score, strain, recovery và tóm tắt.

Bạn: “Xây dựng landing page đơn giản cho sản phẩm mới”

→ OpenClaw hỏi yêu cầu, sinh code, và nếu bạn gắn skill CI/CD thì có thể deploy tự động.

Kết nối với API & dịch vụ bên ngoài

OpenClaw kết nối với dịch vụ bên ngoài thông qua skills và config tương ứng. Bạn thường sẽ:

• Thêm secrets (API key, token) vào config hoặc biến môi trường.
• Cài skill tương ứng (qua wizard hoặc manual).

Ví dụ cấu hình (giả lập):

{
  "google": {
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_SECRET",
    "refresh_token": "YOUR_REFRESH_TOKEN"
  },
  "github": {
    "token": "ghp_YOUR_GITHUB_TOKEN"
  },
  "homeAssistant": {
    "url": "http://192.168.1.100:8123",
    "token": "YOUR_HA_TOKEN"
  }
}

LƯU Ý:

Nên dùng biến môi trường hoặc secret manager thay vì ghi token trực tiếp vào file JSON để an toàn hơn.

Đánh giá OpenClaw: Ưu & nhược

Ưu điểm

Nhược điểm

Câu hỏi thường gặp (FAQ)

OpenClaw có an toàn không?

• Gateway mặc định chạy trên 127.0.0.1, không public ra Internet. Mã nguồn mở, có thể audit. Có thể bật sandbox mode/Docker để cô lập các tác vụ có khả năng nguy hiểm.

Tôi phải trả bao nhiêu tiền?

• OpenClaw (phần mềm) miễn phí. Bạn chỉ trả tiền cho provider (Anthropic, OpenAI, v.v.) nếu dùng model cloud.

Có thể dùng model local không?

• Có thể thông qua skills/tools tích hợp với runtime LLM local (Ollama, v.v.), nhưng đây là hướng nâng cao, không phải đường quick‑start mặc định.

OpenClaw có chạy được trên server Linux (VPS) không?

• Có. Bạn có thể chạy Gateway trên VPS, sau đó truy cập qua SSH tunnel, VPN (Tailscale) hoặc reverse proxy – docs có hướng dẫn Gateway remote.

Có dùng trong group chat được không?

• Có, nhưng nên bật sandbox và policy phù hợp để tránh cho agent quyền quá rộng khi nhiều người cùng chat.

Skills là gì? Tôi có thể viết skill riêng không?

• Skills là các module mở rộng agent (call API, quản lý app, DevOps, v.v.). Bạn có thể cài skill có sẵn hoặc tự viết skill mới bằng TypeScript/JavaScript.

OpenClaw có hoạt động offline hoàn toàn không?

• Nếu dùng model cloud (Claude, GPT‑4…), bắt buộc cần Internet. Nếu dùng model local qua skill, bạn có thể giảm phụ thuộc cloud, nhưng vẫn phải đảm bảo runtime local đang chạy.

Làm sao để update OpenClaw?

• Nếu cài từ source:

cd openclaw
git pull origin main
npm run build

Hoặc dùng các lệnh update/doctor của CLI.

npm i -g openclaw@latest
# hoặc
pnpm add -g openclaw@latest

OpenClaw không chỉ là một chatbot; đây là một nền tảng trợ lý AI local‑first cho developer, maker, và người dùng quan tâm đến quyền riêng tư và tự động hóa cá nhân. Bạn có một Gateway do chính bạn kiểm soát, kết nối với mọi app nhắn tin bạn thích, và có thể mở rộng vô hạn bằng skills theo workflow riêng.

Ai nên dùng OpenClaw?

• Web/devops developer muốn điều khiển hạ tầng từ Telegram/Discord.
• Content creator muốn quản lý inbox, lịch, publish nội dung qua chat.
• Người dùng quan tâm privacy không muốn gửi mọi thứ lên SaaS.
• Startup/SMB cần một “AI ops engineer” tự host, chi phí thấp.
• Hacker/maker thích vọc vạch, viết skill, gắn AI với mọi thứ quanh mình.