Tài liệu OpenClaw đầy đủ: trợ lý AI mã nguồn mở chạy trên chính máy tính của bạn. Thay vì mở trình duyệt vào một trang web để hỏi, bạn nhắn tin cho nó qua Telegram, Zalo, WhatsApp hay Slack — những ứng dụng bạn vẫn dùng hằng ngày — và nó làm việc trên máy bạn.

Chương đầu giải thích điều gì làm nên khác biệt khi tự vận hành. Một dịch vụ AI trên mạng chỉ đọc được thứ bạn dán vào ô chat. OpenClaw chạy trên máy bạn nên nó mở được tệp trong ổ đĩa, chạy lệnh, gửi thư, và nhắn tin thay bạn — trong phạm vi bạn cho phép. Một bảng đối chiếu nêu rõ phần mềm chạy ở đâu, dữ liệu đi đâu, có đọc được tệp trong máy không, có chạy được lệnh không, có nhắn tin thay bạn không, và mỗi cách tốn kém thế nào. Tài liệu cũng nói thẳng OpenClaw không tự nó biết suy nghĩ: nó cần một mô hình AI đứng sau, của OpenAI, Anthropic, Google, hoặc một mô hình chạy ngay trên máy bạn.

Tài liệu ghi lại hai tên cũ của dự án — Clawd và Moltbot — cùng lần đổi tên tháng 1 năm 2026 sau yêu cầu về nhãn hiệu, để bạn biết bài viết cũ trên mạng vẫn đúng về ý tưởng nhưng sai về tên lệnh và đường dẫn tệp. Tài liệu cũng giải thích các tên xoay quanh hình con tôm hùm trong tài liệu chính thức — Molty, gateway, ClawHub, Claw và Moltiverse — để bạn khỏi mất thì giờ tìm ý nghĩa kỹ thuật trong những chữ chỉ là tên riêng. Phiên bản, giấy phép, cách dự án được vận hành và phần mềm gửi đi những gì về nhà sản xuất đều được ghi rõ, kèm danh sách những thứ không bao giờ gửi đi: nội dung hội thoại, tin nhắn, tên mô hình, khoá API, đường dẫn tệp và định danh máy.

Cài đặt gồm máy cần gì trước khi cài, cài trên macOS và Linux, cài trên Windows qua ứng dụng Windows Hub hoặc PowerShell hoặc WSL2, thiết lập ban đầu với Quick start hoặc Custom setup, kiểm tra sau khi cài bằng bốn lệnh chỉ đọc, và gỡ cài rồi cài lại cho đúng cách.

Bốn lối vào gồm bảng điều khiển web, dòng lệnh, cửa sổ trò chuyện trong terminal, và ứng dụng nhắn tin — kèm giải thích cả bốn dùng chung một phiên làm việc và một bộ nhớ, nên bạn hỏi trong Telegram rồi hỏi tiếp trong cửa sổ dòng lệnh, nó vẫn nhớ câu trước.

Tệp cấu hình gồm mọi thứ OpenClaw nhớ đều nằm trong một thư mục duy nhất, các tệp quan trọng và công dụng, cách viết tệp cấu hình, cách sửa cấu hình mà không mở tệp, cách khai khoá bí mật cho đúng, và cách chạy nhiều bản riêng biệt trên một máy.

Các kênh gồm nối Telegram như cách dễ nhất để bắt đầu, nối Zalo với ba kênh khác nhau và cách chọn đúng kênh, nối WhatsApp, Discord, Slack và các kênh còn lại — cùng phần ai được nhắn tin cho trợ lý của bạn.

Mô hình AI và nhà cung cấp gồm cách OpenClaw gọi tên mô hình theo dạng provider/model, thứ tự chọn mô hình với mô hình chính cùng danh sách dự phòng và xoay vòng khoá, bốn cách khai khoá API, danh sách nhà cung cấp được hỗ trợ sẵn, mô hình phụ cho việc rẻ và việc quyết định cùng mô hình ảnh và mô hình PDF, chạy mô hình cục bộ với Ollama và LM Studio, và theo dõi hạn mức cùng chi phí gọi mô hình.

