> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Thiết lập Gateway từ xa > Nội dung này đã được hợp nhất vào [Truy cập từ xa](/vi/gateway/remote#macos-persistent-ssh-tunnel-via-launchagent). Xem trang đó để biết hướng dẫn hiện tại. # Chạy OpenClaw\.app với Gateway từ xa OpenClaw\.app dùng đường hầm SSH để kết nối đến một gateway từ xa. Hướng dẫn này chỉ cho bạn cách thiết lập. ## Tổng quan ```mermaid theme={"theme":{"light":"min-light","dark":"min-dark"}} flowchart TB subgraph Client["Client Machine"] direction TB A["OpenClaw.app"] B["ws://127.0.0.1:18789\n(local port)"] T["SSH Tunnel"] A --> B B --> T end subgraph Remote["Remote Machine"] direction TB C["Gateway WebSocket"] D["ws://127.0.0.1:18789"] C --> D end T --> C ``` ## Thiết lập nhanh ### Bước 1: Thêm cấu hình SSH Chỉnh sửa `~/.ssh/config` và thêm: ```ssh theme={"theme":{"light":"min-light","dark":"min-dark"}} Host remote-gateway HostName # e.g., 172.27.187.184 User # e.g., jefferson LocalForward 18789 127.0.0.1:18789 IdentityFile ~/.ssh/id_rsa ``` Thay `` và `` bằng các giá trị của bạn. ### Bước 2: Sao chép khóa SSH Sao chép khóa công khai của bạn sang máy từ xa (nhập mật khẩu một lần): ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} ssh-copy-id -i ~/.ssh/id_rsa @ ``` ### Bước 3: Cấu hình xác thực Gateway từ xa ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw config set gateway.remote.token "" ``` Dùng `gateway.remote.password` thay thế nếu gateway từ xa của bạn dùng xác thực bằng mật khẩu. `OPENCLAW_GATEWAY_TOKEN` vẫn hợp lệ như một ghi đè ở cấp shell, nhưng thiết lập remote-client bền vững là `gateway.remote.token` / `gateway.remote.password`. ### Bước 4: Khởi động đường hầm SSH ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} ssh -N remote-gateway & ``` ### Bước 5: Khởi động lại OpenClaw\.app ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # Quit OpenClaw.app (⌘Q), then reopen: open /path/to/OpenClaw.app ``` Ứng dụng giờ sẽ kết nối đến gateway từ xa thông qua đường hầm SSH. *** ## Tự động khởi động đường hầm khi đăng nhập Để đường hầm SSH tự động khởi động khi bạn đăng nhập, hãy tạo một Launch Agent. ### Tạo tệp PLIST Lưu nội dung này dưới dạng `~/Library/LaunchAgents/ai.openclaw.ssh-tunnel.plist`: ```xml theme={"theme":{"light":"min-light","dark":"min-dark"}} Label ai.openclaw.ssh-tunnel ProgramArguments /usr/bin/ssh -N remote-gateway KeepAlive RunAtLoad ``` ### Tải Launch Agent ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} launchctl bootstrap gui/$UID ~/Library/LaunchAgents/ai.openclaw.ssh-tunnel.plist ``` Đường hầm giờ sẽ: * Tự động khởi động khi bạn đăng nhập * Khởi động lại nếu bị sập * Tiếp tục chạy trong nền Ghi chú cũ: gỡ mọi LaunchAgent `com.openclaw.ssh-tunnel` còn sót lại nếu có. *** ## Khắc phục sự cố **Kiểm tra đường hầm có đang chạy không:** ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} ps aux | grep "ssh -N remote-gateway" | grep -v grep lsof -i :18789 ``` **Khởi động lại đường hầm:** ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} launchctl kickstart -k gui/$UID/ai.openclaw.ssh-tunnel ``` **Dừng đường hầm:** ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} launchctl bootout gui/$UID/ai.openclaw.ssh-tunnel ``` *** ## Cách hoạt động | Thành phần | Chức năng | | ------------------------------------ | ------------------------------------------------------- | | `LocalForward 18789 127.0.0.1:18789` | Chuyển tiếp cổng cục bộ 18789 đến cổng từ xa 18789 | | `ssh -N` | SSH mà không thực thi lệnh từ xa (chỉ chuyển tiếp cổng) | | `KeepAlive` | Tự động khởi động lại đường hầm nếu bị sập | | `RunAtLoad` | Khởi động đường hầm khi agent được tải | OpenClaw\.app kết nối đến `ws://127.0.0.1:18789` trên máy khách của bạn. Đường hầm SSH chuyển tiếp kết nối đó đến cổng 18789 trên máy từ xa nơi Gateway đang chạy. ## Liên quan * [Truy cập từ xa](/vi/gateway/remote) * [Tailscale](/vi/gateway/tailscale)