OpenClaw là trợ lý AI mã nguồn mở bạn tự chạy trên máy tính hoặc máy chủ của mình, rồi nhắn tin với nó qua Telegram, Zalo, WhatsApp, Discord hay ngay trên trình duyệt. Khác chatbot thông thường, OpenClaw có trí nhớ lâu dài lưu thành file trên máy bạn, tự làm việc theo lịch và dùng được công cụ thật: trình duyệt, file, lệnh hệ thống.
Bài này là hướng dẫn từ A–Z cho người mới: OpenClaw là gì và từng có tên gì, tốn bao nhiêu tiền, cần máy thế nào, cách cài trên macOS, Windows, Linux và VPS, thiết lập lần đầu, nối Telegram và Zalo, các file quy định "tính cách" và trí nhớ, skills, lịch tự động, lệnh hay dùng, bảo mật và lỗi thường gặp. Thông tin đối chiếu với tài liệu chính thức của OpenClaw ngày 7/11/2026. OpenClaw ra bản mới rất thường xuyên, nên khi lệnh trong bài khác với máy bạn, hãy tin tài liệu chính thức.
OpenClaw là gì?
Theo tài liệu chính thức, OpenClaw là trợ lý AI chạy trên hạ tầng của chính bạn, dùng cho một người hoặc chia sẻ cho cả nhóm. Trung tâm của nó là Gateway: một tiến trình chạy liên tục trên máy bạn, Mac mini, máy chủ ở nhà hay VPS. Gateway nhận tin nhắn từ các ứng dụng chat, chuyển cho mô hình AI xử lý, cho phép AI dùng công cụ, rồi gửi câu trả lời về đúng cuộc trò chuyện.
Ba điểm khiến OpenClaw khác ChatGPT hay Claude trên web:
Chạy trên máy của bạn: cấu hình, lịch sử hội thoại và trí nhớ nằm trên ổ đĩa của bạn, không nằm trên một dịch vụ trung gian. Chỉ phần nội dung gửi cho mô hình AI là đi ra ngoài, tới nhà cung cấp mô hình bạn chọn.
Nhắn ở nơi bạn đang dùng: không cần mở trang web riêng, bạn nhắn cho trợ lý như nhắn cho một người trên Telegram hay Zalo, kể cả từ điện thoại khi máy chạy OpenClaw ở nhà.
Hành động được, không chỉ trả lời: mở trình duyệt điền form, đọc và sắp xếp file, chạy lệnh, gửi báo cáo buổi sáng theo lịch.
OpenClaw không phải trình soạn code. Tài liệu chính thức nói rõ: để viết code nhanh trong một dự án, dùng Claude Code hoặc Codex; OpenClaw là lớp trợ lý và điều phối, mạnh ở trí nhớ lâu dài, truy cập từ nhiều thiết bị và tự động hóa công việc.

