OpenClaw Là Gì? Hướng Dẫn Cài Đặt & Sử Dụng Đầy Đủ (2026)

OpenClaw 🦞 là AI personal agent mã nguồn mở (MIT license), local-first — toàn bộ Gateway chạy trên máy của bạn, kết nối 20+ nền tảng nhắn tin để bạn ra lệnh cho AI từ Telegram, WhatsApp, Discord hay bất kỳ đâu.

OpenClaw 🦞 — Local-first AI agent: npm install một lệnh, kết nối Telegram/WhatsApp/Discord/iMessage và nhiều hơn nữa

Tóm tắt:

• ✅ Self-hosted — chạy trên hardware của bạn, quy tắc của bạn
• ✅ Multi-channel — một Gateway phục vụ WhatsApp, Telegram, Discord cùng lúc
• ✅ Agent-native — tool use, sessions, memory, multi-agent routing
• ✅ Open source — MIT license, community-driven

Các Khái Niệm Quan Trọng

Kiến trúc hoạt động:

Telegram / Discord / WhatsApp / Signal / iMessage...
                        │
                        ▼
            ┌─────────────────────┐
            │      Gateway        │  ← chạy local trên máy bạn
            │  127.0.0.1:18789    │
            └──────────┬──────────┘
                       │
          ├─ AI Agent (RPC)
          ├─ CLI (openclaw ...)
          ├─ WebChat UI / Dashboard
          └─ macOS app / iOS / Android nodes

Cài Đặt Nhanh (Quick Start)

Yêu Cầu Hệ Thống

• Node.js ≥ 22.16 (bắt buộc — theo docs chính thức)
• npm hoặc pnpm

Bước 1 — Cài OpenClaw

npm install -g openclaw@latest

Bước 2 — Chạy Onboarding (cài daemon tự động)

openclaw onboard --install-daemon

Lệnh này cài Gateway như một background service — tự khởi động cùng hệ điều hành (launchd trên macOS, systemd trên Linux). Đây là cách đơn giản nhất để setup.

Nếu chỉ muốn onboarding không cài daemon:

openclaw onboard

Bước 3 — Pair Channel và Khởi Chạy Gateway

# Pair WhatsApp (hoặc channel khác) rồi start Gateway:
openclaw channels login
openclaw gateway --port 18789

Kiểm Tra Trạng Thái

openclaw doctor

Lệnh doctor kiểm tra cấu hình, connections và phát hiện rủi ro bảo mật.

Dashboard Local

Sau khi Gateway chạy, truy cập:

http://127.0.0.1:18789/

Cài Từ Source (Developer)

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build        # build UI (tự cài deps lần đầu)
pnpm build           # tạo dist/

# Chạy onboarding:
pnpm openclaw onboard --install-daemon

# Dev loop (auto-reload khi thay đổi source):
pnpm gateway:watch

Cấu Hình Cơ Bản

File cấu hình chính: ~/.openclaw/openclaw.json

Nếu không tạo file config, OpenClaw dùng bundled Pi binary ở RPC mode với per-sender sessions.

Minimal config (chỉ cần AI model):

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  }
}

Với Telegram:

{
  "agent": {
    "model": "openai/gpt-4o"
  },
  "channels": {
    "telegram": {
      "token": "YOUR_BOT_TOKEN",
      "allowFrom": ["YOUR_TELEGRAM_USER_ID"]
    }
  }
}

Với WhatsApp (lock down group):

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+15555550123"],
      "groups": {
        "*": { "requireMention": true }
      }
    }
  },
  "messages": {
    "groupChat": {
      "mentionPatterns": ["@openclaw"]
    }
  }
}

Với Ollama (model local, hoàn toàn offline):

{
  "agent": {
    "model": "ollama/qwen3.5:latest"
  }
}

Xem đầy đủ tất cả keys cấu hình: docs.openclaw.ai/gateway/configuration

Channels Được Hỗ Trợ

OpenClaw hỗ trợ 20+ nền tảng — một Gateway phục vụ tất cả cùng lúc:

Hướng Dẫn Sử Dụng Cơ Bản

Sau khi cài xong, tương tác qua Telegram hoặc CLI:

# Gửi message qua CLI:
openclaw message send --to +84xxxxxxxxx --message "Hello"

# Chạy agent với task cụ thể:
openclaw agent --message "Ship checklist" --thinking high

# Phê duyệt pairing request từ người dùng mới:
openclaw pairing approve telegram <code>

Chat Commands Thực Tế

# Tìm file
Tìm tất cả PDF trong Downloads tạo tuần này

# Tóm tắt tài liệu
Tóm tắt file /Documents/report.pdf

# Tìm kiếm web
Tìm thông tin mới nhất về GPT-5 và tóm tắt

# Thực thi code
Chạy script backup.sh và báo kết quả

Sample Usecase Thực Tế

1. Trợ Lý Quản Lý File

"Tìm tất cả file Excel có tên 'budget' trong Desktop,
 copy vào /Archive/2025/"

2. Browser Automation

"Mở Chrome, vào gmail.com, lấy 5 email chưa đọc và tóm tắt"

3. Research Agent

"Tìm hiểu Astro.js framework, so sánh với Next.js,
 tóm tắt 300 từ và lưu vào ~/research/astro.md"

4. Voice Wake (macOS/iOS)

Setup wake word "Hey Claw" → nói lệnh trực tiếp, không cần mở app.

5. Scheduled Task (Cron)

"Mỗi sáng 8h: lấy thời tiết + tóm tắt tech news,
 gửi vào Telegram của tôi"

Skills System

Skills là các plugin mở rộng tại ~/.openclaw/workspace/skills/<skill>/SKILL.md:

• ClawHub — marketplace skills cộng đồng
• Skills inject context vào agent qua AGENTS.md, SOUL.md, TOOLS.md
• Custom skill: tạo folder + SKILL.md với frontmatter name và description

Remote Access

Muốn truy cập Gateway từ bên ngoài mạng local? Hai option:

• Web surfaces: docs.openclaw.ai/web
• Tailscale: docs.openclaw.ai/gateway/tailscale

Security Model — Đọc Trước Khi Dùng

⚠️ OpenClaw kết nối với messaging surfaces thật. Treat inbound DMs như untrusted input.

DM Pairing (mặc định):

{
  "channels": {
    "telegram": {
      "dmPolicy": "pairing"  // người lạ phải verify pairing code trước
    }
  }
}

Approve người dùng mới:

openclaw pairing approve telegram <code>

Sandbox cho group/channel (khuyến nghị):

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main"  // non-main sessions chạy trong Docker container riêng
      }
    }
  }
}

Update channel an toàn:

openclaw update --channel stable    # bản ổn định
# hoặc:
openclaw update --channel beta      # prerelease

Tổng Kết

OpenClaw là lựa chọn tốt nếu bạn muốn:

• ✅ AI agent local-first, dữ liệu không rời máy
• ✅ Kết nối 20+ platform (Telegram, WhatsApp, Discord...) bằng một Gateway
• ✅ Cài đơn giản qua một lệnh npm
• ✅ Dashboard web tại localhost:18789
• ✅ Tùy chỉnh sâu qua Skills và openclaw.json
• ✅ MIT license, open source hoàn toàn

Tài nguyên chính thức:

• 🐙 GitHub: github.com/openclaw/openclaw
• 📚 Docs: docs.openclaw.ai
• 🌐 Website: openclaw.ai
• 🚀 Quick Start: docs.openclaw.ai/start/quickstart