OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Platforms overview

Ứng dụng Linux

Gateway được hỗ trợ đầy đủ trên Linux. Node là runtime được khuyến nghị; Bun không được khuyến nghị (đã biết có vấn đề với WhatsApp/Telegram).

Hiện chưa có ứng dụng đồng hành gốc cho Linux. Chúng tôi hoan nghênh các đóng góp.

Cách nhanh (VPS)

  1. Cài đặt Node 24 (khuyến nghị) hoặc Node 22.19+ (LTS, vẫn được hỗ trợ).
  2. npm i -g openclaw@latest
  3. openclaw onboard --install-daemon
  4. Từ máy tính xách tay của bạn: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
  5. Mở http://127.0.0.1:18789/ và xác thực bằng bí mật dùng chung đã cấu hình (mặc định là token; mật khẩu nếu gateway.auth.mode là "password").

Hướng dẫn máy chủ đầy đủ: Máy chủ Linux. Ví dụ VPS từng bước: exe.dev.

Cài đặt

Dịch vụ Gateway (systemd)

Cài đặt bằng một trong các lệnh sau:

bash
openclaw onboard --install-daemonopenclaw gateway installopenclaw configure   # chọn "Gateway service" khi được nhắc

Sửa chữa hoặc di chuyển một bản cài đặt hiện có:

bash
openclaw doctor

Theo mặc định, openclaw gateway install tạo một unit systemd cấp người dùng. Hướng dẫn dịch vụ đầy đủ, bao gồm biến thể unit cấp hệ thống dành cho các máy chủ dùng chung hoặc luôn hoạt động, có trong cẩm nang vận hành Gateway.

Chỉ tự viết unit cho thiết lập tùy chỉnh. Ví dụ unit người dùng tối thiểu (~/.config/systemd/user/openclaw-gateway[-<profile>].service):

ini
[Unit]Description=OpenClaw Gateway (profile: <profile>, v<version>)After=network-online.targetWants=network-online.targetStartLimitBurst=5StartLimitIntervalSec=60 [Service]ExecStart=/usr/local/bin/openclaw gateway --port 18789Restart=alwaysRestartSec=5RestartPreventExitStatus=78TimeoutStopSec=30TimeoutStartSec=30SuccessExitStatus=0 143OOMPolicy=continueKillMode=control-group [Install]WantedBy=default.target

Bật unit:

bash
systemctl --user enable --now openclaw-gateway[-<profile>].service

Áp lực bộ nhớ và việc tiến trình bị kết thúc do OOM

Trên Linux, kernel chọn một tiến trình nạn nhân của OOM khi máy chủ, máy ảo hoặc cgroup của container hết bộ nhớ. Gateway không phải là lựa chọn phù hợp để bị kết thúc vì nó quản lý các phiên tồn tại lâu dài và kết nối kênh, do đó OpenClaw ưu tiên để các tiến trình con tạm thời bị kết thúc trước khi có thể.

Đối với các tiến trình con đủ điều kiện trên Linux, OpenClaw bọc lệnh trong một shim /bin/sh ngắn để tăng oom_score_adj của chính tiến trình con lên 1000, sau đó dùng exec chạy lệnh thực tế. Thao tác này không yêu cầu đặc quyền: một tiến trình luôn có thể tăng điểm OOM của chính nó.

Các bề mặt tiến trình con được áp dụng:

  • Tiến trình con của lệnh do trình giám sát quản lý
  • Tiến trình con của shell PTY
  • Tiến trình con của máy chủ MCP qua stdio
  • Các tiến trình trình duyệt/Chrome do OpenClaw khởi chạy (thông qua runtime tiến trình của SDK Plugin)

Trình bọc chỉ dành cho Linux và bị bỏ qua khi /bin/sh không khả dụng hoặc khi môi trường của tiến trình con đặt OPENCLAW_CHILD_OOM_SCORE_ADJ thành 0, false, no hoặc off.

Xác minh một tiến trình con:

bash
cat /proc/<child-pid>/oom_score_adj

Giá trị dự kiến cho các tiến trình con được áp dụng là 1000; bản thân tiến trình Gateway giữ điểm số thông thường (thường là 0).

OOMPolicy=continue của unit systemd giữ cho dịch vụ Gateway tiếp tục hoạt động khi một tiến trình con tạm thời bị trình kết thúc OOM chọn, thay vì đánh dấu toàn bộ unit là thất bại và khởi động lại tất cả các kênh; tiến trình con hoặc phiên thất bại sẽ báo cáo lỗi riêng.

Điều này không thay thế việc tinh chỉnh bộ nhớ thông thường. Nếu VPS hoặc container liên tục kết thúc các tiến trình con, hãy tăng giới hạn bộ nhớ, giảm mức đồng thời hoặc thêm các biện pháp kiểm soát tài nguyên mạnh hơn (MemoryMax= của systemd, giới hạn bộ nhớ container).

Liên quan

Was this useful?
On this page

On this page