diff --git a/README.md b/README.md
index 39e88a6..361f35b 100644
--- a/README.md
+++ b/README.md
@@ -60,6 +60,8 @@ Runtime/toolchain versions used during development:
- OpenShell CLI and gateway compatible with current `NVIDIA/NemoClaw` blueprint constraints
- NemoClaw CLI compatible with the current `NVIDIA/NemoClaw` repo
+Sandbox creation follows NemoClaw's OpenShell routed-name contract: names are 1-19 characters, start with a lowercase letter, contain only lowercase letters, numbers, and single internal hyphens, and end with a letter or number.
+
Use `./install_versioned_nemoclaw_openshell.sh` to install or refresh the OpenShell/NemoClaw pair. Override `OPENSHELL_VERSION`, `NEMOCLAW_INSTALL_REF`, or `OPENCLAW_VERSION` only when intentionally testing a different pair.
The app uses Next.js `15.5.15`, React `18.3.1`, TypeScript, Tailwind CSS, `ws`, `node-pty`, and the official MCP TypeScript SDK.
diff --git a/app/api/sandbox/create/route.ts b/app/api/sandbox/create/route.ts
index 1272c0a..01b7696 100644
--- a/app/api/sandbox/create/route.ts
+++ b/app/api/sandbox/create/route.ts
@@ -27,9 +27,9 @@ const NEMOCLAW_STATE_ROOT = path.join(process.env.HOME || "/tmp", ".nemoclaw")
function validateSandboxName(name: string) {
if (!name || typeof name !== "string") throw new Error("sandbox name is required")
- if (name.length > 63) throw new Error("sandbox name too long (max 63 chars)")
- if (!/^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/.test(name)) {
- throw new Error("sandbox name must be lowercase alphanumeric with optional internal hyphens")
+ if (name.length > 19) throw new Error("sandbox name too long (max 19 chars)")
+ if (!/^(?!.*--)[a-z]([a-z0-9-]*[a-z0-9])?$/.test(name)) {
+ throw new Error("sandbox name must start with a lowercase letter and contain only lowercase letters, numbers, and single internal hyphens")
}
return name
}
diff --git a/app/components/ConfigurationPanel.tsx b/app/components/ConfigurationPanel.tsx
index 2d1f957..2035c65 100644
--- a/app/components/ConfigurationPanel.tsx
+++ b/app/components/ConfigurationPanel.tsx
@@ -220,8 +220,8 @@ export default function ConfigurationPanel({ sandboxId, mode = 'existing', onCre
))}