← Back to PRs

#17099: docs(pi): add loginctl enable-linger instruction for SSH persistence

by Limitless2023 open 2026-02-15 12:08 View on GitHub →
docs stale size: XS
Fixes #17069 ## Problem When running OpenClaw on Raspberry Pi accessed via SSH, the gateway dies when the SSH session closes because systemd-logind's default kills all user processes. ## Solution Added a warning note in the Raspberry Pi docs with the workaround: ```bash sudo loginctl enable-linger $USER ``` This prevents systemd from killing the gateway when the SSH session ends. ## Impact - Helps users avoid the common pitfall of their Pi gateway dying after disconnecting SSH - Low-risk documentation fix with clear reproduction steps from the issue <!-- greptile_comment --> <h3>Greptile Summary</h3> This PR adds helpful SSH persistence documentation for Raspberry Pi users and attempts to optimize hook loading by skipping cache-busting for bundled hooks. - **Docs change (raspberry-pi.md)**: Clean addition - warns users about systemd killing processes when SSH disconnects and provides the `loginctl enable-linger` fix - **Loader optimization (loader.ts)**: The optimization logic is sound, but `entry.origin` should be `entry.hook.source` and the comparison value should be `"openclaw-bundled"` not `"bundled"` The bug makes the optimization a no-op (always applies cache-busting), so it doesn't break existing functionality - it just fails to deliver the performance improvement. <h3>Confidence Score: 3/5</h3> - Safe to merge with the logic fix - docs are good, bug doesn't break functionality - The documentation change is solid and the loader bug doesn't cause runtime errors (just makes the optimization ineffective). However, the bug should be fixed before merging to actually deliver the performance benefit. - src/hooks/loader.ts needs the property path corrected <sub>Last reviewed commit: 3b9c17c</sub> <!-- greptile_other_comments_section --> <!-- /greptile_comment -->

Most Similar PRs