macOS companion app

Vòng đời Gateway trên macOS

Theo mặc định, ứng dụng macOS quản lý Gateway thông qua launchd và không khởi chạy Gateway dưới dạng tiến trình con. Trước tiên, ứng dụng thử kết nối với một Gateway đang chạy trên cổng đã cấu hình; nếu không thể kết nối đến Gateway nào, ứng dụng sẽ bật dịch vụ launchd thông qua CLI openclaw bên ngoài (không có môi trường chạy nhúng). Cơ chế này giúp tự động khởi động ổn định khi đăng nhập và khởi động lại khi xảy ra sự cố.

Chế độ tiến trình con (Gateway được ứng dụng trực tiếp khởi chạy) hiện không được sử dụng. Nếu cần tích hợp chặt chẽ hơn với giao diện người dùng, hãy chạy Gateway thủ công trong terminal.

Hành vi mặc định (launchd)

Ứng dụng cài đặt một LaunchAgent riêng cho từng người dùng, có nhãn ai.openclaw.gateway (hoặc ai.openclaw.<profile> khi sử dụng --profile/OPENCLAW_PROFILE).
Khi chế độ Cục bộ được bật, ứng dụng bảo đảm LaunchAgent đã được nạp và khởi động Gateway nếu cần.
Nhật ký được ghi vào đường dẫn nhật ký Gateway của launchd (hiển thị trong Cài đặt gỡ lỗi).

Các lệnh thường dùng:

bash

launchctl kickstart -k gui/$UID/ai.openclaw.gatewaylaunchctl bootout gui/$UID/ai.openclaw.gateway

Thay nhãn bằng ai.openclaw.<profile> khi chạy một hồ sơ có tên.

Bản dựng phát triển chưa ký

scripts/restart-mac.sh --no-sign dành cho các bản dựng cục bộ nhanh không có khóa ký. Để ngăn launchd trỏ đến một tệp nhị phân chuyển tiếp chưa ký, lệnh này ghi ~/.openclaw/disable-launchagent.

Các lần chạy đã ký của scripts/restart-mac.sh sẽ xóa thiết lập ghi đè này nếu có tệp đánh dấu. Để đặt lại thủ công:

bash

rm ~/.openclaw/disable-launchagent

Chế độ chỉ kết nối

Để buộc ứng dụng macOS không bao giờ cài đặt hoặc quản lý launchd, hãy khởi chạy ứng dụng với --attach-only (hoặc --no-launchd). Thao tác này thiết lập ~/.openclaw/disable-launchagent, vì vậy ứng dụng chỉ kết nối với một Gateway đang chạy. Bật hoặc tắt hành vi tương tự trong Cài đặt gỡ lỗi.

Chế độ từ xa

Chế độ từ xa không bao giờ khởi động Gateway cục bộ. Ứng dụng sử dụng đường hầm SSH đến máy chủ từ xa và kết nối qua đường hầm đó.

Lý do chúng tôi ưu tiên launchd

Tự động khởi động khi đăng nhập.
Ngữ nghĩa khởi động lại/KeepAlive tích hợp sẵn.
Nhật ký và cơ chế giám sát có tính dự đoán.

Nếu chế độ tiến trình con thực sự cần thiết trở lại, chế độ này phải được ghi tài liệu dưới dạng một chế độ riêng biệt, rõ ràng và chỉ dành cho phát triển.

Liên quan

Was this useful?