Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Gateway là máy chủ WebSocket của OpenClaw (kênh, nút, phiên, hook). Các lệnh con trong trang này nằm dưới openclaw gateway ….

Bonjour discovery

Thiết lập mDNS cục bộ + DNS-SD diện rộng.

Discovery overview

Cách OpenClaw quảng bá và tìm Gateway.

Configuration

Các khóa cấu hình Gateway cấp cao nhất.

​
Chạy Gateway

Chạy một tiến trình Gateway cục bộ: 
openclaw gateway
Bí danh chạy foreground: 
openclaw gateway run
  • Theo mặc định, Gateway từ chối khởi động trừ khi gateway.mode=local được đặt trong ~/.openclaw/openclaw.json. Dùng --allow-unconfigured cho các lần chạy tạm thời/phát triển.
  • openclaw onboard --mode local và openclaw setup được kỳ vọng sẽ ghi gateway.mode=local. Nếu tệp tồn tại nhưng thiếu gateway.mode, hãy xem đó là cấu hình bị hỏng hoặc bị ghi đè và sửa chữa thay vì ngầm giả định chế độ cục bộ.
  • Nếu tệp tồn tại và thiếu gateway.mode, Gateway xem đó là hư hại cấu hình đáng ngờ và từ chối “đoán local” thay bạn.
  • Việc bind ra ngoài loopback mà không có xác thực sẽ bị chặn (rào chắn an toàn).
  • SIGUSR1 kích hoạt khởi động lại trong tiến trình khi được cho phép (commands.restart được bật theo mặc định; đặt commands.restart: false để chặn khởi động lại thủ công, trong khi gateway tool/config apply/update vẫn được phép).
  • Các handler SIGINT/SIGTERM dừng tiến trình gateway, nhưng chúng không khôi phục bất kỳ trạng thái terminal tùy chỉnh nào. Nếu bạn bọc CLI bằng TUI hoặc đầu vào raw-mode, hãy khôi phục terminal trước khi thoát.

​
Tùy chọn

​
--port <port>
number
Cổng WebSocket (mặc định lấy từ config/env; thường là 18789).
​
--bind <loopback|lan|tailnet|auto|custom>
string
Chế độ bind listener.
​
--auth <token|password>
string
Ghi đè chế độ xác thực.
​
--token <token>
string
Ghi đè token (cũng đặt OPENCLAW_GATEWAY_TOKEN cho tiến trình).
​
--password <password>
string
Ghi đè mật khẩu.
​
--password-file <path>
string
Đọc mật khẩu gateway từ một tệp.
​
--tailscale <off|serve|funnel>
string
Công khai Gateway qua Tailscale.
​
--tailscale-reset-on-exit
boolean
Đặt lại cấu hình serve/funnel của Tailscale khi tắt.
​
--allow-unconfigured
boolean
Cho phép gateway khởi động khi không có gateway.mode=local trong cấu hình. Chỉ bỏ qua kiểm tra bảo vệ khởi động cho bootstrap tạm thời/phát triển; không ghi hoặc sửa tệp cấu hình.
​
--dev
boolean
Tạo cấu hình + workspace phát triển nếu thiếu (bỏ qua BOOTSTRAP.md).
​
--reset
boolean
Đặt lại cấu hình phát triển + thông tin xác thực + phiên + workspace (yêu cầu --dev).
​
--force
boolean
Kill mọi listener hiện có trên cổng đã chọn trước khi khởi động.
​
--verbose
boolean
Nhật ký chi tiết.
​
--cli-backend-logs
boolean
Chỉ hiển thị nhật ký backend CLI trong console (và bật stdout/stderr).
​
--ws-log <auto|full|compact>
string
mặc định:"auto"
Kiểu nhật ký WebSocket.
​
--compact
boolean
Bí danh cho --ws-log compact.
​
--raw-stream
boolean
Ghi sự kiện stream mô hình thô vào jsonl.
​
--raw-stream-path <path>
string
Đường dẫn jsonl của stream thô.
--password inline có thể bị lộ trong danh sách tiến trình cục bộ. Ưu tiên --password-file, env, hoặc gateway.auth.password dùng SecretRef.