Clawdbot, Moltbot và OpenClaw: một sản phẩm, ba cái tên
Nếu bạn từng đọc về Clawdbot hay Moltbot, đó chính là OpenClaw ở các giai đoạn trước. Dự án do Peter Steinberger, nhà sáng lập PSPDFKit, khởi đầu như một dự án cá nhân.
| Thời gian | Tên gọi | Chuyện gì xảy ra |
|---|---|---|
| 11/2025 | Clawdbot | Ra đời như dự án cá nhân, linh vật là chú tôm hùm "Clawd" |
| 27/1/2026 | Moltbot | Đổi tên sau khi Anthropic gửi email đề nghị vì lý do thương hiệu |
| 30/1/2026 | OpenClaw | Tên chính thức hiện tại, kho mã chuyển về github.com/openclaw/openclaw |
| 15/2/2026 | OpenClaw Foundation | Steinberger gia nhập OpenAI làm mảng tác tử cá nhân; OpenClaw chuyển sang quỹ độc lập |
Mốc đổi tên lấy theo trang lịch sử dự án; tin Steinberger sang OpenAI được The Decoder và nhiều báo công nghệ đưa ngày 15/2/2026.
OpenClaw có thuộc OpenAI không? Không. Theo mục hỏi đáp chính thức, OpenClaw do OpenClaw Foundation quản lý, là tổ chức phi lợi nhuận độc lập. OpenAI là một trong các nhà tài trợ và người sáng lập làm việc ở đó, nhưng nhà tài trợ không sở hữu hay điều khiển dự án, và mã nguồn không ưu tiên mô hình của hãng nào.
OpenClaw làm được gì?
Tài liệu chính thức liệt kê năm việc phổ biến nhất. Dưới đây là cách giao việc cụ thể bằng tiếng Việt:
Bản tin cá nhân: "Mỗi sáng 7 giờ, tóm tắt email chưa đọc, lịch họp hôm nay và tin tức về ngành nội thất, gửi vào Telegram cho tôi."
Tìm hiểu và viết nháp: "Tìm 10 đơn vị phân phối thiết bị điện ở Bình Dương có website, lập bảng tên, địa chỉ, số điện thoại, rồi viết nháp email giới thiệu cho từng nơi. Chưa gửi, để tôi duyệt."
Nhắc việc và theo dõi: "Thứ Sáu hằng tuần nhắc tôi đối soát công nợ, kèm danh sách khách quá hạn trong file công nợ."
Tự động trên trình duyệt: điền form lặp lại, thu thập dữ liệu từ trang web, kiểm tra giá đối thủ.
Giao việc từ xa: đang ở ngoài, nhắn từ điện thoại để máy ở văn phòng xử lý file rồi gửi kết quả lại.
Với việc gửi tin hàng loạt, chạy quảng cáo hay liên hệ khách hàng, chính tài liệu OpenClaw khuyên luôn để người duyệt trước khi gửi, tránh spam và tuân thủ luật cùng chính sách của nền tảng: để OpenClaw viết nháp, bạn duyệt.
OpenClaw có miễn phí không? Chi phí thực tế
Phần mềm OpenClaw miễn phí và mã nguồn mở. Quỹ OpenClaw không có gói trả phí, không có dịch vụ lưu trữ hộ, không bán token. Tiền bạn thực sự trả nằm ở hai chỗ:
| Khoản | Các lựa chọn | Ghi chú |
|---|---|---|
| Mô hình AI | Khóa API trả theo mức dùng (Anthropic, OpenAI, Google, OpenRouter…); dùng lại đăng nhập Claude Code hoặc Codex có sẵn; mô hình chạy trên máy | Đây là khoản chính. Tác tử chạy lịch tự động cả ngày có thể tốn nhiều hơn bạn nghĩ |
| Máy chạy Gateway | Máy tính đang dùng (0 đồng), Mac mini hay máy cũ để ở nhà, hoặc thuê VPS | Muốn trợ lý chạy 24/7 thì cần máy luôn bật |
Vài lưu ý khi chọn cách trả tiền cho mô hình, theo mục hỏi đáp chính thức:
Không bắt buộc mua gói Claude hay ChatGPT. Khóa API trả theo mức dùng là đủ. Với máy chủ chạy lâu dài, tài liệu khuyên dùng khóa API vì chi phí dễ đoán hơn.
Dùng gói Claude Pro/Max qua Claude Code: được, nhưng phần dùng này trừ vào hạn mức của gói, không phải lượt miễn phí thêm. Cách Anthropic tính phần này đã thay đổi nhiều lần, nên kiểm tra trang hỗ trợ của Anthropic trước khi dựa vào.
Gói ChatGPT/Codex: OpenClaw hỗ trợ đăng nhập bằng tài khoản ChatGPT; hạn mức có thể khác với khi dùng ChatGPT trên web.
Mô hình chạy trên máy: làm được, nhưng tài liệu không khuyến khích mô hình nhỏ vì ngữ cảnh ngắn và dễ bị lừa bằng lệnh cài cắm (prompt injection) hơn.
Giá mỗi nhà cung cấp mô hình thay đổi thường xuyên, xem trực tiếp trang giá của nhà cung cấp bạn chọn. Đặt giới hạn chi tiêu trong tài khoản API ngay từ đầu.
Cần máy thế nào? Chạy trên laptop hay VPS
Yêu cầu phần mềm: Node.js 24.16.0 trở lên (dòng 24) hoặc 26.1.0 trở lên; tài liệu khuyên Node 26 và các bản 24.22.1+ hoặc 26.12.1+ để có bản vá bảo mật. Nhiều bài viết cũ ghi Node 22, yêu cầu này đã cũ. Script cài đặt chính thức tự cài Node nếu máy chưa có.
Hệ điều hành: macOS, Linux, Windows. Trên Windows có ứng dụng Windows Hub, bộ cài PowerShell hoặc chạy trong WSL2.
Cấu hình máy chủ: tối thiểu 1 vCPU, 1 GB RAM, khoảng 500 MB ổ đĩa; khuyên dùng 1–2 vCPU và từ 2 GB RAM khi nối nhiều kênh hoặc dùng tự động trình duyệt. Hệ điều hành máy chủ được thử nghiệm kỹ nhất là Ubuntu LTS.
| Chạy trên laptop | Chạy trên VPS hoặc máy riêng | |
|---|---|---|
| Ưu điểm | Không tốn tiền máy chủ, đọc được file trên máy, thấy trình duyệt chạy trực tiếp | Chạy 24/7, mạng ổn định, không bị ngắt khi gập máy |
| Nhược điểm | Máy ngủ, mất mạng hay cập nhật hệ điều hành là trợ lý ngừng | Thường không có màn hình, chỉ truy cập file từ xa, cần biết SSH |
| Hợp với | Thử nghiệm, dùng trong giờ làm | Bản tin, nhắc việc, bot trả lời cần chạy liên tục |
Tài liệu khuyên chạy trên máy riêng nếu được: vừa ổn định, vừa tách biệt quyền với dữ liệu cá nhân trên máy chính. Không cần mua Mac mini, trừ khi bạn cần iMessage hoặc công cụ chỉ có trên macOS.
Cách cài đặt OpenClaw
Chỉ tải và chạy lệnh từ trang chính thức openclaw.ai, docs.openclaw.ai và kho github.com/openclaw. Trong đợt đổi tên đầu năm 2026, đã có tài khoản giả mạo nhận là thành viên dự án để quảng bá token lừa đảo.
Cách nhanh nhất: một lệnh
Nếu máy đã có Node.js đúng phiên bản:
npx openclaw@latestLệnh này chạy OpenClaw và mở luôn phần thiết lập. Nếu máy đã đăng nhập Claude Code, Codex hoặc có sẵn khóa API, OpenClaw tự phát hiện, gửi thử một yêu cầu để xác nhận rồi mở bảng điều khiển.
macOS, Linux, WSL2: script chính thức
curl -fsSL https://openclaw.ai/install.sh | bashScript tự nhận hệ điều hành, cài Node nếu thiếu, cài OpenClaw rồi chạy trình hướng dẫn thiết lập. Trên macOS còn có ứng dụng thanh menu: tải file OpenClaw-<phiên bản>.dmg ở trang Releases của kho GitHub chính thức.
Windows
Cách dễ nhất cho người mới là Windows Hub: ứng dụng cài như phần mềm bình thường, có thiết lập, biểu tượng trạng thái ở khay hệ thống và khung chat. Tải ở trang Releases của kho openclaw/openclaw-windows-node trên GitHub, chọn bản x64 hoặc arm64 theo máy. Windows Hub chạy trên Windows 10 20H2 trở lên.
Muốn dùng dòng lệnh, mở PowerShell và chạy:
iwr -useb https://openclaw.ai/install.ps1 | iexCài bằng npm
Nếu bạn tự quản lý Node:
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemonTùy chọn --allow-scripts=openclaw dành cho npm 12 hoặc npm 11.16 trở lên; npm 11.15 trở xuống thì bỏ tùy chọn này.
Docker và VPS
Muốn chạy cách ly trên VPS, tài liệu có hướng dẫn Docker cùng hướng dẫn riêng cho nhiều nhà cung cấp máy chủ (DigitalOcean, Hetzner, Google Cloud, Azure…). Lưu ý: bản Docker mặc định mở cổng ra ngoài, phải bật xác thực trước khi dùng. Xem mục bảo mật bên dưới.
Kiểm tra cài đặt
openclaw --version
openclaw doctor
openclaw gateway statusLệnh đầu cho biết đã cài được chưa, doctor kiểm tra lỗi cấu hình, lệnh cuối cho biết Gateway có đang chạy không. Gateway mặc định nghe ở cổng 18789.
Thiết lập lần đầu (onboarding)
Sau khi cài, trình hướng dẫn tự mở (hoặc chạy openclaw onboard). Bạn chọn một trong hai đường:
Quick start: nhận diện quyền dùng AI sẵn có, bạn chọn một cách kết nối, OpenClaw gửi thử để xác nhận, tạo workspace rồi mở bảng điều khiển trên trình duyệt. Đường này đặt tên tác tử là
mainvà cho toàn quyền.Custom setup: cùng các bước nhưng hỏi từng lựa chọn: tên tác tử, mức quyền, gửi thống kê ẩn danh hay không, các phần cài thêm.
Cuối Quick start, OpenClaw hỏi có giữ OpenClaw chạy nền không. Chọn Có thì Gateway chạy như một dịch vụ hệ thống: LaunchAgent trên macOS, systemd trên Linux và WSL2, Scheduled Task trên Windows. Chọn Không thì Gateway chỉ chạy khi cửa sổ Terminal còn mở. Muốn cài chạy nền sau:
openclaw gateway install
openclaw gateway startTheo tài liệu, cài đặt mất khoảng 2–5 phút, Quick start thêm vài phút. Muốn chỉnh thêm về sau, chạy openclaw configure.
Phiên làm việc đầu tiên: từng bước
Mở bảng điều khiển: chạy
openclaw dashboard. Trang Control UI mở trên trình duyệt; tải được là mọi thứ đã chạy.Chào và giới thiệu: nhắn bằng tiếng Việt: "Chào bạn. Tôi tên Minh, làm chủ một xưởng nội thất ở Thủ Đức. Trả lời tôi bằng tiếng Việt, ngắn gọn, đi thẳng vào việc." Tác tử sẽ ghi những điều này vào file về bạn.
Giao một việc nhỏ, không rủi ro: "Tìm 5 bài viết mới nhất về giá gỗ cao su xuất khẩu, tóm tắt mỗi bài 3 dòng, kèm link."
Thử trí nhớ: "Hãy nhớ rằng tôi chỉ muốn nhận báo cáo vào buổi sáng." Sau đó gõ
/newđể mở phiên mới và hỏi lại xem nó còn nhớ không.Nối điện thoại: làm theo mục Telegram bên dưới, rồi nhắn thử từ điện thoại.
Mới cho tự động chạy: khi đã quen cách nó làm việc, mới tạo lịch tự động và cho dùng các công cụ quyền cao.
Muốn dừng một việc đang chạy, gửi riêng một tin nhắn stop (hoặc abort, halt). Tin nhắn dồn dập trong lúc tác tử đang làm sẽ được đưa vào việc đang chạy; muốn xếp hàng làm lần lượt, gõ /queue followup.
Workspace: các file tạo nên "tính cách" và trí nhớ
Mỗi tác tử có một workspace, mặc định ở ~/.openclaw/workspace. Đây là thư mục làm việc và cũng là trí nhớ của tác tử: mọi thứ nó biết về bạn được lưu thành file Markdown đọc được, sửa được. Bạn sửa trực tiếp hoặc vào Settings → Agents → Files trong bảng điều khiển.
| File | Chứa gì | Khi nào được nạp |
|---|---|---|
AGENTS.md | Quy tắc làm việc, thứ tự ưu tiên, cách dùng trí nhớ, ghi chú về công cụ trên máy | Đầu mỗi phiên |
SOUL.md | Giọng điệu, quan điểm, mức độ ngắn gọn, giới hạn | Đầu mỗi phiên |
USER.md | Sở thích, cách giao tiếp, dự án đang làm của bạn (giới hạn riêng 4.000 ký tự) | Đầu mỗi phiên |
IDENTITY.md | Tên, phong cách, emoji của tác tử | Tạo trong lần chạy đầu |
MEMORY.md | Trí nhớ dài hạn: sự kiện, quyết định quan trọng | Chỉ trong phiên riêng tư, không nạp ở nhóm chat |
memory/YYYY-MM-DD.md | Nhật ký từng ngày | Hôm nay và hôm qua, khi mở phiên mới |
BOOT.md | Danh sách việc làm khi Gateway khởi động (tùy chọn) | Khi bật hook boot-md |
skills/ | Skill riêng của workspace này | Khi cần dùng |
Cấu hình, khóa đăng nhập và lịch sử phiên không nằm trong workspace mà ở ~/.openclaw/ (file cấu hình chính là ~/.openclaw/openclaw.json). Đừng đưa thư mục này lên Git hay chia sẻ cho người khác.
Một ví dụ AGENTS.md ngắn cho trợ lý văn phòng:
# Quy tắc làm việc
- Luôn trả lời bằng tiếng Việt.
- Không gửi email, tin nhắn cho người ngoài khi chưa được tôi duyệt.
- Không xóa file. Cần dọn thì chuyển vào thư mục _thung-rac và báo tôi.
- Số liệu tài chính phải ghi rõ lấy từ file nào.
- Hỏi lại nếu yêu cầu chưa rõ, đừng tự đoán.Tài liệu OpenClaw khuyên tách bạch: AGENTS.md để quy tắc vận hành, SOUL.md chỉ để giọng điệu và phong cách. SOUL.md nên ngắn và sắc, tránh những câu chung chung như "luôn chuyên nghiệp, hỗ trợ tận tình" vì chúng gần như không thay đổi hành vi.
Trí nhớ hoạt động thế nào
Tác tử chỉ nhớ những gì được ghi xuống đĩa, không có trạng thái ẩn nào khác. Muốn nó nhớ điều gì, chỉ cần nói: "Hãy nhớ rằng báo giá luôn gửi kèm file PDF." Nó sẽ ghi vào file phù hợp: sở thích ổn định vào USER.md, sự kiện và quyết định vào MEMORY.md, diễn biến trong ngày vào nhật ký memory/.
Vì trí nhớ là file thường, bạn mở ra xem được nó đang nhớ gì, xóa được điều sai. Nên sao lưu workspace bằng một kho Git riêng tư, vì trí nhớ có thể chứa thông tin nhạy cảm.
Nối Telegram: kênh dễ cài nhất
Tài liệu chính thức gợi ý Telegram là kênh nhanh nhất để nhắn với trợ lý từ điện thoại, vì chỉ cần một token bot.
Tạo bot: trong Telegram, nhắn cho @BotFather (kiểm tra đúng tên này), gõ
/newbot, đặt tên và lưu token được cấp.Đưa token vào OpenClaw:
openclaw channels add --channel telegram --token <token-bot>Kiểm tra kênh:
openclaw channels status --probe.Ghép đôi: nhắn một tin bất kỳ cho bot. Bot trả về mã ghép đôi. Trên máy chạy OpenClaw, duyệt mã:
openclaw pairing list telegram openclaw pairing approve telegram <MÃ>Mã hết hạn sau 1 giờ.
Cơ chế ghép đôi là lớp bảo vệ quan trọng: người lạ tìm thấy bot của bạn và nhắn tin sẽ không được xử lý cho đến khi bạn duyệt. Trong nhóm chat, bot mặc định chỉ trả lời khi được nhắc tên (@mention).
Nối OpenClaw với Zalo: chọn đúng cách
OpenClaw hiện có ba cách nối Zalo, mức độ an toàn rất khác nhau:
| Cách | Hoạt động thế nào | Nên dùng? |
|---|---|---|
| Zalo (kênh tích hợp sẵn) | Tạo bot ở Zalo Bot Platform (bot.zaloplatforms.com), lấy token, đưa vào cấu hình. Hỗ trợ nhắn riêng và nhóm (phải nhắc tên bot) | Có. Dùng API chính thức; tài liệu ghi trạng thái thử nghiệm |
| Zalo ClawBot (plugin của Zalo Platforms) | Quét mã QR bằng ứng dụng Zalo, một bot riêng được gắn với tài khoản của bạn và chỉ nói chuyện với bạn | Có, cho trợ lý cá nhân. Dùng API chính thức; đang ở bản Beta |
| Zalo personal (zalouser) | Tự động hóa chính tài khoản Zalo cá nhân bằng thư viện không chính thức | Không khuyến khích. Tài liệu OpenClaw cảnh báo có thể bị khóa tài khoản |
Cài Zalo ClawBot: chạy openclaw onboard và chọn Zalo ClawBot trong danh sách kênh; trình hướng dẫn cài plugin, hiện mã QR trong Terminal, bạn quét bằng ứng dụng Zalo và đồng ý điều khoản trong Zalo Mini App. Mã QR hết hạn sau 5 phút. Cài tay:
openclaw plugins install "@zalo-platforms/openclaw-zaloclawbot@0.1.4"
openclaw plugins enable openclaw-zaloclawbot
openclaw channels login --channel openclaw-zaloclawbot
openclaw channels status --probeSố phiên bản plugin ở trên là bản tài liệu ghi ngày 7/11/2026; kiểm tra lại trang Zalo ClawBot để lấy bản mới nhất. Plugin này yêu cầu OpenClaw từ bản 2026.4.10.
Kênh Zalo tích hợp sẵn có vài giới hạn cần biết: mỗi tin nhắn gửi đi tối đa 2.000 ký tự, file đính kèm mặc định tối đa 5 MB, chưa hỗ trợ thả cảm xúc hay trả lời trích dẫn. Trang tài liệu này nói về bot tạo từ Zalo Bot Creator; Zalo Official Account (OA) là sản phẩm khác và không được trang này đề cập.
Với doanh nghiệp muốn tự động trả lời khách trên Zalo một cách ổn định, kênh chính thức vẫn là Zalo OA cùng API dành cho OA, hoặc một Zalo Mini App để khách đặt hàng, đặt lịch ngay trong Zalo. Tấn Phát Digital có nhận phát triển Zalo Mini App; gọi hoặc nhắn Zalo 0374 225 294 để được tư vấn.
Skills và ClawHub
Skill là gói hướng dẫn dạy tác tử làm một loại việc, gồm file SKILL.md và các file đi kèm. ClawHub (clawhub.ai) là kho công khai chứa skill và plugin cho OpenClaw. Hai khái niệm khác nhau: skill là hướng dẫn dạng văn bản, plugin là mã chạy trong Gateway (ví dụ một kênh chat mới). Nhiều bài viết cũ dùng nhầm lệnh plugins install để cài skill.
openclaw skills search "calendar"
openclaw skills install @tac-gia/ten-skill
openclaw skills update --allVới plugin từ ClawHub:
openclaw plugins search "calendar"
openclaw plugins install clawhub:<tên-gói>Trang mỗi skill trên ClawHub hiện phiên bản, lượt tải và tóm tắt kết quả quét bảo mật. Đọc kỹ trước khi cài: skill từ cộng đồng có thể chứa chỉ dẫn độc hại, và tác tử sẽ làm theo với quyền mà bạn đã cấp cho nó.
Lịch tự động (automations)
OpenClaw có bộ lập lịch riêng: đến giờ, nó đánh thức tác tử làm việc rồi gửi kết quả vào kênh chat, một webhook, hoặc không gửi đi đâu. Quản lý bằng lệnh openclaw automations (tên cũ openclaw cron vẫn dùng được). Cách đơn giản nhất là nói thẳng trong chat: "Mỗi sáng thứ Hai 8 giờ, gửi tôi danh sách việc tuần này." Xem lại các lịch đã tạo:
openclaw automations list
openclaw automations runs <mã-lịch>Ngoài lịch giờ, OpenClaw còn có webhook để dịch vụ khác đánh thức tác tử, và trigger theo email Gmail. Bắt đầu với một hai lịch đơn giản, xem kết quả vài ngày rồi mới thêm.
Lệnh hay dùng

