Moltbot 🦞

"LỘT XÁC! LỘT XÁC!" — Một chú tôm hùm không gian, chắc vậy.

Cổng kết nối AI cho mọi hệ điều hành + WhatsApp/Telegram/Discord/iMessage.
Các Plugin bổ sung thêm Mattermost và nhiều hơn nữa.
Gửi một tin nhắn, nhận phản hồi từ Agent — ngay trong túi của bạn.

GitHub · Bản phát hành · Tài liệu · Thiết lập trợ lý Moltbot

Moltbot kết nối WhatsApp (qua WhatsApp Web / Baileys), Telegram (Bot API / grammY), Discord (Bot API / discord.js), và iMessage (imsg CLI) tới các Agent lập trình như Pi. Các Plugin bổ sung thêm Mattermost và nhiều nền tảng khác. Moltbot cũng là nền tảng vận hành Clawd, chú trợ lý tôm hùm không gian.

Bắt đầu tại đây

Cài đặt mới từ đầu: Hướng dẫn bắt đầu
Thiết lập theo hướng dẫn (khuyên dùng): Trình hướng dẫn - Wizard (moltbot onboard)
Mở bảng điều khiển (Local Gateway): http://localhost:18789/

Nếu Gateway đang chạy trên máy tính của bạn, liên kết trên sẽ mở giao diện điều khiển (Control UI) ngay lập tức. Nếu không tải được, hãy khởi động Gateway trước bằng lệnh: moltbot gateway.

Bảng điều khiển (Giao diện điều khiển Web)

Bảng điều khiển là nơi bạn có thể trò chuyện, cấu hình hệ thống, quản lý nút mạng và các phiên làm việc.

Địa chỉ cục bộ: http://127.0.0.1:18789/
Truy cập từ xa: Bề mặt giao diện Web và Tailscale

Cơ chế hoạt động

Hầu hết các hoạt động đều đi qua Gateway (moltbot gateway), một tiến trình chạy ngầm duy nhất quản lý các kết nối kênh nhắn tin và quyền điều khiển WebSocket.

Mô hình mạng

Mỗi máy chủ một Gateway (khuyên dùng): Đây là tiến trình duy nhất được phép quản lý phiên WhatsApp Web.
Ưu tiên nội bộ (Loopback): WebSocket của Gateway mặc định chạy tại ws://127.0.0.1:18789.
Nút mạng (Nodes): Kết nối tới Gateway qua mạng nội bộ, Tailscale hoặc SSH.
Truy cập từ xa: Sử dụng SSH tunnel hoặc Tailscale; xem Truy cập từ xa.

Các tính năng chính (Tóm tắt)

📱 Tích hợp WhatsApp — Sử dụng giao thức WhatsApp Web.
✈️ Bot Telegram — Chat riêng tư (DM) + Nhóm qua Bot API.
🎮 Bot Discord — Chat riêng tư + Các kênh trong máy chủ.
💬 iMessage — Tích hợp qua công cụ dòng lệnh trên macOS.
🤖 Cầu nối Agent — Kết nối với Pi (chế độ RPC) với khả năng truyền phát dữ liệu.
🧠 Điều hướng đa Agent — Phân chia tài khoản/người dùng cho các Agent riêng biệt (cách ly không gian làm việc).
🔐 Xác thực thuê bao — Hỗ trợ Anthropic (Claude Pro/Max) + OpenAI (ChatGPT/Codex) qua OAuth.
👥 Hỗ trợ Chat nhóm — Mặc định dựa trên việc nhắc tên (@mention).
📎 Hỗ trợ Đa phương tiện — Gửi và nhận hình ảnh, âm thanh, tài liệu.
🖥️ WebChat & App macOS — Giao diện cục bộ và ứng dụng trên thanh menu.

Bắt đầu nhanh

Yêu cầu hệ thống: Node ≥ 22.

# Cài đặt qua npm (khuyên dùng)
npm install -g moltbot@latest

# Thiết lập và cài đặt dịch vụ chạy ngầm
moltbot onboard --install-daemon

# Đăng nhập WhatsApp (hiển thị mã QR)
moltbot channels login

Tài liệu chi tiết

Trung tâm hướng dẫn:
- Trung tâm trợ giúp ← Cách sửa lỗi & Xử lý sự cố
- Cấu hình hệ thống
- Các lệnh dòng lệnh (Slash commands)
- Điều hướng đa Agent
- Cập nhật & Quay lại phiên bản cũ
- Quản lý Nút mạng (iOS/Android)
- Giao diện Web (Control UI)

Bản quyền

MIT — Tự do như chú tôm hùm giữa đại dương 🦞

4.8 KiB Raw Blame History