​
Hồ sơ hóa khởi động

  • Đặt OPENCLAW_GATEWAY_STARTUP_TRACE=1 để ghi thời gian từng pha trong quá trình khởi động Gateway, bao gồm độ trễ eventLoopMax theo từng pha và thời gian bảng tra cứu Plugin cho installed-index, manifest registry, startup planning, và owner-map.
  • Đặt OPENCLAW_DIAGNOSTICS=timeline với OPENCLAW_DIAGNOSTICS_TIMELINE_PATH=<path> để ghi một timeline chẩn đoán khởi động JSONL best-effort cho các bộ kiểm thử QA bên ngoài. Bạn cũng có thể bật cờ bằng diagnostics.flags: ["timeline"] trong cấu hình; đường dẫn vẫn được cung cấp qua env. Thêm OPENCLAW_DIAGNOSTICS_EVENT_LOOP=1 để bao gồm các mẫu event-loop.
  • Chạy pnpm test:startup:gateway -- --runs 5 --warmup 1 để benchmark quá trình khởi động Gateway. Benchmark ghi lại output đầu tiên của tiến trình, /healthz, /readyz, thời gian startup trace, độ trễ event-loop, và chi tiết thời gian bảng tra cứu Plugin.

​
Truy vấn Gateway đang chạy

Tất cả lệnh truy vấn đều dùng WebSocket RPC.
  • Mặc định: dễ đọc cho người dùng (có màu trong TTY).
  • --json: JSON cho máy đọc (không styling/spinner).
  • --no-color (hoặc NO_COLOR=1): tắt ANSI trong khi vẫn giữ bố cục cho người đọc.
Khi bạn đặt --url, CLI không fallback về thông tin xác thực trong cấu hình hoặc môi trường. Truyền rõ ràng --token hoặc --password. Thiếu thông tin xác thực tường minh là lỗi.

​
gateway health

openclaw gateway health --url ws://127.0.0.1:18789
Endpoint HTTP /healthz là probe liveness: nó trả về khi máy chủ có thể trả lời HTTP. Endpoint HTTP /readyz nghiêm ngặt hơn và vẫn đỏ trong khi các sidecar khởi động, kênh, hoặc hook đã cấu hình vẫn đang ổn định. Các phản hồi readiness chi tiết cục bộ hoặc đã xác thực bao gồm một khối chẩn đoán eventLoop với độ trễ event-loop, mức sử dụng event-loop, tỷ lệ lõi CPU, và cờ degraded.

​
gateway usage-cost

Lấy tóm tắt usage-cost từ nhật ký phiên. 
openclaw gateway usage-cost
openclaw gateway usage-cost --days 7
openclaw gateway usage-cost --json
​
--days <days>
number
mặc định:"30"
Số ngày cần đưa vào.

​
gateway stability

