Secure Long Running AI Agents with OpenShell on DGX Station
Run OpenClaw in an NVIDIA OpenShell sandbox on DGX Station
Confirm your environment
Verify the OS, GPU, Docker, and Python are available before installing anything.
head -n 2 /etc/os-release
nvidia-smi
docker info --format '{{.ServerVersion}}'
python3 --version
Expected output should show Ubuntu 24.04 (DGX OS), a detected GPU (e.g. NVIDIA GB300 on DGX Station), a Docker server version, and Python 3.12+. If you access the DGX Station remotely, ensure port 18789 is available for the OpenClaw dashboard.
Docker Configuration
First, verify that the local user has Docker permissions using the following command.
docker ps
If you get a permission denied error (permission denied while trying to connect to the docker API at unix:///var/run/docker.sock), add your user to the system's Docker group. This will enable you to run Docker commands without requiring sudo. The command to do so is as follows:
sudo usermod -aG docker $USER
newgrp docker
Now that we have verified the user's Docker permission, we must configure Docker so that it can use the NVIDIA Container Runtime.
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker
Run a sample workload to verify the setup:
docker run --rm --runtime=nvidia --gpus all ubuntu nvidia-smi
Install the OpenShell CLI
Create a virtual environment and install the openshell CLI.
cd ~
uv venv openshell-env && source openshell-env/bin/activate
uv pip install openshell
openshell --help
If you don't have uv installed yet:
curl -LsSf https://astral.sh/uv/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
Expected output should show the openshell command tree with subcommands like gateway, sandbox, provider, and inference.
Deploy the OpenShell gateway on DGX Station
The gateway is the control plane that manages sandboxes. Since you are running directly on the DGX Station, it deploys locally inside Docker.
openshell gateway start
openshell status
openshell status should report the gateway as Connected. The first run may take a few minutes while Docker pulls the required images and the internal k3s cluster bootstraps.
NOTE
Remote gateway deployment requires passwordless SSH access. Ensure your SSH public key is added to ~/.ssh/authorized_keys on the DGX Station before using the --remote flag.
TIP
If you want to manage the DGX Station gateway from a separate workstation, run openshell gateway start --remote <username>@<dgx-station-ip-or-hostname> from that workstation instead. All subsequent commands will route through the SSH tunnel.
Install Ollama and pull a model
Install Ollama (if not already present) and download a model for local inference.
curl -fsSL https://ollama.com/install.sh | sh
ollama --version
DGX Station provides 252 GB VRAM, so you can run large models:
| GPU memory available | Suggested model | Model size | Notes |
|---|---|---|---|
| 25–48 GB | nemotron-3-nano | ~24GB | Lower latency, good for interactive use |
| 48–80 GB | gpt-oss:120b | ~65GB | Good balance of quality and speed |
| 252 GB (GB300) | nemotron-3-super:120b | ~86GB | Best quality on DGX Station |
Verify Ollama is running (it auto-starts as a service after installation). If not, start it manually:
ollama serve &
Configure Ollama to listen on all interfaces so the OpenShell gateway container can reach it. Create a systemd override:
mkdir -p /etc/systemd/system/ollama.service.d/
sudo nano /etc/systemd/system/ollama.service.d/override.conf
Add these lines to the file (create the file if it does not exist):
[Service]
Environment="OLLAMA_HOST=0.0.0.0"
Save and exit, then reload and restart Ollama:
sudo systemctl daemon-reload
sudo systemctl restart ollama
Verify Ollama is listening on all interfaces:
ss -tlnp | grep 11434
You should see *:11434 in the output. If it only shows 127.0.0.1:11434, confirm the override file contents and that you ran systemctl daemon-reload before restarting.
Next, run a model from Ollama (adjust the model name to match your choice from the Ollama model library). The ollama run command will pull the model automatically if it is not already present. Running the model here ensures it is loaded and ready when you use it with OpenClaw, reducing the chance of timeouts later. Example for nemotron-3-super:
ollama run nemotron-3-super:120b
Verify the model is available:
ollama list
Create an inference provider
We are going to create an OpenShell provider that points to your local Ollama server. This lets OpenShell route inference requests to your DGX Station–hosted model.
First, find the IP address of your DGX Station:
hostname -I | awk '{print $1}'
Then create the provider, replacing {Machine_IP} with the IP address from the command above (e.g. 10.110.106.169):
openshell provider create \
--name local-ollama \
--type openai \
--credential OPENAI_API_KEY=not-needed \
--config OPENAI_BASE_URL=http://{Machine_IP}:11434/v1
IMPORTANT
Do not use localhost or 127.0.0.1 here. The OpenShell gateway runs inside a Docker container, so it cannot reach the host via localhost. Use the machine's actual IP address.
Verify the provider was created:
openshell provider list
Configure inference routing
Point the inference.local endpoint (available inside every sandbox) at your Ollama model. Replace the model name with your choice from Step 5:
openshell inference set \
--provider local-ollama \
--model nemotron-3-super:120b
The output should confirm the route and show a validated endpoint URL, for example: http://10.110.106.169:11434/v1/chat/completions (openai_chat_completions).
NOTE
If you see failed to verify inference endpoint or failed to connect (for example because the gateway cannot reach the host IP from inside its container), add --no-verify to skip endpoint verification: openshell inference set --provider local-ollama --model nemotron-3-super:120b --no-verify. Ensure Ollama is running and listening on all interfaces (see Step 5).
Verify the configuration:
openshell inference get
Expected output should show provider: local-ollama and model: nemotron-3-super:120b (or whichever model you chose).
Deploy OpenShell Sandbox
Create a sandbox using the pre-built OpenClaw community sandbox. This pulls the OpenClaw Dockerfile, the default policy, and startup scripts from the OpenShell Community catalog:
openshell sandbox create \
--keep \
--forward 18789 \
--name dgx-demo \
--from openclaw \
-- openclaw-start
NOTE
Do not pass --policy with a local file path (e.g. openclaw-policy.yaml) when using --from openclaw. The policy is bundled with the community sandbox; a local file path can cause "file not found."
The --keep flag keeps the sandbox running after the initial process exits, so you can reconnect later. This is the default behavior. To terminate the sandbox when the initial process exits, use the --no-keep flag instead.
NOTE
The sandbox name is displayed in the creation output. You can also set it explicitly with --name <your-name>. To find it later, run openshell sandbox list.
The CLI will:
- Resolve
openclawagainst the community catalog - Pull and build the container image
- Apply the bundled sandbox policy
- Launch OpenClaw inside the sandbox
In order to verify the default policy enabled for your sandbox, please run the following command:
openshell sandbox get dgx-demo
Configure OpenClaw within OpenShell Sandbox
The sandbox container will spin up and the OpenClaw onboarding wizard will launch automatically in your terminal.
IMPORTANT
The onboarding wizard is fully interactive — it requires arrow-key navigation and Enter to select options. It cannot be completed from a non-interactive session (e.g. a script or automation tool). You must run openshell sandbox create from a terminal with full TTY support.
If the wizard did not complete during sandbox creation, reconnect to the sandbox to re-run it:
openshell sandbox connect dgx-demo
Use the arrow keys and Enter key to interact with the installation.
- If you understand and agree, use the arrow key of your keyboard to select 'Yes' and press the Enter key.
- Quickstart vs Manual: select Quickstart and press the Enter key.
- Model/auth Provider: Select Custom Provider, the second-to-last option.
- API Base URL: update to https://inference.local/v1
- How do you want to provide this API key?: Paste API key for now.
- API key: please enter "ollama".
- Endpoint compatibility: select OpenAI-compatible and press Enter.
- Model ID: enter the model name you chose in Step 5 (e.g.
nemotron-3-super:120b).- This may take 1-2 minutes as the Ollama model is spun up in the background.
- Endpoint ID: leave the default value.
- Alias: enter the same model name (this is optional).
- Channel: Select Skip for now.
- Skills: Select No for now.
- Enable hooks: Select No for now and press Enter.
It might take 1-2 minutes to get through the final stages. Afterwards, you should see a URL with a token you can use to connect to the gateway.
The expected output will be similar, but the token will be unique.
OpenClaw gateway starting in background.
Logs: /tmp/gateway.log
UI: http://127.0.0.1:18789/?token=9b4c9a9c9f6905131327ce55b6d044bd53e0ec423dd6189e
If you are using the DGX Station as the primary device, right-click on the URL in the UI section and select Open Link.
Accessing the dashboard from the host or a remote system: The dashboard URL (e.g. http://127.0.0.1:18789/?token=...) is inside the sandbox, so the host does not forward port 18789 by default. To reach it from your host or another machine, use SSH local port forwarding. From a machine that can reach the OpenShell gateway, run (replace gateway URL, sandbox-id, token, and gateway-name with values from your environment):
ssh -o ProxyCommand='/usr/local/bin/openshell ssh-proxy --gateway https://127.0.0.1:8080/connect/ssh --sandbox-id <sandbox-id> --token <token> --gateway-name openshell' -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o LogLevel=ERROR -N -L 18789:127.0.0.1:18789 sandbox
Then open http://127.0.0.1:18789/?token=<your-token> in your local browser.
To access from another machine, use the SSH tunnel described above, or open the dashboard URL in your browser (e.g. after port forwarding or from the DGX Station's local browser).
From this page, you can now Chat with your OpenClaw agent within the protected confines of the runtime OpenShell provides.
Conduct Inference within Sandbox
Connecting to the Sandbox (Terminal)
Now that OpenClaw has been configured within the OpenShell protected runtime, you can connect directly into the sandbox environment via:
openshell sandbox connect dgx-demo
Once loaded into the sandbox terminal, you can test connectivity to the Ollama model with this command:
curl https://inference.local/v1/responses \
-H "Content-Type: application/json" \
-d '{
"instructions": "You are a helpful assistant.",
"input": "Hello!"
}'
Verify sandbox isolation
Open a second terminal and check the sandbox status and live logs:
source ~/openshell-env/bin/activate
openshell term
The terminal dashboard shows:
- Sandbox status — name, phase, image, providers, and port forwards
- Live log stream — outbound connections, policy decisions (
allow,deny,inspect_for_inference), and inference interceptions
Verify that the OpenClaw agent can reach inference.local for model requests and that unauthorized outbound traffic is denied.
TIP
Press f to follow live output, s to filter by source, and q to quit the terminal dashboard.
Reconnect to the sandbox
If you exit the sandbox session, reconnect at any time:
openshell sandbox connect dgx-demo
NOTE
openshell sandbox connect is interactive-only — it opens a terminal session inside the sandbox. There is no way to pass a command for non-interactive execution. Use openshell sandbox upload/download for file transfers, or use the SSH proxy for scripted access (see Step 9).
To transfer files in or out (replace dgx-demo with your sandbox name if you used a different one):
openshell sandbox upload dgx-demo ./local-file /sandbox/destination
openshell sandbox download dgx-demo /sandbox/file ./local-destination
Cleanup
Stop and remove the sandbox (use the name you gave it, e.g. dgx-demo):
openshell sandbox delete dgx-demo
Stop the gateway (preserves state for later):
openshell gateway stop
WARNING
The following command permanently removes the gateway cluster and all its data.
openshell gateway destroy
Remove the inference provider you created in Step 6:
openshell provider delete local-ollama
To also remove the Ollama model:
ollama rm nemotron-3-super:120b
Next steps
- Add more providers: Attach GitHub tokens, GitLab tokens, or cloud API keys as providers with
openshell provider create. When creating the sandbox, pass the provider name(s) with--provider <name>(e.g.--provider my-github) to inject those credentials into the sandbox securely. - Try other community sandboxes: Run
openshell sandbox create --from baseor--from sdgfor other pre-built environments. - Connect VS Code: Use
openshell sandbox ssh-config <sandbox-name>and append the output to~/.ssh/configto connect VS Code Remote-SSH directly into the sandbox. - Monitor and audit: Use
openshell logs <sandbox-name> --tailoropenshell termto continuously monitor agent activity and policy decisions.