2.5 KiB
2.5 KiB
| title | summary | read_when | |
|---|---|---|---|
| Fly.io | Hướng dẫn triển khai Moltbot trên nền tảng Fly.io với bộ nhớ lưu trữ vĩnh viễn |
|
Triển khai trên Fly.io
Mục tiêu: Chạy Moltbot Gateway trên một máy chủ Fly.io với ổ cứng lưu trữ bền vững, tự động cấu hình HTTPS và có khả năng truy cập qua Discord/Telegram.
Các bước chuẩn bị
- Đã cài đặt công cụ flyctl CLI.
- Tài khoản Fly.io (Gói miễn phí là đủ dùng).
- Khóa API của nhà cung cấp AI (Anthropic, OpenAI, v.v.).
Lộ trình thực hiện nhanh
-
Tạo ứng dụng Fly:
git clone https://github.com/moltbot/moltbot.git cd moltbot fly apps create ten-ứng-dụng-của-bạn -
Tạo ổ cứng lưu trữ (Volume):
fly volumes create moltbot_data --size 1 --region iad -
Thiết lập bí mật (Secrets):
# Bắt buộc: Mã xác thực Gateway fly secrets set CLAWDBOT_GATEWAY_TOKEN=$(openssl rand -hex 32) # Khóa API AI fly secrets set ANTHROPIC_API_KEY=sk-ant-... -
Triển khai:
fly deploy
Các cấu hình quan trọng trong fly.toml
Để Bot hoạt động ổn định trên Fly.io, bạn cần lưu ý:
- Bộ nhớ (RAM): Fly mặc định cấp 512MB, nhưng mức này thường gây lỗi tràn bộ nhớ (OOM). Hãy nâng lên ít nhất 1GB (1024mb) hoặc tốt nhất là 2GB.
- Địa chỉ IP: Webhook của Moltbot cần IP để nhận tin nhắn. Bạn có thể chọn triển khai công khai (Public) hoặc riêng tư (Private) qua mạng WireGuard/Tailscale.
- Lưu trữ trạng thái: Đảm bảo biến
CLAWDBOT_STATE_DIRtrỏ tới thư mục/data(nơi gắn ổ cứng đã tạo ở bước 2).
Xử lý sự cố thường gặp
- Lỗi Gateway Lock: Nếu công nương (container) bị khởi động lại đột ngột, tệp khóa có thể còn sót lại trên ổ cứng. Hãy dùng
fly ssh consoleđể xóa tệp/data/gateway.*.lock. - Lỗi bộ nhớ: Nếu Bot liên tục bị sập và khởi động lại, hãy nâng cấp RAM của máy ảo Fly bằng lệnh:
fly machine update <id> --vm-memory 2048.
Tài liệu liên quan: Thuê máy chủ VPS, Cấu hình Gateway.