Lấy trình ghi ổn định chẩn đoán gần đây từ Gateway đang chạy. 
openclaw gateway stability
openclaw gateway stability --type payload.large
openclaw gateway stability --bundle latest
openclaw gateway stability --bundle latest --export
openclaw gateway stability --json
​
--limit <limit>
number
mặc định:"25"
Số lượng sự kiện gần đây tối đa cần đưa vào (tối đa 1000).
​
--type <type>
string
Lọc theo loại sự kiện chẩn đoán, chẳng hạn như payload.large hoặc diagnostic.memory.pressure.
​
--since-seq <seq>
number
Chỉ bao gồm các sự kiện sau một số thứ tự chẩn đoán.
​
--bundle [path]
string
Đọc một bundle ổn định đã lưu thay vì gọi Gateway đang chạy. Dùng --bundle latest (hoặc chỉ --bundle) cho bundle mới nhất trong thư mục trạng thái, hoặc truyền trực tiếp đường dẫn JSON của bundle.
​
--export
boolean
Ghi một tệp zip chẩn đoán hỗ trợ có thể chia sẻ thay vì in chi tiết ổn định.
​
--output <path>
string
Đường dẫn output cho --export.
  • Bản ghi giữ metadata vận hành: tên sự kiện, số đếm, kích thước byte, chỉ số bộ nhớ, trạng thái hàng đợi/phiên, tên kênh/Plugin, và tóm tắt phiên đã biên tập. Chúng không giữ văn bản chat, nội dung webhook, output công cụ, nội dung request hoặc response thô, token, cookie, giá trị bí mật, hostname, hoặc id phiên thô. Đặt diagnostics.enabled: false để tắt hoàn toàn trình ghi.
  • Khi Gateway thoát nghiêm trọng, timeout khi tắt, và lỗi khởi động sau restart, OpenClaw ghi cùng snapshot chẩn đoán vào ~/.openclaw/logs/stability/openclaw-stability-*.json khi trình ghi có sự kiện. Kiểm tra bundle mới nhất bằng openclaw gateway stability --bundle latest; --limit, --type, và --since-seq cũng áp dụng cho output bundle.

​
gateway diagnostics export

Ghi một tệp zip chẩn đoán cục bộ được thiết kế để đính kèm vào báo cáo lỗi. Để xem mô hình quyền riêng tư và nội dung bundle, xem Diagnostics Export. 
openclaw gateway diagnostics export
openclaw gateway diagnostics export --output openclaw-diagnostics.zip
openclaw gateway diagnostics export --json
​
--output <path>
string
Đường dẫn zip output. Mặc định là một bản export hỗ trợ trong thư mục trạng thái.
​
--log-lines <count>
number
mặc định:"5000"
Số dòng nhật ký đã làm sạch tối đa cần đưa vào.
​
--log-bytes <bytes>
number
mặc định:"1000000"
Số byte nhật ký tối đa cần kiểm tra.
​
--url <url>
string
URL WebSocket của Gateway cho snapshot health.
​
--token <token>
string
Token Gateway cho snapshot health.
​
--password <password>
string
Mật khẩu Gateway cho snapshot health.
​
--timeout <ms>
number
mặc định:"3000"
Timeout cho snapshot trạng thái/health.
​
--no-stability-bundle
boolean
Bỏ qua tra cứu bundle ổn định đã lưu.
​
--json
boolean
In đường dẫn đã ghi, kích thước, và manifest dưới dạng JSON.
Bản export chứa một manifest, tóm tắt Markdown, hình dạng cấu hình, chi tiết cấu hình đã làm sạch, tóm tắt nhật ký đã làm sạch, snapshot trạng thái/health Gateway đã làm sạch, và bundle ổn định mới nhất khi có. Nó được thiết kế để chia sẻ. Nó giữ các chi tiết vận hành hỗ trợ gỡ lỗi, chẳng hạn như các trường nhật ký OpenClaw an toàn, tên subsystem, mã trạng thái, thời lượng, chế độ đã cấu hình, cổng, id Plugin, id provider, thiết lập tính năng không bí mật, và thông điệp nhật ký vận hành đã biên tập. Nó bỏ qua hoặc biên tập văn bản chat, nội dung webhook, output công cụ, thông tin xác thực, cookie, mã định danh tài khoản/tin nhắn, văn bản prompt/hướng dẫn, hostname, và giá trị bí mật. Khi một thông điệp kiểu LogTape trông giống văn bản payload người dùng/chat/công cụ, bản export chỉ giữ thông tin rằng một thông điệp đã bị bỏ qua cùng với số byte của nó.

​
gateway status

