buildAI2026-03-1710 phút

OpenClaw Là Gì? Hướng Dẫn Cài Đặt & Sử Dụng Trên Windows, macOS và Ubuntu

Hướng dẫn chính xác về OpenClaw 🦞 — AI assistant mã nguồn mở local-first: cài đặt qua npm một lệnh, cấu hình qua openclaw.json, kết nối Telegram/Discord/WhatsApp, giải thích Gateway, Sessions, Skills và lưu ý bảo mật.

OpenClaw 🦞 là một AI personal assistant mã nguồn mở với hơn 250,000 GitHub stars — một trong những dự án AI open-source phát triển nhanh nhất năm 2025-2026. Ra đời dưới tên Clawdbot (11/2025), đổi thành Moltbot rồi OpenClaw (đầu 2026), được phát triển bởi lập trình viên người Áo Peter Steinberger.

Điểm khác biệt cốt lõi: OpenClaw chạy local-first — Gateway chạy trên máy bạn, kết nối với 20+ nền tảng nhắn tin (Telegram, Discord, WhatsApp, Slack, Signal, iMessage...) để bạn ra lệnh cho AI từ bất kỳ đâu.

OpenClaw AI assistant – cài đặt và sử dụng trên Windows, macOS, Ubuntu

OpenClaw 🦞 — Local-first AI agent kết nối 20+ nền tảng nhắn tin

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

Khái niệm	Giải thích
Gateway	"Control plane" trung tâm — chạy local trên `ws://127.0.0.1:18789`, điều phối tất cả kết nối channel, tool và event
Session	Một phiên hội thoại — lưu context, lịch sử và trạng thái agent
Channel	Kênh giao tiếp (Telegram, Discord, CLI terminal, WebChat...)
Skill	Plugin mở rộng tại `~/.openclaw/workspace/skills/<skill>/SKILL.md`
Node	Thành phần mở rộng phần cứng (iOS, Android, camera, voice wake...)

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

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

Cài Đặt

Yêu Cầu

Node.js ≥ 22 (bắt buộc)
npm hoặc pnpm

Cài Một Lệnh (Khuyến Nghị)

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

# Sau đó chạy onboarding (tự cài daemon launchd/systemd):
openclaw onboard --install-daemon

Lệnh onboard --install-daemon sẽ 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).

Khởi Chạy Gateway

openclaw gateway --port 18789 --verbose

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 các rủi ro bảo mật.

Cài Từ Source (Dành Cho 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

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 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:

Nhóm	Platforms
Messaging	WhatsApp, Telegram, Signal, iMessage, BlueBubbles
Work	Slack, Discord, Microsoft Teams, Google Chat
Social	Twitch, Nostr, LINE, Zalo, Feishu
Self-hosted	Matrix, Mattermost, Nextcloud Talk, Synology Chat
Web	WebChat (built-in browser UI)

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 cho agent qua CLI:
openclaw message send --to +84xxxxxxxxx --message "Hello"

# Chạy agent với một 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ông Dụng

# Tìm file
Tìm tất cả PDF trong thư mục 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 có thể 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

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

⚠️ OpenClaw kết nối với các messaging surface 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
      }
    }
  }
}

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, Discord, WhatsApp...)
✅ Cài đơn giản qua một lệnh npm
✅ Tùy chỉnh sâu qua Skills và openclaw.json
✅ Gateway daemon tự chạy nền cùng hệ điều hành

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

🐙 GitHub: github.com/openclaw/openclaw
📚 Docs: docs.openclaw.ai
🌐 Website: openclaw.ai