docs: explain blocked plugin ownership repair

This commit is contained in:
Peter Steinberger
2026-05-06 04:43:31 +01:00
parent b971ebaaab
commit cbc228f0f6
4 changed files with 78 additions and 0 deletions

View File

@@ -343,6 +343,14 @@ See [ClawDock](/install/clawdock) for the full helper guide.
sudo chown -R 1000:1000 /path/to/openclaw-config /path/to/openclaw-workspace
```
The same mismatch can show up as a plugin warning such as
`blocked plugin candidate: suspicious ownership (... uid=1000, expected uid=0 or root)`
followed by `plugin present but blocked`. That means the process uid and the
mounted plugin directory owner disagree. Prefer running the container as the
default uid 1000 and fixing the bind mount ownership. Only chown
`/path/to/openclaw-config/npm` to `root:root` if you intentionally run
OpenClaw as root long term.
</Accordion>
<Accordion title="Faster rebuilds">