gateway status hiển thị dịch vụ Gateway (launchd/systemd/schtasks) cùng với probe tùy chọn về khả năng kết nối/xác thực. 
openclaw gateway status
openclaw gateway status --json
openclaw gateway status --require-rpc
​
--url <url>
string
Thêm một mục tiêu probe tường minh. Remote đã cấu hình + localhost vẫn được probe.
​
--token <token>
string
Xác thực token cho probe.
​
--password <password>
string
Xác thực mật khẩu cho probe.
​
--timeout <ms>
number
mặc định:"10000"
Timeout probe.
​
--no-probe
boolean
Bỏ qua probe kết nối (chỉ xem dịch vụ).
​
--deep
boolean
Quét cả các dịch vụ cấp hệ thống.
​
--require-rpc
boolean
Nâng cấp probe kết nối mặc định thành probe đọc và thoát khác không khi probe đọc đó thất bại. Không thể kết hợp với --no-probe.
  • gateway status vẫn khả dụng để chẩn đoán ngay cả khi cấu hình CLI cục bộ bị thiếu hoặc không hợp lệ.
  • gateway status mặc định chứng minh trạng thái dịch vụ, kết nối WebSocket và khả năng xác thực hiển thị tại thời điểm bắt tay. Nó không chứng minh các thao tác đọc/ghi/quản trị.
  • Các phép thăm dò chẩn đoán không làm thay đổi xác thực thiết bị lần đầu: chúng tái sử dụng mã thông báo thiết bị đã lưu trong bộ nhớ đệm khi có, nhưng không tạo danh tính thiết bị CLI mới hoặc bản ghi ghép đôi thiết bị chỉ đọc mới chỉ để kiểm tra trạng thái.
  • gateway status phân giải các SecretRef xác thực đã cấu hình để xác thực thăm dò khi có thể.
  • Nếu một SecretRef xác thực bắt buộc không được phân giải trong đường dẫn lệnh này, gateway status --json báo cáo rpc.authWarning khi kết nối/xác thực thăm dò thất bại; truyền rõ ràng --token/--password hoặc phân giải nguồn bí mật trước.
  • Nếu phép thăm dò thành công, cảnh báo auth-ref chưa phân giải sẽ bị ẩn để tránh báo động sai.
  • Dùng --require-rpc trong script và tự động hóa khi một dịch vụ đang lắng nghe là chưa đủ và bạn cũng cần các lệnh gọi RPC phạm vi đọc hoạt động tốt.
  • --deep thêm một lần quét nỗ lực tối đa để tìm các bản cài đặt launchd/systemd/schtasks bổ sung. Khi phát hiện nhiều dịch vụ giống gateway, đầu ra cho người đọc in gợi ý dọn dẹp và cảnh báo rằng hầu hết thiết lập chỉ nên chạy một gateway trên mỗi máy.
  • Đầu ra cho người đọc bao gồm đường dẫn nhật ký tệp đã phân giải cùng ảnh chụp nhanh đường dẫn/tính hợp lệ cấu hình CLI so với dịch vụ để giúp chẩn đoán sai lệch hồ sơ hoặc thư mục trạng thái.
  • Trên các bản cài đặt Linux systemd, kiểm tra sai lệch xác thực dịch vụ đọc cả giá trị Environment= và EnvironmentFile= từ unit (bao gồm %h, đường dẫn có dấu ngoặc kép, nhiều tệp và tệp tùy chọn có tiền tố -).
  • Kiểm tra sai lệch phân giải SecretRef gateway.auth.token bằng env runtime đã hợp nhất (env lệnh dịch vụ trước, rồi env tiến trình làm dự phòng).
  • Nếu xác thực bằng mã thông báo không thực sự đang hoạt động (gateway.auth.mode rõ ràng là password/none/trusted-proxy, hoặc chưa đặt chế độ trong đó mật khẩu có thể thắng và không có ứng viên mã thông báo nào có thể thắng), kiểm tra sai lệch mã thông báo sẽ bỏ qua phân giải mã thông báo cấu hình.

​
gateway probe