Agent, phiên làm việc và quyền hạn gồm một agent chứa những gì, các tệp định danh trong không gian làm việc, chạy nhiều agent và định tuyến kênh về đúng agent, khoá phiên cùng phạm vi cùng khởi tạo lại và nén ngữ cảnh, bốn chế độ quyền của phiên, bộ công cụ theo hồ sơ từ minimal qua messaging và coding tới full, nhịp tim để trợ lý chủ động lên tiếng, và bộ chạy agent gồm runtime nhúng, Codex, Claude CLI, Gemini CLI và Copilot.

Công cụ và kỹ năng gồm công cụ exec và việc agent chạy lệnh thật trên máy bạn, chính sách công cụ cho phép và cấm, kỹ năng là gì và tệp SKILL.md viết ra sao, các trường khai báo trong SKILL.md, thứ tự nạp kỹ năng và mức ưu tiên, quản lý kỹ năng từ dòng lệnh và từ ClawHub, và các lệnh gạch chéo dùng trong khung chat.

Phần mở rộng và ClawHub gồm plugin OpenClaw là gì và có những loại nào, cách cài plugin bằng lệnh, kiểm tra tương thích plugin qua pluginApi và minGatewayVersion, ClawHub là gì, dùng CLI để đăng nhập và tìm và công bố, tự viết một kỹ năng rồi công bố, và biến môi trường ClawHub cùng cách tắt telemetry.

Tự động hoá gồm năm cơ chế tự động hoá trong OpenClaw và cách chọn, tác vụ hẹn giờ, nhịp tim là tác vụ giám sát nền mặc định, tác vụ nền cùng luồng tác vụ, móc sự kiện và chỉ thị thường trực, webhook HTTP gọi vào gateway cùng trigger Gmail và email IMAP, và ba ví dụ tự động hoá dùng được ngay.

Vận hành gateway gồm gateway là gì và nó mở những cổng nào, khởi động và dừng và cài làm dịch vụ nền, chạy gateway như dịch vụ trên macOS và Linux và Windows, đọc nhật ký gateway, truy cập từ xa qua Tailscale hoặc đường hầm SSH, chạy nhiều gateway trên cùng một máy, bộ lệnh vận hành hằng ngày, và kênh cập nhật cùng sao lưu và quản nhiều gateway bằng fleet.

Bảo mật và ranh giới tin cậy gồm hiểu đúng rủi ro, vì sao một gateway là một ranh giới tin cậy, các mặc định an toàn có sẵn, sáu lớp phân quyền xếp chồng, sandbox, xác thực gateway, tiêm lệnh qua nội dung ngoài, bí mật nằm trên đĩa, và danh mục kiểm trước khi cho người khác nhắn tin cho trợ lý.

Xử lý sự cố gồm thang lệnh sáu mươi giây đầu, chín nhánh của cây quyết định, chữ ký nhật ký và nguyên nhân, lỗi lúc cài đặt, cấu hình sai làm gateway không khởi động, sự cố theo từng kênh, cổng bị chiếm và nhiều bản gateway cùng chạy, và khi nào nên gỡ cài rồi cài lại.

Phụ lục gồm cờ toàn cục, mười lăm nhóm lệnh, lệnh hay dùng theo đầu việc, lệnh gạch chéo trong cửa sổ chat và quy ước --json, cùng bảng thuật ngữ Anh - Việt chạy từ A đến Z.

Viết song ngữ Việt - Anh cạnh nhau, để bạn đọc hiểu bằng tiếng Việt mà vẫn khớp đúng tên lệnh và khoá cấu hình mà phần mềm yêu cầu. Phiên bản 1.0, tháng 9/2026.