mirror of
https://github.com/openclaw/openclaw.git
synced 2026-11-17 22:02:26 +00:00
* docs(podman): reach host model servers from a containerized gateway Rootless Podman maps host-gateway aliases (host.docker.internal / host.containers.internal) to a link-local address (169.254.1.2), which exact-origin SSRF trust excludes, so provider baseUrls built on the alias are rejected. Document the alias setup and two fixes: use the host LAN/tailnet IP as the baseUrl, or opt in per provider with allowPrivateNetwork. Flag the same exception in local-models. * docs(local-models): add non-interactive hybrid setup recipe Onboarding configures one provider per run: --custom-* flags are silently ignored next to a hosted --auth-choice. Document the scripted sequence — onboard hosted, patch the local provider into config, add the fallback — running config-mutating steps through the container once the gateway is up. * docs(podman): add rootless container troubleshooting Cover three failure modes observed with a real rootless Quadlet deployment: config writes rejected by the gateway ownership lock (use --container or podman exec, wait ~90s after stopping), :Z relabel failures on root-owned mounts (plain ro instead), and one-off podman run commands needing --userns=keep-id to match gateway file ownership. * docs: address ClawSweeper review findings - podman: use gateway recover-lock instead of heartbeat-wait for stale ownership - local-models: pipe container config patch via stdin (host --file path not visible) - podman: qualify that plain ro mount avoids relabel but not SELinux access checks * docs: qualify Podman host alias networking Co-authored-by: Micah Abbott <miabbott@redhat.com> Co-authored-by: miabbott <10236257+miabbott@users.noreply.github.com> Co-authored-by: Vincent Koc <vincentkoc@ieee.org> |
||
|---|---|---|
| .. | ||
| compose-operations.md | ||
| environment-variables.md | ||
| networking-and-storage.md | ||
| sandbox-and-troubleshooting.md | ||