gateway probe là lệnh “gỡ lỗi mọi thứ”. Nó luôn thăm dò:
  • gateway từ xa đã cấu hình của bạn (nếu đã đặt), và
  • localhost (loopback) ngay cả khi đã cấu hình từ xa.
Nếu bạn truyền --url, mục tiêu rõ ràng đó được thêm trước cả hai. Đầu ra cho người đọc gắn nhãn các mục tiêu là:
  • URL (explicit)
  • Remote (configured) hoặc Remote (configured, inactive)
  • Local loopback
Nếu nhiều gateway có thể truy cập, lệnh sẽ in tất cả. Nhiều gateway được hỗ trợ khi bạn dùng hồ sơ/cổng tách biệt (ví dụ: bot cứu hộ), nhưng hầu hết bản cài đặt vẫn chạy một gateway duy nhất.
openclaw gateway probe
openclaw gateway probe --json
  • Reachable: yes nghĩa là ít nhất một mục tiêu đã chấp nhận kết nối WebSocket.
  • Capability: read-only|write-capable|admin-capable|pairing-pending|connect-only báo cáo điều phép thăm dò có thể chứng minh về xác thực. Nó tách biệt với khả năng truy cập.
  • Read probe: ok nghĩa là các lệnh gọi RPC chi tiết phạm vi đọc (health/status/system-presence/config.get) cũng thành công.
  • Read probe: limited - missing scope: operator.read nghĩa là kết nối thành công nhưng RPC phạm vi đọc bị giới hạn. Trường hợp này được báo cáo là khả năng truy cập suy giảm, không phải thất bại hoàn toàn.
  • Read probe: failed sau Connect: ok nghĩa là Gateway đã chấp nhận kết nối WebSocket, nhưng chẩn đoán đọc tiếp theo đã hết thời gian chờ hoặc thất bại. Trường hợp này cũng là khả năng truy cập suy giảm, không phải Gateway không thể truy cập.
  • Giống gateway status, probe tái sử dụng xác thực thiết bị đã lưu trong bộ nhớ đệm nhưng không tạo danh tính thiết bị lần đầu hoặc trạng thái ghép đôi.
  • Mã thoát chỉ khác không khi không có mục tiêu nào được thăm dò có thể truy cập.
Cấp cao nhất:
  • ok: ít nhất một mục tiêu có thể truy cập.
  • degraded: ít nhất một mục tiêu đã chấp nhận kết nối nhưng không hoàn tất toàn bộ chẩn đoán RPC chi tiết.
  • capability: khả năng tốt nhất thấy được trên các mục tiêu có thể truy cập (read_only, write_capable, admin_capable, pairing_pending, connected_no_operator_scope, hoặc unknown).
  • primaryTargetId: mục tiêu tốt nhất để xem là mục tiêu thắng đang hoạt động theo thứ tự này: URL rõ ràng, đường hầm SSH, từ xa đã cấu hình, rồi local loopback.
  • warnings[]: bản ghi cảnh báo nỗ lực tối đa với code, message và targetIds tùy chọn.
  • network: gợi ý URL local loopback/tailnet suy ra từ cấu hình hiện tại và mạng của máy chủ.
  • discovery.timeoutMs và discovery.count: ngân sách khám phá/số lượng kết quả thực tế được dùng cho lượt thăm dò này.
Theo từng mục tiêu (targets[].connect):
  • ok: khả năng truy cập sau phân loại kết nối + suy giảm.
  • rpcOk: RPC chi tiết đầy đủ thành công.
  • scopeLimited: RPC chi tiết thất bại do thiếu phạm vi operator.
