openclaw/translation/vietnamese

🦞 Moltbot — Trợ lý AI Cá nhân

LỘT VỎ! LỘT VỎ NÀO! (EXFOLIATE!)

🦞 Moltbot — Trợ lý AI Cá nhân

LỘT VỎ! LỘT VỎ NÀO! (EXFOLIATE!)

Moltbot là trợ lý AI cá nhân vận hành ngay trên thiết bị của bạn.

Nó có mặt trên mọi nền tảng bạn thường dùng (WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, Microsoft Teams, WebChat), và mở rộng sang cả BlueBubbles, Matrix, Zalo hay Zalo Personal. Moltbot có thể Nghe và Nói trên macOS/iOS/Android, thậm chí hiển thị một "Live Canvas" để bạn tương tác trực tiếp. Hãy nhớ: Gateway chỉ là bộ điều khiển trung tâm — sản phẩm thực sự chính là người trợ lý đồng hành cùng bạn.

Nếu bạn đang tìm kiếm một trợ lý ảo riêng tư, chỉ phục vụ mình bạn, chạy cục bộ (local-first), tốc độ phản hồi nhanh và luôn sẵn sàng (always-on), thì Moltbot chính là câu trả lời.

Website · Tài liệu · Bắt đầu · Cập nhật · Showcase · FAQ · Wizard · Nix · Docker · Discord

---

Cài đặt thế nào?

Cách tốt nhất là chạy trình hướng dẫn cài đặt (onboarding wizard): moltbot onboard. Nó sẽ dắt tay chỉ việc bạn qua các bước thiết lập gateway, không gian làm việc (workspace), kết nối kênh chat và cài đặt kỹ năng (skills). CLI wizard này hoạt động mượt mà trên macOS, Linux, và Windows (thông qua WSL2; đặc biệt khuyên dùng).

Hỗ trợ cài đặt qua: npm, pnpm, hoặc bun.

Người dùng mới? Bắt đầu tại đây: Hướng dẫn nhập môn

Đăng ký (OAuth) - Cần chuẩn bị gì?

• Anthropic (Claude Pro/Max)
• OpenAI (ChatGPT/Codex)

Lời khuyên về Model: Mặc dù Moltbot hỗ trợ mọi model, tôi thực sự khuyên bạn nên dùng Anthropic Pro/Max (100/200) + Opus 4.5. Combo này cho khả năng xử lý ngữ cảnh dài (long-context) cực tốt và kháng lại các trò "hack não" (prompt-injection) hiệu quả hơn. Xem thêm tại Onboarding.

Quản lý Models

• Cấu hình Model + CLI: Models
• Cơ chế tự động chuyển đổi (Failover) và xoay vòng profile (OAuth vs API keys): Model failover

Cài đặt (Khuyên dùng)

Yêu cầu: Node ≥22.

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

moltbot onboard --install-daemon

Lệnh trên sẽ cài đặt Gateway daemon (chạy ngầm dưới dạng service launchd/systemd) để trợ lý của bạn luôn trực tuyến. Lưu ý cho người dùng cũ: Lệnh clawdbot vẫn dùng được như một lớp tương thích (shim).

Chạy thử nhanh (Dành cho người bận rộn)

Yêu cầu: Node ≥22.

Hướng dẫn đầy đủ (xác thực, ghép đôi thiết bị, kênh chat): Bắt đầu

# 1. Cài đặt và chạy wizard
moltbot onboard --install-daemon

# 2. Khởi động Gateway
moltbot gateway --port 18789 --verbose

# 3. Gửi thử tin nhắn
moltbot message send --to +1234567890 --message "Xin chào từ Moltbot"

# 4. Ra lệnh cho trợ lý (có thể phản hồi về bất kỳ kênh nào đã kết nối: WhatsApp, Telegram, Zalo...)
moltbot agent --message "Lên danh sách việc cần làm cho việc vận chuyển" --thinking high

Muốn nâng cấp? Xem Hướng dẫn cập nhật (và nhớ chạy moltbot doctor để kiểm tra sức khỏe hệ thống).

Kênh phát triển (Release Channels)

Bạn muốn dùng bản nào?

• stable: Bản ổn định, được gắn thẻ rõ ràng (vYYYY.M.D), npm tag là latest. Khuyên dùng cho môi trường production.
• beta: Bản thử nghiệm (vYYYY.M.D-beta.N), npm tag beta. Tính năng mới nhưng có thể chưa có app macOS đi kèm.
• dev: Bản "mới ra lò" từ nhánh main (bleeding edge), npm tag dev. Dành cho dev thích vọc vạch.

Cách chuyển kênh (git + npm): moltbot update --channel stable|beta|dev. Chi tiết: Các kênh phát triển.

Cài từ mã nguồn (Dành cho Dev)

Ưu tiên dùng pnpm. bun là tùy chọn nếu bạn muốn chạy thẳng TypeScript mà không cần build.

git clone https://github.com/moltbot/moltbot.git
cd moltbot

pnpm install
pnpm ui:build # Tự động cài dependencies cho UI lần đầu
pnpm build

pnpm moltbot onboard --install-daemon

# Chế độ Dev (Tự động reload khi sửa code TS)
pnpm gateway:watch

Lưu ý: pnpm moltbot ... sẽ chạy thẳng TypeScript (qua tsx). pnpm build sẽ tạo thư mục dist/ để chạy như một ứng dụng Node thông thường.

Bảo mật mặc định (Xử lý tin nhắn riêng - DM)

Moltbot kết nối với các ứng dụng nhắn tin thật. Hãy luôn coi các tin nhắn DM gửi đến là dữ liệu không đáng tin cậy (untrusted input).

Đọc kỹ: Hướng dẫn bảo mật

