docs: document docker cli dns override · openclaw/openclaw@484a289
sallyom
·
2026-05-08
·
via Recent Commits to openclaw:main
| Original file line number | Diff line number | Diff line change |
|---|
@@ -148,6 +148,7 @@ Docs: https://docs.openclaw.ai
|
148 | 148 | |
149 | 149 | ### Fixes |
150 | 150 | |
| 151 | +- Docs/Docker: document a local Compose override for Docker Desktop DNS failures in the shared-network `openclaw-cli` sidecar, keeping the default compose setup hardened while unblocking `openclaw plugins install` when users opt in. Fixes #79018. Thanks @Jason-Vaughan. |
151 | 152 | - Compute plugin callback authorization dynamically [AI]. (#78866) Thanks @pgondhi987. |
152 | 153 | - fix(active-memory): require admin scope for global toggles [AI]. (#78863) Thanks @pgondhi987. |
153 | 154 | - Honor owner enforcement for native commands [AI]. (#78864) Thanks @pgondhi987. |
|
| Original file line number | Diff line number | Diff line change |
|---|
@@ -335,6 +335,32 @@ See [ClawDock](/install/clawdock) for the full helper guide.
|
335 | 335 | `no-new-privileges` on both `openclaw-gateway` and `openclaw-cli`. |
336 | 336 | </Accordion> |
337 | 337 | |
| 338 | +<Accordion title="Docker Desktop DNS failures in openclaw-cli"> |
| 339 | +Some Docker Desktop setups fail DNS lookups from the shared-network |
| 340 | +`openclaw-cli` sidecar after `NET_RAW` is dropped, which shows up as |
| 341 | +`EAI_AGAIN` during npm-backed commands such as `openclaw plugins install`. |
| 342 | +Keep the default hardened compose file for normal gateway operation. The |
| 343 | +local override below loosens the CLI container's security posture by |
| 344 | +restoring Docker's default capabilities, so use it only for the one-off CLI |
| 345 | +command that needs package registry access, not as your default Compose |
| 346 | +invocation: |
| 347 | + |
| 348 | +```bash |
| 349 | +printf '%s\n' \ |
| 350 | + 'services:' \ |
| 351 | + ' openclaw-cli:' \ |
| 352 | + ' cap_drop: !reset []' \ |
| 353 | + > docker-compose.cli-no-dropped-caps.local.yml |
| 354 | + |
| 355 | +docker compose -f docker-compose.yml -f docker-compose.cli-no-dropped-caps.local.yml run --rm openclaw-cli plugins install <package> |
| 356 | +``` |
| 357 | + |
| 358 | +If you already created a long-running `openclaw-cli` container, recreate it |
| 359 | +with the same override. `docker compose exec` and `docker exec` cannot |
| 360 | +change Linux capabilities on an already-created container. |
| 361 | + |
| 362 | +</Accordion> |
| 363 | + |
338 | 364 | <Accordion title="Permissions and EACCES"> |
339 | 365 | The image runs as `node` (uid 1000). If you see permission errors on |
340 | 366 | `/home/node/.openclaw`, make sure your host bind mounts are owned by uid 1000: |
|
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。