# 🦞 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](https://molt.bot) · [Tài liệu](https://docs.molt.bot) · [Bắt đầu](./docs/start/getting-started.vi.md) · [Cập nhật](./docs/install/updating.vi.md) · [Showcase](./docs/start/showcase.vi.md) · [FAQ](./docs/start/faq.vi.md) · [Wizard](./docs/start/wizard.vi.md) · [Nix](https://github.com/moltbot/nix-clawdbot) · [Docker](./docs/install/docker.vi.md) · [Discord](https://discord.gg/clawd) --- ### 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](./docs/start/getting-started.vi.md) ### Đăng ký (OAuth) - Cần chuẩn bị gì? - **[Anthropic](https://www.anthropic.com/)** (Claude Pro/Max) - **[OpenAI](https://openai.com/)** (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](./docs/start/onboarding.vi.md). ## Quản lý Models - Cấu hình Model + CLI: [Models](./docs/concepts/models.vi.md) - Cơ chế tự động chuyển đổi (Failover) và xoay vòng profile (OAuth vs API keys): [Model failover](./docs/concepts/model-failover.vi.md) ## Cài đặt (Khuyên dùng) Yêu cầu: **Node ≥22**. ```bash 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](./docs/start/getting-started.vi.md) ```bash # 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](./docs/install/updating.vi.md) (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](./docs/install/development-channels.vi.md). ## 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. ```bash 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](./docs/gateway/security/index.vi.md) 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