Cơ chế mặc định trên Telegram/WhatsApp/Signal/Zalo...:

• Chế độ Ghép đôi (Pairing Mode) (dmPolicy="pairing"): Người lạ nhắn tin đến sẽ chỉ nhận được một mã ghép đôi ngắn. Bot KHÔNG xử lý hay trả lời nội dung của họ.
• Phê duyệt: Bạn dùng lệnh moltbot pairing approve <kênh> <mã> trên thiết bị admin để thêm người đó vào "Danh sách trắng" (Allowlist).
• Mở công khai (Cẩn thận): Nếu muốn ai cũng chat được, set dmPolicy="open" và thêm "*" vào allowlist (channels.discord.dm.allowFrom).

Chạy moltbot doctor thường xuyên để quét các cấu hình rủi ro.

Tính năng nổi bật

• Gateway ưu tiên cục bộ (Local-first) — Một bộ não điều khiển duy nhất cho mọi phiên làm việc, kênh chat và công cụ.
• Hộp thư đa kênh — Gom tất cả về một mối: WhatsApp, Telegram, Slack, Discord, Zalo, iMessage...
• Định tuyến thông minh — Tự động chia luồng tin nhắn từ các nguồn khác nhau vào các Agent riêng biệt (cô lập workspace và session).
• Voice Wake & Talk Mode — Trò chuyện rảnh tay 24/7 trên macOS/iOS/Android (kết hợp với ElevenLabs).
• Live Canvas — Không gian làm việc trực quan (UI) do Agent tự vẽ và điều khiển thông qua A2UI.
• Hệ sinh thái Công cụ — Điều khiển trình duyệt, vẽ canvas, cron job, và tương tác sâu với Discord/Slack.
• Ứng dụng vệ tinh — App trên thanh menu macOS + Nodes trên điện thoại iOS/Android.
• Kỹ năng (Skills) — Cài đặt và quản lý kỹ năng dễ dàng qua ClawdHub.

Lịch sử phát triển (Star History)

Chúng tôi đã xây dựng những gì?

1. Nền tảng cốt lõi

• Gateway: "Trạm kiểm soát không lưu" xử lý WebSocket, phiên (session), cấu hình, cron, webhooks và giao diện quản lý Control UI.
• CLI: Công cụ dòng lệnh mạnh mẽ để gửi tin, quản lý agent, chạy wizard và sửa lỗi (doctor).
• Pi Agent Runtime: Môi trường chạy Agent hỗ trợ RPC, tool streaming (stream công cụ) và block streaming.
• Mô hình Session: Hỗ trợ chat 1-1 (main), chat nhóm (cô lập ngữ cảnh), chế độ hàng đợi (queue), và tự động phản hồi.
• Xử lý Media: Pipeline xử lý ảnh/âm thanh/video, hook để transcribe (gỡ băng) âm thanh, quản lý file tạm.

2. Kết nối Kênh (Channels)

• Hỗ trợ tận răng: WhatsApp (Baileys), Telegram (grammY), Slack (Bolt), Discord, Google Chat, Signal, iMessage (macOS), Zalo (extension)...
• Định tuyến nhóm: Kiểm soát việc bot trả lời khi nào (khi được tag, hay luôn luôn), phân luồng tin nhắn trong nhóm.

3. Ứng dụng & Nodes

• macOS App: Nằm trên thanh menu, hỗ trợ Voice Wake (gọi dậy bằng giọng nói), Talk Mode (chế độ đàm thoại), và điều khiển Gateway từ xa.
• iOS/Android Node: Biến điện thoại thành "tai mắt" cho Agent (Camera, Canvas, Ghi màn hình, Location).
• macOS Node Mode: Cho phép Agent chạy lệnh hệ thống (system.run) hoặc gửi thông báo (system.notify).

... (Các phần kỹ thuật sâu hơn về Runtime, Ops, Docker, Tailscale được giữ nguyên các liên kết và thuật ngữ chuyên ngành để đảm bảo độ chính xác)

Cách hoạt động (Mô hình tóm tắt)

WhatsApp / Telegram / Slack / Zalo / WebChat ...
               │
               ▼
┌───────────────────────────────┐
│            Gateway            │
│    (Bộ não / Control Plane)   │
│     ws://127.0.0.1:18789      │
└──────────────┬────────────────┘
               │
               ├─ Pi agent (Xử lý logic)
               ├─ CLI (Công cụ dòng lệnh)
               ├─ WebChat UI (Giao diện web)
               ├─ Ứng dụng macOS
               └─ Các node iOS / Android (Vệ tinh)

Truy cập từ xa (Tailscale)

Moltbot tích hợp sâu với Tailscale để bạn truy cập Gateway an toàn từ bất cứ đâu mà không cần mở port rườm rà.

• Serve: Chỉ truy cập được trong mạng nội bộ Tailscale (Tailnet).
• Funnel: Mở ra internet công cộng (Yêu cầu mật khẩu).

Mẹo: Linux là môi trường tuyệt vời để chạy Gateway. Bạn có thể để Gateway ở server Linux, còn Client (CLI, App) ở máy Mac/Phone và kết nối về qua Tailscale.

Cộng đồng

Dự án này được xây dựng cho Molty - một trợ lý AI tôm hùm không gian 🦞, bởi Peter Steinberger và cộng đồng open-source.

Tham gia cùng chúng tôi tại:

• clawd.me
• @moltbot

Xem CONTRIBUTING.vi.md để biết cách đóng góp. Các PR viết code theo cảm hứng (vibe-coded) hoặc dùng AI hỗ trợ đều được chào đón nhiệt liệt! 🤖

---

Cảm ơn tất cả các contributors đã góp phần tạo nên Moltbot!