Repository navigation
v0.1.36
UnraidClaw 0.1.36 lets an agent create a container with the advanced settings of Unraid's own container form: extra docker parameters, post arguments, a fixed IP, privileged mode, CPU pinning and host devices. Everything else, including the REST API, MCP endpoint, OpenClaw plugin and CLI, behaves as in 0.1.34. There is no 0.1.35.
Highlights
Advanced settings when creating a container
POST /api/docker/containersand theunraid_docker_createtool accept six new optional fields.extraArgsis Unraid's Extra Parameters (docker run options such as--gpus all,--cap-add=SYS_ADMINor--memory=8g),postArgsis Post Arguments (the container command),staticIpis a fixed IPv4 or IPv6 address,privilegedruns the container privileged,cpusetpins it to CPUs anddevicespasses host devices through. See the Docker create section of the README.- Each field is passed to
docker runin the order Unraid's own command builder uses and saved to the matching field of the container's template, so the Docker tab shows the setting and rebuilds the container the same way. - The OpenClaw plugin is 0.1.16 on npm, with the new fields in the
unraid_docker_createtool and guidance for them inSKILL.md. The CLI reads the same tool definitions, sounraidclaw docker createtakes the fields too. - Thanks to @totalanni for the
extraArgsandstaticIpimplementation this release builds on.
Security and reliability fixes
- Unraid hands Extra Parameters and Post Arguments to the shell unescaped whenever it rebuilds a container from its template, so both fields accept only letters, digits,
: . , / + = _ -and single spaces between tokens. Quotes, other whitespace and shell metacharacters are rejected with400before docker runs, and every value reaches docker as an argument list, never through a shell. extraArgsmust start with an option,cpusetmust be CPU numbers and ranges,devicesmust be paths under/devwithout.., andprivilegedmust be a real boolean, so a mistyped value cannot become a different container.- A fixed IP is rejected on
bridge,hostandnone, where docker itself refuses it, with a message naming the networks that accept one.
Upgrade notes
- Nothing to configure. The new fields are optional and a request without them creates the same container as before.
- A container created with any of these settings in effect is refused by
POST /api/ca/app/:name/updateandunraid_ca_update, which rebuild only settings they can reproduce exactly. Update such a container from the Docker tab.
Install and downloads
- Unraid plugin: update from the Unraid WebGUI (Plugins > Check for Updates) or install through Community Applications.
unraidclaw-0.1.36-x86_64-1.txzis the package the WebGUI downloads; you do not need to fetch it by hand. - CLI:
npm install -g unraidclaw-cli, or downloadunraidclaw-cli-0.1.36.tar.gzfor machines without npm. Verify it with the.sha256file, extract it, and make sure Node.js 22 or newer is onPATH. Runs on Linux, macOS and Windows; see the CLI guide. - OpenClaw plugin: see OpenClaw plugin in the README for install and update commands.
- Checksums: the
.md5file covers the.txzpackage and the.sha256file covers the CLI archive.