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?

Clawdbot chính là giải pháp đó.

Tại sao lại là Clawdbot?

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ọ. Clawdbot đả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 – Clawdbot 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 Clawdbot

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

Clawdbot 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 Ý:
Clawdbot đị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, nhưng hiện không phải đường chính thức “bật là chạy local LLM sẵn”, nên không nên hứa sẵn cho người dùng phổ thông.

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 Clawdbot CLI (khuyên dùng)

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

npm install -g clawdbot
# hoặc
pnpm add -g clawdbot
# hoặc
bun add -g clawdbot

Kiểm tra:

clawdbot --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”.

clawdbot onboard

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 ~/clawd) 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/bun) để 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/clawdbot/clawdbot.git
cd clawdbot

Cài dependencies:

npm install
# hoặc
pnpm install
# hoặc
bun install

Build code + UI khi cần:

npm run build
npm run ui:build

Sau đó dùng npx clawdbot onboard hoặc cài global như trên và dùng clawdbot ....

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

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

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

clawdbot providers 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 ~/.clawdbot/clawdbot.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.

clawdbot gateway --port 18789

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

✓ Gateway listening on ws://127.0.0.1:18789
✓ Control UI: http://127.0.0.1:18789/ui
✓ WebChat:    http://127.0.0.1:18789/chat
✓ Ready to receive messages...

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.

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

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: ~/.clawdbot/clawdbot.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”

→ Clawdbot 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’”

→ Clawdbot 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)

→ Clawdbot 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”

→ Clawdbot 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

Clawdbot 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á Clawdbot: Ưu & nhược

Ưu điểm

Nhược điểm

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

Clawdbot 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?

• Clawdbot (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.

Clawdbot 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.

Clawdbot 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 Clawdbot?

• Nếu cài từ source:

cd clawdbot
git pull origin main
npm run build

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

Clawdbot 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 Clawdbot?

• 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.