Skip to content

fix(install): support PILOT_TRANSPORT env var for compat mode (PILOT-222)#349

Open
matthew-pilot wants to merge 1 commit into
mainfrom
openclaw/pilot-222-20260703-165000
Open

fix(install): support PILOT_TRANSPORT env var for compat mode (PILOT-222)#349
matthew-pilot wants to merge 1 commit into
mainfrom
openclaw/pilot-222-20260703-165000

Conversation

@matthew-pilot

Copy link
Copy Markdown
Collaborator

What changed

The daemon already auto-probes UDP reachability and falls back to compat (WSS/443) transport when UDP is blocked (PR #314, commit f0c422f). This change adds PILOT_TRANSPORT env var support to install.sh for users who want to explicitly force a transport mode on systems where UDP may be unavailable.

What was failing

install.sh did not pass -transport to the systemd unit or LaunchAgent plist, and had no documentation for the PILOT_TRANSPORT env var. Users on UDP-blocked hosts had no way to force compat mode through the installer — they had to manually edit the service file or the plist after install.

Fix

  1. Documentation — Added PILOT_TRANSPORT=compat to the Usage examples and a new ENVIRONMENT VARIABLES header block
  2. Systemd unit — Pass -transport $PILOT_TRANSPORT in ExecStart when the env var is set (following the same pattern as PILOT_HOSTNAME / PILOT_PUBLIC)
  3. LaunchAgent plist — Add -transport + value strings when the env var is set (same EXTRA_ARGS pattern)

Verification

  • bash -n install.sh — syntax OK
  • dash -n install.sh — syntax OK (POSIX sh compat)

Closes https://vulturelabs.atlassian.net/browse/PILOT-222

The daemon already auto-probes UDP reachability and falls back
to compat (WSS/443) transport when UDP is blocked (PR #314,
commit f0c422f). This change adds PILOT_TRANSPORT env var support
to install.sh for users who want to explicitly force a transport
mode on systems where UDP may be unavailable.

Changes:
- Document PILOT_TRANSPORT=compat in Usage section + new
  ENVIRONMENT VARIABLES header block
- Pass -transport flag to systemd unit when PILOT_TRANSPORT is set
- Pass -transport to LaunchAgent plist when PILOT_TRANSPORT is set

Closes PILOT-222
@matthew-pilot matthew-pilot requested a review from TeoSlayer as a code owner July 3, 2026 16:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant