mirror of https://github.com/openclaw/openclaw.git synced 2026-08-27 12:56:01 -06:00

Files

T

History

Peter Steinberger 162e8d1394 refactor(plugins): derive private config types from schemas (#130414 )

* refactor(plugins): derive private config types from schemas

* test(ci): make directory binding proof deterministic

Replace race-prone child-cwd polling with a synchronous fixture retarget after the real chdir, preserving the full worker and security assertions. Shrink the assertion-safety baseline for the three casts removed by the schema cleanup.

2026-08-26 17:21:24 -07:00

src

refactor(plugins): derive private config types from schemas (#130414 )

2026-08-26 17:21:24 -07:00

index.ts

…

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