Cài đặt Moltbot

Yêu cầu

  • Node.js 22+ (bắt buộc)
  • RAM: 4GB+
  • OS: macOS, Linux, hoặc Windows (qua WSL2)

Cài đặt (5 phút)

Bước 1: Cài Moltbot

npm install -g moltbot@latest

Bước 2: Chạy setup wizard

moltbot onboard --install-daemon

Wizard sẽ hỏi:

  1. Chọn AI: Anthropic (Claude) hoặc OpenAI (GPT)
  2. Đăng nhập hoặc nhập API key
  3. Có muốn tự động chạy khi khởi động không? → Yes

Bước 3: Khởi động

moltbot gateway --port 18789 --verbose

Bước 4: Test

moltbot agent --message "Xin chào!"

Nếu thấy trả lời → Thành công!


Thêm kênh chat

WhatsApp (dễ nhất):

moltbot channels login whatsapp
# Quét QR code hiện ra

Telegram:

# 1. Tạo bot qua @BotFather, lấy token
# 2. Cấu hình:
moltbot config set channels.telegram.botToken "YOUR_TOKEN"

Discord:

# 1. Tạo bot trên Discord Developer Portal
# 2. Lấy token
# 3. Cấu hình:
moltbot config set channels.discord.token "YOUR_TOKEN"

Kiểm tra trạng thái

# Kiểm tra tổng thể
moltbot doctor

# Kiểm tra các kênh
moltbot channels status --probe

# Kiểm tra memory
moltbot memory status

Các folder quan trọng

~/.moltbot/              ← Cấu hình & dữ liệu
├── moltbot.json         ← File cấu hình chính
├── credentials/          ← Thông tin đăng nhập các kênh
└── memory/               ← Database tìm kiếm

~/clawd/                  ← Workspace
├── MEMORY.md             ← Memory dài hạn
├── memory/               ← Ghi chú hàng ngày
│   ├── 2026-01-27.md
│   └── ...
├── SOUL.md               ← Tính cách bot
└── USER.md               ← Thông tin về bạn

Tùy chỉnh

Đổi tính cách bot:

Sửa file ~/clawd/SOUL.md:

# Tính cách

Bạn là trợ lý thân thiện, hay dùng emoji 😊
Trả lời ngắn gọn, dễ hiểu.

Thêm thông tin về bạn:

Sửa file ~/clawd/USER.md:

# Thông tin User

- Tên: Thuong
- Ngôn ngữ: Tiếng Việt
- Đang làm: Dự án website bán hàng
- Thích: TypeScript, Next.js

Lỗi thường gặp

Gateway không chạy được:

# Kiểm tra port
ss -ltnp | grep 18789

# Tắt process cũ và chạy lại
pkill -f moltbot
moltbot gateway --force

Kênh không kết nối:

# Đăng nhập lại
moltbot channels login <tên-kênh>

Memory không hoạt động:

# Đồng bộ lại
moltbot memory sync --force

Update

npm update -g moltbot
moltbot doctor

Tóm tắt

  1. Cài đặt: npm install -g moltbot@latest
  2. Setup: moltbot onboard --install-daemon
  3. Chạy: moltbot gateway
  4. Thêm kênh: moltbot channels login <kênh>
  5. Kiểm tra: moltbot doctor