Theo từng mục tiêu (targets[].auth):
  • role: vai trò xác thực được báo cáo trong hello-ok khi có.
  • scopes: các phạm vi được cấp được báo cáo trong hello-ok khi có.
  • capability: phân loại khả năng xác thực được hiển thị cho mục tiêu đó.
  • ssh_tunnel_failed: thiết lập đường hầm SSH thất bại; lệnh đã quay về thăm dò trực tiếp.
  • multiple_gateways: có thể truy cập nhiều hơn một mục tiêu; điều này bất thường trừ khi bạn cố ý chạy các hồ sơ tách biệt, chẳng hạn như bot cứu hộ.
  • auth_secretref_unresolved: SecretRef xác thực đã cấu hình không thể được phân giải cho một mục tiêu thất bại.
  • probe_scope_limited: kết nối WebSocket thành công, nhưng phép thăm dò đọc bị giới hạn do thiếu operator.read.

​
Từ xa qua SSH (tương đương ứng dụng Mac)

Chế độ “Từ xa qua SSH” của ứng dụng macOS dùng chuyển tiếp cổng cục bộ để gateway từ xa (có thể chỉ liên kết với loopback) có thể truy cập tại ws://127.0.0.1:<port>. Tương đương trên CLI: 
openclaw gateway probe --ssh user@gateway-host
​
--ssh <target>
string
user@host hoặc user@host:port (cổng mặc định là 22).
​
--ssh-identity <path>
string
Tệp danh tính.
​
--ssh-auto
boolean
Chọn máy chủ gateway đầu tiên được phát hiện làm mục tiêu SSH từ endpoint khám phá đã phân giải (local. cộng với miền diện rộng đã cấu hình, nếu có). Gợi ý chỉ TXT sẽ bị bỏ qua.
Cấu hình (tùy chọn, dùng làm mặc định):
  • gateway.remote.sshTarget
  • gateway.remote.sshIdentity

​
gateway call <method>

Trình trợ giúp RPC cấp thấp. 
openclaw gateway call status
openclaw gateway call logs.tail --params '{"sinceMs": 60000}'
​
--params <json>
string
mặc định:"{}"
Chuỗi đối tượng JSON cho tham số.
​
--url <url>
string
URL WebSocket của Gateway.
​
--token <token>
string
Mã thông báo Gateway.
​
--password <password>
string
Mật khẩu Gateway.
​
--timeout <ms>
number
Ngân sách thời gian chờ.
​
--expect-final
boolean
Chủ yếu dành cho RPC kiểu agent phát trực tuyến các sự kiện trung gian trước payload cuối cùng.
​
--json
boolean
Đầu ra JSON có thể đọc bằng máy.
--params phải là JSON hợp lệ.

​
Quản lý dịch vụ Gateway

openclaw gateway install
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
openclaw gateway uninstall

​
Cài đặt với wrapper

Dùng --wrapper khi dịch vụ được quản lý phải khởi động thông qua một tệp thực thi khác, ví dụ một shim trình quản lý bí mật hoặc trình trợ giúp chạy dưới tư cách người dùng khác. Wrapper nhận các đối số Gateway thông thường và chịu trách nhiệm cuối cùng exec openclaw hoặc Node với các đối số đó. 
cat > ~/.local/bin/openclaw-doppler <<'EOF'
#!/usr/bin/env bash
set -euo pipefail
exec doppler run --project my-project --config production -- openclaw "$@"
EOF
chmod +x ~/.local/bin/openclaw-doppler

