mirror of https://github.com/openclaw/openclaw.git synced 2026-08-28 05:16:23 -06:00

Files

T

History

Peter Steinberger 430d2caa56 fix(sandbox): retire plugin backends with registry lifecycle (#130662 )

* fix(openshell): unregister sandbox backend on plugin stop

Bind the explicit backend disposer to the plugin service lifetime so disabling or reloading OpenShell retires its factory, manager, and workdir hooks together. Preserve the core registry's stale and repeated disposer semantics.

* fix(sandbox): retire plugin backends with registry lifecycle

2026-08-27 12:54:25 -07:00

src

fix(openshell): preserve nested host symlinks during mirror sync (#131122 )

2026-08-27 12:43:30 -07:00

.npmignore

fix(release): restore bundled plugin package validation (#130875 )

2026-08-27 19:32:29 +08:00

index.test.ts

fix(sandbox): retire plugin backends with registry lifecycle (#130662 )

2026-08-27 12:54:25 -07:00

index.ts

fix(sandbox): retire plugin backends with registry lifecycle (#130662 )

2026-08-27 12:54:25 -07:00

openclaw.plugin.json

fix(openshell): sandbox cleanup, workspace sync, and gateway setup failures (#129641 )

2026-08-25 18:08:55 -07:00

package.json

chore(release): prepare 2026.8.1 (#120375 )

2026-08-07 18:44:12 -07:00

README.md

fix(sandbox): restore reliable OpenShell execution and workspace integrity (#130031 )

2026-08-26 03:10:07 -07:00

tsconfig.json

refactor(plugins): inherit shared package boundary settings (#117474 )

2026-08-01 09:11:09 -07:00

README.md

@openclaw/openshell-sandbox

Official NVIDIA OpenShell sandbox backend for OpenClaw.

This plugin lets OpenClaw use OpenShell-managed local or remote sandboxes with SSH command execution. Choose mirror mode for a synchronized local workspace or remote mode for a remote-canonical workspace.

Mirror operations sharing a workspace run sequentially so concurrent agent turns cannot overwrite one another. Outbound attachments resolve against the configured remote workspace, which defaults to /sandbox.

Configuring an OpenShell workspace requires OpenShell v0.0.88 or newer. The plugin supports OpenShell control-plane workspaces through plugins.entries.openshell.config.workspace; this is separate from OpenClaw's local/remote filesystem workspace mode. The setting applies to the whole plugin instance, not individual agents or sessions. When unset, the plugin preserves the OpenShell CLI's ambient OPENSHELL_WORKSPACE selection, or its default fallback when no ambient selection exists.

Install

openclaw plugins install @openclaw/openshell-sandbox

Restart the Gateway after installing or updating the plugin.

Configure

Install and configure the OpenShell CLI before enabling the backend. As the same operating system user that runs the OpenClaw Gateway, verify:

openshell --version
openshell gateway list
openshell sandbox list

Set agents.defaults.sandbox.backend to "openshell", enable plugins.entries.openshell, and restart the OpenClaw Gateway. OpenShell settings belong under plugins.entries.openshell.config.

The optional policy setting must be the path to a readable OpenShell policy YAML file on the Gateway host; it is not a policy name or ID. Use an absolute path to avoid resolving it relative to an agent workspace.

Use the OpenShell docs for credentials, workspace mirroring, runtime selection, and troubleshooting:

https://docs.openclaw.ai/gateway/openshell

Package

Plugin id: openshell
Package: @openclaw/openshell-sandbox
Minimum OpenClaw host: 2026.5.12-beta.1