Vài lệnh chat đáng nhớ: /new mở phiên mới, /model xem và đổi mô hình mà không cần khởi động lại, /verbose off ẩn tin nhắn hệ thống nếu thấy rối. Đa số lệnh có dấu / phải gửi thành một tin nhắn riêng.
Bảo mật: phần quan trọng nhất
Một trợ lý đọc được tin nhắn, file và chạy được lệnh trên máy bạn là công cụ mạnh, và cũng là mục tiêu hấp dẫn. OpenClaw có mặc định khá an toàn: Gateway chỉ nghe trên máy (loopback), người lạ nhắn phải ghép đôi, nhóm chat phải nằm trong danh sách cho phép. Rủi ro thường đến từ việc người dùng tự nới lỏng những mặc định này.
| Rủi ro | Chuyện gì có thể xảy ra | Cách phòng |
|---|---|---|
| Lỗ hổng phần mềm | CVE-2026-25253 (điểm 8,8): bản cũ hơn 2026.1.29 có thể bị chiếm quyền chỉ qua một đường link độc | Cập nhật thường xuyên bằng openclaw update; đã vá từ bản 2026.1.29 |
| Lệnh cài cắm (prompt injection) | Trang web, email, tài liệu chứa chỉ dẫn ẩn khiến tác tử làm điều bạn không muốn | Dùng mô hình mạnh, hạn chế công cụ quyền cao, không cho tác tử tự đọc nội dung lạ rồi tự hành động |
| Skill độc hại | Skill cộng đồng chứa chỉ dẫn hoặc script gây hại | Chỉ cài skill đã đọc qua, xem kết quả quét trên ClawHub |
| Mở Gateway ra Internet | Người ngoài truy cập bảng điều khiển, điều khiển trợ lý | Giữ mặc định loopback; cần truy cập từ xa thì dùng Tailscale hoặc proxy có xác thực |
| Lộ khóa API | Khóa trong cấu hình, nhật ký bị lộ, người khác dùng bằng tiền của bạn | Không chia sẻ thư mục ~/.openclaw, đặt giới hạn chi tiêu, đổi khóa ngay khi nghi lộ |
| Workspace không phải hộp cách ly | Tác tử vẫn đọc ghi được file ngoài workspace bằng đường dẫn tuyệt đối | Bật sandbox nếu cần cách ly; chạy trên máy riêng, không phải máy chứa dữ liệu quan trọng |
Thông tin CVE theo cơ sở dữ liệu OSV. Một lệnh kiểm tra bạn nên chạy định kỳ, nhất là sau khi đổi cấu hình:
openclaw security auditThêm một nguyên tắc từ tài liệu: mỗi Gateway là một vùng tin cậy. Chia sẻ một OpenClaw cho cả nhóm được, nhưng chỉ giữa những người tin nhau. Người không tin nhau cần Gateway, tài khoản và tốt nhất là máy riêng. Đừng biến OpenClaw thành bot trả lời công khai cho khách hàng khi chưa giới hạn công cụ của nó.
Cập nhật, sao lưu và gỡ cài đặt
Cập nhật nên chạy từ Terminal thay vì nhờ tác tử tự cập nhật, vì quá trình này có thể khởi động lại Gateway giữa chừng:
openclaw update
openclaw update statusCó các kênh phát hành stable, beta, dev; người mới nên ở stable.
Sao lưu trước khi thay đổi lớn: openclaw backup create. Workspace nên có thêm một kho Git riêng tư.
Gỡ cài đặt: openclaw uninstall hỏi bạn muốn gỡ phần nào: dịch vụ chạy nền, cấu hình và dữ liệu, workspace, ứng dụng macOS. Chạy thử trước với openclaw uninstall --dry-run để xem nó sẽ xóa gì. Lệnh này không gỡ chính chương trình OpenClaw; phần đó gỡ theo cách bạn đã cài (ví dụ npm uninstall -g openclaw).
Lỗi thường gặp
| Hiện tượng | Nguyên nhân thường gặp | Cách xử lý |
|---|---|---|
| Không biết lỗi ở đâu | Nhiều khả năng | Chạy openclaw triage: kiểm tra chỉ đọc rồi tóm tắt chẩn đoán; hoặc openclaw doctor |
| Báo lỗi phiên bản Node | Node cũ (thường là 22) | Cài Node 24.16+ hoặc 26, hoặc dùng script cài chính thức |
| Windows báo "openclaw not recognized" | Đường dẫn chưa cập nhật sau khi cài | Mở lại PowerShell; vẫn lỗi thì dùng Windows Hub |
| Bot Telegram hay Zalo không trả lời | Sai token, chưa duyệt ghép đôi, Gateway tắt | openclaw channels status --probe, openclaw pairing list, openclaw logs --follow |
| Mã ghép đôi không dùng được | Mã quá 1 giờ | Nhắn lại cho bot để nhận mã mới |
| Mã QR Zalo ClawBot hết hạn | QR chỉ có hiệu lực 5 phút | Chạy lại lệnh đăng nhập để tạo mã mới |
| Lỗi 429 từ nhà cung cấp mô hình | Hết hạn mức của gói hoặc tài khoản API | Chờ làm mới, nâng hạn mức, hoặc đặt mô hình dự phòng (fallback) |
| Trợ lý ngừng khi gập laptop | Máy ngủ | Chạy trên máy luôn bật hoặc VPS |
| Chat đầy tin nhắn hệ thống | Đang bật verbose, trace hoặc reasoning | Gửi /verbose off, /trace off, /reasoning off |
OpenClaw khác gì Claude Code, Cursor, ZeroClaw?
| Công cụ | Là gì | Hợp với |
|---|---|---|
| OpenClaw | Trợ lý chạy liên tục, nhắn qua ứng dụng chat, có trí nhớ và lịch tự động | Việc văn phòng, bản tin, nhắc việc, tự động hóa, giao việc từ điện thoại |
| Claude Code | Tác tử lập trình trong Terminal và trình soạn code | Viết, sửa code trong một dự án |
| Cursor | Trình soạn code có AI, nền VS Code | Lập trình hằng ngày, xem và duyệt thay đổi trực quan |
| ZeroClaw | Dự án tác tử tự lưu trữ khác, viết bằng Rust, nhắm tới nhẹ và nhanh | Người muốn so sánh các lựa chọn tự lưu trữ |
Các công cụ này bổ sung cho nhau: OpenClaw dùng lại được đăng nhập Claude Code hoặc Codex trên cùng máy. Muốn điều phối nhiều tác tử như một "công ty", xem thêm Paperclip AI là gì.
Học OpenClaw ở đâu
Nguồn đáng tin nhất là docs.openclaw.ai: mục Getting started để cài, mục FAQ trả lời gần hết câu hỏi của người mới, mục Security nên đọc trước khi nối kênh hay mở công cụ quyền cao. Kho mã và ghi chú phát hành ở github.com/openclaw/openclaw.
Nếu bạn muốn dùng AI để tự làm sản phẩm chứ không chỉ để trợ lý, đọc hướng dẫn tự học vibe code từ A–Z và bài công cụ vibe code cho người mới. Trước khi cho bất kỳ tác tử AI nào chạm vào dữ liệu thật, đi qua checklist trong bài rủi ro khi vibe code.
Muốn học có người kèm? Tấn Phát Digital có khóa học vibe code cho người mới, học online qua Zoom hoặc Google Meet trong 3 ngày, học phí 10 triệu đồng. Hết khóa, mỗi học viên có một website giới thiệu nhiều trang chạy trên tên miền riêng, có form liên hệ, đã đưa lên Google, và biết cách tự sửa nội dung, tự thêm tính năng bằng AI. Liên hệ Tấn Phát Digital để hỏi lịch khai giảng.