openclaw gateway install --wrapper ~/.local/bin/openclaw-doppler --force
openclaw gateway restart
Bạn cũng có thể đặt wrapper thông qua môi trường. gateway install xác thực rằng đường dẫn là một tệp thực thi, ghi wrapper vào ProgramArguments của dịch vụ và lưu bền OPENCLAW_WRAPPER trong môi trường dịch vụ cho các lần cài đặt lại bắt buộc, cập nhật và sửa chữa bằng doctor sau này. 
OPENCLAW_WRAPPER="$HOME/.local/bin/openclaw-doppler" openclaw gateway install --force
openclaw doctor
Để xóa wrapper đã lưu bền, xóa OPENCLAW_WRAPPER trong khi cài đặt lại: 
OPENCLAW_WRAPPER= openclaw gateway install --force
openclaw gateway restart
  • gateway status: --url, --token, --password, --timeout, --no-probe, --require-rpc, --deep, --json
  • gateway install: --port, --runtime <node|bun>, --token, --wrapper <path>, --force, --json
  • gateway uninstall|start|stop|restart: --json
  • Dùng gateway restart để khởi động lại một dịch vụ được quản lý. Không nối chuỗi gateway stop và gateway start để thay thế khởi động lại; trên macOS, gateway stop cố ý vô hiệu hóa LaunchAgent trước khi dừng nó.
  • Các lệnh vòng đời chấp nhận --json để viết script.
  • Khi xác thực bằng mã thông báo yêu cầu một mã thông báo và gateway.auth.token được quản lý bằng SecretRef, gateway install xác thực rằng SecretRef có thể được phân giải nhưng không lưu bền mã thông báo đã phân giải vào metadata môi trường dịch vụ.
  • Nếu xác thực bằng mã thông báo yêu cầu một mã thông báo và SecretRef mã thông báo đã cấu hình chưa được phân giải, cài đặt thất bại đóng thay vì lưu bền văn bản thuần dự phòng.
  • Với xác thực bằng mật khẩu trên gateway run, ưu tiên OPENCLAW_GATEWAY_PASSWORD, --password-file, hoặc gateway.auth.password được hỗ trợ bằng SecretRef thay vì --password nội tuyến.
  • Trong chế độ xác thực suy luận, OPENCLAW_GATEWAY_PASSWORD chỉ trong shell không nới lỏng yêu cầu mã thông báo khi cài đặt; hãy dùng cấu hình bền vững (gateway.auth.password hoặc env cấu hình) khi cài đặt dịch vụ được quản lý.
  • Nếu cả gateway.auth.token và gateway.auth.password đều được cấu hình và gateway.auth.mode chưa được đặt, cài đặt sẽ bị chặn cho đến khi chế độ được đặt rõ ràng.

​
Khám phá gateway (Bonjour)

gateway discover quét beacon Gateway (_openclaw-gw._tcp).
  • DNS-SD multicast: local.
  • DNS-SD unicast (Bonjour diện rộng): chọn một miền (ví dụ: openclaw.internal.) và thiết lập split DNS + máy chủ DNS; xem Bonjour.
Chỉ các gateway có bật khám phá Bonjour (mặc định) mới quảng bá beacon. Bản ghi khám phá diện rộng bao gồm (TXT):
  • role (gợi ý vai trò gateway)
  • transport (gợi ý truyền tải, ví dụ gateway)
  • gatewayPort (cổng WebSocket, thường là 18789)
  • sshPort (tùy chọn; client mặc định mục tiêu SSH là 22 khi không có)
  • tailnetDns (tên máy chủ MagicDNS, khi có)
  • gatewayTls / gatewayTlsSha256 (TLS đã bật + vân tay chứng chỉ)
  • cliPath (gợi ý cài đặt từ xa được ghi vào vùng diện rộng)

​
gateway discover

openclaw gateway discover
​
--timeout <ms>
number
mặc định:"2000"
Thời gian chờ theo từng lệnh (duyệt/phân giải).
​
--json
boolean
Đầu ra có thể đọc bằng máy (cũng tắt kiểu hiển thị/spinner).
Ví dụ: 
openclaw gateway discover --timeout 4000
openclaw gateway discover --json | jq '.beacons[].wsUrl'
  • CLI quét local. cùng với miền diện rộng đã cấu hình khi miền này được bật.
  • wsUrl trong đầu ra JSON được dẫn xuất từ điểm cuối dịch vụ đã phân giải, không phải từ các gợi ý chỉ có TXT như lanHost hoặc tailnetDns.
  • Trên mDNS local., sshPort và cliPath chỉ được phát quảng bá khi discovery.mdns.mode là full. DNS-SD diện rộng vẫn ghi cliPath; sshPort cũng vẫn là tùy chọn ở đó.

​
Liên quan