Triển khai trên Railway | Docs

Triển khai OpenClaw trên Railway chỉ với một cú nhấp chuột, toàn bộ quá trình thiết lập diễn ra ngay trên trình duyệt. Đây là cách đơn giản nhất nếu bạn không muốn động vào terminal phía server — Railway lo phần Gateway, còn bạn cấu hình mọi thứ qua trình hướng dẫn /setup.

Danh sách nhanh (cho người mới)

Nhấn Deploy on Railway (bên dưới).
Thêm một Volume gắn vào /data.
Đặt các biến môi trường bắt buộc (ít nhất là SETUP_PASSWORD).
Bật HTTP Proxy trên cổng 8080.
Mở https://<your-railway-domain>/setup và hoàn tất trình hướng dẫn.

Triển khai một cú nhấp

Deploy on Railway

Sau khi triển khai xong, tìm URL công khai tại Railway → dịch vụ của bạn → Settings → Domains.

Railway sẽ:

cấp cho bạn một tên miền tự động (thường là https://<something>.up.railway.app), hoặc
dùng tên miền riêng nếu bạn đã gắn vào.

Sau đó mở:

https://<your-railway-domain>/setup — trình hướng dẫn cài đặt (có mật khẩu bảo vệ)
https://<your-railway-domain>/openclaw — giao diện điều khiển

Bạn được gì

OpenClaw Gateway + giao diện điều khiển được lưu trữ sẵn
Trình hướng dẫn cài đặt qua web tại /setup (không cần gõ lệnh)
Lưu trữ bền vững qua Railway Volume (/data) — cấu hình, thông tin xác thực và workspace vẫn còn sau mỗi lần triển khai lại
Xuất bản sao lưu tại /setup/export để di chuyển sang nền tảng khác khi cần

Cấu hình bắt buộc trên Railway

Mạng công khai

Bật HTTP Proxy cho dịch vụ.

Cổng: 8080

Volume (bắt buộc)

Gắn một volume tại:

/data

Biến môi trường

Đặt các biến sau cho dịch vụ:

SETUP_PASSWORD (bắt buộc)
PORT=8080 (bắt buộc — phải khớp với cổng trong phần Public Networking)
OPENCLAW_STATE_DIR=/data/.openclaw (khuyến nghị)
OPENCLAW_WORKSPACE_DIR=/data/workspace (khuyến nghị)
OPENCLAW_GATEWAY_TOKEN (khuyến nghị; coi như mật khẩu quản trị)

Quy trình cài đặt

Truy cập https://<your-railway-domain>/setup và nhập SETUP_PASSWORD.
Chọn nhà cung cấp mô hình/xác thực rồi dán API key vào.
(Tùy chọn) Thêm token Telegram/Discord/Slack.
Nhấn Run setup.

Nếu Telegram DM được đặt ở chế độ ghép nối, trình hướng dẫn có thể phê duyệt mã ghép nối luôn.

Lấy token cho các kênh chat

Token bot Telegram

Nhắn tin cho @BotFather trên Telegram
Gõ /newbot
Sao chép token (dạng 123456789:AA...)
Dán vào /setup

Token bot Discord

Truy cập https://discord.com/developers/applications
New Application → đặt tên
Bot → Add Bot
Bật MESSAGE CONTENT INTENT trong Bot → Privileged Gateway Intents (bắt buộc, nếu không bot sẽ crash ngay khi khởi động)
Sao chép Bot Token rồi dán vào /setup
Mời bot vào server (OAuth2 URL Generator; scopes: bot, applications.commands)

Sao lưu và di chuyển

Tải bản sao lưu tại:

https://<your-railway-domain>/setup/export

File này chứa toàn bộ trạng thái OpenClaw + workspace, giúp bạn chuyển sang máy chủ khác mà không mất cấu hình hay dữ liệu.