From b00f27498d22f7e0c2ab3d5135c086690e7bcaa6 Mon Sep 17 00:00:00 2001 From: Charan Jagwani Date: Mon, 20 Apr 2026 10:25:05 -0700 Subject: [PATCH] docs: use ~/nemoclaw instead of hardcoded /home/ubuntu (#1319) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit CLI deploy was fixed in #1470 (detects remote $HOME), but docs and regenerated skills still told users to `cd /home/ubuntu/nemoclaw` in post-deploy SSH examples — which fails on shadecloud and other Brev providers that use non-ubuntu usernames. Co-Authored-By: Claude Opus 4.7 (1M context) Signed-off-by: Charan Jagwani --- .agents/skills/nemoclaw-user-deploy-remote/SKILL.md | 2 +- .agents/skills/nemoclaw-user-manage-policy/SKILL.md | 2 +- .../references/troubleshooting.md | 12 ++++++++++++ docs/deployment/deploy-to-remote-gpu.md | 2 +- docs/network-policy/approve-network-requests.md | 2 +- 5 files changed, 16 insertions(+), 4 deletions(-) diff --git a/.agents/skills/nemoclaw-user-deploy-remote/SKILL.md b/.agents/skills/nemoclaw-user-deploy-remote/SKILL.md index 025268d78ea..ae5db1b3e7c 100644 --- a/.agents/skills/nemoclaw-user-deploy-remote/SKILL.md +++ b/.agents/skills/nemoclaw-user-deploy-remote/SKILL.md @@ -71,7 +71,7 @@ $ nemoclaw deploy SSH to the instance and run the OpenShell TUI to monitor activity and approve network requests: ```console -$ ssh 'cd /home/ubuntu/nemoclaw && set -a && . .env && set +a && openshell term' +$ ssh 'cd ~/nemoclaw && set -a && . .env && set +a && openshell term' ``` ## Step 5: Verify Inference diff --git a/.agents/skills/nemoclaw-user-manage-policy/SKILL.md b/.agents/skills/nemoclaw-user-manage-policy/SKILL.md index bb39a63ef5b..7c03df0bbf7 100644 --- a/.agents/skills/nemoclaw-user-manage-policy/SKILL.md +++ b/.agents/skills/nemoclaw-user-manage-policy/SKILL.md @@ -30,7 +30,7 @@ $ openshell term For a remote sandbox, pass the instance name: ```console -$ ssh my-gpu-box 'cd /home/ubuntu/nemoclaw && . .env && openshell term' +$ ssh my-gpu-box 'cd ~/nemoclaw && . .env && openshell term' ``` The TUI displays the sandbox state, active inference provider, and a live feed of network activity. diff --git a/.agents/skills/nemoclaw-user-reference/references/troubleshooting.md b/.agents/skills/nemoclaw-user-reference/references/troubleshooting.md index caa146c90ad..ab8952e3ce5 100644 --- a/.agents/skills/nemoclaw-user-reference/references/troubleshooting.md +++ b/.agents/skills/nemoclaw-user-reference/references/troubleshooting.md @@ -350,6 +350,18 @@ The status command detects the sandbox context and reports "active (inside sandb Run `openshell sandbox list` on the host to check the underlying sandbox state. +### `openclaw update` hangs or times out inside the sandbox + +This is expected for the current NemoClaw deployment model. +NemoClaw installs `openclaw` into the sandbox image at build time, so the CLI is image-pinned rather than updated in place inside a running sandbox. + +Do not run `openclaw update` inside the sandbox. +Instead: + +1. Upgrade to a NemoClaw release that includes the newer `openclaw` version. +2. If you build NemoClaw from source, bump the pinned `openclaw` version in `Dockerfile.base` and rebuild the sandbox base image. +3. Back up any workspace files you need, then recreate the sandbox so it uses the rebuilt image. + ### Inference requests time out Verify that the inference provider endpoint is reachable from the host. diff --git a/docs/deployment/deploy-to-remote-gpu.md b/docs/deployment/deploy-to-remote-gpu.md index ef001142981..6c3b45c14dc 100644 --- a/docs/deployment/deploy-to-remote-gpu.md +++ b/docs/deployment/deploy-to-remote-gpu.md @@ -83,7 +83,7 @@ $ nemoclaw deploy SSH to the instance and run the OpenShell TUI to monitor activity and approve network requests: ```console -$ ssh 'cd /home/ubuntu/nemoclaw && set -a && . .env && set +a && openshell term' +$ ssh 'cd ~/nemoclaw && set -a && . .env && set +a && openshell term' ``` ## Verify Inference diff --git a/docs/network-policy/approve-network-requests.md b/docs/network-policy/approve-network-requests.md index 57ed29908f9..e765377984c 100644 --- a/docs/network-policy/approve-network-requests.md +++ b/docs/network-policy/approve-network-requests.md @@ -41,7 +41,7 @@ $ openshell term For a remote sandbox, pass the instance name: ```console -$ ssh my-gpu-box 'cd /home/ubuntu/nemoclaw && . .env && openshell term' +$ ssh my-gpu-box 'cd ~/nemoclaw && . .env && openshell term' ``` The TUI displays the sandbox state, active inference provider, and a live feed of network activity.