Nhiều Gateway (trên cùng một máy chủ)
Hầu hết các thiết lập nên sử dụng một Gateway vì một Gateway có thể xử lý nhiều kết nối tin nhắn và agent. Nếu cần cách ly mạnh hơn hoặc dự phòng (ví dụ, một bot cứu hộ), hãy chạy các Gateway riêng biệt với cấu hình và cổng riêng.
Danh sách kiểm tra cách ly (bắt buộc)
OPENCLAW_CONFIG_PATH — file cấu hình cho từng instance
OPENCLAW_STATE_DIR — phiên, thông tin xác thực, bộ nhớ đệm cho từng instance
agents.defaults.workspace — thư mục gốc workspace cho từng instance
gateway.port (hoặc --port) — duy nhất cho từng instance
- Các cổng phát sinh (trình duyệt/canvas) không được trùng lặp
Nếu các yếu tố này được chia sẻ, bạn sẽ gặp xung đột cấu hình và cổng.
Khuyến nghị: sử dụng profile (--profile)
Profile tự động định phạm vi cho OPENCLAW_STATE_DIR + OPENCLAW_CONFIG_PATH và thêm hậu tố vào tên dịch vụ.
Dịch vụ theo profile:
Hướng dẫn bot cứu hộ
Chạy một Gateway thứ hai trên cùng máy chủ với:
- profile/cấu hình riêng
- thư mục trạng thái riêng
- workspace riêng
- cổng cơ sở (và các cổng phát sinh)
Điều này giúp bot cứu hộ cách ly khỏi bot chính để có thể gỡ lỗi hoặc áp dụng thay đổi cấu hình nếu bot chính bị ngừng hoạt động.
Khoảng cách cổng: để ít nhất 20 cổng giữa các cổng cơ sở để các cổng trình duyệt/canvas/CDP phát sinh không bị trùng.
Cách cài đặt (bot cứu hộ)
Ánh xạ cổng (phát sinh)
Cổng cơ sở = gateway.port (hoặc OPENCLAW_GATEWAY_PORT / --port).
- cổng dịch vụ điều khiển trình duyệt = cơ sở + 2 (chỉ loopback)
- máy chủ canvas được phục vụ trên máy chủ HTTP của Gateway (cùng cổng với
gateway.port)
- Các cổng CDP của profile trình duyệt tự động phân bổ từ
browser.controlPort + 9 .. + 108
Nếu bạn ghi đè bất kỳ cổng nào trong cấu hình hoặc môi trường, hãy đảm bảo chúng duy nhất cho từng instance.
Lưu ý về Browser/CDP (lỗi thường gặp)
- Không ghim
browser.cdpUrl vào cùng giá trị trên nhiều instance.
- Mỗi instance cần cổng điều khiển trình duyệt và dải CDP riêng (phát sinh từ cổng gateway của nó).
- Nếu cần cổng CDP cụ thể, đặt
browser.profiles.<name>.cdpPort cho từng instance.
- Chrome từ xa: sử dụng
browser.profiles.<name>.cdpUrl (cho từng profile, từng instance).
Ví dụ môi trường thủ công
Kiểm tra nhanh
Lần sửa đổi cuối 22 tháng 3, 2026