From e3eb9bde0a35cdfe5453ea257a19596848fe5bc3 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 04:45:49 -0700 Subject: [PATCH 01/27] fix: stop agents where group signals are denied OpenShell's sandbox denies signals to a process group with EPERM. The OpenClaw adapter let that error escape its stop and left the Gateway running until the sandbox went away, and the ACP runner left the agent process running the same way. Both now signal the child itself when the group signal is denied. The Python adapters share `common.utils.signal_process_group` for this. Not covered here: the Codex adapter's SIGKILL of its app server, which has the same pattern. Signed-off-by: Carlos Villela --- .../src/nemo_fabric_adapters/common/utils.py | 17 +++++++++ .../nemo_fabric_adapters/openclaw/adapter.py | 17 +++------ adapters/typescript/common/src/acp-runner.ts | 10 ++++- .../common/test/acp-runner.test.mjs | 37 +++++++++++++++++-- .../strands/test/strands-acp.test.mjs | 7 ++-- tests/adapters/test_openclaw.py | 25 +++++++++++++ 6 files changed, 94 insertions(+), 19 deletions(-) diff --git a/adapters/python/common/src/nemo_fabric_adapters/common/utils.py b/adapters/python/common/src/nemo_fabric_adapters/common/utils.py index 9878b63e5..c45b6c10f 100644 --- a/adapters/python/common/src/nemo_fabric_adapters/common/utils.py +++ b/adapters/python/common/src/nemo_fabric_adapters/common/utils.py @@ -9,6 +9,7 @@ import json import os import re +import signal import sys import uuid from contextlib import nullcontext @@ -790,3 +791,19 @@ def write_relay_configs( def relay_model_name(payload: dict[str, Any]) -> str: return selected_model_config(payload).get("model") or "unknown" + + +def signal_process_group(pid: int, signum: signal.Signals) -> None: + """Signal a child's process group, or only the child where that's denied. + + OpenShell's sandbox denies signals to a process group with EPERM. + """ + try: + os.killpg(pid, signum) + except ProcessLookupError: + pass + except PermissionError: + try: + os.kill(pid, signum) + except ProcessLookupError: + pass diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py index 7c616642b..7e082eead 100644 --- a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py @@ -1583,10 +1583,7 @@ def _forward_gateway_signal(self, signum: int) -> None: process = self._process if process is None or process.returncode is not None: return - try: - os.killpg(process.pid, signum) - except ProcessLookupError: - pass + common_utils.signal_process_group(process.pid, signum) async def _wait_started(self, port: int, token: str, timeout: float) -> None: deadline = asyncio.get_running_loop().time() + timeout @@ -1735,10 +1732,7 @@ async def stop(self) -> None: if os.name == "nt": process.terminate() else: - try: - os.killpg(process.pid, signal.SIGTERM) - except ProcessLookupError: - pass + common_utils.signal_process_group(process.pid, signal.SIGTERM) try: await asyncio.wait_for( process.wait(), timeout=self._shutdown_timeout @@ -1749,10 +1743,9 @@ async def stop(self) -> None: if os.name == "nt": process.kill() else: - try: - os.killpg(process.pid, signal.SIGKILL) - except ProcessLookupError: - pass + common_utils.signal_process_group( + process.pid, signal.SIGKILL + ) try: await process.wait() except asyncio.CancelledError as error: diff --git a/adapters/typescript/common/src/acp-runner.ts b/adapters/typescript/common/src/acp-runner.ts index d2dd97a2d..fdfac458c 100644 --- a/adapters/typescript/common/src/acp-runner.ts +++ b/adapters/typescript/common/src/acp-runner.ts @@ -141,7 +141,15 @@ async function terminateProcessTree(child: ChildProcessWithoutNullStreams, timeo try { process.kill(-pid, signal); } catch (error) { - if ((error as NodeJS.ErrnoException).code !== "ESRCH") throw error; + const code = (error as NodeJS.ErrnoException).code; + if (code === "ESRCH") return; + // OpenShell's sandbox denies signals to a process group; signal the agent itself. + if (code !== "EPERM") throw error; + try { + process.kill(pid, signal); + } catch (fallbackError) { + if ((fallbackError as NodeJS.ErrnoException).code !== "ESRCH") throw fallbackError; + } } }; // Each agent has its own process group, including tool and MCP children. diff --git a/adapters/typescript/common/test/acp-runner.test.mjs b/adapters/typescript/common/test/acp-runner.test.mjs index db8da8019..8474c14ed 100644 --- a/adapters/typescript/common/test/acp-runner.test.mjs +++ b/adapters/typescript/common/test/acp-runner.test.mjs @@ -213,10 +213,11 @@ test("retries process-group termination after a failed stop", { skip: process.pl }); const pids = JSON.parse(await readFile(marker, "utf8")); const originalKill = process.kill.bind(process); - let failTermination = true; + // Deny the first stop's group signal and its fallback to the agent itself. + let deniedTerminations = 2; const kill = t.mock.method(process, "kill", (pid, signal) => { - if (pid === -pids.parent && signal === "SIGTERM" && failTermination) { - failTermination = false; + if (Math.abs(pid) === pids.parent && signal === "SIGTERM" && deniedTerminations > 0) { + deniedTerminations -= 1; throw Object.assign(new Error("termination denied"), { code: "EPERM" }); } return originalKill(pid, signal); @@ -252,3 +253,33 @@ test("retries process-group termination after a failed stop", { skip: process.pl } if (cleanupError !== undefined) throw cleanupError; }); + +test("stops the agent where process-group signals are denied", { skip: process.platform === "win32" }, async (t) => { + const directory = await mkdtemp(join(tmpdir(), "fabric-acp-denied-")); + const marker = join(directory, "pids.json"); + const session = await startAcpSession({ + command: process.execPath, + args: [fixture], + cwd: process.cwd(), + env: { ...process.env, TEST_DESCENDANT_MARKER: marker }, + shutdownTimeoutMs: 1_000, + }); + const pids = JSON.parse(await readFile(marker, "utf8")); + const originalKill = process.kill.bind(process); + // OpenShell's sandbox denies every signal to a process group. + const kill = t.mock.method(process, "kill", (pid, signal) => { + if (pid < 0) throw Object.assign(new Error("group signals denied"), { code: "EPERM" }); + return originalKill(pid, signal); + }); + try { + await session.stop(); + await waitForProcessToStop(pids.parent); + } finally { + kill.mock.restore(); + for (const pid of [pids.parent, pids.child]) { + try { originalKill(pid, "SIGKILL"); } catch (error) { + if (error.code !== "ESRCH") throw error; + } + } + } +}); diff --git a/adapters/typescript/strands/test/strands-acp.test.mjs b/adapters/typescript/strands/test/strands-acp.test.mjs index dbdc1f051..36d6d9f80 100644 --- a/adapters/typescript/strands/test/strands-acp.test.mjs +++ b/adapters/typescript/strands/test/strands-acp.test.mjs @@ -212,10 +212,11 @@ test("retains a timed-out runtime session until process cleanup succeeds", { ski const { pid: parent } = JSON.parse(await readFile(input.runtimeContext.environment.env.TEST_STRANDS_STATE, "utf8")); const { pid: child } = JSON.parse(await readFile(descendantState, "utf8")); const originalKill = process.kill.bind(process); - let failTermination = true; + // Deny the first stop's group signal and its fallback to the agent itself. + let deniedTerminations = 2; const kill = t.mock.method(process, "kill", (pid, signal) => { - if (pid === -parent && signal === "SIGTERM" && failTermination) { - failTermination = false; + if (Math.abs(pid) === parent && signal === "SIGTERM" && deniedTerminations > 0) { + deniedTerminations -= 1; throw Object.assign(new Error("termination denied"), { code: "EPERM" }); } return originalKill(pid, signal); diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index ffb1d7c67..f6f344fce 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -1323,6 +1323,31 @@ async def test_openclaw_stop_continues_after_cleanup_failures( assert runtime._temp_dir is None +@pytest.mark.skipif(os.name == "nt", reason="Requires POSIX process groups") +async def test_openclaw_stop_ends_the_gateway_where_group_signals_are_denied( + mock_openclaw: Path, tmp_path: Path, monkeypatch: pytest.MonkeyPatch +): + os.environ["FAKE_OPENCLAW_CAPTURE"] = str(tmp_path / "config.json") + runtime = adapter.OpenClawRuntime() + await runtime.start( + { + "config": _config(mock_openclaw), + "runtime_context": _context(tmp_path).to_mapping(), + "base_dir": str(tmp_path), + } + ) + gateway = runtime._process + + # OpenShell's sandbox denies signals to a process group with EPERM. + def deny_group_signals(_pgid: int, _signum: int) -> None: + raise PermissionError(1, "Operation not permitted") + + monkeypatch.setattr(os, "killpg", deny_group_signals) + await runtime.stop() + + assert gateway.returncode is not None + + @pytest.mark.parametrize("phase", ["client", "process", "logs"]) async def test_openclaw_stop_completes_cleanup_before_propagating_cancellation( monkeypatch: pytest.MonkeyPatch, phase: str From 7bb12a1cbb7d43b5c229ee19e9278bf621391254 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 04:47:10 -0700 Subject: [PATCH 02/27] fix: bound OpenClaw's whole start by one deadline On busy hosts, such as CI runners starting three agents at once on four vCPUs, the Gateway took close to 40 s to become ready. Each startup step had its own 30 s timeout, so start failed at random and could also run past NeMo Fabric's 90 s start limit. `startup_timeout_seconds` now bounds all of start, from checking the `openclaw` command to the Gateway becoming ready, with a 60 s default. The descriptor caps it at 75 s so start stays within Fabric's limit. OpenClaw 2026.9.34 also starts a background lookup of catalog.openclaw.ai once the Gateway is ready. The adapter already turns off update checks and telemetry, and now sets `models.catalogRefresh.enabled` to false too. Signed-off-by: Carlos Villela --- adapters/python/openclaw/README.md | 2 +- .../openclaw/openclaw.fabric-adapter.json | 5 ++-- .../nemo_fabric_adapters/openclaw/adapter.py | 19 +++++++++----- docs/integrations/harness/openclaw.mdx | 2 +- .../nemo_fabric_adapter_catalog/catalog.json | 7 ++--- tests/_utils/mock_openclaw.py | 3 +++ tests/adapters/test_openclaw.py | 26 +++++++++++++++++++ 7 files changed, 51 insertions(+), 13 deletions(-) diff --git a/adapters/python/openclaw/README.md b/adapters/python/openclaw/README.md index ebdb1f2a3..a8447ddde 100644 --- a/adapters/python/openclaw/README.md +++ b/adapters/python/openclaw/README.md @@ -107,7 +107,7 @@ The following settings are specific to the OpenClaw adapter: | `agent_id` | `default` | OpenClaw agent for NeMo Fabric-originated invocations. | | `channel_config` | None | OpenClaw-native `channels` and `bindings` for a prepared service. Every binding must target `agent_id`. Managed runtimes reject this setting. | | `port_range` | Random available range | Inclusive consumer-allocated range with `start` and `end` fields; it must span at least 111 ports. | -| `startup_timeout_seconds` | `30` | Gateway startup timeout. | +| `startup_timeout_seconds` | `60` | One deadline for all of start, from checking the `openclaw` command to the Gateway becoming ready; at most 75 seconds. | | `shutdown_timeout_seconds` | `5` | Graceful shutdown timeout. | | `connect_timeout_seconds` | `10` | Local HTTP connection timeout. | | `read_timeout_seconds` | None | Local HTTP response timeout. When unset, the invocation timeout bounds the response. | diff --git a/adapters/python/openclaw/openclaw.fabric-adapter.json b/adapters/python/openclaw/openclaw.fabric-adapter.json index 862c01b2d..5d00b0240 100644 --- a/adapters/python/openclaw/openclaw.fabric-adapter.json +++ b/adapters/python/openclaw/openclaw.fabric-adapter.json @@ -67,8 +67,9 @@ "startup_timeout_seconds": { "type": "number", "exclusiveMinimum": 0, - "default": 30, - "description": "Maximum time to wait for the OpenClaw Gateway to become ready." + "maximum": 75, + "default": 60, + "description": "One deadline for all of start, from checking the OpenClaw command to the Gateway becoming ready, within NeMo Fabric's 90-second start limit." }, "shutdown_timeout_seconds": { "type": "number", diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py index 7e082eead..3b5034248 100644 --- a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py @@ -38,7 +38,7 @@ from nemo_fabric_adapters.openclaw import _windows_job -DEFAULT_STARTUP_TIMEOUT_SECONDS = 30.0 +DEFAULT_STARTUP_TIMEOUT_SECONDS = 60.0 # Fabric gives the adapter host 10 s to stop, including this wait. DEFAULT_SHUTDOWN_TIMEOUT_SECONDS = 5.0 DEFAULT_CONNECT_TIMEOUT_SECONDS = 10.0 @@ -511,6 +511,7 @@ def _openclaw_config( }, "telemetry": {"enabled": False}, "update": {"checkOnStart": False}, + "models": {"catalogRefresh": {"enabled": False}}, "discovery": {"mdns": {"mode": "off"}}, } agent_id = _agent_id(config.harness.settings if config.harness else {}) @@ -556,7 +557,7 @@ def _openclaw_config( "id": model.api_key_env, } if provider: - result["models"] = {"providers": {model.provider: provider}} + result["models"]["providers"] = {model.provider: provider} channel_config = _channel_config( config.harness.settings if config.harness else {}, agent_id=agent_id ) @@ -1084,8 +1085,14 @@ async def start(self, payload: dict[str, Any]) -> dict[str, Any] | None: startup_timeout = _positive_setting( settings, "startup_timeout_seconds", DEFAULT_STARTUP_TIMEOUT_SECONDS ) + # One deadline covers every startup step, so start ends within it. + startup_deadline = asyncio.get_running_loop().time() + startup_timeout + + def startup_remaining() -> float: + return max(startup_deadline - asyncio.get_running_loop().time(), 0.0) + version_output = await _command_output( - command, "--version", env=child_env, timeout=startup_timeout + command, "--version", env=child_env, timeout=startup_remaining() ) version = _validate_openclaw_version(version_output) from nemo_fabric_adapters.common.provenance import record_version @@ -1139,7 +1146,7 @@ async def start(self, payload: dict[str, Any]) -> dict[str, Any] | None: "validate", "--json", env=child_env, - timeout=startup_timeout, + timeout=startup_remaining(), ) if os.name == "nt": try: @@ -1152,7 +1159,7 @@ async def start(self, payload: dict[str, Any]) -> dict[str, Any] | None: gateway_command = _gateway_command( command, port=port, - prefix=await _parent_death_prefix(timeout=startup_timeout), + prefix=await _parent_death_prefix(timeout=startup_remaining()), ) self._process = await asyncio.create_subprocess_exec( *gateway_command, @@ -1179,7 +1186,7 @@ async def start(self, payload: dict[str, Any]) -> dict[str, Any] | None: ), ] self._install_signal_handlers() - await self._wait_started(port, token, startup_timeout) + await self._wait_started(port, token, startup_remaining()) self._client = httpx.AsyncClient( headers={"authorization": f"Bearer {token}"}, http2=True, diff --git a/docs/integrations/harness/openclaw.mdx b/docs/integrations/harness/openclaw.mdx index e33020a46..05add4484 100644 --- a/docs/integrations/harness/openclaw.mdx +++ b/docs/integrations/harness/openclaw.mdx @@ -71,7 +71,7 @@ harness = HarnessConfig( adapter_id="nvidia.fabric.openclaw", settings={ "openclaw_command": "/opt/openclaw/bin/openclaw", - "startup_timeout_seconds": 30, + "startup_timeout_seconds": 60, }, ) ``` diff --git a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json index 2d6fc6b90..29b4508fe 100644 --- a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json +++ b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json @@ -2091,9 +2091,10 @@ "type": "number" }, "startup_timeout_seconds": { - "default": 30, - "description": "Maximum time to wait for the OpenClaw Gateway to become ready.", + "default": 60, + "description": "One deadline for all of start, from checking the OpenClaw command to the Gateway becoming ready, within NeMo Fabric's 90-second start limit.", "exclusiveMinimum": 0, + "maximum": 75, "type": "number" } }, @@ -2105,7 +2106,7 @@ "name": "nemo-fabric-adapters-openclaw", "version": "0.7.0" }, - "sha256": "bc95c4dfeee7638a490df68073543d8632b1eb7d9957c4874d72dd8522e99c56", + "sha256": "27af873589f481bd85f2e8e5fd32826879d5d1ba1dbdd1ff0c1e1d1298bb5be0", "source": "adapters/python/openclaw/openclaw.fabric-adapter.json" }, "nvidia.fabric.opencode": { diff --git a/tests/_utils/mock_openclaw.py b/tests/_utils/mock_openclaw.py index 7316d9d45..1c8fdeb29 100755 --- a/tests/_utils/mock_openclaw.py +++ b/tests/_utils/mock_openclaw.py @@ -8,10 +8,13 @@ import os import signal import sys +import time from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer args = sys.argv[1:] +if args[:1] != ["gateway"] and (delay := os.environ.get("FAKE_OPENCLAW_COMMAND_DELAY")): + time.sleep(float(delay)) if args == ["--version"]: print("OpenClaw 2026.9.34 (fabric test)") raise SystemExit(0) diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index f6f344fce..427cd0cd0 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -481,6 +481,8 @@ async def test_openclaw_runtime_generates_config_invokes_and_cleans_up( assert generated["mcp"]["servers"]["local"]["command"] == "python" assert generated["mcp"]["servers"]["remote"]["transport"] == ("streamable-http") assert "auth" not in generated["mcp"]["servers"]["remote"] + # The sandbox would deny OpenClaw's model catalog lookup anyway. + assert generated["models"]["catalogRefresh"] == {"enabled": False} assert not state_root.exists() @@ -1323,6 +1325,30 @@ async def test_openclaw_stop_continues_after_cleanup_failures( assert runtime._temp_dir is None +async def test_openclaw_startup_timeout_bounds_all_of_start( + mock_openclaw: Path, tmp_path: Path, monkeypatch: pytest.MonkeyPatch +): + # Each command finishes within the timeout, but the two together don't. + monkeypatch.setenv("FAKE_OPENCLAW_COMMAND_DELAY", "0.6") + monkeypatch.setenv("FAKE_OPENCLAW_CAPTURE", str(tmp_path / "config.json")) + config = _config(mock_openclaw) + assert config.harness is not None + config.harness.settings["startup_timeout_seconds"] = 1 + runtime = adapter.OpenClawRuntime() + + with pytest.raises(adapter.lifecycle.LifecycleError) as caught: + await runtime.start( + { + "config": config, + "runtime_context": _context(tmp_path).to_mapping(), + "base_dir": str(tmp_path), + } + ) + + assert caught.value.code == "openclaw_command_timeout" + assert runtime._process is None + + @pytest.mark.skipif(os.name == "nt", reason="Requires POSIX process groups") async def test_openclaw_stop_ends_the_gateway_where_group_signals_are_denied( mock_openclaw: Path, tmp_path: Path, monkeypatch: pytest.MonkeyPatch From f638e4422e72a475f2a7611c2aacd5dcb1512918 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 04:50:17 -0700 Subject: [PATCH 03/27] feat: serve OpenClaw's Control UI from managed runtimes OpenClaw's Control UI is its browser dashboard and chat. With `harness.settings.interfaces.dashboard.port`, a managed runtime runs the Gateway on that exact loopback port with the Control UI on, accepting the loopback origins for it. After the Gateway starts, the adapter writes the per-start sign-in token to `/.fabric/openclaw/runtimes//interfaces/dashboard.token` with mode 0600, and `stop` removes it. Prepared and attached services reject interfaces. The descriptor's schema validates the settings, including that a dashboard port can't be combined with `port_range`; the adapter doesn't repeat those checks. The atomic owner-only file write that the service connection file already used moves to `common.local_interfaces` so the token file can share it. Left for later: extra browser origins beyond loopback, and checking on Linux that the Gateway itself owns the port. Signed-off-by: Carlos Villela --- .../common/local_interfaces.py | 35 +++++ adapters/python/openclaw/README.md | 1 + .../openclaw/openclaw.fabric-adapter.json | 29 ++++ .../nemo_fabric_adapters/openclaw/adapter.py | 92 ++++++++--- docs/integrations/harness/openclaw.mdx | 37 +++++ .../nemo_fabric_adapter_catalog/catalog.json | 41 ++++- tests/adapters/test_openclaw.py | 148 ++++++++++++++++++ 7 files changed, 359 insertions(+), 24 deletions(-) create mode 100644 adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py diff --git a/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py b/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py new file mode 100644 index 000000000..a8e30575d --- /dev/null +++ b/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py @@ -0,0 +1,35 @@ +# SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. +# SPDX-License-Identifier: Apache-2.0 + +"""Helpers for native interfaces that an adapter serves on loopback.""" + +from __future__ import annotations + +import os +import tempfile +from pathlib import Path + + +def write_private_file(path: Path, payload: str) -> None: + """Atomically write an owner-only file in an owner-only directory.""" + path.parent.mkdir(parents=True, exist_ok=True, mode=0o700) + os.chmod(path.parent, 0o700) + descriptor, temporary_name = tempfile.mkstemp( + dir=path.parent, + prefix=f".{path.name}.", + ) + try: + if hasattr(os, "fchmod"): + os.fchmod(descriptor, 0o600) + with os.fdopen(descriptor, "w", encoding="utf-8") as stream: + descriptor = -1 + stream.write(payload) + os.replace(temporary_name, path) + except BaseException: + if descriptor >= 0: + os.close(descriptor) + try: + os.unlink(temporary_name) + except FileNotFoundError: + pass + raise diff --git a/adapters/python/openclaw/README.md b/adapters/python/openclaw/README.md index a8447ddde..b7df6522c 100644 --- a/adapters/python/openclaw/README.md +++ b/adapters/python/openclaw/README.md @@ -107,6 +107,7 @@ The following settings are specific to the OpenClaw adapter: | `agent_id` | `default` | OpenClaw agent for NeMo Fabric-originated invocations. | | `channel_config` | None | OpenClaw-native `channels` and `bindings` for a prepared service. Every binding must target `agent_id`. Managed runtimes reject this setting. | | `port_range` | Random available range | Inclusive consumer-allocated range with `start` and `end` fields; it must span at least 111 ports. | +| `interfaces.dashboard` | None | Serve the Control UI on a managed runtime, with an exact `port` and optional `enabled`; see [Serve the Control UI](../../../docs/integrations/harness/openclaw.mdx#serve-the-control-ui). | | `startup_timeout_seconds` | `60` | One deadline for all of start, from checking the `openclaw` command to the Gateway becoming ready; at most 75 seconds. | | `shutdown_timeout_seconds` | `5` | Graceful shutdown timeout. | | `connect_timeout_seconds` | `10` | Local HTTP connection timeout. | diff --git a/adapters/python/openclaw/openclaw.fabric-adapter.json b/adapters/python/openclaw/openclaw.fabric-adapter.json index 5d00b0240..cfc9419f4 100644 --- a/adapters/python/openclaw/openclaw.fabric-adapter.json +++ b/adapters/python/openclaw/openclaw.fabric-adapter.json @@ -64,6 +64,32 @@ "additionalProperties": false, "description": "Inclusive consumer-allocated port range. The adapter selects a Gateway base port whose complete derived footprint through base + 110 fits within the range. When omitted, the adapter selects an available local range." }, + "interfaces": { + "type": "object", + "properties": { + "dashboard": { + "type": "object", + "properties": { + "enabled": { + "type": "boolean", + "default": true, + "description": "Serve the Control UI. A present dashboard is on unless this is false." + }, + "port": { + "type": "integer", + "minimum": 1, + "maximum": 65425, + "description": "Exact loopback Gateway base port, which serves the Control UI. Start fails if it or port + 2 is in use, and OpenClaw reserves ports through port + 110. Can't be combined with port_range." + } + }, + "required": ["port"], + "additionalProperties": false, + "description": "OpenClaw's Control UI. After the Gateway starts, the adapter writes its sign-in token to /.fabric/openclaw/runtimes//interfaces/dashboard.token." + } + }, + "additionalProperties": false, + "description": "Native interfaces served by a managed runtime. Services reject interfaces." + }, "startup_timeout_seconds": { "type": "number", "exclusiveMinimum": 0, @@ -89,6 +115,9 @@ "description": "Timeout between response bytes from the local OpenClaw Gateway. When unset, the invocation timeout bounds the response." } }, + "dependentSchemas": { + "port_range": {"properties": {"interfaces": {"properties": {"dashboard": false}}}} + }, "additionalProperties": false }, "model_schema": { diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py index 3b5034248..908652262 100644 --- a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py @@ -7,6 +7,7 @@ from __future__ import annotations import asyncio +import contextlib import copy import ipaddress import json @@ -33,6 +34,7 @@ from nemo_fabric_adapter_contract import models as contract from nemo_fabric_adapters.common import instructions as common_instructions from nemo_fabric_adapters.common import lifecycle +from nemo_fabric_adapters.common import local_interfaces from nemo_fabric_adapters.common import openai_chat from nemo_fabric_adapters.common import utils as common_utils from nemo_fabric_adapters.openclaw import _windows_job @@ -160,6 +162,31 @@ def _positive_setting(settings: dict[str, Any], name: str, default: float) -> fl return float(value) +def _dashboard_port(settings: dict[str, Any]) -> int | None: + """Return the Control UI's port when the settings enable it. + + The descriptor's schema has already checked the settings. + """ + dashboard = settings.get("interfaces", {}).get("dashboard") + if dashboard is None or not dashboard.get("enabled", True): + return None + return dashboard["port"] + + +def _dashboard_token_path(context: contract.RuntimeContext, base_dir: Path) -> Path: + root = context.artifacts.root + artifact_root = (base_dir / str(root)).resolve() if root else base_dir / "artifacts" + return ( + artifact_root + / ".fabric" + / "openclaw" + / "runtimes" + / context.runtime_id + / "interfaces" + / "dashboard.token" + ) + + def _agent_id(settings: dict[str, Any]) -> str: value = settings.get("agent_id", "default") if not isinstance(value, str) or not value.strip(): @@ -461,6 +488,7 @@ def _openclaw_config( port: int, token_env: str, service_mode: bool = False, + dashboard: bool = False, ) -> dict[str, Any]: model = _selected_model(config) model_id = _model_id(model) @@ -493,7 +521,15 @@ def _openclaw_config( "mode": "token", "token": {"source": "env", "provider": "default", "id": token_env}, }, - "controlUi": {"enabled": False}, + "controlUi": { + "enabled": True, + "allowedOrigins": [ + f"http://127.0.0.1:{port}", + f"http://localhost:{port}", + ], + } + if dashboard + else {"enabled": False}, "http": {"endpoints": {"chatCompletions": {"enabled": True}}}, }, "agents": { @@ -782,8 +818,6 @@ def _write_service_connection( token: str, agent_id: str, ) -> None: - path.parent.mkdir(parents=True, exist_ok=True, mode=0o700) - os.chmod(path.parent, 0o700) payload = ( json.dumps( { @@ -794,25 +828,7 @@ def _write_service_connection( ) + "\n" ) - descriptor, temporary_name = tempfile.mkstemp( - dir=path.parent, - prefix=f".{path.name}.", - ) - try: - if hasattr(os, "fchmod"): - os.fchmod(descriptor, 0o600) - with os.fdopen(descriptor, "w", encoding="utf-8") as stream: - descriptor = -1 - stream.write(payload) - os.replace(temporary_name, path) - except BaseException: - if descriptor >= 0: - os.close(descriptor) - try: - os.unlink(temporary_name) - except FileNotFoundError: - pass - raise + local_interfaces.write_private_file(path, payload) def _read_service_connection(path: Path) -> tuple[str, str, str]: @@ -857,6 +873,7 @@ def __init__(self) -> None: self._temp_dir: tempfile.TemporaryDirectory[str] | None = None self._port: int | None = None self._token: str | None = None + self._dashboard_token_path: Path | None = None self._gateway_url: str | None = None self._agent_id = "default" self._shutdown_timeout = DEFAULT_SHUTDOWN_TIMEOUT_SECONDS @@ -1050,6 +1067,13 @@ async def start(self, payload: dict[str, Any]) -> dict[str, Any] | None: "openclaw_invalid_service_context", "OpenClaw service context must be an object", ) + if service is not None and "interfaces" in settings: + raise lifecycle.LifecycleError( + "openclaw_interfaces_require_managed_runtime", + "OpenClaw interfaces require a managed runtime", + metadata={"field": "harness.settings.interfaces"}, + ) + dashboard_port = _dashboard_port(settings) self._service_host = service is not None and service.get("operation") in { "prepare", "attach", @@ -1106,7 +1130,20 @@ def startup_remaining() -> float: kind="component", ) - port = _select_port(settings) + if dashboard_port is None: + port = _select_port(settings) + else: + port = dashboard_port + for candidate in (port, port + 2): + if not _port_available(candidate): + raise lifecycle.LifecycleError( + "openclaw_interface_port_unavailable", + f"OpenClaw dashboard port {candidate} is already in use", + metadata={ + "field": "harness.settings.interfaces.dashboard.port", + "port": candidate, + }, + ) # Generate a one-time use token for the OpenClaw gateway token = secrets.token_urlsafe(48) @@ -1123,6 +1160,7 @@ def startup_remaining() -> float: port=port, token_env=token_env, service_mode=service is not None and service.get("operation") == "prepare", + dashboard=dashboard_port is not None, ) config_path.write_text(json.dumps(generated, indent=2) + "\n", encoding="utf-8") config_path.chmod(0o600) @@ -1187,6 +1225,10 @@ def startup_remaining() -> float: ] self._install_signal_handlers() await self._wait_started(port, token, startup_remaining()) + if dashboard_port is not None: + token_path = _dashboard_token_path(context, base_dir) + local_interfaces.write_private_file(token_path, token) + self._dashboard_token_path = token_path self._client = httpx.AsyncClient( headers={"authorization": f"Bearer {token}"}, http2=True, @@ -1708,6 +1750,10 @@ async def invoke( async def stop(self) -> None: cancellation: asyncio.CancelledError | None = None self._stopping = True + token_path, self._dashboard_token_path = self._dashboard_token_path, None + if token_path is not None: + with contextlib.suppress(OSError): + token_path.unlink(missing_ok=True) try: self._restore_signal_handlers() except Exception: diff --git a/docs/integrations/harness/openclaw.mdx b/docs/integrations/harness/openclaw.mdx index 05add4484..ce21a3f11 100644 --- a/docs/integrations/harness/openclaw.mdx +++ b/docs/integrations/harness/openclaw.mdx @@ -115,6 +115,43 @@ By default, the adapter chooses an available local port range. Set `port_range` to an inclusive consumer-allocated range with `start` and `end` fields. The range must span at least 111 ports. OpenClaw's [derived-port mapping](https://docs.openclaw.ai/gateway/multiple-gateways#port-mapping-derived) uses `base_port + 2` for browser control and allocates browser CDP ports from `base_port + 11` through `base_port + 110`. The adapter verifies only that `base_port` and `base_port + 2` are available before startup. OpenClaw allocates the CDP ports on demand instead of reserving the complete range, so the adapter cannot guarantee that those ports will still be available when OpenClaw needs them. Keep the configured range reserved for the lifetime of the runtime or service when using OpenClaw browser features. +## Serve the Control UI + +OpenClaw's Control UI is its browser dashboard and chat. A managed runtime +serves it when `harness.settings.interfaces.dashboard` is present: + +```python +from nemo_fabric import HarnessConfig + +harness = HarnessConfig( + adapter_id="nvidia.fabric.openclaw", + settings={"interfaces": {"dashboard": {"port": 18789}}}, +) +``` + +- The Gateway listens on `127.0.0.1` at the dashboard `port`, which serves the + Control UI. `start` fails with `openclaw_interface_port_unavailable` if + `port` or `port + 2` is in use. OpenClaw also uses `port + 10` for its + browser relay and allocates browser CDP ports from `port + 11` through + `port + 110`, so reserve the whole range from `port` through `port + 110`. + `port` can't be combined with `port_range`; set `enabled` to `false` to keep + a configured dashboard off. +- After the Gateway starts, the adapter writes the sign-in token, generated at + each start, to + `/.fabric/openclaw/runtimes//interfaces/dashboard.token` + with mode `0600`. `stop` removes it; if the adapter host is killed, the file + can remain. +- Open `http://127.0.0.1:/#token=` through a forward to that + port to sign in. The Control UI removes the token from the address bar. + OpenClaw 2026.9.34 accepts any loopback origin, such as a forward to a + different local port; the token is still required. +- Processes that run as the runtime's user, including the agent's own tools, + can read the token and reach the port. +- The adapter regenerates OpenClaw's configuration at each start and marks it + read-only, so changes made through the Control UI don't survive a restart. +- Prepared and attached services reject `interfaces` with + `openclaw_interfaces_require_managed_runtime`. + ## Use a Shared Service Call `prepare_service()` to map the normalized `FabricConfig` to diff --git a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json index 29b4508fe..ba0937b1e 100644 --- a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json +++ b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json @@ -2001,6 +2001,17 @@ "settings_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, + "dependentSchemas": { + "port_range": { + "properties": { + "interfaces": { + "properties": { + "dashboard": false + } + } + } + } + }, "properties": { "agent_id": { "default": "default", @@ -2053,6 +2064,34 @@ "exclusiveMinimum": 0, "type": "number" }, + "interfaces": { + "additionalProperties": false, + "description": "Native interfaces served by a managed runtime. Services reject interfaces.", + "properties": { + "dashboard": { + "additionalProperties": false, + "description": "OpenClaw's Control UI. After the Gateway starts, the adapter writes its sign-in token to /.fabric/openclaw/runtimes//interfaces/dashboard.token.", + "properties": { + "enabled": { + "default": true, + "description": "Serve the Control UI. A present dashboard is on unless this is false.", + "type": "boolean" + }, + "port": { + "description": "Exact loopback Gateway base port, which serves the Control UI. Start fails if it or port + 2 is in use, and OpenClaw reserves ports through port + 110. Can't be combined with port_range.", + "maximum": 65425, + "minimum": 1, + "type": "integer" + } + }, + "required": [ + "port" + ], + "type": "object" + } + }, + "type": "object" + }, "openclaw_command": { "description": "OpenClaw executable name or path. Relative paths containing a directory are resolved from the NeMo Fabric base directory.", "minLength": 1, @@ -2106,7 +2145,7 @@ "name": "nemo-fabric-adapters-openclaw", "version": "0.7.0" }, - "sha256": "27af873589f481bd85f2e8e5fd32826879d5d1ba1dbdd1ff0c1e1d1298bb5be0", + "sha256": "5a90fc71ffd726f09d952162d0fa49e5fcc153a2398c37467815ffafd1ecfd93", "source": "adapters/python/openclaw/openclaw.fabric-adapter.json" }, "nvidia.fabric.opencode": { diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index 427cd0cd0..1a48e6ce2 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -11,6 +11,7 @@ import os import shutil import signal +import socket import subprocess import sys import time @@ -98,11 +99,30 @@ def _config(command: Path, *, with_skills: bool = False) -> AgentConfig: ) +def _dashboard_config(command: Path, dashboard: dict[str, object]) -> AgentConfig: + config = _config(command) + assert config.harness is not None + config.harness.settings["interfaces"] = {"dashboard": dashboard} + return config + + +def _dashboard_token(base_dir: Path) -> Path: + return ( + base_dir + / "artifacts/.fabric/openclaw/runtimes/openclaw-runtime/interfaces/dashboard.token" + ) + + @pytest.fixture(name="mock_openclaw") def mock_openclaw_fixture(repo_root: Path) -> Path: return repo_root / "tests/_utils/mock_openclaw.py" +@pytest.fixture(name="dashboard_port") +def dashboard_port_fixture() -> int: + return adapter._select_port({}) + + def test_openclaw_port_availability_checks_one_port( monkeypatch: pytest.MonkeyPatch, ): @@ -183,6 +203,46 @@ def test_openclaw_rejects_invalid_port_range(settings: dict[str, object]): assert caught.value.metadata == {"field": "harness.settings.port_range"} +@pytest.mark.parametrize( + "settings", + [ + pytest.param({"interfaces": {"terminal": {}}}, id="unsupported-interface"), + pytest.param( + {"interfaces": {"dashboard": {"port": 20_000, "token": "x"}}}, + id="unknown-field", + ), + pytest.param({"interfaces": {"dashboard": {}}}, id="missing-port"), + pytest.param({"interfaces": {"dashboard": {"port": 65_426}}}, id="port-too-high"), + pytest.param( + { + "interfaces": {"dashboard": {"port": 20_000}}, + "port_range": {"start": 20_000, "end": 20_200}, + }, + id="port-range-with-dashboard", + ), + pytest.param({"startup_timeout_seconds": 76}, id="startup-timeout-too-long"), + ], +) +def test_openclaw_plan_rejects_invalid_settings( + tmp_path: Path, settings: dict[str, object] +): + config = FabricConfig.from_mapping( + { + "metadata": {"name": "openclaw-interfaces"}, + "harness": { + "adapter_id": "nvidia.fabric.openclaw", + "resolution": "preinstalled", + "settings": settings, + }, + "models": {"default": {"provider": "test", "model": "fabric-echo"}}, + "environment": {"provider": "local", "workspace": "."}, + } + ) + + with pytest.raises(FabricConfigError): + Fabric().plan(config, base_dir=tmp_path) + + @pytest.mark.parametrize("raw", ["2026.9.34 extra", "2026.9.34\nuntrusted suffix"]) async def test_gateway_records_the_same_version_it_validates(monkeypatch, raw): from nemo_fabric_adapters.common import provenance @@ -481,6 +541,8 @@ async def test_openclaw_runtime_generates_config_invokes_and_cleans_up( assert generated["mcp"]["servers"]["local"]["command"] == "python" assert generated["mcp"]["servers"]["remote"]["transport"] == ("streamable-http") assert "auth" not in generated["mcp"]["servers"]["remote"] + assert generated["gateway"]["controlUi"] == {"enabled": False} + assert not (tmp_path / "artifacts").exists() # The sandbox would deny OpenClaw's model catalog lookup anyway. assert generated["models"]["catalogRefresh"] == {"enabled": False} assert not state_root.exists() @@ -1325,6 +1387,92 @@ async def test_openclaw_stop_continues_after_cleanup_failures( assert runtime._temp_dir is None +@pytest.mark.skipif(sys.platform == "win32", reason="Requires POSIX file permissions") +async def test_openclaw_dashboard_serves_control_ui_with_a_token_file( + mock_openclaw: Path, tmp_path: Path, dashboard_port: int +): + capture = tmp_path / "config.json" + os.environ["FAKE_OPENCLAW_CAPTURE"] = str(capture) + token_path = _dashboard_token(tmp_path) + runtime = adapter.OpenClawRuntime() + + await runtime.start( + { + "config": _dashboard_config(mock_openclaw, {"port": dashboard_port}), + "runtime_context": _context(tmp_path).to_mapping(), + "base_dir": str(tmp_path), + } + ) + try: + gateway_token = runtime._token + stored_token = token_path.read_text(encoding="utf-8") + token_mode = token_path.stat().st_mode & 0o777 + directory_mode = token_path.parent.stat().st_mode & 0o777 + finally: + await runtime.stop() + + generated = json.loads(capture.read_text(encoding="utf-8")) + assert generated["gateway"]["port"] == dashboard_port + assert generated["gateway"]["controlUi"] == { + "enabled": True, + "allowedOrigins": [ + f"http://127.0.0.1:{dashboard_port}", + f"http://localhost:{dashboard_port}", + ], + } + assert stored_token == gateway_token + assert token_mode == 0o600 + assert directory_mode == 0o700 + assert not token_path.exists() + + +@pytest.mark.parametrize("offset", [0, 2]) +async def test_openclaw_dashboard_port_in_use_fails_start( + mock_openclaw: Path, tmp_path: Path, dashboard_port: int, offset: int +): + runtime = adapter.OpenClawRuntime() + + with socket.create_server(("127.0.0.1", dashboard_port + offset)): + with pytest.raises(adapter.lifecycle.LifecycleError) as caught: + await runtime.start( + { + "config": _dashboard_config( + mock_openclaw, {"port": dashboard_port} + ), + "runtime_context": _context(tmp_path).to_mapping(), + "base_dir": str(tmp_path), + } + ) + + assert caught.value.code == "openclaw_interface_port_unavailable" + assert caught.value.metadata == { + "field": "harness.settings.interfaces.dashboard.port", + "port": dashboard_port + offset, + } + assert runtime._process is None + assert not (tmp_path / "artifacts").exists() + + +@pytest.mark.parametrize("operation", ["prepare", "attach", "connect"]) +async def test_openclaw_services_reject_interfaces( + mock_openclaw: Path, tmp_path: Path, operation: str +): + runtime = adapter.OpenClawRuntime() + + with pytest.raises(adapter.lifecycle.LifecycleError) as caught: + await runtime.start( + { + "config": _dashboard_config(mock_openclaw, {"port": 20_000}), + "runtime_context": _context(tmp_path).to_mapping(), + "base_dir": str(tmp_path), + "service": {"operation": operation}, + } + ) + + assert caught.value.code == "openclaw_interfaces_require_managed_runtime" + assert runtime._process is None + + async def test_openclaw_startup_timeout_bounds_all_of_start( mock_openclaw: Path, tmp_path: Path, monkeypatch: pytest.MonkeyPatch ): From dde1815c7bbec98f247246d48e89a44ba6bf6547 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 12:55:45 -0700 Subject: [PATCH 04/27] test: skip the OpenClaw tests that run the mock script where CI can't Signed-off-by: Carlos Villela --- tests/adapters/test_openclaw.py | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index 1a48e6ce2..5d9f0afb0 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -1426,6 +1426,7 @@ async def test_openclaw_dashboard_serves_control_ui_with_a_token_file( assert not token_path.exists() +@pytest.mark.skipif(sys.platform == "win32", reason="Runs the mock openclaw script directly") @pytest.mark.parametrize("offset", [0, 2]) async def test_openclaw_dashboard_port_in_use_fails_start( mock_openclaw: Path, tmp_path: Path, dashboard_port: int, offset: int @@ -1473,6 +1474,7 @@ async def test_openclaw_services_reject_interfaces( assert runtime._process is None +@pytest.mark.skipif(sys.platform == "win32", reason="Runs the mock openclaw script directly") async def test_openclaw_startup_timeout_bounds_all_of_start( mock_openclaw: Path, tmp_path: Path, monkeypatch: pytest.MonkeyPatch ): @@ -1497,7 +1499,10 @@ async def test_openclaw_startup_timeout_bounds_all_of_start( assert runtime._process is None -@pytest.mark.skipif(os.name == "nt", reason="Requires POSIX process groups") +@pytest.mark.skipif( + sys.platform in {"darwin", "win32"}, + reason="Starts the mock Gateway, which CI runs only on Linux", +) async def test_openclaw_stop_ends_the_gateway_where_group_signals_are_denied( mock_openclaw: Path, tmp_path: Path, monkeypatch: pytest.MonkeyPatch ): From 075f8c4455b7631a12ff0ea2e736d28cc554fa11 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 17:05:22 -0700 Subject: [PATCH 05/27] docs: correct OpenClaw's dashboard port and token file claims OpenClaw allocates browser CDP ports through port + 110 on demand; it doesn't reserve them. The dashboard port description now says to keep that range free. The token file is owner-only only on POSIX hosts. On Windows, chmod sets only the read-only flag, so the file inherits the artifact root's permissions. The guide now says so. Signed-off-by: Carlos Villela --- .../src/nemo_fabric_adapters/common/local_interfaces.py | 6 +++++- adapters/python/openclaw/openclaw.fabric-adapter.json | 2 +- docs/integrations/harness/openclaw.mdx | 3 ++- .../src/nemo_fabric_adapter_catalog/catalog.json | 4 ++-- 4 files changed, 10 insertions(+), 5 deletions(-) diff --git a/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py b/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py index a8e30575d..51f3c1bd6 100644 --- a/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py +++ b/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py @@ -11,7 +11,11 @@ def write_private_file(path: Path, payload: str) -> None: - """Atomically write an owner-only file in an owner-only directory.""" + """Atomically write an owner-only file in an owner-only directory. + + On Windows, chmod sets only the read-only flag, so the file inherits the + directory's permissions. + """ path.parent.mkdir(parents=True, exist_ok=True, mode=0o700) os.chmod(path.parent, 0o700) descriptor, temporary_name = tempfile.mkstemp( diff --git a/adapters/python/openclaw/openclaw.fabric-adapter.json b/adapters/python/openclaw/openclaw.fabric-adapter.json index cfc9419f4..602cda7b5 100644 --- a/adapters/python/openclaw/openclaw.fabric-adapter.json +++ b/adapters/python/openclaw/openclaw.fabric-adapter.json @@ -79,7 +79,7 @@ "type": "integer", "minimum": 1, "maximum": 65425, - "description": "Exact loopback Gateway base port, which serves the Control UI. Start fails if it or port + 2 is in use, and OpenClaw reserves ports through port + 110. Can't be combined with port_range." + "description": "Exact loopback Gateway base port, which serves the Control UI. Start fails if it or port + 2 is in use. OpenClaw allocates browser ports through port + 110 on demand, so keep that range free. Can't be combined with port_range." } }, "required": ["port"], diff --git a/docs/integrations/harness/openclaw.mdx b/docs/integrations/harness/openclaw.mdx index ce21a3f11..8ec365a8e 100644 --- a/docs/integrations/harness/openclaw.mdx +++ b/docs/integrations/harness/openclaw.mdx @@ -139,7 +139,8 @@ harness = HarnessConfig( - After the Gateway starts, the adapter writes the sign-in token, generated at each start, to `/.fabric/openclaw/runtimes//interfaces/dashboard.token` - with mode `0600`. `stop` removes it; if the adapter host is killed, the file + with mode `0600` on POSIX hosts; on Windows, the file inherits the artifact + root's permissions. `stop` removes it; if the adapter host is killed, the file can remain. - Open `http://127.0.0.1:/#token=` through a forward to that port to sign in. The Control UI removes the token from the address bar. diff --git a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json index ba0937b1e..fe59187af 100644 --- a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json +++ b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json @@ -2078,7 +2078,7 @@ "type": "boolean" }, "port": { - "description": "Exact loopback Gateway base port, which serves the Control UI. Start fails if it or port + 2 is in use, and OpenClaw reserves ports through port + 110. Can't be combined with port_range.", + "description": "Exact loopback Gateway base port, which serves the Control UI. Start fails if it or port + 2 is in use. OpenClaw allocates browser ports through port + 110 on demand, so keep that range free. Can't be combined with port_range.", "maximum": 65425, "minimum": 1, "type": "integer" @@ -2145,7 +2145,7 @@ "name": "nemo-fabric-adapters-openclaw", "version": "0.7.0" }, - "sha256": "5a90fc71ffd726f09d952162d0fa49e5fcc153a2398c37467815ffafd1ecfd93", + "sha256": "f2420e753b7efff19d6c56a8ff00f428f07f2f0761d77f49a031e90aa7f3a057", "source": "adapters/python/openclaw/openclaw.fabric-adapter.json" }, "nvidia.fabric.opencode": { From e9d33365001e652fe96eba5640bb747017235188 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 17:05:23 -0700 Subject: [PATCH 06/27] test: cover a disabled OpenClaw dashboard and token cleanup after failed starts A dashboard with enabled false serves no Control UI and writes no token. A start that fails after writing the token removes it, and a start that times out with a dashboard configured leaves no artifacts. Signed-off-by: Carlos Villela --- tests/adapters/test_openclaw.py | 76 ++++++++++++++++++++++++++++++++- 1 file changed, 74 insertions(+), 2 deletions(-) diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index 5d9f0afb0..21e19f123 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -1426,6 +1426,74 @@ async def test_openclaw_dashboard_serves_control_ui_with_a_token_file( assert not token_path.exists() +@pytest.mark.skipif( + sys.platform in {"darwin", "win32"}, + reason="Starts the mock Gateway, which CI runs only on Linux", +) +async def test_openclaw_dashboard_disabled_serves_no_control_ui( + mock_openclaw: Path, tmp_path: Path, dashboard_port: int +): + capture = tmp_path / "config.json" + os.environ["FAKE_OPENCLAW_CAPTURE"] = str(capture) + runtime = adapter.OpenClawRuntime() + + await runtime.start( + { + "config": _dashboard_config( + mock_openclaw, {"port": dashboard_port, "enabled": False} + ), + "runtime_context": _context(tmp_path).to_mapping(), + "base_dir": str(tmp_path), + } + ) + try: + gateway_port = runtime._port + token_exists = _dashboard_token(tmp_path).exists() + finally: + await runtime.stop() + + generated = json.loads(capture.read_text(encoding="utf-8")) + assert generated["gateway"]["controlUi"] == {"enabled": False} + assert gateway_port != dashboard_port + assert not token_exists + + +@pytest.mark.skipif( + sys.platform in {"darwin", "win32"}, + reason="Starts the mock Gateway, which CI runs only on Linux", +) +async def test_openclaw_dashboard_removes_the_token_when_start_fails_after_writing_it( + mock_openclaw: Path, + tmp_path: Path, + dashboard_port: int, + monkeypatch: pytest.MonkeyPatch, +): + os.environ["FAKE_OPENCLAW_CAPTURE"] = str(tmp_path / "config.json") + token_path = _dashboard_token(tmp_path) + token_written: list[bool] = [] + + # Start reads the HTTP read timeout only after it writes the token. + def fail_after_token_write(_settings): + token_written.append(token_path.exists()) + raise RuntimeError("start failed after writing the token") + + monkeypatch.setattr(adapter, "_read_timeout", fail_after_token_write) + runtime = adapter.OpenClawRuntime() + + with pytest.raises(RuntimeError, match="after writing the token"): + await runtime.start( + { + "config": _dashboard_config(mock_openclaw, {"port": dashboard_port}), + "runtime_context": _context(tmp_path).to_mapping(), + "base_dir": str(tmp_path), + } + ) + + assert token_written == [True] + assert not token_path.exists() + assert runtime._process is None + + @pytest.mark.skipif(sys.platform == "win32", reason="Runs the mock openclaw script directly") @pytest.mark.parametrize("offset", [0, 2]) async def test_openclaw_dashboard_port_in_use_fails_start( @@ -1476,12 +1544,15 @@ async def test_openclaw_services_reject_interfaces( @pytest.mark.skipif(sys.platform == "win32", reason="Runs the mock openclaw script directly") async def test_openclaw_startup_timeout_bounds_all_of_start( - mock_openclaw: Path, tmp_path: Path, monkeypatch: pytest.MonkeyPatch + mock_openclaw: Path, + tmp_path: Path, + dashboard_port: int, + monkeypatch: pytest.MonkeyPatch, ): # Each command finishes within the timeout, but the two together don't. monkeypatch.setenv("FAKE_OPENCLAW_COMMAND_DELAY", "0.6") monkeypatch.setenv("FAKE_OPENCLAW_CAPTURE", str(tmp_path / "config.json")) - config = _config(mock_openclaw) + config = _dashboard_config(mock_openclaw, {"port": dashboard_port}) assert config.harness is not None config.harness.settings["startup_timeout_seconds"] = 1 runtime = adapter.OpenClawRuntime() @@ -1497,6 +1568,7 @@ async def test_openclaw_startup_timeout_bounds_all_of_start( assert caught.value.code == "openclaw_command_timeout" assert runtime._process is None + assert not (tmp_path / "artifacts").exists() @pytest.mark.skipif( From 427a3e3a92dd96ec6804e59c41e08a2082fc3579 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 17:02:24 -0700 Subject: [PATCH 07/27] fix: don't signal a child's PID after it exits Where group signals are denied, stop falls back to signaling the child's own PID. Once the child is reaped, that PID can belong to another process. The ACP runner now skips the fallback after the agent exits, and OpenClaw rechecks the Gateway's return code before it escalates to SIGKILL. The tests now cover an agent that ignores SIGTERM, a Gateway that needs SIGKILL, and signal forwarding, each where group signals are denied. Signed-off-by: Carlos Villela --- .../nemo_fabric_adapters/openclaw/adapter.py | 14 +-- adapters/typescript/common/src/acp-runner.ts | 2 + .../common/test/acp-runner.test.mjs | 60 ++++++------ tests/adapters/test_openclaw.py | 97 ++++++++++++++++++- 4 files changed, 139 insertions(+), 34 deletions(-) diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py index 908652262..044325cb2 100644 --- a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py @@ -1793,12 +1793,14 @@ async def stop(self) -> None: except (TimeoutError, asyncio.CancelledError) as error: if isinstance(error, asyncio.CancelledError): cancellation = cancellation or error - if os.name == "nt": - process.kill() - else: - common_utils.signal_process_group( - process.pid, signal.SIGKILL - ) + # A reaped Gateway's PID can belong to another process. + if process.returncode is None: + if os.name == "nt": + process.kill() + else: + common_utils.signal_process_group( + process.pid, signal.SIGKILL + ) try: await process.wait() except asyncio.CancelledError as error: diff --git a/adapters/typescript/common/src/acp-runner.ts b/adapters/typescript/common/src/acp-runner.ts index fdfac458c..067bbe298 100644 --- a/adapters/typescript/common/src/acp-runner.ts +++ b/adapters/typescript/common/src/acp-runner.ts @@ -145,6 +145,8 @@ async function terminateProcessTree(child: ChildProcessWithoutNullStreams, timeo if (code === "ESRCH") return; // OpenShell's sandbox denies signals to a process group; signal the agent itself. if (code !== "EPERM") throw error; + // Node reaps an exited agent, so its PID can belong to another process. + if (child.exitCode !== null || child.signalCode !== null) return; try { process.kill(pid, signal); } catch (fallbackError) { diff --git a/adapters/typescript/common/test/acp-runner.test.mjs b/adapters/typescript/common/test/acp-runner.test.mjs index 8474c14ed..e772e6270 100644 --- a/adapters/typescript/common/test/acp-runner.test.mjs +++ b/adapters/typescript/common/test/acp-runner.test.mjs @@ -254,32 +254,38 @@ test("retries process-group termination after a failed stop", { skip: process.pl if (cleanupError !== undefined) throw cleanupError; }); -test("stops the agent where process-group signals are denied", { skip: process.platform === "win32" }, async (t) => { - const directory = await mkdtemp(join(tmpdir(), "fabric-acp-denied-")); - const marker = join(directory, "pids.json"); - const session = await startAcpSession({ - command: process.execPath, - args: [fixture], - cwd: process.cwd(), - env: { ...process.env, TEST_DESCENDANT_MARKER: marker }, - shutdownTimeoutMs: 1_000, - }); - const pids = JSON.parse(await readFile(marker, "utf8")); - const originalKill = process.kill.bind(process); - // OpenShell's sandbox denies every signal to a process group. - const kill = t.mock.method(process, "kill", (pid, signal) => { - if (pid < 0) throw Object.assign(new Error("group signals denied"), { code: "EPERM" }); - return originalKill(pid, signal); - }); - try { - await session.stop(); - await waitForProcessToStop(pids.parent); - } finally { - kill.mock.restore(); - for (const pid of [pids.parent, pids.child]) { - try { originalKill(pid, "SIGKILL"); } catch (error) { - if (error.code !== "ESRCH") throw error; +for (const ignoresSigterm of [false, true]) { + test(`stops an agent that ${ignoresSigterm ? "ignores" : "exits on"} SIGTERM where process-group signals are denied`, { skip: process.platform === "win32" }, async (t) => { + const directory = await mkdtemp(join(tmpdir(), "fabric-acp-denied-")); + const marker = join(directory, "pids.json"); + const session = await startAcpSession({ + command: process.execPath, + args: [fixture], + cwd: process.cwd(), + env: { ...process.env, TEST_DESCENDANT_MARKER: marker, TEST_IGNORE_SIGTERM: ignoresSigterm ? "1" : "0" }, + shutdownTimeoutMs: 1_000, + }); + const pids = JSON.parse(await readFile(marker, "utf8")); + const originalKill = process.kill.bind(process); + const agentSignals = []; + // OpenShell's sandbox denies every signal to a process group. + const kill = t.mock.method(process, "kill", (pid, signal) => { + if (pid < 0) throw Object.assign(new Error("group signals denied"), { code: "EPERM" }); + if (pid === pids.parent && signal !== 0) agentSignals.push(signal); + return originalKill(pid, signal); + }); + try { + await session.stop(); + await waitForProcessToStop(pids.parent); + // Once the agent exits, its PID can belong to another process. + assert.deepEqual(agentSignals, ignoresSigterm ? ["SIGTERM", "SIGKILL"] : ["SIGTERM"]); + } finally { + kill.mock.restore(); + for (const pid of [pids.parent, pids.child]) { + try { originalKill(pid, "SIGKILL"); } catch (error) { + if (error.code !== "ESRCH") throw error; + } } } - } -}); + }); +} diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index 21e19f123..c88e19ad7 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -1594,9 +1594,75 @@ def deny_group_signals(_pgid: int, _signum: int) -> None: raise PermissionError(1, "Operation not permitted") monkeypatch.setattr(os, "killpg", deny_group_signals) + try: + await runtime.stop() + + assert gateway.returncode is not None + finally: + if gateway.returncode is None: + gateway.kill() + await gateway.wait() + + +@pytest.mark.skipif(os.name == "nt", reason="POSIX process groups") +async def test_openclaw_stop_kills_a_gateway_that_ignores_sigterm_where_group_signals_are_denied( + monkeypatch: pytest.MonkeyPatch, +): + runtime = adapter.OpenClawRuntime() + runtime._shutdown_timeout = 0.01 + mock_process = MagicMock(spec=asyncio.subprocess.Process) + mock_process.pid = 1234 + mock_process.returncode = None + wait_calls = 0 + + async def wait_for_process(): + nonlocal wait_calls + wait_calls += 1 + if wait_calls == 1: + await asyncio.Event().wait() + + mock_process.wait = AsyncMock(side_effect=wait_for_process) + runtime._process = mock_process + signals: list[tuple[int, int]] = [] + + def deny_group_signals(_pgid: int, _signum: int) -> None: + raise PermissionError(1, "Operation not permitted") + + monkeypatch.setattr(adapter.os, "killpg", deny_group_signals) + monkeypatch.setattr( + adapter.os, "kill", lambda pid, signum: signals.append((pid, signum)) + ) + await runtime.stop() - assert gateway.returncode is not None + assert signals == [(1234, signal.SIGTERM), (1234, signal.SIGKILL)] + + +@pytest.mark.skipif(os.name == "nt", reason="POSIX process groups") +async def test_openclaw_stop_does_not_kill_a_gateway_that_exited_during_cancellation( + monkeypatch: pytest.MonkeyPatch, +): + runtime = adapter.OpenClawRuntime() + mock_process = MagicMock(spec=asyncio.subprocess.Process) + mock_process.pid = 1234 + mock_process.returncode = None + + async def exit_then_cancel(): + mock_process.returncode = 0 + raise asyncio.CancelledError + + mock_process.wait = AsyncMock(side_effect=exit_then_cancel) + runtime._process = mock_process + signals: list[tuple[int, int]] = [] + monkeypatch.setattr( + adapter.os, "killpg", lambda pid, signum: signals.append((pid, signum)) + ) + + with pytest.raises(asyncio.CancelledError): + await runtime.stop() + + # Once the Gateway is reaped, its PID can belong to another process. + assert signals == [(1234, signal.SIGTERM)] @pytest.mark.parametrize("phase", ["client", "process", "logs"]) @@ -1849,6 +1915,35 @@ def test_openclaw_signal_handler_forwards_to_gateway_process_group( assert forwarded == [(1234, signal.SIGTERM)] +@pytest.mark.skipif(os.name == "nt", reason="POSIX signal forwarding") +def test_openclaw_signal_handler_forwards_to_gateway_where_group_signals_are_denied( + monkeypatch: pytest.MonkeyPatch, +): + runtime = adapter.OpenClawRuntime() + mock_process = MagicMock(spec=asyncio.subprocess.Process) + mock_process.pid = 1234 + mock_process.returncode = None + runtime._process = mock_process + forwarded: list[tuple[int, int]] = [] + + def deny_group_signals(_pgid: int, _signum: int) -> None: + raise PermissionError(1, "Operation not permitted") + + monkeypatch.setattr(adapter.os, "killpg", deny_group_signals) + monkeypatch.setattr( + adapter.os, "kill", lambda pid, signum: forwarded.append((pid, signum)) + ) + + runtime._install_signal_handlers() + try: + with pytest.raises(SystemExit): + runtime._signal_handler(signal.SIGTERM, None) + finally: + runtime._restore_signal_handlers() + + assert forwarded == [(1234, signal.SIGTERM)] + + def test_windows_job_assigns_process_and_enables_kill_on_close( monkeypatch: pytest.MonkeyPatch, ): From 532424e143e6d9c85fb96ade01ce9c7b0ee94223 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 17:03:19 -0700 Subject: [PATCH 08/27] fix: end OpenClaw's readiness check at the startup deadline The readiness loop checked the deadline only between requests, and each /startupz request could wait up to 1 second per phase. A request that began just before the deadline could run past it. Each request is now bounded by the time left. Signed-off-by: Carlos Villela --- .../nemo_fabric_adapters/openclaw/adapter.py | 8 +++++-- tests/adapters/test_openclaw.py | 23 +++++++++++++++++++ 2 files changed, 29 insertions(+), 2 deletions(-) diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py index 044325cb2..09ad5d4f4 100644 --- a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py @@ -1649,10 +1649,14 @@ async def _wait_started(self, port: int, token: str, timeout: float) -> None: metadata={"detail": detail[-2000:]}, ) try: - response = await client.get(f"http://127.0.0.1:{port}/startupz") + # A request can't outlast the startup deadline. + response = await asyncio.wait_for( + client.get(f"http://127.0.0.1:{port}/startupz"), + timeout=deadline - asyncio.get_running_loop().time(), + ) if response.status_code == 200: return - except httpx.RequestError: + except (httpx.RequestError, TimeoutError): pass await asyncio.sleep(0.05) raise lifecycle.LifecycleError( diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index c88e19ad7..cdb6617f3 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -1665,6 +1665,29 @@ async def exit_then_cancel(): assert signals == [(1234, signal.SIGTERM)] +async def test_openclaw_startup_deadline_bounds_a_pending_readiness_request(): + async def never_respond(reader, _writer): + await reader.read() + + server = await asyncio.start_server(never_respond, "127.0.0.1", 0) + port = server.sockets[0].getsockname()[1] + runtime = adapter.OpenClawRuntime() + mock_process = MagicMock(spec=asyncio.subprocess.Process) + mock_process.returncode = None + runtime._process = mock_process + loop = asyncio.get_running_loop() + started = loop.time() + try: + with pytest.raises(adapter.lifecycle.LifecycleError) as caught: + await runtime._wait_started(port, "token", 0.2) + finally: + server.close() + + assert caught.value.code == "openclaw_gateway_start_timeout" + # Each readiness request otherwise waits up to 1 second for a response. + assert loop.time() - started < 0.8 + + @pytest.mark.parametrize("phase", ["client", "process", "logs"]) async def test_openclaw_stop_completes_cleanup_before_propagating_cancellation( monkeypatch: pytest.MonkeyPatch, phase: str From 4a6009ae18e954bbabf4eb576491390876859d12 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 17:03:19 -0700 Subject: [PATCH 09/27] docs: describe OpenClaw's startup deadline The guide's example sets startup_timeout_seconds without saying what it covers or that the descriptor caps it at 75 seconds. Signed-off-by: Carlos Villela --- docs/integrations/harness/openclaw.mdx | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/integrations/harness/openclaw.mdx b/docs/integrations/harness/openclaw.mdx index 8ec365a8e..4821372fb 100644 --- a/docs/integrations/harness/openclaw.mdx +++ b/docs/integrations/harness/openclaw.mdx @@ -81,6 +81,11 @@ contains a directory is resolved from the NeMo Fabric base directory. The adapte uses the resolved executable for its version check, configuration validation, and Gateway startup. +`startup_timeout_seconds` sets one deadline for all of start, from checking the +`openclaw` command to the Gateway becoming ready. It defaults to 60 seconds and +can be at most 75 seconds, which keeps start within NeMo Fabric's 90-second +start limit. + The adapter supports only OpenClaw's default `openclaw` agent runtime. The adapter accepts normalized model provider, model, base URL, temperature, From 838f0bc0ed3bc99eb342be6641e53ea1a0ab1b7e Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Thu, 5 Nov 2026 10:08:08 -0700 Subject: [PATCH 10/27] fix: retry removing the OpenClaw dashboard token after a failed stop stop() suppressed OSError when unlinking the dashboard token and cleared the path, so a later stop() could not retry. Log the failure, keep the path, and continue Gateway cleanup. Signed-off-by: Carlos Villela --- .../nemo_fabric_adapters/openclaw/adapter.py | 14 +++++-- tests/adapters/test_openclaw.py | 41 +++++++++++++++++++ 2 files changed, 52 insertions(+), 3 deletions(-) diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py index 44f32f814..f120ddf64 100644 --- a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py @@ -7,7 +7,6 @@ from __future__ import annotations import asyncio -import contextlib import copy import ipaddress import json @@ -1754,10 +1753,19 @@ async def invoke( async def stop(self) -> None: cancellation: asyncio.CancelledError | None = None self._stopping = True - token_path, self._dashboard_token_path = self._dashboard_token_path, None + token_path = self._dashboard_token_path if token_path is not None: - with contextlib.suppress(OSError): + try: token_path.unlink(missing_ok=True) + except OSError: + # Keep the path so a later stop can retry. + logger.error( + "OpenClaw could not remove its dashboard token at %s", + token_path, + exc_info=True, + ) + else: + self._dashboard_token_path = None try: self._restore_signal_handlers() except Exception: diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index 3b13a814c..c7be809cb 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -1494,6 +1494,47 @@ def fail_after_token_write(_settings): assert runtime._process is None +@pytest.mark.skipif( + sys.platform in {"darwin", "win32"}, + reason="Starts the mock Gateway, which CI runs only on Linux", +) +async def test_openclaw_dashboard_stop_retries_a_token_it_could_not_remove( + mock_openclaw: Path, + tmp_path: Path, + dashboard_port: int, + monkeypatch: pytest.MonkeyPatch, + caplog: pytest.LogCaptureFixture, +): + os.environ["FAKE_OPENCLAW_CAPTURE"] = str(tmp_path / "config.json") + token_path = _dashboard_token(tmp_path) + runtime = adapter.OpenClawRuntime() + await runtime.start( + { + "config": _dashboard_config(mock_openclaw, {"port": dashboard_port}), + "runtime_context": _context(tmp_path).to_mapping(), + "base_dir": str(tmp_path), + } + ) + unlink = Path.unlink + + def fail_token_unlink(path: Path, missing_ok: bool = False) -> None: + if path == token_path: + raise PermissionError("token is locked") + unlink(path, missing_ok=missing_ok) + + with monkeypatch.context() as patch: + patch.setattr(Path, "unlink", fail_token_unlink) + await runtime.stop() + + assert runtime._process is None + assert token_path.exists() + assert "could not remove its dashboard token" in caplog.text + + await runtime.stop() + + assert not token_path.exists() + + @pytest.mark.skipif(sys.platform == "win32", reason="Runs the mock openclaw script directly") @pytest.mark.parametrize("offset", [0, 2]) async def test_openclaw_dashboard_port_in_use_fails_start( From 13b87243c7428d4dbac74c3f5da2ced6c758642d Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 8 Nov 2026 00:24:05 -0700 Subject: [PATCH 11/27] test: share the OpenClaw dashboard tests' start payload Start each dashboard test through one helper, and keep the startup-timeout test where it was, so the diff shows only the lines that changed. Signed-off-by: Carlos Villela --- tests/adapters/test_openclaw.py | 146 ++++++++++++++++---------------- 1 file changed, 74 insertions(+), 72 deletions(-) diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index c7be809cb..97fa75a69 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -113,6 +113,22 @@ def _dashboard_token(base_dir: Path) -> Path: ) +async def _start( + runtime: adapter.OpenClawRuntime, + tmp_path: Path, + config: AgentConfig, + **payload: object, +) -> None: + await runtime.start( + { + "config": config, + "runtime_context": _context(tmp_path).to_mapping(), + "base_dir": str(tmp_path), + **payload, + } + ) + + @pytest.fixture(name="mock_openclaw") def mock_openclaw_fixture(repo_root: Path) -> Path: return repo_root / "tests/_utils/mock_openclaw.py" @@ -212,7 +228,9 @@ def test_openclaw_rejects_invalid_port_range(settings: dict[str, object]): id="unknown-field", ), pytest.param({"interfaces": {"dashboard": {}}}, id="missing-port"), - pytest.param({"interfaces": {"dashboard": {"port": 65_426}}}, id="port-too-high"), + pytest.param( + {"interfaces": {"dashboard": {"port": 65_426}}}, id="port-too-high" + ), pytest.param( { "interfaces": {"dashboard": {"port": 20_000}}, @@ -1396,12 +1414,8 @@ async def test_openclaw_dashboard_serves_control_ui_with_a_token_file( token_path = _dashboard_token(tmp_path) runtime = adapter.OpenClawRuntime() - await runtime.start( - { - "config": _dashboard_config(mock_openclaw, {"port": dashboard_port}), - "runtime_context": _context(tmp_path).to_mapping(), - "base_dir": str(tmp_path), - } + await _start( + runtime, tmp_path, _dashboard_config(mock_openclaw, {"port": dashboard_port}) ) try: gateway_token = runtime._token @@ -1437,14 +1451,10 @@ async def test_openclaw_dashboard_disabled_serves_no_control_ui( os.environ["FAKE_OPENCLAW_CAPTURE"] = str(capture) runtime = adapter.OpenClawRuntime() - await runtime.start( - { - "config": _dashboard_config( - mock_openclaw, {"port": dashboard_port, "enabled": False} - ), - "runtime_context": _context(tmp_path).to_mapping(), - "base_dir": str(tmp_path), - } + await _start( + runtime, + tmp_path, + _dashboard_config(mock_openclaw, {"port": dashboard_port, "enabled": False}), ) try: gateway_port = runtime._port @@ -1481,12 +1491,10 @@ def fail_after_token_write(_settings): runtime = adapter.OpenClawRuntime() with pytest.raises(RuntimeError, match="after writing the token"): - await runtime.start( - { - "config": _dashboard_config(mock_openclaw, {"port": dashboard_port}), - "runtime_context": _context(tmp_path).to_mapping(), - "base_dir": str(tmp_path), - } + await _start( + runtime, + tmp_path, + _dashboard_config(mock_openclaw, {"port": dashboard_port}), ) assert token_written == [True] @@ -1508,12 +1516,8 @@ async def test_openclaw_dashboard_stop_retries_a_token_it_could_not_remove( os.environ["FAKE_OPENCLAW_CAPTURE"] = str(tmp_path / "config.json") token_path = _dashboard_token(tmp_path) runtime = adapter.OpenClawRuntime() - await runtime.start( - { - "config": _dashboard_config(mock_openclaw, {"port": dashboard_port}), - "runtime_context": _context(tmp_path).to_mapping(), - "base_dir": str(tmp_path), - } + await _start( + runtime, tmp_path, _dashboard_config(mock_openclaw, {"port": dashboard_port}) ) unlink = Path.unlink @@ -1535,7 +1539,9 @@ def fail_token_unlink(path: Path, missing_ok: bool = False) -> None: assert not token_path.exists() -@pytest.mark.skipif(sys.platform == "win32", reason="Runs the mock openclaw script directly") +@pytest.mark.skipif( + sys.platform == "win32", reason="Runs the mock openclaw script directly" +) @pytest.mark.parametrize("offset", [0, 2]) async def test_openclaw_dashboard_port_in_use_fails_start( mock_openclaw: Path, tmp_path: Path, dashboard_port: int, offset: int @@ -1544,14 +1550,10 @@ async def test_openclaw_dashboard_port_in_use_fails_start( with socket.create_server(("127.0.0.1", dashboard_port + offset)): with pytest.raises(adapter.lifecycle.LifecycleError) as caught: - await runtime.start( - { - "config": _dashboard_config( - mock_openclaw, {"port": dashboard_port} - ), - "runtime_context": _context(tmp_path).to_mapping(), - "base_dir": str(tmp_path), - } + await _start( + runtime, + tmp_path, + _dashboard_config(mock_openclaw, {"port": dashboard_port}), ) assert caught.value.code == "openclaw_interface_port_unavailable" @@ -1570,48 +1572,17 @@ async def test_openclaw_services_reject_interfaces( runtime = adapter.OpenClawRuntime() with pytest.raises(adapter.lifecycle.LifecycleError) as caught: - await runtime.start( - { - "config": _dashboard_config(mock_openclaw, {"port": 20_000}), - "runtime_context": _context(tmp_path).to_mapping(), - "base_dir": str(tmp_path), - "service": {"operation": operation}, - } + await _start( + runtime, + tmp_path, + _dashboard_config(mock_openclaw, {"port": 20_000}), + service={"operation": operation}, ) assert caught.value.code == "openclaw_interfaces_require_managed_runtime" assert runtime._process is None -@pytest.mark.skipif(sys.platform == "win32", reason="Runs the mock openclaw script directly") -async def test_openclaw_startup_timeout_bounds_all_of_start( - mock_openclaw: Path, - tmp_path: Path, - dashboard_port: int, - monkeypatch: pytest.MonkeyPatch, -): - # Each command finishes within the timeout, but the two together don't. - monkeypatch.setenv("FAKE_OPENCLAW_COMMAND_DELAY", "0.6") - monkeypatch.setenv("FAKE_OPENCLAW_CAPTURE", str(tmp_path / "config.json")) - config = _dashboard_config(mock_openclaw, {"port": dashboard_port}) - assert config.harness is not None - config.harness.settings["startup_timeout_seconds"] = 1 - runtime = adapter.OpenClawRuntime() - - with pytest.raises(adapter.lifecycle.LifecycleError) as caught: - await runtime.start( - { - "config": config, - "runtime_context": _context(tmp_path).to_mapping(), - "base_dir": str(tmp_path), - } - ) - - assert caught.value.code == "openclaw_command_timeout" - assert runtime._process is None - assert not (tmp_path / "artifacts").exists() - - @pytest.mark.skipif( sys.platform in {"darwin", "win32"}, reason="Starts the mock Gateway, which CI runs only on Linux", @@ -1790,6 +1761,37 @@ def signal_group(pid: int, signum: int) -> None: assert pid_signals == ([(1234, signal.SIGTERM)] if group_signals_denied else []) +@pytest.mark.skipif( + sys.platform == "win32", reason="Runs the mock openclaw script directly" +) +async def test_openclaw_startup_timeout_bounds_all_of_start( + mock_openclaw: Path, + tmp_path: Path, + dashboard_port: int, + monkeypatch: pytest.MonkeyPatch, +): + # Each command finishes within the timeout, but the two together don't. + monkeypatch.setenv("FAKE_OPENCLAW_COMMAND_DELAY", "0.6") + monkeypatch.setenv("FAKE_OPENCLAW_CAPTURE", str(tmp_path / "config.json")) + config = _dashboard_config(mock_openclaw, {"port": dashboard_port}) + assert config.harness is not None + config.harness.settings["startup_timeout_seconds"] = 1 + runtime = adapter.OpenClawRuntime() + + with pytest.raises(adapter.lifecycle.LifecycleError) as caught: + await runtime.start( + { + "config": config, + "runtime_context": _context(tmp_path).to_mapping(), + "base_dir": str(tmp_path), + } + ) + + assert caught.value.code == "openclaw_command_timeout" + assert runtime._process is None + assert not (tmp_path / "artifacts").exists() + + async def test_openclaw_startup_deadline_bounds_a_pending_readiness_request(): async def never_respond(reader, _writer): await reader.read() From 58b3926d7fb89183322264c932439f63e9a4ce51 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Mon, 9 Nov 2026 06:05:00 -0800 Subject: [PATCH 12/27] fix: preserve passing native health with unknown activity Reuse the shared health correction from Hermes review commit 3d2d62b7 so native OpenClaw clients do not require the full unmerged Hermes PR. Continue rejecting passing shutdown observations. Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- crates/fabric-core/src/check.rs | 54 ++++++++++++++++++- docs/sdk/health-checks.mdx | 2 +- .../src/nemo_fabric/check.py | 2 +- tests/python/test_checks.py | 15 ++++++ 4 files changed, 69 insertions(+), 4 deletions(-) diff --git a/crates/fabric-core/src/check.rs b/crates/fabric-core/src/check.rs index 661b11685..e49484d89 100644 --- a/crates/fabric-core/src/check.rs +++ b/crates/fabric-core/src/check.rs @@ -616,7 +616,7 @@ fn valid_remote_report(report: &CheckReport, request: &CheckRequest) -> bool { runtime.state == CheckRuntimeState::Active && matches!( runtime.activity, - RuntimeActivity::Idle | RuntimeActivity::Busy + RuntimeActivity::Idle | RuntimeActivity::Busy | RuntimeActivity::Unknown ) })) { @@ -960,6 +960,9 @@ pub fn check_environment( RuntimeActivity::Idle | RuntimeActivity::Busy => { CheckRuntimeState::Active } + RuntimeActivity::Unknown if result.outcome == CheckOutcome::Passed => { + CheckRuntimeState::Active + } RuntimeActivity::Stopped => CheckRuntimeState::Stopped, _ => CheckRuntimeState::Unknown, }, @@ -1178,7 +1181,9 @@ fn probe_target( || scope != CheckScope::Service && !matches!( observation.activity, - RuntimeActivity::Idle | RuntimeActivity::Busy + RuntimeActivity::Idle + | RuntimeActivity::Busy + | RuntimeActivity::Unknown ))) || observation.observed_at.is_some() && !valid_time { @@ -1395,6 +1400,51 @@ mod tests { cleanup(&runtime); } + #[test] + fn healthy_runtime_can_have_unknown_activity() { + let runtime = runtime(); + register( + &runtime, + vec![CheckLevel::Live, CheckLevel::Active, CheckLevel::Ready], + ); + let peer = peer(&runtime, 3, |_, level| gateway_passed(level)); + let request = request(&runtime, CheckLevel::Ready, 3.0); + let mut report = check_environment(&runtime.environment, &request).unwrap(); + assert_eq!(report.outcome, CheckOutcome::Passed); + let observation = report.runtime.as_ref().unwrap(); + assert_eq!(observation.state, CheckRuntimeState::Active); + assert_eq!(observation.activity, RuntimeActivity::Unknown); + assert!(valid_remote_report(&report, &request)); + assert_eq!(peer.join().unwrap().len(), 3); + for activity in [RuntimeActivity::Stopping, RuntimeActivity::Stopped] { + report.runtime.as_mut().unwrap().activity = activity; + assert!(!valid_remote_report(&report, &request)); + } + cleanup(&runtime); + } + + #[test] + fn shutdown_activity_cannot_pass_runtime_health() { + let runtime = runtime(); + register(&runtime, vec![CheckLevel::Live]); + let peer = peer(&runtime, 2, |index, level| { + let mut observation = passed(level); + observation["activity"] = if index == 0 { "stopping" } else { "stopped" }.into(); + observation + }); + for _ in 0..2 { + let report = check_environment( + &runtime.environment, + &request(&runtime, CheckLevel::Live, 3.0), + ) + .unwrap(); + assert_eq!(report.outcome, CheckOutcome::Unknown); + assert_eq!(report.reason_code, Some(CheckReason::ProbeError)); + } + assert_eq!(peer.join().unwrap().len(), 2); + cleanup(&runtime); + } + #[test] fn gateway_service_checks_do_not_require_a_runtime_binding() { let runtime = runtime(); diff --git a/docs/sdk/health-checks.mdx b/docs/sdk/health-checks.mdx index 695226c4b..522ac2fc9 100644 --- a/docs/sdk/health-checks.mdx +++ b/docs/sdk/health-checks.mdx @@ -49,7 +49,7 @@ The report uses one of these outcomes: | `unknown` | The check could not establish the result, for example because of a timeout, unavailable target, invalid native response, or ownership change. | | `unsupported` | The installed adapter or execution mode does not provide the requested check. | -Runtime `activity` is separate from health. A runtime can report `busy` and pass every supported level while an invocation waits for a model response. Activity describes NeMo Fabric invocations; activity does not establish that an agent will accept a second concurrent prompt. +Runtime `activity` is separate from health. A runtime can report `busy` and pass every supported level while an invocation waits for a model response. It can also pass with `activity: unknown` when native health is established but the adapter cannot observe all browser or terminal work. Passing health requires an active runtime; `stopping` or `stopped` activity cannot pass. Activity does not establish that an agent will accept a second concurrent prompt. ## Native Evidence by Adapter diff --git a/sdk/python/nemo-fabric-runtime/src/nemo_fabric/check.py b/sdk/python/nemo-fabric-runtime/src/nemo_fabric/check.py index 79becf714..3cb546d92 100644 --- a/sdk/python/nemo-fabric-runtime/src/nemo_fabric/check.py +++ b/sdk/python/nemo-fabric-runtime/src/nemo_fabric/check.py @@ -255,7 +255,7 @@ def _consistency(self) -> Self: and ( self.runtime is None or self.runtime.state != "active" - or self.runtime.activity in ("stopped", "stopping", "unknown") + or self.runtime.activity in ("stopped", "stopping") ) ): raise ValueError("incomplete passing evidence") diff --git a/tests/python/test_checks.py b/tests/python/test_checks.py index 187b081a8..87e81a1ca 100644 --- a/tests/python/test_checks.py +++ b/tests/python/test_checks.py @@ -100,6 +100,21 @@ def test_report_fields_cannot_be_reassigned_or_deleted(check_report): del report.outcome +@pytest.mark.parametrize("activity", ["idle", "busy", "unknown"]) +def test_passing_health_does_not_require_known_activity(check_report, activity): + check_report["runtime"]["activity"] = activity + report = CheckReport.from_mapping(check_report) + assert report.outcome == "passed" + assert report.runtime["activity"] == activity + + +@pytest.mark.parametrize("activity", ["stopping", "stopped"]) +def test_passing_health_rejects_shutdown_activity(check_report, activity): + check_report["runtime"]["activity"] = activity + with pytest.raises(FabricConfigError, match="The check report is invalid"): + CheckReport.from_mapping(check_report) + + async def test_sdk_checks_use_one_client_timer( check_environment, check_report, monkeypatch ): From dac140c494bd8089a9251feb773a91bfb1d4bca9 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Mon, 9 Nov 2026 06:05:31 -0800 Subject: [PATCH 13/27] feat(openclaw): share configuration across native clients Apply selected-agent replacement instructions through the public Gateway prompt hook, attach the native terminal without a separate port, and retain SDK/service defaults. Include real four-client configuration, tools/MCP, skills and concurrency qualification. Relay remains deferred. Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- .../openclaw/openclaw.fabric-adapter.json | 27 +- adapters/python/openclaw/pyproject.toml | 3 + .../nemo_fabric_adapters/openclaw/adapter.py | 68 ++- .../openclaw/interfaces.py | 149 +++++ .../openclaw/native_config/index.mjs | 16 + .../native_config/openclaw.plugin.json | 24 + .../openclaw/native_config/package.json | 10 + .../nemo_fabric_adapters/openclaw/terminal.py | 136 +++++ .../nemo_fabric_adapter_catalog/catalog.json | 25 +- tests/_utils/mock_api_server.py | 7 +- tests/adapters/test_openclaw.py | 52 +- tests/adapters/test_openclaw_interfaces.py | 146 +++++ tests/adapters/test_openclaw_native.py | 557 ++++++++++++++++++ 13 files changed, 1213 insertions(+), 7 deletions(-) create mode 100644 adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/interfaces.py create mode 100644 adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/index.mjs create mode 100644 adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/openclaw.plugin.json create mode 100644 adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/package.json create mode 100644 adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/terminal.py create mode 100644 tests/adapters/test_openclaw_interfaces.py create mode 100644 tests/adapters/test_openclaw_native.py diff --git a/adapters/python/openclaw/openclaw.fabric-adapter.json b/adapters/python/openclaw/openclaw.fabric-adapter.json index 602cda7b5..b66238528 100644 --- a/adapters/python/openclaw/openclaw.fabric-adapter.json +++ b/adapters/python/openclaw/openclaw.fabric-adapter.json @@ -18,7 +18,7 @@ "type": "string", "minLength": 1, "default": "default", - "description": "OpenClaw agent selected for NeMo Fabric-originated invocations." + "description": "OpenClaw agent selected for SDK invocations and managed native clients." }, "channel_config": { "type": "object", @@ -80,11 +80,34 @@ "minimum": 1, "maximum": 65425, "description": "Exact loopback Gateway base port, which serves the Control UI. Start fails if it or port + 2 is in use. OpenClaw allocates browser ports through port + 110 on demand, so keep that range free. Can't be combined with port_range." + }, + "public_origins": { + "type": "array", + "items": { + "type": "string", + "pattern": "^https?://[^/\\s?#@]+$" + }, + "uniqueItems": true, + "default": [], + "description": "Additional browser HTTP(S) origins. OpenClaw also permits loopback origins; the token is always required." } }, - "required": ["port"], + "required": [ + "port" + ], "additionalProperties": false, "description": "OpenClaw's Control UI. After the Gateway starts, the adapter writes its sign-in token to /.fabric/openclaw/runtimes//interfaces/dashboard.token." + }, + "terminal": { + "type": "object", + "properties": { + "enabled": { + "type": "boolean", + "default": true + } + }, + "additionalProperties": false, + "description": "Attach the native terminal to the existing Gateway. No terminal port; publishes a private executable launcher and terminal.running marker." } }, "additionalProperties": false, diff --git a/adapters/python/openclaw/pyproject.toml b/adapters/python/openclaw/pyproject.toml index 6af8febd0..0d663d03a 100644 --- a/adapters/python/openclaw/pyproject.toml +++ b/adapters/python/openclaw/pyproject.toml @@ -40,6 +40,9 @@ Documentation = "https://docs.nvidia.com/nemo/fabric" where = ["src"] include = ["nemo_fabric_adapters.openclaw*"] +[tool.setuptools.package-data] +"nemo_fabric_adapters.openclaw" = ["native_config/*.mjs", "native_config/*.json"] + [tool.setuptools.data-files] "share/nemo-fabric/adapters/openclaw" = ["openclaw.fabric-adapter.json"] diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py index f120ddf64..6715c54f7 100644 --- a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py @@ -37,6 +37,7 @@ from nemo_fabric_adapters.common import openai_chat from nemo_fabric_adapters.common import utils as common_utils from nemo_fabric_adapters.openclaw import _windows_job +from nemo_fabric_adapters.openclaw import interfaces as native_interfaces DEFAULT_STARTUP_TIMEOUT_SECONDS = 60.0 @@ -161,6 +162,13 @@ def _positive_setting(settings: dict[str, Any], name: str, default: float) -> fl return float(value) +def _native_interfaces_enabled(settings: dict[str, Any]) -> bool: + """Return whether this runtime exposes a managed browser or terminal client.""" + return any( + native_interfaces.enabled(settings, name) for name in ("dashboard", "terminal") + ) + + def _dashboard_port(settings: dict[str, Any]) -> int | None: """Return the Control UI's port when the settings enable it. @@ -525,6 +533,9 @@ def _openclaw_config( "allowedOrigins": [ f"http://127.0.0.1:{port}", f"http://localhost:{port}", + *native_interfaces.public_origins( + config.harness.settings if config.harness else {} + ), ], } if dashboard @@ -553,6 +564,27 @@ def _openclaw_config( result["agents"]["entries"] = {agent_id: {}} if config.instructions is not None and config.instructions.system is not None: result["agents"]["defaults"]["contextInjection"] = "never" + if _native_interfaces_enabled( + config.harness.settings if config.harness else {} + ): + result["plugins"] = { + "load": { + "paths": [str(Path(__file__).with_name("native_config").resolve())] + }, + "entries": { + "fabric-shared-config": { + "enabled": True, + "hooks": { + "allowConversationAccess": True, + "allowPromptInjection": True, + }, + "config": { + "agentId": agent_id, + "systemInstruction": config.instructions.system.content, + }, + } + }, + } skill_paths = _resolve_skill_paths(config, base_dir) if skill_paths: result["skills"] = {"load": {"extraDirs": skill_paths}} @@ -873,6 +905,7 @@ def __init__(self) -> None: self._port: int | None = None self._token: str | None = None self._dashboard_token_path: Path | None = None + self._interface_directory: Path | None = None self._gateway_url: str | None = None self._agent_id = "default" self._shutdown_timeout = DEFAULT_SHUTDOWN_TIMEOUT_SECONDS @@ -948,6 +981,11 @@ def observed(outcome: str, reason: str | None) -> dict[str, Any]: if service_host else "stopped" if reason == "agent_exited" + else "unknown" + if config is not None + and _native_interfaces_enabled( + config.harness.settings if config.harness else {} + ) else ( "busy" if self._active_invoke_task is not None @@ -1073,6 +1111,12 @@ async def start(self, payload: dict[str, Any]) -> dict[str, Any] | None: metadata={"field": "harness.settings.interfaces"}, ) dashboard_port = _dashboard_port(settings) + if native_interfaces.enabled(settings, "terminal") and os.name != "posix": + raise lifecycle.LifecycleError( + "openclaw_terminal_platform_unsupported", + "Managed OpenClaw terminal requires POSIX", + ) + native_interfaces.public_origins(settings) self._service_host = service is not None and service.get("operation") in { "prepare", "attach", @@ -1228,6 +1272,23 @@ def startup_remaining() -> float: token_path = _dashboard_token_path(context, base_dir) local_interfaces.write_private_file(token_path, token) self._dashboard_token_path = token_path + if _native_interfaces_enabled(settings): + self._interface_directory = _dashboard_token_path( + context, base_dir + ).parent + native_interfaces.publish( + self._interface_directory, + runtime_id=context.runtime_id, + port=port, + token=token, + command=command, + workspace=str( + Path(context.environment.workspace or base_dir).resolve() + ), + agent_id=_agent_id(settings), + dashboard=dashboard_port is not None, + terminal=native_interfaces.enabled(settings, "terminal"), + ) self._client = httpx.AsyncClient( headers={"authorization": f"Bearer {token}"}, http2=True, @@ -1689,7 +1750,9 @@ async def invoke( instruction = ( self._config.instructions.system if self._config.instructions else None ) - if instruction is not None: + if instruction is not None and not _native_interfaces_enabled( + self._config.harness.settings if self._config.harness else {} + ): messages.append({"role": "system", "content": instruction.content}) messages.append( { @@ -1753,6 +1816,9 @@ async def invoke( async def stop(self) -> None: cancellation: asyncio.CancelledError | None = None self._stopping = True + if self._interface_directory is not None: + if native_interfaces.remove(self._interface_directory): + self._interface_directory = None token_path = self._dashboard_token_path if token_path is not None: try: diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/interfaces.py b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/interfaces.py new file mode 100644 index 000000000..0f10462cb --- /dev/null +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/interfaces.py @@ -0,0 +1,149 @@ +# SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. +# SPDX-License-Identifier: Apache-2.0 + +"""Private attachment discovery for clients of one managed OpenClaw Gateway.""" + +from __future__ import annotations + +import json +import logging +import os +import shlex +import shutil +import sys +from pathlib import Path +from urllib.parse import urlsplit + +from nemo_fabric_adapters.common import lifecycle, local_interfaces + +logger = logging.getLogger(__name__) +FILES = ("terminal.running", "terminal", "gateway.json", "client.json", "gateway.token") + + +def enabled(settings: dict, name: str) -> bool: + """A present interface is enabled unless explicitly disabled.""" + item = settings.get("interfaces", {}).get(name) + return item is not None and item.get("enabled", True) + + +def public_origins(settings: dict) -> list[str]: + """Accept HTTP origins without credentials, paths, queries, or fragments.""" + origins = ( + settings.get("interfaces", {}).get("dashboard", {}).get("public_origins", []) + ) + for origin in origins: + try: + parsed = urlsplit(origin) + valid = ( + parsed.scheme in {"http", "https"} + and parsed.hostname + and parsed.username is None + and parsed.password is None + and not parsed.path + and not parsed.query + and not parsed.fragment + and parsed.port != 0 + ) + except ValueError: + valid = False + if not valid: + raise lifecycle.LifecycleError( + "openclaw_invalid_origin", + "Dashboard public_origins must contain HTTP(S) origins", + metadata={ + "field": "harness.settings.interfaces.dashboard.public_origins" + }, + ) + return origins + + +def publish( + directory: Path, + *, + runtime_id: str, + port: int, + token: str, + command: Path, + workspace: str, + agent_id: str, + dashboard: bool, + terminal: bool, +) -> None: + """Publish connection material after Gateway readiness and the marker last.""" + token_file = "dashboard.token" if dashboard else "gateway.token" + if not dashboard: + local_interfaces.write_private_file(directory / token_file, token) + connection = { + "version": 1, + "runtime_id": runtime_id, + "http_url": f"http://127.0.0.1:{port}", + "ws_url": f"ws://127.0.0.1:{port}", + "agent_id": agent_id, + "token_file": token_file, + "command": str(command), + "workspace": workspace, + } + local_interfaces.write_private_file( + directory / "gateway.json", json.dumps(connection) + "\n" + ) + if not terminal: + return + client = { + "gateway": { + "mode": "remote", + "remote": { + "url": connection["ws_url"], + "transport": "direct", + "token": { + "source": "env", + "provider": "default", + "id": "FABRIC_OPENCLAW_CLIENT_TOKEN", + }, + }, + }, + } + local_interfaces.write_private_file( + directory / "client.json", json.dumps(client) + "\n" + ) + launcher = ( + "#!/bin/sh\nexec " + + " ".join( + shlex.quote(arg) + for arg in ( + sys.executable, + "-m", + "nemo_fabric_adapters.openclaw.terminal", + "--connection", + str(directory / "gateway.json"), + ) + ) + + ' "$@"\n' + ) + local_interfaces.write_private_file(directory / "terminal", launcher) + os.chmod(directory / "terminal", 0o700) + local_interfaces.write_private_file( + directory / "terminal.running", runtime_id + "\n" + ) + + +def remove(directory: Path) -> bool: + """Revoke the marker first; retain failed paths for a later stop retry.""" + removed = True + for name in FILES: + try: + (directory / name).unlink(missing_ok=True) + except OSError: + removed = False + logger.error( + "OpenClaw could not remove interface file %s", + directory / name, + exc_info=True, + ) + try: + shutil.rmtree(directory / "client-state") + except FileNotFoundError: + pass + except OSError: + removed = False + logger.error("OpenClaw could not remove private client state", exc_info=True) + return removed diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/index.mjs b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/index.mjs new file mode 100644 index 000000000..ed6b79383 --- /dev/null +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/index.mjs @@ -0,0 +1,16 @@ +// SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. +// SPDX-License-Identifier: Apache-2.0 + +/** Apply the managed agent's replacement prompt at the shared Gateway boundary. */ +export default { + id: "fabric-shared-config", + name: "NeMo Fabric shared configuration", + register(api) { + const { agentId, systemInstruction } = api.pluginConfig; + api.on("before_prompt_build", (_event, context) => { + if (context.agentId === agentId) { + return { systemPrompt: systemInstruction }; + } + }, { priority: 1000 }); + }, +}; diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/openclaw.plugin.json b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/openclaw.plugin.json new file mode 100644 index 000000000..31b4c86c9 --- /dev/null +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/openclaw.plugin.json @@ -0,0 +1,24 @@ +{ + "id": "fabric-shared-config", + "name": "NeMo Fabric shared configuration", + "activation": { + "onStartup": true + }, + "configSchema": { + "type": "object", + "additionalProperties": false, + "required": [ + "agentId", + "systemInstruction" + ], + "properties": { + "agentId": { + "type": "string", + "minLength": 1 + }, + "systemInstruction": { + "type": "string" + } + } + } +} diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/package.json b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/package.json new file mode 100644 index 000000000..4734f814b --- /dev/null +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/package.json @@ -0,0 +1,10 @@ +{ + "name": "nemo-fabric-openclaw-config", + "private": true, + "type": "module", + "openclaw": { + "extensions": [ + "./index.mjs" + ] + } +} diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/terminal.py b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/terminal.py new file mode 100644 index 000000000..5b1fedc79 --- /dev/null +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/terminal.py @@ -0,0 +1,136 @@ +# SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. +# SPDX-License-Identifier: Apache-2.0 + +"""Launch the native TUI against the managed Gateway without secrets in argv.""" + +from __future__ import annotations + +import argparse +import json +import os +import stat +import sys +import uuid +from pathlib import Path +from urllib.parse import urlsplit + +import httpx + + +def _read_private(path: Path) -> str: + """Read a private owned file without following its final symlink.""" + descriptor = os.open(path, os.O_RDONLY | os.O_NOFOLLOW) + with os.fdopen(descriptor) as stream: + info = os.fstat(stream.fileno()) + if ( + not stat.S_ISREG(info.st_mode) + or info.st_uid != os.getuid() + or info.st_mode & 0o077 + ): + raise ValueError("Attachment files must be owner-only regular files") + return stream.read() + + +def attachment( + connection: Path, session: str | None = None +) -> tuple[list[str], dict[str, str], str]: + """Validate discovery and authenticated health, then build a native client launch.""" + if os.name != "posix": + raise ValueError("Managed terminal attachment currently requires POSIX") + parent = connection.parent.lstat() + if ( + not stat.S_ISDIR(parent.st_mode) + or parent.st_uid != os.getuid() + or parent.st_mode & 0o077 + ): + raise ValueError( + "Attachment directory must be private and owned by the current user" + ) + data = json.loads(_read_private(connection)) + parsed = urlsplit(data["http_url"]) + if ( + data["version"] != 1 + or parsed.scheme != "http" + or parsed.hostname != "127.0.0.1" + or not parsed.port + or parsed.username + or parsed.password + or parsed.path + or parsed.query + or parsed.fragment + or data["ws_url"] != f"ws://127.0.0.1:{parsed.port}" + or data["token_file"] not in {"dashboard.token", "gateway.token"} + ): + raise ValueError("Invalid managed Gateway descriptor") + if ( + _read_private(connection.with_name("terminal.running")).strip() + != data["runtime_id"] + ): + raise ValueError("Managed terminal attachment is no longer available") + token = _read_private(connection.with_name(data["token_file"])).strip() + with httpx.Client(trust_env=False, timeout=3) as client: + response = client.get( + data["http_url"] + "/v1/models", + headers={"Authorization": f"Bearer {token}"}, + ) + response.raise_for_status() + # Validate the client config as private even though it contains only a secret reference. + _read_private(connection.with_name("client.json")) + command = Path(data["command"]) + workspace = Path(data["workspace"]) + if ( + not command.is_absolute() + or not os.access(command, os.X_OK) + or not workspace.is_absolute() + or not workspace.is_dir() + ): + raise ValueError("Managed executable or workspace is unavailable") + session = f"fabric-terminal-{uuid.uuid4().hex}" if session is None else session + if ( + ":" in session + or not session + or any(character.isspace() for character in session) + ): + raise ValueError("Use a nonempty session name without colons or whitespace") + environment = { + key: value + for key, value in os.environ.items() + if not key.startswith("OPENCLAW_") + } + environment.update( + { + "OPENCLAW_CONFIG_PATH": str(connection.with_name("client.json").absolute()), + "OPENCLAW_STATE_DIR": str(connection.parent / "client-state"), + "OPENCLAW_CONFIG_READONLY": "1", + "DO_NOT_TRACK": "1", + "FABRIC_OPENCLAW_CLIENT_TOKEN": token, + } + ) + return ( + [str(command), "tui", "--session", f"agent:{data['agent_id']}:{session}"], + environment, + str(workspace), + ) + + +def main() -> None: + """Attach to one selected runtime; the client never starts a Gateway.""" + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--connection", type=Path, required=True) + parser.add_argument( + "--session", help="Native session name; omit for a new conversation" + ) + args = parser.parse_args() + try: + command, environment, workspace = attachment(args.connection, args.session) + except (OSError, ValueError, KeyError, httpx.HTTPError): + parser.exit( + 1, + "Managed OpenClaw attachment is unavailable; check the runtime and private connection files.\n", + ) + os.chdir(workspace) + os.execvpe(command[0], command, environment) + + +if __name__ == "__main__": + main() diff --git a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json index 020b6387f..d480c665c 100644 --- a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json +++ b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json @@ -2070,7 +2070,7 @@ "properties": { "agent_id": { "default": "default", - "description": "OpenClaw agent selected for NeMo Fabric-originated invocations.", + "description": "OpenClaw agent selected for SDK invocations and managed native clients.", "minLength": 1, "type": "string" }, @@ -2137,12 +2137,33 @@ "maximum": 65425, "minimum": 1, "type": "integer" + }, + "public_origins": { + "default": [], + "description": "Additional browser HTTP(S) origins. OpenClaw also permits loopback origins; the token is always required.", + "items": { + "pattern": "^https?://[^/\\s?#@]+$", + "type": "string" + }, + "type": "array", + "uniqueItems": true } }, "required": [ "port" ], "type": "object" + }, + "terminal": { + "additionalProperties": false, + "description": "Attach the native terminal to the existing Gateway. No terminal port; publishes a private executable launcher and terminal.running marker.", + "properties": { + "enabled": { + "default": true, + "type": "boolean" + } + }, + "type": "object" } }, "type": "object" @@ -2200,7 +2221,7 @@ "name": "nemo-fabric-adapters-openclaw", "version": "0.7.0" }, - "sha256": "f2420e753b7efff19d6c56a8ff00f428f07f2f0761d77f49a031e90aa7f3a057", + "sha256": "e09e634bdd1f9ac1c32bb6aa35e7bf572de3c7ed8c5ac610b0528ef4d996ebb1", "source": "adapters/python/openclaw/openclaw.fabric-adapter.json" }, "nvidia.fabric.opencode": { diff --git a/tests/_utils/mock_api_server.py b/tests/_utils/mock_api_server.py index 65dbb82ea..2b66fe0fa 100644 --- a/tests/_utils/mock_api_server.py +++ b/tests/_utils/mock_api_server.py @@ -36,6 +36,7 @@ def reset_state() -> None: app.state.requests = [] app.state.status_code = 200 app.state.delay_seconds = 0.0 + app.state.response_text = None app.state.chat_authorization_headers = [] app.state.tool_calls = [] app.state.tool_call_index = 0 @@ -74,6 +75,7 @@ async def scenario(request: Request) -> dict[str, object]: payload = await request.json() app.state.status_code = int(payload.get("status_code", 200)) app.state.delay_seconds = float(payload.get("delay_seconds", 0.0)) + app.state.response_text = payload.get("response_text") tool_call = payload.get("tool_call") app.state.tool_calls = payload.get("tool_calls") or ( [tool_call] if tool_call is not None else [] @@ -193,7 +195,10 @@ async def chat_completions(request: Request): if isinstance(message, dict) and message.get("role") == "user" ] latest = user_messages[-1].get("content", "") if user_messages else "" - content = f"echo user_count={len(user_messages)} latest={latest}" + content = ( + app.state.response_text + or f"echo user_count={len(user_messages)} latest={latest}" + ) if payload.get("stream") is True: return StreamingResponse( _stream_chat_completion(payload, content), diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index 97fa75a69..d3087d8b9 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -222,7 +222,9 @@ def test_openclaw_rejects_invalid_port_range(settings: dict[str, object]): @pytest.mark.parametrize( "settings", [ - pytest.param({"interfaces": {"terminal": {}}}, id="unsupported-interface"), + pytest.param( + {"interfaces": {"terminal": {"port": 20_000}}}, id="terminal-has-no-port" + ), pytest.param( {"interfaces": {"dashboard": {"port": 20_000, "token": "x"}}}, id="unknown-field", @@ -2487,3 +2489,51 @@ async def test_openclaw_gateway_stream_keeps_usage_observational(): "observed": {"input_tokens": 42, "output_tokens": 8, "total_tokens": 50}, "gaps": ["scope_unverified"], } + + +@pytest.mark.skipif(os.name != "posix", reason="The native terminal requires POSIX") +@pytest.mark.parametrize( + "selection, shared", + [ + ({}, False), + ({"terminal": {"enabled": False}}, False), + ({"terminal": {}}, True), + ], +) +async def test_native_configuration_owns_prompt_once( + mock_openclaw, tmp_path, selection, shared +): + capture = tmp_path / "config.json" + request_capture = tmp_path / "request.json" + os.environ["FAKE_OPENCLAW_CAPTURE"] = str(capture) + os.environ["FAKE_OPENCLAW_REQUEST"] = str(request_capture) + config = _config(mock_openclaw) + config.harness.settings["interfaces"] = selection + runtime = adapter.OpenClawRuntime() + await _start(runtime, tmp_path, config) + try: + result = await runtime.invoke( + AgentRunRequest(input="Check shared configuration."), _context(tmp_path) + ) + assert result.status == "succeeded" + request = json.loads(request_capture.read_text()) + assert [message["role"] for message in request["messages"]] == ( + ["user"] if shared else ["system", "user"] + ) + generated = json.loads(capture.read_text()) + if shared: + entry = generated["plugins"]["entries"]["fabric-shared-config"] + assert entry["config"] == { + "agentId": "default", + "systemInstruction": "Be concise.", + } + directory = _dashboard_token(tmp_path).parent + assert (directory / "terminal.running").exists() + assert (directory / "gateway.json").exists() + assert (await runtime.check("ready"))["activity"] == "unknown" + else: + assert "plugins" not in generated + assert not _dashboard_token(tmp_path).parent.exists() + finally: + await runtime.stop() + assert not (_dashboard_token(tmp_path).parent / "terminal.running").exists() diff --git a/tests/adapters/test_openclaw_interfaces.py b/tests/adapters/test_openclaw_interfaces.py new file mode 100644 index 000000000..a1bbe4e6e --- /dev/null +++ b/tests/adapters/test_openclaw_interfaces.py @@ -0,0 +1,146 @@ +# SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. +# SPDX-License-Identifier: Apache-2.0 + +"""Managed OpenClaw interface ownership and private attachment contracts.""" + +import json +import os +import sys +from pathlib import Path +from unittest.mock import MagicMock + +import pytest +from nemo_fabric_adapters.common import lifecycle +from nemo_fabric_adapters.openclaw import interfaces, terminal + + +@pytest.fixture(name="connection") +def connection_fixture(tmp_path): + if os.name != "posix": + pytest.skip("Managed terminal attachment requires POSIX") + directory = tmp_path / "interfaces" + interfaces.publish( + directory, + runtime_id="test-runtime", + port=18789, + token="test-secret-token", + command=Path(sys.executable).absolute(), + workspace=str(tmp_path), + agent_id="reviewer", + dashboard=False, + terminal=True, + ) + return directory / "gateway.json" + + +@pytest.mark.parametrize( + "origin", + ["https://chat.example.com", "http://localhost:1234", "https://[::1]:8443"], +) +def test_public_origins_accept_http_origins(origin): + assert interfaces.public_origins( + {"interfaces": {"dashboard": {"public_origins": [origin]}}} + ) == [origin] + + +@pytest.mark.parametrize( + "origin", + [ + "https://host/path", + "https://host/", + "https://host?key=value", + "https://user:secret@host", + "javascript:alert(1)", + "https://host:0", + "http://host:invalid", + "https://host#token", + ], +) +def test_public_origins_reject_non_origins(origin): + with pytest.raises(lifecycle.LifecycleError, match="HTTP\\(S\\) origins"): + interfaces.public_origins( + {"interfaces": {"dashboard": {"public_origins": [origin]}}} + ) + + +def test_discovery_has_no_secret_and_cleanup_revokes_marker_first( + connection, monkeypatch +): + directory = connection.parent + assert "test-secret-token" not in connection.read_text() + assert "test-secret-token" not in (directory / "terminal").read_text() + assert "test-secret-token" not in (directory / "client.json").read_text() + assert (directory / "terminal").stat().st_mode & 0o777 == 0o700 + for name in ("gateway.json", "gateway.token", "client.json", "terminal.running"): + assert (directory / name).stat().st_mode & 0o777 == 0o600 + removed = [] + unlink = Path.unlink + + def record(path, **kwargs): + removed.append(path.name) + return unlink(path, **kwargs) + + monkeypatch.setattr(Path, "unlink", record) + assert interfaces.remove(directory) + assert removed[0] == "terminal.running" + assert not any((directory / name).exists() for name in interfaces.FILES) + + +def test_cleanup_retries_failed_removal(connection, monkeypatch): + unlink = Path.unlink + + def deny(path, **kwargs): + if path.name == "gateway.token": + raise PermissionError("denied") + return unlink(path, **kwargs) + + with monkeypatch.context() as scoped: + scoped.setattr(Path, "unlink", deny) + assert not interfaces.remove(connection.parent) + assert interfaces.remove(connection.parent) + assert not connection.with_name("gateway.token").exists() + + +def test_terminal_uses_configured_gateway_without_secret_argv(connection, monkeypatch): + mock_client = MagicMock() + monkeypatch.setattr(terminal.httpx, "Client", mock_client) + os.environ["OPENCLAW_GATEWAY_URL"] = "ws://unmanaged.example" + os.environ["OPENCLAW_GATEWAY_TOKEN"] = "ambient-wrong-token" + command, environment, workspace = terminal.attachment(connection, "review") + assert command[1:] == ["tui", "--session", "agent:reviewer:review"] + assert all("test-secret-token" not in arg for arg in command) + assert "OPENCLAW_GATEWAY_URL" not in environment + assert "OPENCLAW_GATEWAY_TOKEN" not in environment + assert environment["FABRIC_OPENCLAW_CLIENT_TOKEN"] == "test-secret-token" + assert workspace == str(connection.parent.parent) + config = json.loads(Path(environment["OPENCLAW_CONFIG_PATH"]).read_text()) + assert config["gateway"]["mode"] == "remote" + assert config["gateway"]["remote"]["url"] == "ws://127.0.0.1:18789" + mock_client.return_value.__enter__.return_value.get.assert_called_once_with( + "http://127.0.0.1:18789/v1/models", + headers={"Authorization": "Bearer test-secret-token"}, + ) + + +@pytest.mark.parametrize( + "name", ["gateway.json", "gateway.token", "client.json", "terminal.running"] +) +def test_terminal_rejects_public_or_symlinked_files(connection, name, monkeypatch): + monkeypatch.setattr(terminal.httpx, "Client", MagicMock()) + file = connection.with_name(name) + file.chmod(0o644) + with pytest.raises(ValueError, match="owner-only"): + terminal.attachment(connection) + file.chmod(0o600) + target = file.with_suffix(".target") + file.rename(target) + file.symlink_to(target) + with pytest.raises(OSError): + terminal.attachment(connection) + + +@pytest.mark.parametrize("session", ["agent:other:main", "two words", ""]) +def test_terminal_rejects_ambiguous_session(connection, session, monkeypatch): + monkeypatch.setattr(terminal.httpx, "Client", MagicMock()) + with pytest.raises(ValueError, match="session name"): + terminal.attachment(connection, session) diff --git a/tests/adapters/test_openclaw_native.py b/tests/adapters/test_openclaw_native.py new file mode 100644 index 000000000..456684464 --- /dev/null +++ b/tests/adapters/test_openclaw_native.py @@ -0,0 +1,557 @@ +# SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. +# SPDX-License-Identifier: Apache-2.0 + +"""Opt-in qualification against the pinned OpenClaw Gateway and real native clients.""" + +import asyncio +import json +import os +import sys +from pathlib import Path + +import httpx +import pytest +from nemo_fabric import Fabric, FabricConfig + +pytestmark = pytest.mark.skipif( + not os.environ.get("FABRIC_OPENCLAW_TEST_COMMAND"), + reason="Set FABRIC_OPENCLAW_TEST_COMMAND to pinned OpenClaw for native qualification", +) + + +@pytest.fixture(name="native_config") +def native_config_fixture(tmp_path, api_server, unused_tcp_port): + os.environ["ADAPTER_PYTHON"] = sys.executable + os.environ["FABRIC_TEST_MODEL_KEY"] = "native-parity-test-key" + marker = "FABRIC_SHARED_PROMPT_72931" + skill = tmp_path / "external-skills/native-parity" + skill.mkdir(parents=True) + (skill / "SKILL.md").write_text( + "---\nname: native-parity\ndescription: Check the Fabric native parity marker.\n---\nFABRIC_SKILL_98214\n" + ) + config = FabricConfig.from_mapping( + { + "metadata": {"name": "openclaw-native-parity"}, + "harness": { + "adapter_id": "nvidia.fabric.openclaw", + "settings": { + "openclaw_command": os.environ["FABRIC_OPENCLAW_TEST_COMMAND"], + "agent_id": "reviewer", + "interfaces": { + "dashboard": {"port": unused_tcp_port}, + "terminal": {}, + }, + }, + }, + "models": { + "default": { + "provider": "fabric-test", + "model": "fabric-echo", + "base_url": f"{api_server}/v1", + "api_key_env": "FABRIC_TEST_MODEL_KEY", + "temperature": 0.2, + "top_p": 0.8, + "max_tokens": 128, + } + }, + "instructions": {"system": {"content": marker, "mode": "replace"}}, + "tools": {"blocked": ["exec", "process"]}, + "skills": {"paths": [str(skill)]}, + "mcp": { + "servers": { + "fabricprobe": { + "transport": "streamable-http", + "url": f"{api_server}/mcp", + "custom_headers": { + "Authorization": "Bearer native-mcp-test-key" + }, + } + } + }, + "environment": { + "provider": "local", + "workspace": str(tmp_path), + "artifacts": str(tmp_path / "artifacts"), + }, + } + ) + return config + + +async def test_native_and_sdk_share_gateway_configuration( + tmp_path, api_server, unused_tcp_port, native_config +): + from nemo_fabric import CheckRequest, EnvironmentHandle + from playwright.async_api import async_playwright + import pexpect + + marker = native_config.instructions.system.content + (tmp_path / "source.txt").write_text("FABRIC_SOURCE_MARKER_35291\n") + fabric = Fabric() + async with await fabric.start_runtime(native_config, base_dir=tmp_path) as runtime: + directory = ( + tmp_path + / "artifacts/.fabric/openclaw/runtimes" + / runtime.runtime_id + / "interfaces" + ) + token = (directory / "dashboard.token").read_text() + async with httpx.AsyncClient(trust_env=False, timeout=60) as client: + + async def scenario(path, turn): + calls = ( + [ + {"name": "read", "arguments": {"path": "source.txt"}}, + { + "name": "write", + "arguments": { + "path": f"{path}-result.txt", + "content": f"{path} configured workspace verified", + }, + }, + ] + if turn == 1 + else [ + { + "name": "tool_call", + "arguments": { + "id": "mcp:fabricprobe:fabricprobe__get_authorization_header", + "args": {}, + }, + }, + { + "name": "read", + "arguments": { + "path": str( + Path(native_config.skills.paths[0]) / "SKILL.md" + ) + }, + }, + ] + ) + response = await client.post( + f"{api_server}/_scenario", + json={ + "tool_calls": calls, + "response_text": f"{path} turn {turn} complete", + }, + ) + response.raise_for_status() + + for turn in (1, 2): + await scenario("sdk", turn) + result = await runtime.invoke(input=f"SDK parity turn {turn}") + assert result.status == "succeeded", result.to_mapping() + assert ( + tmp_path / "sdk-result.txt" + ).read_text() == "sdk configured workspace verified" + + for turn in (1, 2): + await scenario("http", turn) + response = await client.post( + f"http://127.0.0.1:{unused_tcp_port}/v1/chat/completions", + headers={"Authorization": f"Bearer {token}"}, + json={ + "model": "openclaw/reviewer", + "user": "http-parity-client", + "messages": [ + {"role": "user", "content": f"HTTP parity turn {turn}"} + ], + }, + ) + assert response.status_code == 200, response.text + assert ( + tmp_path / "http-result.txt" + ).read_text() == "http configured workspace verified" + + async with async_playwright() as playwright: + browser = await playwright.chromium.launch( + headless=True, + args=["--no-sandbox"], + executable_path=os.environ.get("FABRIC_TEST_CHROMIUM"), + ) + try: + page = await browser.new_page() + await page.goto( + f"http://127.0.0.1:{unused_tcp_port}/#token={token}" + ) + textarea = page.get_by_role( + "textbox", name="Chat composer", exact=True + ) + await textarea.wait_for(timeout=20000) + for turn in (1, 2): + await scenario("browser", turn) + await textarea.fill(f"Browser parity turn {turn}") + await textarea.press("Enter") + await ( + page.get_by_role("paragraph") + .filter(has_text=f"browser turn {turn} complete") + .wait_for(timeout=30000) + ) + await page.wait_for_timeout(500) + await page.screenshot(path=str(tmp_path / "browser.png")) + (tmp_path / "browser-body.txt").write_text( + (await page.locator("body").inner_text()).replace( + token, "[redacted]" + ) + ) + finally: + await page.screenshot(path=str(tmp_path / "browser.png")) + (tmp_path / "browser-body.txt").write_text( + (await page.locator("body").inner_text()).replace( + token, "[redacted]" + ) + ) + (tmp_path / "browser-model-requests.json").write_text( + json.dumps( + (await client.get(f"{api_server}/_requests")).json(), + indent=2, + ) + ) + await browser.close() + assert ( + tmp_path / "browser-result.txt" + ).read_text() == "browser configured workspace verified" + + def terminal_turns(): + child = pexpect.spawn( + str(directory / "terminal"), + ["--session", "parity-terminal"], + encoding="utf-8", + timeout=45, + dimensions=(32, 120), + ) + try: + with (tmp_path / "terminal.log").open("w") as transcript: + child.logfile_read = transcript + child.expect(r"(?= 4 + messages = json.dumps(payloads) + assert "FABRIC_SOURCE_MARKER_35291" in messages + assert "FABRIC_SKILL_98214" in messages + for name in ( + "terminal.running", + "terminal", + "gateway.json", + "client.json", + "dashboard.token", + ): + assert not (directory / name).exists() + + +async def test_native_mcp_and_skills_use_managed_configuration( + tmp_path, api_server, native_config +): + from nemo_fabric_adapters.openclaw import terminal + + fabric = Fabric() + async with await fabric.start_runtime(native_config, base_dir=tmp_path) as runtime: + async with httpx.AsyncClient(trust_env=False, timeout=60) as client: + await client.post( + f"{api_server}/_scenario", + json={ + "tool_call": { + "name": "tool_search", + "arguments": {"query": "fabricprobe authorization header"}, + } + }, + ) + result = await runtime.invoke( + input="Discover the configured MCP authorization tool." + ) + assert result.status == "succeeded", result.to_mapping() + payloads = (await client.get(f"{api_server}/_requests")).json() + (tmp_path / "mcp-search-requests.json").write_text( + json.dumps(payloads, indent=2) + ) + tool_messages = [ + message + for payload in payloads + for message in payload["messages"] + if message["role"] == "tool" + ] + assert any( + "get_authorization_header" in str(message["content"]) + for message in tool_messages + ), tool_messages + await client.post( + f"{api_server}/_scenario", + json={ + "tool_call": { + "name": "tool_call", + "arguments": { + "id": "mcp:fabricprobe:fabricprobe__get_authorization_header", + "args": {}, + }, + } + }, + ) + result = await runtime.invoke(input="Call the discovered MCP tool.") + assert result.status == "succeeded", result.to_mapping() + assert ( + await client.get(f"{api_server}/_mcp_authorization_headers") + ).json()[-1] == "Bearer native-mcp-test-key" + forbidden = tmp_path / "forbidden-exec.txt" + await client.post( + f"{api_server}/_scenario", + json={ + "tool_call": { + "name": "tool_call", + "arguments": { + "id": "exec", + "args": {"command": f"touch {forbidden}"}, + }, + } + }, + ) + result = await runtime.invoke( + input="Check that blocked shell execution is rejected." + ) + assert result.status == "succeeded", result.to_mapping() + assert not forbidden.exists() + payloads = (await client.get(f"{api_server}/_requests")).json() + refusal = next( + message["content"] + for message in reversed(payloads[-1]["messages"]) + if message["role"] == "tool" + ) + assert any( + term in str(refusal).lower() + for term in ( + "unknown tool", + "not found", + "not allowed", + "denied", + "unavailable", + ) + ), refusal + connection = ( + tmp_path + / "artifacts/.fabric/openclaw/runtimes" + / runtime.runtime_id + / "interfaces/gateway.json" + ) + command, environment, _ = terminal.attachment(connection) + process = await asyncio.create_subprocess_exec( + command[0], + "gateway", + "call", + "skills.status", + "--params", + '{"agentId":"reviewer"}', + "--json", + env=environment, + stdout=asyncio.subprocess.PIPE, + stderr=asyncio.subprocess.PIPE, + ) + stdout, stderr = await asyncio.wait_for(process.communicate(), 30) + (tmp_path / "skills-status.txt").write_bytes(stdout) + assert process.returncode == 0, stderr.decode() + assert "native-parity" in stdout.decode() + + +async def test_four_clients_can_invoke_concurrently( + tmp_path, api_server, unused_tcp_port, native_config +): + import pexpect + from playwright.async_api import async_playwright + + fabric = Fabric() + async with await fabric.start_runtime(native_config, base_dir=tmp_path) as runtime: + directory = ( + tmp_path + / "artifacts/.fabric/openclaw/runtimes" + / runtime.runtime_id + / "interfaces" + ) + token = (directory / "dashboard.token").read_text().strip() + async with async_playwright() as playwright: + browser = await playwright.chromium.launch( + headless=True, + args=["--no-sandbox"], + executable_path=os.environ.get("FABRIC_TEST_CHROMIUM"), + ) + child = None + try: + page = await browser.new_page() + await page.goto(f"http://127.0.0.1:{unused_tcp_port}/#token={token}") + composer = page.get_by_role("textbox", name="Chat composer", exact=True) + await composer.wait_for(timeout=20000) + child = pexpect.spawn( + str(directory / "terminal"), + ["--session", "concurrent-tui"], + encoding="utf-8", + timeout=30, + dimensions=(32, 120), + ) + await asyncio.to_thread(child.expect, r"(? Date: Mon, 9 Nov 2026 06:06:29 -0800 Subject: [PATCH 14/27] docs(openclaw): explain and demonstrate four invocation paths Mirror the Hermes overview and SDK/API/dashboard/TUI guide structure, add an editable invocation diagram and a repeatable owner/client example, and keep Relay explicitly deferred. Preserve existing Hermes docs and examples while its separate PR is unmerged. Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- adapters/python/openclaw/README.md | 13 +- assets/openclaw-invocation-paths.excalidraw | 1356 +++++++++++++++++ assets/openclaw-invocation-paths.png | Bin 0 -> 202011 bytes docs/index.yml | 10 +- docs/integrations/harness/openclaw.mdx | 245 --- .../harness/openclaw/openclaw-api.mdx | 24 + .../harness/openclaw/openclaw-dashboard.mdx | 63 + .../harness/openclaw/openclaw-sdk.mdx | 100 ++ .../harness/openclaw/openclaw-tui.mdx | 26 + .../harness/openclaw/openclaw.mdx | 148 ++ docs/integrations/harness/overview.mdx | 2 +- docs/sdk/health-checks.mdx | 4 +- examples/interfaces/README-openclaw.md | 102 ++ examples/interfaces/README.md | 5 + examples/interfaces/openclaw.py | 186 +++ 15 files changed, 2032 insertions(+), 252 deletions(-) create mode 100644 assets/openclaw-invocation-paths.excalidraw create mode 100644 assets/openclaw-invocation-paths.png delete mode 100644 docs/integrations/harness/openclaw.mdx create mode 100644 docs/integrations/harness/openclaw/openclaw-api.mdx create mode 100644 docs/integrations/harness/openclaw/openclaw-dashboard.mdx create mode 100644 docs/integrations/harness/openclaw/openclaw-sdk.mdx create mode 100644 docs/integrations/harness/openclaw/openclaw-tui.mdx create mode 100644 docs/integrations/harness/openclaw/openclaw.mdx create mode 100644 examples/interfaces/README-openclaw.md create mode 100644 examples/interfaces/openclaw.py diff --git a/adapters/python/openclaw/README.md b/adapters/python/openclaw/README.md index b7df6522c..b53054edb 100644 --- a/adapters/python/openclaw/README.md +++ b/adapters/python/openclaw/README.md @@ -104,10 +104,11 @@ The following settings are specific to the OpenClaw adapter: | Setting | Default | Description | | --- | --- | --- | | `openclaw_command` | `openclaw` | Executable name or path. | -| `agent_id` | `default` | OpenClaw agent for NeMo Fabric-originated invocations. | +| `agent_id` | `default` | Selected agent for SDK and managed native clients. | | `channel_config` | None | OpenClaw-native `channels` and `bindings` for a prepared service. Every binding must target `agent_id`. Managed runtimes reject this setting. | | `port_range` | Random available range | Inclusive consumer-allocated range with `start` and `end` fields; it must span at least 111 ports. | -| `interfaces.dashboard` | None | Serve the Control UI on a managed runtime, with an exact `port` and optional `enabled`; see [Serve the Control UI](../../../docs/integrations/harness/openclaw.mdx#serve-the-control-ui). | +| `interfaces.dashboard` | None | Serve the Control UI on a managed runtime, with an exact `port`, optional `enabled`, and `public_origins`; refer to the [dashboard guide](../../../docs/integrations/harness/openclaw/openclaw-dashboard.mdx). | +| `interfaces.terminal` | None | Attach the native terminal to the existing Gateway, without a separate port. Refer to the [terminal guide](../../../docs/integrations/harness/openclaw/openclaw-tui.mdx). | | `startup_timeout_seconds` | `60` | One deadline for all of start, from checking the `openclaw` command to the Gateway becoming ready; at most 75 seconds. | | `shutdown_timeout_seconds` | `5` | Graceful shutdown timeout. | | `connect_timeout_seconds` | `10` | Local HTTP connection timeout. | @@ -115,7 +116,13 @@ The following settings are specific to the OpenClaw adapter: OpenClaw's [derived-port mapping](https://docs.openclaw.ai/gateway/multiple-gateways#port-mapping-derived) uses `base_port + 2` for browser control and allocates browser CDP ports from `base_port + 11` through `base_port + 110`. Set `port_range` when the consumer reserves a port range before configuring NeMo Fabric; the adapter selects a base whose complete derived footprint fits inside that range. The adapter verifies only that `base_port` and `base_port + 2` are available before startup. OpenClaw allocates the CDP ports on demand instead of reserving the complete range, so the adapter cannot guarantee that those ports will still be available when OpenClaw needs them. Keep the configured range reserved for the lifetime of the runtime when using OpenClaw browser features. -Relay telemetry and native OpenTelemetry are not supported. +With native interfaces enabled, one Gateway owns all four client paths. A small adapter-owned plugin applies replacement system instructions to the selected agent through the public `before_prompt_build` hook. SDK requests omit duplicate instruction injection in that mode; SDK-only and service behavior are preserved. OpenClaw appends its native model-identity sentence. Model, workspace, tools, MCP, and skill configuration are shared; native responses remain native. + +After readiness, private `interfaces/gateway.json` discovery references `dashboard.token` or `gateway.token`. Terminal selection adds an executable `interfaces/terminal` and `terminal.running` marker; the marker is removed first on stop. The launcher uses private client configuration and an environment SecretRef, not token arguments. Terminal attachment currently requires POSIX. Pinned TUI `/quit` can use a native exit-code-130 fallback while the Gateway stays usable. + +Refer to the [four-path architecture](../../../docs/integrations/harness/openclaw/openclaw.mdx) and [repeatable examples](../../../examples/interfaces/README-openclaw.md). Relay telemetry, ATIF/ATOF export, and native OpenTelemetry are not supported. + +With native browser or terminal access enabled, runtime activity is `unknown`; healthy endpoints can still pass normalized checks. SDK invocation state alone cannot account for native work. ## Gateway Health diff --git a/assets/openclaw-invocation-paths.excalidraw b/assets/openclaw-invocation-paths.excalidraw new file mode 100644 index 000000000..6f4793649 --- /dev/null +++ b/assets/openclaw-invocation-paths.excalidraw @@ -0,0 +1,1356 @@ +{ + "type": "excalidraw", + "version": 2, + "source": "https://excalidraw.com", + "elements": [ + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "title", + "type": "text", + "x": 40, + "y": 25, + "width": 438.4375, + "height": 40, + "strokeColor": "#245400", + "backgroundColor": "transparent", + "seed": 1, + "versionNonce": 896046343, + "updated": 1794203765817, + "fontSize": 32, + "fontFamily": 2, + "text": "OpenClaw invocation paths", + "originalText": "OpenClaw invocation paths", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "a0" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "subtitle", + "type": "text", + "x": 40, + "y": 73, + "width": 516.630859375, + "height": 25, + "strokeColor": "#495057", + "backgroundColor": "transparent", + "seed": 2, + "versionNonce": 584868585, + "updated": 1794203765817, + "fontSize": 20, + "fontFamily": 2, + "text": "Four client paths \u00b7 One Gateway execution backend", + "originalText": "Four client paths \u00b7 One Gateway execution backend", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "a1" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 3 + }, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "runtime-boundary", + "type": "rectangle", + "x": 450, + "y": 130, + "width": 740, + "height": 760, + "strokeColor": "#868e96", + "backgroundColor": "transparent", + "seed": 3, + "versionNonce": 1371429927, + "updated": 1794203765817, + "index": "a2" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "runtime-label", + "type": "text", + "x": 472, + "y": 148, + "width": 249.15234375, + "height": 30, + "strokeColor": "#868e96", + "backgroundColor": "transparent", + "seed": 4, + "versionNonce": 1963072969, + "updated": 1794203765817, + "fontSize": 24, + "fontFamily": 2, + "text": "NeMo Fabric runtime", + "originalText": "NeMo Fabric runtime", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "a3" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "config-group" + ], + "frameId": null, + "roundness": { + "type": 3 + }, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "config", + "type": "rectangle", + "x": 500, + "y": 205, + "width": 640, + "height": 122, + "strokeColor": "#638b20", + "backgroundColor": "#f4fbdf", + "seed": 5, + "versionNonce": 1779318599, + "updated": 1794203765817, + "index": "a4" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "config-group" + ], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "config-title", + "type": "text", + "x": 522, + "y": 222, + "width": 251.3203125, + "height": 30, + "strokeColor": "#638b20", + "backgroundColor": "transparent", + "seed": 6, + "versionNonce": 879590569, + "updated": 1794203765817, + "fontSize": 24, + "fontFamily": 2, + "text": "Shared configuration", + "originalText": "Shared configuration", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "a5" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "config-group" + ], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "config-detail", + "type": "text", + "x": 522, + "y": 261, + "width": 327.65625, + "height": 50, + "strokeColor": "#343a40", + "backgroundColor": "transparent", + "seed": 7, + "versionNonce": 817151591, + "updated": 1794203765817, + "fontSize": 20, + "fontFamily": 2, + "text": "Model \u00b7 Instructions \u00b7 Tools / MCP\nWorkspace \u00b7 Skills", + "originalText": "Model \u00b7 Instructions \u00b7 Tools / MCP\nWorkspace \u00b7 Skills", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "a6" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "adapter-group" + ], + "frameId": null, + "roundness": { + "type": 3 + }, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "adapter", + "type": "rectangle", + "x": 500, + "y": 370, + "width": 640, + "height": 100, + "strokeColor": "#1971c2", + "backgroundColor": "#e7f5ff", + "seed": 8, + "versionNonce": 1892286345, + "updated": 1794203765817, + "index": "a7" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "adapter-group" + ], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "adapter-title", + "type": "text", + "x": 522, + "y": 387, + "width": 172.828125, + "height": 30, + "strokeColor": "#1971c2", + "backgroundColor": "transparent", + "seed": 9, + "versionNonce": 1484675463, + "updated": 1794203765817, + "fontSize": 24, + "fontFamily": 2, + "text": "Fabric adapter", + "originalText": "Fabric adapter", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "a8" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "adapter-group" + ], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "adapter-detail", + "type": "text", + "x": 522, + "y": 426, + "width": 283.037109375, + "height": 25, + "strokeColor": "#343a40", + "backgroundColor": "transparent", + "seed": 10, + "versionNonce": 944973417, + "updated": 1794203765817, + "fontSize": 20, + "fontFamily": 2, + "text": "Invoke \u00b7 Start \u00b7 Health \u00b7 Stop", + "originalText": "Invoke \u00b7 Start \u00b7 Health \u00b7 Stop", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "a9" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "gateway-group" + ], + "frameId": null, + "roundness": { + "type": 3 + }, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "gateway", + "type": "rectangle", + "x": 500, + "y": 525, + "width": 640, + "height": 310, + "strokeColor": "#2b8a3e", + "backgroundColor": "#ebfbee", + "seed": 11, + "versionNonce": 111644839, + "updated": 1794203765817, + "index": "aA" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "gateway-group" + ], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "gateway-title", + "type": "text", + "x": 522, + "y": 542, + "width": 235.51171875, + "height": 30, + "strokeColor": "#2b8a3e", + "backgroundColor": "transparent", + "seed": 12, + "versionNonce": 1171550537, + "updated": 1794203765817, + "fontSize": 24, + "fontFamily": 2, + "text": "OpenClaw Gateway", + "originalText": "OpenClaw Gateway", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "aB" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "gateway-group" + ], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "gateway-detail", + "type": "text", + "x": 522, + "y": 581, + "width": 443.1640625, + "height": 25, + "strokeColor": "#343a40", + "backgroundColor": "transparent", + "seed": 13, + "versionNonce": 81585095, + "updated": 1794203765817, + "fontSize": 20, + "fontFamily": 2, + "text": "Native HTTP + browser + terminal protocols", + "originalText": "Native HTTP + browser + terminal protocols", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "aC" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "gateway-group" + ], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "agent-loop", + "type": "text", + "x": 530, + "y": 655, + "width": 436.37109375, + "height": 30, + "strokeColor": "#2b8a3e", + "backgroundColor": "transparent", + "seed": 14, + "versionNonce": 1856593961, + "updated": 1794203765817, + "fontSize": 24, + "fontFamily": 2, + "text": "Native OpenClaw agent loop + tools", + "originalText": "Native OpenClaw agent loop + tools", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "aD" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "gateway-group" + ], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "sessions", + "type": "text", + "x": 530, + "y": 713, + "width": 361.9423828125, + "height": 52.5, + "strokeColor": "#343a40", + "backgroundColor": "transparent", + "seed": 15, + "versionNonce": 859493095, + "updated": 1794203765817, + "fontSize": 21, + "fontFamily": 2, + "text": "Shared configuration\nConversations selected by session", + "originalText": "Shared configuration\nConversations selected by session", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "aE" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "sdk-group" + ], + "frameId": null, + "roundness": { + "type": 3 + }, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "sdk", + "type": "rectangle", + "x": 40, + "y": 370, + "width": 300, + "height": 100, + "strokeColor": "#1971c2", + "backgroundColor": "#e7f5ff", + "seed": 16, + "versionNonce": 1354593033, + "updated": 1794203765817, + "index": "aF" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "sdk-group" + ], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "sdk-title", + "type": "text", + "x": 62, + "y": 387, + "width": 123, + "height": 30, + "strokeColor": "#1971c2", + "backgroundColor": "transparent", + "seed": 17, + "versionNonce": 978181639, + "updated": 1794203765817, + "fontSize": 24, + "fontFamily": 2, + "text": "SDK client", + "originalText": "SDK client", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "aG" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "sdk-group" + ], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "sdk-detail", + "type": "text", + "x": 62, + "y": 426, + "width": 81.083984375, + "height": 25, + "strokeColor": "#343a40", + "backgroundColor": "transparent", + "seed": 18, + "versionNonce": 1082927593, + "updated": 1794203765817, + "fontSize": 20, + "fontFamily": 2, + "text": "invoke()", + "originalText": "invoke()", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "aH" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "http-group" + ], + "frameId": null, + "roundness": { + "type": 3 + }, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "http", + "type": "rectangle", + "x": 40, + "y": 515, + "width": 300, + "height": 100, + "strokeColor": "#7950b2", + "backgroundColor": "#f3f0ff", + "seed": 19, + "versionNonce": 2098365735, + "updated": 1794203765817, + "index": "aI" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "http-group" + ], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "http-title", + "type": "text", + "x": 62, + "y": 532, + "width": 134.96484375, + "height": 30, + "strokeColor": "#7950b2", + "backgroundColor": "transparent", + "seed": 20, + "versionNonce": 1998652617, + "updated": 1794203765817, + "fontSize": 24, + "fontFamily": 2, + "text": "HTTP client", + "originalText": "HTTP client", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "aJ" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "http-group" + ], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "http-detail", + "type": "text", + "x": 62, + "y": 571, + "width": 195.556640625, + "height": 25, + "strokeColor": "#343a40", + "backgroundColor": "transparent", + "seed": 21, + "versionNonce": 1257588807, + "updated": 1794203765817, + "fontSize": 20, + "fontFamily": 2, + "text": "Native API requests", + "originalText": "Native API requests", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "aK" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "browser-group" + ], + "frameId": null, + "roundness": { + "type": 3 + }, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "browser", + "type": "rectangle", + "x": 40, + "y": 660, + "width": 300, + "height": 100, + "strokeColor": "#2b8a3e", + "backgroundColor": "#ebfbee", + "seed": 22, + "versionNonce": 1541033, + "updated": 1794203765817, + "index": "aL" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "browser-group" + ], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "browser-title", + "type": "text", + "x": 62, + "y": 677, + "width": 97.25390625, + "height": 30, + "strokeColor": "#2b8a3e", + "backgroundColor": "transparent", + "seed": 23, + "versionNonce": 1372759911, + "updated": 1794203765817, + "fontSize": 24, + "fontFamily": 2, + "text": "Browser", + "originalText": "Browser", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "aM" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "browser-group" + ], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "browser-detail", + "type": "text", + "x": 62, + "y": 716, + "width": 207.099609375, + "height": 25, + "strokeColor": "#343a40", + "backgroundColor": "transparent", + "seed": 24, + "versionNonce": 1738221193, + "updated": 1794203765817, + "fontSize": 20, + "fontFamily": 2, + "text": "OpenClaw Control UI", + "originalText": "OpenClaw Control UI", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "aN" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "terminal-group" + ], + "frameId": null, + "roundness": { + "type": 3 + }, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "terminal", + "type": "rectangle", + "x": 40, + "y": 805, + "width": 300, + "height": 100, + "strokeColor": "#2b8a3e", + "backgroundColor": "#ebfbee", + "seed": 25, + "versionNonce": 1341596295, + "updated": 1794203765817, + "index": "aO" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "terminal-group" + ], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "terminal-title", + "type": "text", + "x": 62, + "y": 822, + "width": 101.42578125, + "height": 30, + "strokeColor": "#2b8a3e", + "backgroundColor": "transparent", + "seed": 26, + "versionNonce": 677866857, + "updated": 1794203765817, + "fontSize": 24, + "fontFamily": 2, + "text": "Terminal", + "originalText": "Terminal", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "aP" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [ + "terminal-group" + ], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "terminal-detail", + "type": "text", + "x": 62, + "y": 861, + "width": 140.6640625, + "height": 25, + "strokeColor": "#343a40", + "backgroundColor": "transparent", + "seed": 27, + "versionNonce": 102709671, + "updated": 1794203765817, + "fontSize": 20, + "fontFamily": 2, + "text": "OpenClaw TUI", + "originalText": "OpenClaw TUI", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "aQ" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "sdk-path", + "type": "arrow", + "x": 348, + "y": 420, + "width": 142, + "height": 0, + "strokeColor": "#1971c2", + "backgroundColor": "transparent", + "seed": 28, + "versionNonce": 1506269257, + "updated": 1794203765817, + "points": [ + [ + 0, + 0 + ], + [ + 142, + 0 + ] + ], + "startBinding": null, + "endBinding": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false, + "index": "aR", + "lastCommittedPoint": null + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "config-adapter", + "type": "arrow", + "x": 820, + "y": 335, + "width": 0, + "height": 25, + "strokeColor": "#638b20", + "backgroundColor": "transparent", + "seed": 29, + "versionNonce": 1769434311, + "updated": 1794203765817, + "points": [ + [ + 0, + 0 + ], + [ + 0, + 25 + ] + ], + "startBinding": null, + "endBinding": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false, + "index": "aS", + "lastCommittedPoint": null + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "adapter-gateway", + "type": "arrow", + "x": 820, + "y": 478, + "width": 0, + "height": 37, + "strokeColor": "#1971c2", + "backgroundColor": "transparent", + "seed": 30, + "versionNonce": 496494377, + "updated": 1794203765817, + "points": [ + [ + 0, + 0 + ], + [ + 0, + 37 + ] + ], + "startBinding": null, + "endBinding": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false, + "index": "aT", + "lastCommittedPoint": null + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "http-path", + "type": "arrow", + "x": 348, + "y": 565, + "width": 142, + "height": 0, + "strokeColor": "#7950b2", + "backgroundColor": "transparent", + "seed": 31, + "versionNonce": 362560487, + "updated": 1794203765817, + "points": [ + [ + 0, + 0 + ], + [ + 142, + 0 + ] + ], + "startBinding": null, + "endBinding": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false, + "index": "aU", + "lastCommittedPoint": null + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "browser-path", + "type": "arrow", + "x": 348, + "y": 710, + "width": 142, + "height": 95, + "strokeColor": "#2b8a3e", + "backgroundColor": "transparent", + "seed": 32, + "versionNonce": 1313020425, + "updated": 1794203765817, + "points": [ + [ + 0, + 0 + ], + [ + 72, + 0 + ], + [ + 72, + -95 + ], + [ + 142, + -95 + ] + ], + "startBinding": null, + "endBinding": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false, + "index": "aV", + "lastCommittedPoint": null + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "terminal-path", + "type": "arrow", + "x": 348, + "y": 855, + "width": 142, + "height": 65, + "strokeColor": "#2b8a3e", + "backgroundColor": "transparent", + "seed": 33, + "versionNonce": 2124031751, + "updated": 1794203765817, + "points": [ + [ + 0, + 0 + ], + [ + 82, + 0 + ], + [ + 82, + -65 + ], + [ + 142, + -65 + ] + ], + "startBinding": null, + "endBinding": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false, + "index": "aW", + "lastCommittedPoint": null + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "footer-one", + "type": "text", + "x": 40, + "y": 962, + "width": 812.38623046875, + "height": 26.25, + "strokeColor": "#212529", + "backgroundColor": "transparent", + "seed": 34, + "versionNonce": 1824846057, + "updated": 1794203765817, + "fontSize": 21, + "fontFamily": 2, + "text": "\u2022 One Gateway serves every path; clients can select separate conversations.", + "originalText": "\u2022 One Gateway serves every path; clients can select separate conversations.", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "aX" + }, + { + "angle": 0, + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "version": 2, + "isDeleted": false, + "boundElements": [], + "link": null, + "locked": false, + "id": "footer-two", + "type": "text", + "x": 40, + "y": 1002, + "width": 758.6455078125, + "height": 26.25, + "strokeColor": "#212529", + "backgroundColor": "transparent", + "seed": 35, + "versionNonce": 1659743783, + "updated": 1794203765817, + "fontSize": 21, + "fontFamily": 2, + "text": "\u2022 SDK returns normalized results; HTTP and UI responses remain native.", + "originalText": "\u2022 SDK returns normalized results; HTTP and UI responses remain native.", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "autoResize": true, + "lineHeight": 1.25, + "index": "aY" + } + ], + "appState": { + "viewBackgroundColor": "#ffffff", + "exportBackground": true, + "exportEmbedScene": true + }, + "files": {} +} diff --git a/assets/openclaw-invocation-paths.png b/assets/openclaw-invocation-paths.png new file mode 100644 index 0000000000000000000000000000000000000000..4c4df50f5ea7b92f7d88b5b44cb9f94bcc777840 GIT binary patch literal 202011 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

6r<< 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

  • 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"Adapter contract
    JSON over stdio"| Adapter["OpenClaw adapter"] - Adapter -->|"Start with normalized configuration"| Gateway["OpenClaw Gateway process"] - Adapter -->|"Invoke through OpenAI-compatible Chat Completions
    over loopback HTTP"| Gateway - Gateway -->|"TypeScript"| Core["OpenClaw Gateway core"] - Core --> Native - - subgraph Selected["Selected OpenClaw runtime"] - Native["Native OpenClaw runtime"] - end -``` - -## Choose a Lifecycle - -Choose the lifecycle that matches who owns the Gateway: - -| Lifecycle | Gateway Ownership | Use Case | -| --- | --- | --- | -| Managed runtime | NeMo Fabric starts one Gateway for each runtime and stops it with the runtime. | Evaluation, benchmark runs, and other bounded jobs. | -| Prepared service | NeMo Fabric starts and supervises one Gateway that multiple runtimes can share. | Long-lived local deployments and OpenClaw chat channels. | -| Attached service | Another deployment system starts and supervises the Gateway; NeMo Fabric connects to it. | Existing or independently managed deployments. | - -## Install OpenClaw and the Adapter - -Refer to the official OpenClaw [installation documentation](https://docs.openclaw.ai/install) for detailed installation and usage instructions. - -To install OpenClaw from an npm package, then install the NeMo Fabric runtime and adapter run the following commands. - -```bash -# Requires Node.js >=24.22.1 <25 or >=26.12.1, and npm 11.16+ -npm install --global openclaw@2026.9.34 --allow-scripts=openclaw -pip install "nemo-fabric[openclaw]" -``` - -To install the adapter without the NeMo Fabric runtime, use -`nemo-fabric-adapters-openclaw`. The adapter package does not install OpenClaw. - -### Upgrade a Gateway With Retained State - -When upgrading a caller-owned Gateway from OpenClaw 2026.9.4, stop the Gateway and run `openclaw backup create --verify` with the Gateway's existing `OPENCLAW_STATE_DIR` and `OPENCLAW_CONFIG_PATH` before upgrading. The backup must include the active config, its include files, and all configured agent directories, including paths outside the state directory. Protect the archive because it can contain credentials. - -Before upgrading, check the backup result and manifest for the active config, its include files, and every configured agent directory. For paths marked `covered`, confirm that the archive contains the data under a parent directory. Fix missing required paths and rerun the backup. Continue with the upgrade after confirming that all required data is backed up. - -Before migration, copy every legacy session directory while the Gateway is stopped. Include `sessions.json`, `.jsonl` transcripts, and session directories outside `OPENCLAW_STATE_DIR`. The backup command excludes legacy `.jsonl` transcripts. Protect these copies and keep them with the verified archive for rollback. - -Run `openclaw doctor --fix` with the 2026.9.34 executable and the same path settings. The command imports legacy `sessions.json` files and JSONL session data into each agent's SQLite database. Restart the Gateway after the command succeeds. Keep the verified backup for rollback. - -Managed runtimes and NeMo Fabric-owned services use temporary state directories, so each new Gateway starts with fresh state. - -## Configure the Adapter - -Select the adapter and, when necessary, specify the OpenClaw executable: - -```python -from nemo_fabric import HarnessConfig - -harness = HarnessConfig( - adapter_id="nvidia.fabric.openclaw", - settings={ - "openclaw_command": "/opt/openclaw/bin/openclaw", - "startup_timeout_seconds": 60, - }, -) -``` - -Omit `openclaw_command` to resolve `openclaw` from `PATH`. A relative path that -contains a directory is resolved from the NeMo Fabric base directory. The adapter -uses the resolved executable for its version check, configuration validation, -and Gateway startup. - -`startup_timeout_seconds` sets one deadline for all of start, from checking the -`openclaw` command to the Gateway becoming ready. It defaults to 60 seconds and -can be at most 75 seconds, which keeps start within NeMo Fabric's 90-second -start limit. - -The adapter supports only OpenClaw's default `openclaw` agent runtime. - -The adapter accepts normalized model provider, model, base URL, temperature, -`top_p`, `max_tokens`, replacement system instruction, workspace, skills, and -MCP configuration. Normalized MCP authentication is not supported. For a -custom OpenAI-compatible endpoint, set the model's `base_url` and, when needed, -`api_key_env`. - -For an endpoint that supports `stream_options.include_usage`, set -`models..settings.supports_usage_in_streaming` to `true`. This maps to -OpenClaw's native `compat.supportsUsageInStreaming` and requires `base_url`. -Use `false` for an endpoint that rejects streaming usage, or omit the setting -to retain OpenClaw's endpoint capability detection. Attached services own -their model configuration and do not accept this setting. - -OpenClaw 2026.9.4's Gateway does not distinguish aggregate usage from its -last-call fallback, and converts missing usage to zero counters. NeMo Fabric -leaves standard complete counters unknown and preserves the Gateway's counts -in `usage.extensions["nvidia.fabric.openclaw.usage_evidence.v1"].observed`. -The evidence includes `scope_unverified` in `gaps`, plus `missing_usage` or -`zero_unverified` when applicable. Reported counts do not establish complete -coverage of retries, compaction, child agents, or background work. - -For a NeMo Fabric-owned service, `harness.settings.channel_config` accepts -OpenClaw-native `channels` and `bindings`. This supports multiple accounts for -Telegram and other OpenClaw channels without a NeMo Fabric-specific channel schema. -Every binding must target the configured `agent_id`; OpenClaw validates the -nested channel settings. Chat-channel traffic goes directly between the -channel and OpenClaw rather than through a NeMo Fabric runtime. - -By default, the adapter chooses an available local port range. Set `port_range` -to an inclusive consumer-allocated range with `start` and `end` fields. The -range must span at least 111 ports. OpenClaw's [derived-port mapping](https://docs.openclaw.ai/gateway/multiple-gateways#port-mapping-derived) uses `base_port + 2` for browser control and allocates browser CDP ports from `base_port + 11` through `base_port + 110`. The adapter verifies only that `base_port` and `base_port + 2` are available before startup. OpenClaw allocates the CDP ports on demand instead of reserving the complete range, so the adapter cannot guarantee that those ports will still be available when OpenClaw needs them. Keep the configured range reserved for the lifetime of the runtime or service when using OpenClaw browser features. - -## Serve the Control UI - -OpenClaw's Control UI is its browser dashboard and chat. A managed runtime -serves it when `harness.settings.interfaces.dashboard` is present: - -```python -from nemo_fabric import HarnessConfig - -harness = HarnessConfig( - adapter_id="nvidia.fabric.openclaw", - settings={"interfaces": {"dashboard": {"port": 18789}}}, -) -``` - -- The Gateway listens on `127.0.0.1` at the dashboard `port`, which serves the - Control UI. `start` fails with `openclaw_interface_port_unavailable` if - `port` or `port + 2` is in use. OpenClaw also uses `port + 10` for its - browser relay and allocates browser CDP ports from `port + 11` through - `port + 110`, so reserve the whole range from `port` through `port + 110`. - `port` can't be combined with `port_range`; set `enabled` to `false` to keep - a configured dashboard off. -- After the Gateway starts, the adapter writes the sign-in token, generated at - each start, to - `/.fabric/openclaw/runtimes//interfaces/dashboard.token` - with mode `0600` on POSIX hosts; on Windows, the file inherits the artifact - root's permissions. `stop` removes it; if the adapter host is killed, the file - can remain. -- Open `http://127.0.0.1:/#token=` through a forward to that - port to sign in. The Control UI removes the token from the address bar. - OpenClaw 2026.9.34 accepts any loopback origin, such as a forward to a - different local port; the token is still required. -- Processes that run as the runtime's user, including the agent's own tools, - can read the token and reach the port. -- The adapter regenerates OpenClaw's configuration at each start and marks it - read-only, so changes made through the Control UI don't survive a restart. -- Prepared and attached services reject `interfaces` with - `openclaw_interfaces_require_managed_runtime`. - -## Use a Shared Service - -Call `prepare_service()` to map the normalized `FabricConfig` to -`openclaw.json` and start a NeMo Fabric-owned Gateway. Pass the returned service -to `start_runtime()` to give each runtime an independent OpenClaw session: - -```python -from nemo_fabric import Fabric - - -async def invoke_with_prepared_service(config): - fabric = Fabric() - async with await fabric.prepare_service(config) as service: - async with await fabric.start_runtime(config, service=service) as runtime: - return await runtime.invoke(input="Review the workspace changes.") -``` - -Call `attach_service()` when another system owns the Gateway lifecycle. The -reference contains the endpoint and the name of an environment variable that -holds the Gateway token, never the token value: - -```python -from nemo_fabric import Fabric -from nemo_fabric import ServiceReference - - -async def invoke_with_attached_service(config): - reference = ServiceReference.from_mapping( - { - "adapter_id": "nvidia.fabric.openclaw", - "service_type": "openclaw_gateway", - "connection": { - "gateway_url": "https://openclaw.example.com", - "gateway_token_env": "OPENCLAW_GATEWAY_TOKEN", - "agent_id": "default", - }, - } - ) - - fabric = Fabric() - async with await fabric.attach_service(config, reference) as service: - async with await fabric.start_runtime(config, service=service) as runtime: - return await runtime.invoke(input="Review the workspace changes.") -``` - -The service handle contains sanitized identity and connection information and -is valid only in the NeMo Fabric process that created it. Releasing a prepared -service stops its Gateway. Releasing an attached service closes NeMo -Fabric-owned clients and private connection material without stopping the -caller-owned Gateway. Attached Gateways must use HTTPS unless the URL contains -a literal loopback IP address. For an attached service, omit deployment-owned -model endpoints, API-key references, tools, MCP servers, skills, channel -configuration, and startup settings from `config` because NeMo Fabric cannot -apply them to an existing Gateway. - -## Execution and Isolation - -Before starting a managed runtime or prepared service, the adapter writes a -complete temporary `openclaw.json` and sets OpenClaw environment variables. It -does not use the OpenClaw configuration RPC. The generated configuration: - -- binds the Gateway to loopback; -- enables the OpenAI-compatible Chat Completions endpoint; -- uses a cryptographically generated one-time Gateway token; -- applies the normalized workspace, model, skills, and MCP servers; -- disables OpenClaw anonymous telemetry; and -- uses a unique temporary state directory. - -Each invocation sends a terminal request to `/v1/chat/completions` with the -NeMo Fabric runtime ID as the stable OpenClaw session key. A managed runtime -stops its Gateway during runtime shutdown. A prepared service keeps its Gateway -running until the service is released, so multiple runtimes can connect to it. - -The adapter isolates the Gateway in its own process group, continuously checks -its startup endpoint, and forwards `SIGINT` and `SIGTERM` on POSIX systems. -On Linux, the adapter uses `setpriv --pdeathsig SIGTERM` when `setpriv` is -available and can run, so that the kernel signals the Gateway after abrupt -adapter termination. A sandbox that forbids applying capabilities, such as an -OpenShell sandbox, makes `setpriv` fail; the adapter then starts the Gateway -without it. Windows uses a kill-on-close Job Object for the Gateway process -tree. Without `setpriv`, Linux has the same catchable-signal protection as -macOS but cannot handle `SIGKILL`. - -Relay telemetry, native OpenTelemetry, adapter-native response streaming, -cancellation, and live updates are not supported. diff --git a/docs/integrations/harness/openclaw/openclaw-api.mdx b/docs/integrations/harness/openclaw/openclaw-api.mdx new file mode 100644 index 000000000..3e186883a --- /dev/null +++ b/docs/integrations/harness/openclaw/openclaw-api.mdx @@ -0,0 +1,24 @@ +--- +title: "OpenClaw HTTP API" +description: "Send native HTTP requests to the managed OpenClaw Gateway." +--- +{/* SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. +SPDX-License-Identifier: Apache-2.0 */} + +Start with the [OpenClaw overview](./openclaw.mdx) for installation and configuration ownership. + +## API Ownership + +The managed Gateway already serves `/v1/chat/completions` for SDK invocation. Native HTTP clients can call that same endpoint; there is no separate API server or `interfaces.api` setting. + +Enable a dashboard or terminal interface to publish native connection discovery and credentials. Terminal-only is the headless option and does not require browser assets. Read `http_url`, `agent_id`, and `token_file` from the private `interfaces/gateway.json`; read the referenced token file and send the token as `Authorization: Bearer `. The HTTP client sends this header on each request. + +## Requests and Conversations + +Set `model` to `openclaw/` and supply a stable, distinct `user` for each HTTP conversation. Reusing the SDK runtime's selector can share its native session. Omission does not establish conversation isolation. + +The selected managed agent uses the shared model, endpoint, credentials, supported generation parameters, instructions, workspace, tools, MCP, and skills. The HTTP caller does not need to copy system instructions into the request. Responses and any native streaming remain OpenClaw's HTTP behavior rather than Fabric `RunResult` or Relay streams. + +## Testing and Boundaries + +Follow the [HTTP manual test](../../../../examples/interfaces/README-openclaw.md#2-http-api). Direct requests do not increment SDK invocation accounting. There is no ATIF/ATOF export in this iteration. Fabric runtime shutdown revokes discovery and stops the owned Gateway; a client cannot retain the runtime merely by staying connected. diff --git a/docs/integrations/harness/openclaw/openclaw-dashboard.mdx b/docs/integrations/harness/openclaw/openclaw-dashboard.mdx new file mode 100644 index 000000000..22fb94e89 --- /dev/null +++ b/docs/integrations/harness/openclaw/openclaw-dashboard.mdx @@ -0,0 +1,63 @@ +--- +title: "OpenClaw Dashboard" +description: "Use the native browser Control UI on the owned Gateway." +--- +{/* SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. +SPDX-License-Identifier: Apache-2.0 */} + +Start with the [OpenClaw overview](./openclaw.mdx) for installation and shared configuration. + +## Additional Setup + +Install the pinned npm package with its packaged Control UI assets before runtime startup. Startup does not build browser assets or install dependencies. No second backend is needed when terminal or SDK access is also enabled. + +## Serve the Control UI + +OpenClaw's Control UI is its browser dashboard and chat. A managed runtime +serves it when `harness.settings.interfaces.dashboard` is present: + +```python +from nemo_fabric import HarnessConfig + +harness = HarnessConfig( + adapter_id="nvidia.fabric.openclaw", + settings={"interfaces": {"dashboard": {"port": 18789}}}, +) +``` + +- The Gateway listens on `127.0.0.1` at the dashboard `port`, which serves the + Control UI. `start` fails with `openclaw_interface_port_unavailable` if + `port` or `port + 2` is in use. OpenClaw also uses `port + 10` for its + browser relay and allocates browser CDP ports from `port + 11` through + `port + 110`, so reserve the whole range from `port` through `port + 110`. + `port` can't be combined with `port_range`; set `enabled` to `false` to keep + a configured dashboard off. +- After the Gateway starts, the adapter writes the sign-in token, generated at + each start, to + `/.fabric/openclaw/runtimes//interfaces/dashboard.token` + with mode `0600` on POSIX hosts; on Windows, the file inherits the artifact + root's permissions. `stop` removes it; if the adapter host is killed, the file + can remain. +- Open `http://127.0.0.1:/#token=` through a forward to that + port to sign in. The Control UI removes the token from the address bar. + OpenClaw 2026.9.34 accepts any loopback origin, such as a forward to a + different local port; the token is still required. +- Processes that run as the runtime's user, including the agent's own tools, + can read the token and reach the port. +- The adapter regenerates OpenClaw's configuration at each start and marks it + read-only, so changes made through the Control UI don't survive a restart. +- Prepared and attached services reject `interfaces` with + `openclaw_interfaces_require_managed_runtime`. + + +## Origins and Conversations + +`interfaces.dashboard.public_origins` adds explicit HTTP(S) origins to the native allowlist. Supply origins without paths, credentials, queries, or fragments. OpenClaw's loopback-origin exception still applies; the list does not restrict loopback access to only the configured ports. Authentication remains required. This setting does not change the loopback bind; remote access still needs forwarding or a proxy and native pairing where required. + +Select the configured agent and create or select a distinct chat for browser work. Browser tabs can select the same native session; opening another tab does not guarantee a fresh conversation. SDK and HTTP examples use their own stable selectors. + +## Health and Testing + +Native `/healthz`, `/startupz`, `/v1/models`, and `/readyz` observations feed Fabric's normalized checks. With browser or terminal access enabled, runtime activity remains `unknown` because SDK invocation state does not account for native work. Checks do not submit a model turn. + +Follow the [browser manual test](../../../../examples/interfaces/README-openclaw.md#3-browser-dashboard). NeMo Relay export is not supported. diff --git a/docs/integrations/harness/openclaw/openclaw-sdk.mdx b/docs/integrations/harness/openclaw/openclaw-sdk.mdx new file mode 100644 index 000000000..e090eddcb --- /dev/null +++ b/docs/integrations/harness/openclaw/openclaw-sdk.mdx @@ -0,0 +1,100 @@ +--- +title: "OpenClaw SDK" +description: "Invoke and manage OpenClaw through the NeMo Fabric SDK." +--- +{/* SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. +SPDX-License-Identifier: Apache-2.0 */} + +Start with the [OpenClaw overview](./openclaw.mdx) for installation, shared configuration, and the four invocation paths. + +## SDK Execution + +Use the [Code Review Example](../../../../examples/code_review_agent/README.md) with `--variant openclaw`. The adapter sends requests to its managed Gateway's Chat Completions endpoint, preserving the runtime ID as the SDK conversation selector and returning a normalized `RunResult`. + +SDK-only configurations retain existing behavior. When native interfaces are enabled, the same Gateway applies the configured system prompt through the shared plugin. Model, workspace, tools, MCP, and skills are generated once for that Gateway. SDK requests retain their configured generation parameters. Native turns do not create SDK invocation records. + +## Use a Shared Service + +Call `prepare_service()` to map the normalized `FabricConfig` to +`openclaw.json` and start a NeMo Fabric-owned Gateway. Pass the returned service +to `start_runtime()` to give each runtime an independent OpenClaw session: + +```python +from nemo_fabric import Fabric + + +async def invoke_with_prepared_service(config): + fabric = Fabric() + async with await fabric.prepare_service(config) as service: + async with await fabric.start_runtime(config, service=service) as runtime: + return await runtime.invoke(input="Review the workspace changes.") +``` + +Call `attach_service()` when another system owns the Gateway lifecycle. The +reference contains the endpoint and the name of an environment variable that +holds the Gateway token, never the token value: + +```python +from nemo_fabric import Fabric +from nemo_fabric import ServiceReference + + +async def invoke_with_attached_service(config): + reference = ServiceReference.from_mapping( + { + "adapter_id": "nvidia.fabric.openclaw", + "service_type": "openclaw_gateway", + "connection": { + "gateway_url": "https://openclaw.example.com", + "gateway_token_env": "OPENCLAW_GATEWAY_TOKEN", + "agent_id": "default", + }, + } + ) + + fabric = Fabric() + async with await fabric.attach_service(config, reference) as service: + async with await fabric.start_runtime(config, service=service) as runtime: + return await runtime.invoke(input="Review the workspace changes.") +``` + +The service handle contains sanitized identity and connection information and +is valid only in the NeMo Fabric process that created it. Releasing a prepared +service stops its Gateway. Releasing an attached service closes NeMo +Fabric-owned clients and private connection material without stopping the +caller-owned Gateway. Attached Gateways must use HTTPS unless the URL contains +a literal loopback IP address. For an attached service, omit deployment-owned +model endpoints, API-key references, tools, MCP servers, skills, channel +configuration, and startup settings from `config` because NeMo Fabric cannot +apply them to an existing Gateway. + +## Execution and Isolation + +Before starting a managed runtime or prepared service, the adapter writes a +complete temporary `openclaw.json` and sets OpenClaw environment variables. It +does not use the OpenClaw configuration RPC. The generated configuration: + +- binds the Gateway to loopback; +- enables the OpenAI-compatible Chat Completions endpoint; +- uses a cryptographically generated one-time Gateway token; +- applies the normalized workspace, model, skills, and MCP servers; +- disables OpenClaw anonymous telemetry; and +- uses a unique temporary state directory. + +Each invocation sends a terminal request to `/v1/chat/completions` with the +NeMo Fabric runtime ID as the stable OpenClaw session key. A managed runtime +stops its Gateway during runtime shutdown. A prepared service keeps its Gateway +running until the service is released, so multiple runtimes can connect to it. + +The adapter isolates the Gateway in its own process group, continuously checks +its startup endpoint, and forwards `SIGINT` and `SIGTERM` on POSIX systems. +On Linux, the adapter uses `setpriv --pdeathsig SIGTERM` when `setpriv` is +available and can run, so that the kernel signals the Gateway after abrupt +adapter termination. A sandbox that forbids applying capabilities, such as an +OpenShell sandbox, makes `setpriv` fail; the adapter then starts the Gateway +without it. Windows uses a kill-on-close Job Object for the Gateway process +tree. Without `setpriv`, Linux has the same catchable-signal protection as +macOS but cannot handle `SIGKILL`. + +Relay telemetry, native OpenTelemetry, adapter-native response streaming, +cancellation, and live updates are not supported. diff --git a/docs/integrations/harness/openclaw/openclaw-tui.mdx b/docs/integrations/harness/openclaw/openclaw-tui.mdx new file mode 100644 index 000000000..d841c2ceb --- /dev/null +++ b/docs/integrations/harness/openclaw/openclaw-tui.mdx @@ -0,0 +1,26 @@ +--- +title: "OpenClaw Terminal TUI" +description: "Attach the native terminal renderer to the managed Gateway." +--- +{/* SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. +SPDX-License-Identifier: Apache-2.0 */} + +Start with the [OpenClaw overview](./openclaw.mdx) for shared installation, configuration, and ownership. + +## Additional Setup + +Terminal attachment requires POSIX and the pinned OpenClaw executable with a supported Node runtime. The npm package provides the terminal renderer; no Fabric-specific frontend build is required. Browser assets are unnecessary when dashboard is disabled. + +Enable `harness.settings.interfaces.terminal: {}`. There is no terminal port setting. The adapter starts one Gateway and publishes an owner-executable `interfaces/terminal` launcher after readiness. Run that launcher from a real terminal or use `openshell sandbox exec -n SANDBOX --tty -- ` when the runtime is inside an OpenShell sandbox. Local terminal attachment is qualified separately from the OpenShell transport. + +## Attachment and Conversations + +The launcher reads owner-only discovery, marker, and credential files and checks the authenticated endpoint. It starts native `openclaw tui` using a private remote-client configuration and an environment SecretRef. No token is placed in command-line arguments, and ambient OpenClaw target settings are removed. Attachment does not start another Gateway, use native local embedded mode, or install dependencies. + +Each attachment selects the configured agent and creates a new session by default. Pass `--session NAME` to intentionally reuse a native session on that agent. This is a session name, not an agent override or a connection to a previous Fabric runtime. Browser and terminal can select the same conversation explicitly; they are not isolated users. + +## Detach, Health, and Testing + +Use `/quit` to leave a completed conversation. The managed Gateway and other clients remain available. The pinned native TUI sometimes invokes its own shutdown fallback and exits with code 130; the adapter preserves that native exit status. Runtime stop removes `terminal.running` before the remaining connection files and stops the Gateway. Health checks use native endpoint evidence and report activity as unknown while interactive access is enabled. + +Follow the [terminal manual test](../../../../examples/interfaces/README-openclaw.md#4-terminal-tui). Active-turn detach, approval interaction, remote attachment, and native activity aggregation remain unqualified. NeMo Relay integration is deferred. diff --git a/docs/integrations/harness/openclaw/openclaw.mdx b/docs/integrations/harness/openclaw/openclaw.mdx new file mode 100644 index 000000000..815874525 --- /dev/null +++ b/docs/integrations/harness/openclaw/openclaw.mdx @@ -0,0 +1,148 @@ +--- +title: "Use the OpenClaw Adapter" +description: "Four client paths through one managed OpenClaw Gateway." +--- +{/* SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. +SPDX-License-Identifier: Apache-2.0 */} + +You can use OpenClaw through the NVIDIA NeMo Fabric adapter in four ways: + +- **[SDK](./openclaw-sdk.mdx):** invoke through the NeMo Fabric SDK and receive a normalized `RunResult`. +- **[HTTP API](./openclaw-api.mdx):** call the owned Gateway directly and receive its native HTTP response. +- **[Browser dashboard](./openclaw-dashboard.mdx):** use OpenClaw's native Control UI for chat and session management. +- **[Terminal TUI](./openclaw-tui.mdx):** attach OpenClaw's native terminal client to the running Gateway. + +![OpenClaw invocation paths](../../../../assets/openclaw-invocation-paths.png) + +## Shared Configuration + +All four paths execute through one OpenClaw Gateway and its native agent runtime. NeMo Fabric translates `FabricConfig` into one private `openclaw.json`, with a fresh state directory, configured model/endpoint/credential references, generation parameters, workspace, tool policy, MCP servers, and skill paths. + +When a native interface is enabled, a small adapter-owned plugin applies replacement system instructions at OpenClaw's public `before_prompt_build` hook for the selected agent. SDK requests then omit their separate instruction injection, so all clients receive the configured prompt once. Pinned OpenClaw appends its native model-identity sentence after that prompt. Without native interfaces, existing SDK instruction handling is preserved. Omitted instructions preserve the native prompt; `append` remains unsupported. + +The generated configuration is read-only. Native clients share the configured backend but keep separate conversations when they select different native sessions. Filesystem access and Gateway credentials are shared within the runtime; this is not a user-isolation boundary. Native session/model overrides are not qualified; shared defaults do not enforce immutable policy. Native reconfiguration controls do not provide a supported way to change the Fabric-owned configuration. + +## Ownership and Normalization + +The adapter host starts, checks, and stops one Gateway. The SDK remains available when browser or terminal clients are enabled; no separate embedded SDK agent or additional API/TUI server is created. Attaching or detaching a client does not start or stop the Gateway. + +| Surface | Behavior | +| --- | --- | +| Configuration | Shared Fabric translation for the selected managed agent across all four paths. | +| Lifecycle | Fabric owns the managed Gateway; clients attach independently. | +| Responses | SDK returns a normalized `RunResult`; HTTP, browser, and terminal responses remain native. | +| Activity | With native interfaces enabled, activity is `unknown`; healthy native endpoints can still pass normalized health checks. | +| Relay artifacts | NeMo Relay integration and ATIF/ATOF export are deferred. | + +Native interfaces are opt-in and supported only on managed runtimes. Prepared and attached services retain their existing SDK lifecycle and reject `interfaces`; refer to the [SDK guide](./openclaw-sdk.mdx#use-a-shared-service). Cold resume and prior-runtime conversation restoration are outside this feature. + +## Install OpenClaw and the Adapter + +Refer to the official OpenClaw [installation documentation](https://docs.openclaw.ai/install) for detailed installation and usage instructions. + +To install OpenClaw from an npm package, then install the NeMo Fabric runtime and adapter run the following commands. + +```bash +# Requires Node.js >=24.22.1 <25 or >=26.12.1, and npm 11.16+ +npm install --global openclaw@2026.9.34 --allow-scripts=openclaw +pip install "nemo-fabric[openclaw]" +``` + +To install the adapter without the NeMo Fabric runtime, use +`nemo-fabric-adapters-openclaw`. The adapter package does not install OpenClaw. + +### Upgrade a Gateway With Retained State + +When upgrading a caller-owned Gateway from OpenClaw 2026.9.4, stop the Gateway and run `openclaw backup create --verify` with the Gateway's existing `OPENCLAW_STATE_DIR` and `OPENCLAW_CONFIG_PATH` before upgrading. The backup must include the active config, its include files, and all configured agent directories, including paths outside the state directory. Protect the archive because it can contain credentials. + +Before upgrading, check the backup result and manifest for the active config, its include files, and every configured agent directory. For paths marked `covered`, confirm that the archive contains the data under a parent directory. Fix missing required paths and rerun the backup. Continue with the upgrade after confirming that all required data is backed up. + +Before migration, copy every legacy session directory while the Gateway is stopped. Include `sessions.json`, `.jsonl` transcripts, and session directories outside `OPENCLAW_STATE_DIR`. The backup command excludes legacy `.jsonl` transcripts. Protect these copies and keep them with the verified archive for rollback. + +Run `openclaw doctor --fix` with the 2026.9.34 executable and the same path settings. The command imports legacy `sessions.json` files and JSONL session data into each agent's SQLite database. Restart the Gateway after the command succeeds. Keep the verified backup for rollback. + +Managed runtimes and NeMo Fabric-owned services use temporary state directories, so each new Gateway starts with fresh state. + +## Configure the Adapter + +Select the adapter and, when necessary, specify the OpenClaw executable: + +```python +from nemo_fabric import HarnessConfig + +harness = HarnessConfig( + adapter_id="nvidia.fabric.openclaw", + settings={ + "openclaw_command": "/opt/openclaw/bin/openclaw", + "startup_timeout_seconds": 60, + }, +) +``` + +Omit `openclaw_command` to resolve `openclaw` from `PATH`. A relative path that +contains a directory is resolved from the NeMo Fabric base directory. The adapter +uses the resolved executable for its version check, configuration validation, +and Gateway startup. + +`startup_timeout_seconds` sets one deadline for all of start, from checking the +`openclaw` command to the Gateway becoming ready. It defaults to 60 seconds and +can be at most 75 seconds, which keeps start within NeMo Fabric's 90-second +start limit. + +The adapter supports only OpenClaw's default `openclaw` agent runtime. + +The adapter accepts normalized model provider, model, base URL, temperature, +`top_p`, `max_tokens`, replacement system instruction, workspace, skills, and +MCP configuration. Normalized MCP authentication is not supported. For a +custom OpenAI-compatible endpoint, set the model's `base_url` and, when needed, +`api_key_env`. + +For an endpoint that supports `stream_options.include_usage`, set +`models..settings.supports_usage_in_streaming` to `true`. This maps to +OpenClaw's native `compat.supportsUsageInStreaming` and requires `base_url`. +Use `false` for an endpoint that rejects streaming usage, or omit the setting +to retain OpenClaw's endpoint capability detection. Attached services own +their model configuration and do not accept this setting. + +OpenClaw 2026.9.4's Gateway does not distinguish aggregate usage from its +last-call fallback, and converts missing usage to zero counters. NeMo Fabric +leaves standard complete counters unknown and preserves the Gateway's counts +in `usage.extensions["nvidia.fabric.openclaw.usage_evidence.v1"].observed`. +The evidence includes `scope_unverified` in `gaps`, plus `missing_usage` or +`zero_unverified` when applicable. Reported counts do not establish complete +coverage of retries, compaction, child agents, or background work. + +For a NeMo Fabric-owned service, `harness.settings.channel_config` accepts +OpenClaw-native `channels` and `bindings`. This supports multiple accounts for +Telegram and other OpenClaw channels without a NeMo Fabric-specific channel schema. +Every binding must target the configured `agent_id`; OpenClaw validates the +nested channel settings. Chat-channel traffic goes directly between the +channel and OpenClaw rather than through a NeMo Fabric runtime. + +By default, the adapter chooses an available local port range. Set `port_range` +to an inclusive consumer-allocated range with `start` and `end` fields. The +range must span at least 111 ports. OpenClaw's [derived-port mapping](https://docs.openclaw.ai/gateway/multiple-gateways#port-mapping-derived) uses `base_port + 2` for browser control and allocates browser CDP ports from `base_port + 11` through `base_port + 110`. The adapter verifies only that `base_port` and `base_port + 2` are available before startup. OpenClaw allocates the CDP ports on demand instead of reserving the complete range, so the adapter cannot guarantee that those ports will still be available when OpenClaw needs them. Keep the configured range reserved for the lifetime of the runtime or service when using OpenClaw browser features. + + +## Select Native Interfaces + +An absent interface is off. A present interface is enabled unless `enabled` is `false`: + +```python +settings = { + "interfaces": { + "dashboard": {"port": 18789, "public_origins": []}, + "terminal": {}, + } +} +``` + +The dashboard selects the existing Gateway's base port. Terminal has no port; it discovers that same Gateway, or uses the existing allocator when dashboard is absent. The dashboard port conflicts with `port_range`. Both clients can attach in parallel with SDK and native HTTP clients; use distinct sessions to keep conversations separate. + +After readiness, the adapter publishes private connection material under `/.fabric/openclaw/runtimes//interfaces/`. `gateway.json` contains endpoints, selected agent, executable, workspace, and a credential-file reference. The token is in `dashboard.token` when the dashboard is enabled, otherwise `gateway.token`. Terminal adds an executable `terminal` and `terminal.running` marker. Stop removes the marker first and revokes discovery and credentials before stopping the Gateway. An abrupt host kill can leave files; attachment also checks authenticated Gateway availability. + +## Testing and Limitations + +Follow the [four-path OpenClaw examples](../../../../examples/interfaces/README-openclaw.md) for repeatable manual tests. The opt-in native qualification uses a recording model endpoint, a rendered browser, and a PTY to verify actual configuration and tool execution. + +Terminal attachment currently requires POSIX. On Windows, dashboard tokens inherit directory ACLs; mode bits do not enforce owner-only ACLs. Interactive approvals, detach during active work, remote terminal attachment, and full native activity/inventory are not qualified. The pinned TUI can use an exit-code-130 fallback during `/quit`; this does not stop the managed Gateway. NeMo Relay integration and trajectory export remain separate work. diff --git a/docs/integrations/harness/overview.mdx b/docs/integrations/harness/overview.mdx index 7b53b29d4..4a2c517c1 100644 --- a/docs/integrations/harness/overview.mdx +++ b/docs/integrations/harness/overview.mdx @@ -25,7 +25,7 @@ NeMo Fabric includes the following harness integrations: | Kiro | [Use the Kiro adapter](./kiro.mdx) | | AWS Strands | [Use the Strands adapter](./strands.mdx) | | mini-SWE-agent | [Use the mini-SWE-agent adapter](./mini-swe-agent.mdx) | -| OpenClaw | [Use the OpenClaw adapter](./openclaw.mdx) | +| OpenClaw | [Use the OpenClaw adapter](./openclaw/openclaw.mdx) | | OpenHands | [Use the OpenHands adapter](./openhands.mdx) | | OpenCode | [Use the OpenCode adapter](./opencode.mdx) | | Pi | [Use the Pi adapter](./pi.mdx) | diff --git a/docs/sdk/health-checks.mdx b/docs/sdk/health-checks.mdx index 522ac2fc9..6372d63d8 100644 --- a/docs/sdk/health-checks.mdx +++ b/docs/sdk/health-checks.mdx @@ -58,8 +58,8 @@ The table covers all runtime adapters and the OpenClaw Gateway service. Each row | Adapter | `live` Evidence | `active` Evidence | `ready` Evidence | Qualification Tests / Capability Evidence | | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | [Pi](../integrations/harness/pi.mdx) | Completed initialization, unchanged native session identity, and a fresh `extensionRunner.createContext().isIdle()` response; idle and busy both pass. | Completed extension binding and an available native request interface after liveness passes. | The selected model remains configured, required tools remain available, and required MCP transports have no observed error or closure. | [Tests](https://github.com/NVIDIA/NeMo-Fabric/blob/66341998b2e954a008cc7f726be64020adc3d1f4/tests/e2e/test_checks.py) | -| [OpenClaw Runtime](../integrations/harness/openclaw.mdx) | Valid `GET /healthz` response; an owned Gateway process must also remain running. | `GET /startupz` confirms startup, authenticated `GET /v1/models` includes the selected agent, and `GET /v1/chat/completions` returns the expected `405` with `Allow: POST`. | `GET /readyz` reports `ready: true`, including configured channel health. | [Tests](https://github.com/NVIDIA/NeMo-Fabric/blob/66341998b2e954a008cc7f726be64020adc3d1f4/tests/e2e/test_openclaw_checks.py) | -| [OpenClaw Gateway Service](../integrations/harness/openclaw.mdx) | Valid `GET /healthz` response. | Authenticated `GET /v1/models` returns a valid inventory. | `GET /readyz` reports native Gateway readiness, including configured channel health. | [Tests](https://github.com/NVIDIA/NeMo-Fabric/blob/66341998b2e954a008cc7f726be64020adc3d1f4/tests/e2e/test_openclaw_checks.py) | +| [OpenClaw Runtime](../integrations/harness/openclaw/openclaw.mdx) | Valid `GET /healthz` response; an owned Gateway process must also remain running. | `GET /startupz` confirms startup, authenticated `GET /v1/models` includes the selected agent, and `GET /v1/chat/completions` returns the expected `405` with `Allow: POST`. | `GET /readyz` reports `ready: true`, including configured channel health. | [Tests](https://github.com/NVIDIA/NeMo-Fabric/blob/66341998b2e954a008cc7f726be64020adc3d1f4/tests/e2e/test_openclaw_checks.py) | +| [OpenClaw Gateway Service](../integrations/harness/openclaw/openclaw.mdx) | Valid `GET /healthz` response. | Authenticated `GET /v1/models` returns a valid inventory. | `GET /readyz` reports native Gateway readiness, including configured channel health. | [Tests](https://github.com/NVIDIA/NeMo-Fabric/blob/66341998b2e954a008cc7f726be64020adc3d1f4/tests/e2e/test_openclaw_checks.py) | | [Codex](../integrations/harness/codex.mdx) | The owned app-server process has not exited. | A fresh native thread read confirms that the selected thread is loaded. | The fresh thread response reports `idle` or `active`; `systemError` fails readiness. | [Tests](https://github.com/NVIDIA/NeMo-Fabric/blob/86c52264d6e2ecfe7f72f1eb0161f1d1e425ddbb/tests/e2e/test_codex_checks.py) | | [Claude Code](../integrations/harness/claude.mdx) | The owned Claude CLI process has not exited. | A fresh, valid native `get_mcp_status()` response. | The same native status operation establishes initialized CLI responsiveness. Reported MCP connection failures do not themselves fail readiness. | [Tests](https://github.com/NVIDIA/NeMo-Fabric/blob/563ca53755f1a2f57329a79985095acfcfcd5cde/tests/e2e/test_claude_checks.py) | | [LangChain Deep Agents](../integrations/harness/deepagents.mdx) | A fresh read from the owned checkpoint connection with `SELECT 1`. | The compiled graph exposes its message input schema and invocation interface. | Native `aget_state()` returns valid state for the exact owned LangGraph thread. | [Tests](https://github.com/NVIDIA/NeMo-Fabric/blob/5c065c1a7775e4490269f57b406635d30e8a0fd8/tests/e2e/test_deepagents_checks.py) | diff --git a/examples/interfaces/README-openclaw.md b/examples/interfaces/README-openclaw.md new file mode 100644 index 000000000..9e10f9a85 --- /dev/null +++ b/examples/interfaces/README-openclaw.md @@ -0,0 +1,102 @@ + + +# NVIDIA NeMo Fabric OpenClaw Interface Examples + +Start with the [OpenClaw architecture guide](../../docs/integrations/harness/openclaw/openclaw.mdx). These four paths share one managed Gateway, its selected agent, and translated Fabric configuration. SDK responses are normalized; other responses remain native. NeMo Relay integration and trajectory export are deferred. + +| Path | Example | Architecture | +| --- | --- | --- | +| SDK | [Code Review Example](../code_review_agent/README.md) with `--variant openclaw` | [SDK](../../docs/integrations/harness/openclaw/openclaw-sdk.mdx) | +| HTTP | `openclaw.py --http-input ... --once` | [HTTP API](../../docs/integrations/harness/openclaw/openclaw-api.mdx) | +| Browser | `openclaw.py --interface dashboard`, then native chat | [Dashboard](../../docs/integrations/harness/openclaw/openclaw-dashboard.mdx) | +| Terminal | `openclaw.py --interface terminal`, then generated launcher | [Terminal TUI](../../docs/integrations/harness/openclaw/openclaw-tui.mdx) | + +## Shared Setup + +Run all commands from the repository root. Install pinned OpenClaw `2026.9.34` with Node `>=24.22.1 <25` or `>=26.12.1` and npm `11.16+`: + +```bash +npm install --global openclaw@2026.9.34 --allow-scripts=openclaw +openclaw --version +uv sync --frozen --no-default-groups --group adapters --group adapter-tests --group test +export ADAPTER_PYTHON="${ADAPTER_PYTHON:-$PWD/.venv/bin/python}" +export MODEL_BASE_URL="https://MODEL_HOST/v1" +export MODEL_NAME="YOUR_SERVED_MODEL_NAME" +export MODEL_API_KEY="YOUR_MODEL_API_KEY" +``` + +The npm package provides browser and terminal assets; these tests do not build frontends. The model endpoint must be reachable from the adapter and support OpenAI-compatible Chat Completions with file-tool calls. Use a nonempty placeholder only if the endpoint does not require authentication. A separately selected adapter interpreter must contain this checkout's adapter and dependencies. + +Use a new output directory for each run; the example refuses to overwrite one. `--openclaw-command /path/to/openclaw` selects a separately prepared pinned executable. Use `--api-key-env NAME` when your credential uses another environment variable. No command prints the Gateway token. + +## 1. SDK + +Follow the [Code Review Example](../code_review_agent/README.md) with `--variant openclaw`. To compare an SDK turn with the native clients in this example, add `--sdk-input 'Read notes.txt and write sdk-result.md with a short checklist.'` to an owner command below. The result is saved as `sdk-result.json`. + +## 2. HTTP API + +Run a real file task, then stop the owner automatically: + +```bash +export RUN_DIR="$PWD/outputs/interfaces/openclaw-http-$(date +%Y%m%d-%H%M%S)" +.venv/bin/python examples/interfaces/openclaw.py \ + --base-url "$MODEL_BASE_URL" --model "$MODEL_NAME" \ + --interface terminal --output-dir "$RUN_DIR" \ + --http-input 'Read notes.txt and write api-result.md with a short checklist.' --once +cat "$RUN_DIR/workspace/api-result.md" +cat "$RUN_DIR/http-result.json" +cat "$RUN_DIR/cleanup.json" +``` + +Terminal selection publishes private Gateway connection material without enabling the browser. This command does not launch the terminal client. The HTTP request uses that Gateway, an independent stable `user`, and the configured agent. Inspect a native HTTP response and confirm all cleanup fields are true. There is no additional API server or API port setting. + +## 3. Browser Dashboard + +In the owner terminal, choose an available Gateway base port and keep the owner running: + +```bash +export RUN_DIR="$PWD/outputs/interfaces/openclaw-browser-$(date +%Y%m%d-%H%M%S)" +.venv/bin/python examples/interfaces/openclaw.py \ + --base-url "$MODEL_BASE_URL" --model "$MODEL_NAME" \ + --interface dashboard --port 18789 --output-dir "$RUN_DIR" +``` + +Open the printed `http_url` in a browser. Read the printed token-file path privately and enter its value in the native Control UI sign-in field, or use OpenClaw's native token-fragment sign-in flow. The token authenticates to this Gateway; it is not the model API key. Select agent `reviewer` and create a distinct chat. + +Send `Read notes.txt and write browser-result.md with a short checklist.` After completion, send `Read browser-result.md and add one verification step.` Inspect `$RUN_DIR/workspace/browser-result.md` in another terminal. + +Press Enter in the owner terminal to stop. Check `cleanup.json` and confirm the browser can no longer submit work. Browser tabs share a native session when they select the same chat; another tab does not guarantee isolation. + +## 4. Terminal TUI + +In the owner terminal: + +```bash +export RUN_DIR="$PWD/outputs/interfaces/openclaw-terminal-$(date +%Y%m%d-%H%M%S)" +.venv/bin/python examples/interfaces/openclaw.py \ + --base-url "$MODEL_BASE_URL" --model "$MODEL_NAME" \ + --interface terminal --output-dir "$RUN_DIR" +``` + +In another terminal, run the exact `terminal_launcher` path printed by the owner. Terminal attachment requires POSIX and a real TTY. The launcher reads private credentials and attaches to the owned Gateway; it does not start another backend. It has no port argument. Add `--session manual-review` to the launcher to intentionally reuse that conversation on agent `reviewer`; omit it for a new session. + +Send `Read notes.txt and write terminal-result.md with a short checklist.` Follow with `Read terminal-result.md and add one verification step.` Inspect the output, then enter `/quit`. The owner should remain usable; press Enter there when finished. The pinned native client can exit with code 130 through its own disconnect fallback. Verify Gateway survival separately from that native exit status. + +Use `--interface both --port 18789` on the owner to attach browser and terminal concurrently to one Gateway. Select distinct chats unless you intend to share a live conversation. + +## Automated Native Qualification + +The ordinary OpenClaw tests use a deterministic mock executable. The opt-in native tests use the pinned Gateway, a recording model endpoint, actual file tools and MCP, a real browser, and a terminal PTY: + +```bash +uv pip install --python .venv/bin/python playwright pexpect +.venv/bin/python -m playwright install chromium +export FABRIC_OPENCLAW_TEST_COMMAND="$(command -v openclaw)" +mkdir -p outputs/interfaces +.venv/bin/python -m pytest tests/adapters/test_openclaw_native.py -q --basetemp outputs/interfaces/openclaw-native-tests +``` + +Use a fresh `--basetemp` directory: pytest removes an existing one. `FABRIC_TEST_CHROMIUM` can select an already installed browser executable. Retained evidence includes captured model requests, a browser screenshot, a terminal transcript, and native skill inventory. Credentials used by the recorder are test placeholders. These tests assert actual endpoint/model/parameter/prompt parity, workspace/tool policy, MCP execution, skills, conversation behavior, health, and cleanup; they do not assert Relay trajectories. diff --git a/examples/interfaces/README.md b/examples/interfaces/README.md index 31dea54b8..dfa1d3540 100644 --- a/examples/interfaces/README.md +++ b/examples/interfaces/README.md @@ -5,6 +5,11 @@ SPDX-License-Identifier: Apache-2.0 # NVIDIA NeMo Fabric Native Interface Examples +Choose the harness to test: + +- **Hermes:** the native-interface instructions below. +- **OpenClaw:** the [four-path OpenClaw examples](README-openclaw.md), sharing one native Gateway. + This example is a work in progress. Its structure and user experience will be reworked as part of OpenClaw TUI support. Use native harness interfaces alongside a NeMo Fabric-managed runtime. Each harness example uses the public Python SDK for configuration and lifecycle, then sends input through the harness's native interface. diff --git a/examples/interfaces/openclaw.py b/examples/interfaces/openclaw.py new file mode 100644 index 000000000..8376bc5a1 --- /dev/null +++ b/examples/interfaces/openclaw.py @@ -0,0 +1,186 @@ +# SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. +# SPDX-License-Identifier: Apache-2.0 + +"""Host one configured OpenClaw Gateway for SDK, HTTP, browser, and terminal clients.""" + +from __future__ import annotations + +import argparse +import asyncio +import json +import os +import sys +from pathlib import Path + +import httpx +from nemo_fabric import Fabric, FabricConfig + + +def build_config(args: argparse.Namespace, output: Path) -> FabricConfig: + """Prepare a shared file-task workspace and explicitly selected native clients.""" + workspace = output / "workspace" + workspace.mkdir(parents=True) + (workspace / "notes.txt").write_text( + "Release checklist: verify shared model configuration, file tools, and Gateway cleanup.\n" + ) + interfaces = {} + if args.interface in {"terminal", "both"}: + interfaces["terminal"] = {} + if args.interface in {"dashboard", "both"}: + interfaces["dashboard"] = { + "port": args.port, + "public_origins": args.public_origin, + } + settings = {"agent_id": "reviewer", "interfaces": interfaces} + if args.openclaw_command: + settings["openclaw_command"] = args.openclaw_command + return FabricConfig.from_mapping( + { + "metadata": {"name": "openclaw-interfaces-example"}, + "harness": {"adapter_id": "nvidia.fabric.openclaw", "settings": settings}, + "models": { + "default": { + "provider": "fabric-model", + "model": args.model, + "base_url": args.base_url, + "api_key_env": args.api_key_env, + "temperature": 0.0, + "top_p": 0.9, + "max_tokens": 2048, + } + }, + "instructions": { + "system": { + "mode": "replace", + "content": "Complete workspace tasks using the read and write tools. Read source files before writing. " + "Use paths relative to the workspace. Do not use shell or web tools. Summarize actual results briefly.", + } + }, + "tools": {"enabled": ["read", "write"], "blocked": ["exec", "process"]}, + "environment": { + "provider": "local", + "workspace": str(workspace), + "artifacts": str(output / "artifacts"), + }, + } + ) + + +async def run(args: argparse.Namespace) -> None: + """Keep one Gateway alive for clients, or execute supplied SDK/HTTP tasks once.""" + output = args.output_dir.absolute() + output.mkdir(parents=True, exist_ok=False) + os.environ.setdefault("ADAPTER_PYTHON", sys.executable) + config = build_config(args, output) + fabric = Fabric() + async with await fabric.start_runtime(config, base_dir=Path.cwd()) as runtime: + directory = ( + output + / "artifacts/.fabric/openclaw/runtimes" + / runtime.runtime_id + / "interfaces" + ) + connection = json.loads((directory / "gateway.json").read_text()) + # These are paths and endpoints, never credential values. + info = { + "runtime_id": runtime.runtime_id, + "connection": str(directory / "gateway.json"), + "http_url": connection["http_url"], + "agent_id": connection["agent_id"], + "token_file": str(directory / connection["token_file"]), + "workspace": str(output / "workspace"), + } + if "terminal" in config.harness.settings["interfaces"]: + info["terminal_launcher"] = str(directory / "terminal") + (output / "connection.json").write_text(json.dumps(info, indent=2) + "\n") + print(json.dumps(info, indent=2), flush=True) + if args.sdk_input: + result = await runtime.invoke(input=args.sdk_input) + (output / "sdk-result.json").write_text( + json.dumps(result.to_mapping(), indent=2) + "\n" + ) + if result.status != "succeeded": + raise RuntimeError("SDK task failed; inspect sdk-result.json") + if args.http_input: + async with httpx.AsyncClient(trust_env=False, timeout=180) as client: + response = await client.post( + connection["http_url"] + "/v1/chat/completions", + headers={ + "Authorization": "Bearer " + + (directory / connection["token_file"]).read_text().strip() + }, + json={ + "model": f"openclaw/{connection['agent_id']}", + "user": "manual-http-client", + "messages": [{"role": "user", "content": args.http_input}], + }, + ) + response.raise_for_status() + (output / "http-result.json").write_text( + json.dumps(response.json(), indent=2) + "\n" + ) + if not args.once: + print( + "Gateway ready. Attach clients in other terminals; press Enter here to stop.", + flush=True, + ) + await asyncio.to_thread(input) + (output / "cleanup.json").write_text( + json.dumps( + { + "discovery_removed": not (directory / "gateway.json").exists(), + "token_removed": not (directory / connection["token_file"]).exists(), + "terminal_marker_removed": not ( + directory / "terminal.running" + ).exists(), + }, + indent=2, + ) + + "\n" + ) + + +def main() -> None: + """Run the repository example with prepared native dependencies.""" + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--base-url", required=True) + parser.add_argument("--model", required=True) + parser.add_argument("--api-key-env", default="MODEL_API_KEY") + parser.add_argument("--openclaw-command") + parser.add_argument( + "--interface", choices=("terminal", "dashboard", "both"), default="terminal" + ) + parser.add_argument( + "--port", + type=int, + default=18789, + help="Dashboard Gateway base port; terminal-only uses automatic allocation", + ) + parser.add_argument("--public-origin", action="append", default=[]) + parser.add_argument("--output-dir", type=Path, required=True) + parser.add_argument("--sdk-input") + parser.add_argument("--http-input") + parser.add_argument( + "--once", + action="store_true", + help="Stop after supplied tasks; otherwise wait for manual clients", + ) + args = parser.parse_args() + if not os.environ.get(args.api_key_env): + parser.error( + f"Set {args.api_key_env} to the credential required by the model endpoint" + ) + if args.once and not (args.sdk_input or args.http_input): + parser.error("--once requires --sdk-input or --http-input") + if args.interface == "terminal" and (args.public_origin or args.port != 18789): + parser.error( + "--port and --public-origin apply to the dashboard; terminal has no port setting" + ) + try: + asyncio.run(run(args)) + except KeyboardInterrupt: + pass + + +if __name__ == "__main__": + main() From 181e6c2411167b70f73ca6046a7c5e328aff65a7 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Mon, 9 Nov 2026 14:08:01 -0800 Subject: [PATCH 15/27] fix: accept healthy runtimes with unknown activity Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- crates/fabric-core/src/check.rs | 85 ++++++++++++++++++- docs/sdk/health-checks.mdx | 4 +- .../src/nemo_fabric/check.py | 2 +- tests/python/test_checks.py | 32 +++++++ 4 files changed, 119 insertions(+), 4 deletions(-) diff --git a/crates/fabric-core/src/check.rs b/crates/fabric-core/src/check.rs index 091f9e1a7..de4fb1ae0 100644 --- a/crates/fabric-core/src/check.rs +++ b/crates/fabric-core/src/check.rs @@ -616,7 +616,7 @@ fn valid_remote_report(report: &CheckReport, request: &CheckRequest) -> bool { runtime.state == CheckRuntimeState::Active && matches!( runtime.activity, - RuntimeActivity::Idle | RuntimeActivity::Busy + RuntimeActivity::Idle | RuntimeActivity::Busy | RuntimeActivity::Unknown ) })) { @@ -963,6 +963,9 @@ pub fn check_environment( (_, _, RuntimeActivity::Idle | RuntimeActivity::Busy) => { CheckRuntimeState::Active } + (CheckOutcome::Passed, _, RuntimeActivity::Unknown) => { + CheckRuntimeState::Active + } (_, _, RuntimeActivity::Stopped) => CheckRuntimeState::Stopped, _ => CheckRuntimeState::Unknown, }, @@ -1209,7 +1212,9 @@ fn probe_target( || scope != CheckScope::Service && !matches!( observation.activity, - RuntimeActivity::Idle | RuntimeActivity::Busy + RuntimeActivity::Idle + | RuntimeActivity::Busy + | RuntimeActivity::Unknown ))) || observation.observed_at.is_some() && !valid_time { @@ -1426,6 +1431,82 @@ mod tests { cleanup(&runtime); } + #[test] + fn healthy_runtime_can_have_unknown_activity() { + let runtime = runtime(); + register( + &runtime, + vec![CheckLevel::Live, CheckLevel::Active, CheckLevel::Ready], + ); + let peer = peer(&runtime, 3, |_, level| gateway_passed(level)); + let request = request(&runtime, CheckLevel::Ready, 3.0); + let mut report = check_environment(&runtime.environment, &request).unwrap(); + assert_eq!(report.outcome, CheckOutcome::Passed); + let observation = report.runtime.as_ref().unwrap(); + assert_eq!(observation.state, CheckRuntimeState::Active); + assert_eq!(observation.activity, RuntimeActivity::Unknown); + assert!(valid_remote_report(&report, &request)); + assert_eq!(peer.join().unwrap().len(), 3); + for activity in [RuntimeActivity::Stopping, RuntimeActivity::Stopped] { + report.runtime.as_mut().unwrap().activity = activity; + assert!(!valid_remote_report(&report, &request)); + } + cleanup(&runtime); + } + + #[test] + fn unknown_activity_does_not_upgrade_nonpassing_health() { + let runtime = runtime(); + register(&runtime, vec![CheckLevel::Live]); + let peer = peer(&runtime, 2, |index, level| { + let mut observation = gateway_passed(level); + observation["outcome"] = if index == 0 { "unknown" } else { "failed" }.into(); + observation["reason_code"] = if index == 0 { + "probe_error" + } else { + "agent_exited" + } + .into(); + observation + }); + for (outcome, state) in [ + (CheckOutcome::Unknown, CheckRuntimeState::Unknown), + (CheckOutcome::Failed, CheckRuntimeState::Failed), + ] { + let report = check_environment( + &runtime.environment, + &request(&runtime, CheckLevel::Live, 3.0), + ) + .unwrap(); + assert_eq!(report.outcome, outcome); + assert_eq!(report.runtime.unwrap().state, state); + } + assert_eq!(peer.join().unwrap().len(), 2); + cleanup(&runtime); + } + + #[test] + fn shutdown_activity_cannot_pass_runtime_health() { + let runtime = runtime(); + register(&runtime, vec![CheckLevel::Live]); + let peer = peer(&runtime, 2, |index, level| { + let mut observation = passed(level); + observation["activity"] = if index == 0 { "stopping" } else { "stopped" }.into(); + observation + }); + for _ in 0..2 { + let report = check_environment( + &runtime.environment, + &request(&runtime, CheckLevel::Live, 3.0), + ) + .unwrap(); + assert_eq!(report.outcome, CheckOutcome::Unknown); + assert_eq!(report.reason_code, Some(CheckReason::ProbeError)); + } + assert_eq!(peer.join().unwrap().len(), 2); + cleanup(&runtime); + } + #[test] fn gateway_service_checks_do_not_require_a_runtime_binding() { let runtime = runtime(); diff --git a/docs/sdk/health-checks.mdx b/docs/sdk/health-checks.mdx index d3339a0a8..0ddb76e04 100644 --- a/docs/sdk/health-checks.mdx +++ b/docs/sdk/health-checks.mdx @@ -49,7 +49,9 @@ The report uses one of these outcomes: | `unknown` | The check could not establish the result, for example because of a timeout, unavailable target, invalid native response, or ownership change. | | `unsupported` | The installed adapter or execution mode does not provide the requested check. | -Runtime `activity` is separate from health. A runtime can report `busy` and pass every supported level while an invocation waits for a model response. Activity describes NeMo Fabric invocations; activity does not establish that an agent will accept a second concurrent prompt. +Runtime `activity` is separate from health. A runtime can report `busy` and pass every supported level while an invocation waits for a model response. It can also pass with `activity: unknown` when the adapter has positive native health evidence but cannot observe whether work is in progress. A passing runtime check reports `state: active`; activity may be `idle`, `busy`, or `unknown`. An unknown activity value alone does not establish health, and `stopping` or `stopped` activity cannot pass. + +This rule applies to every adapter. It does not change which native evidence each adapter must collect, or turn an `outcome: unknown` into a pass. Consumers waiting for an idle runtime must require `activity: idle`; a passing health result with unknown activity does not establish that an agent will accept another prompt. ## Native Evidence by Adapter diff --git a/sdk/python/nemo-fabric-runtime/src/nemo_fabric/check.py b/sdk/python/nemo-fabric-runtime/src/nemo_fabric/check.py index 79becf714..3cb546d92 100644 --- a/sdk/python/nemo-fabric-runtime/src/nemo_fabric/check.py +++ b/sdk/python/nemo-fabric-runtime/src/nemo_fabric/check.py @@ -255,7 +255,7 @@ def _consistency(self) -> Self: and ( self.runtime is None or self.runtime.state != "active" - or self.runtime.activity in ("stopped", "stopping", "unknown") + or self.runtime.activity in ("stopped", "stopping") ) ): raise ValueError("incomplete passing evidence") diff --git a/tests/python/test_checks.py b/tests/python/test_checks.py index 187b081a8..ae9cee06c 100644 --- a/tests/python/test_checks.py +++ b/tests/python/test_checks.py @@ -100,6 +100,38 @@ def test_report_fields_cannot_be_reassigned_or_deleted(check_report): del report.outcome +@pytest.mark.parametrize("activity", ["idle", "busy", "unknown"]) +def test_passing_health_does_not_require_known_activity(check_report, activity): + check_report["runtime"]["activity"] = activity + report = CheckReport.from_mapping(check_report) + assert report.outcome == "passed" + assert report.runtime["activity"] == activity + + +@pytest.mark.parametrize( + "outcome, reason", [("unknown", "probe_error"), ("failed", "agent_exited")] +) +def test_unknown_activity_preserves_nonpassing_health(check_report, outcome, reason): + check_report["outcome"] = outcome + check_report["reason_code"] = reason + check_report["runtime"] = { + "state": "failed" if outcome == "failed" else "unknown", + "activity": "unknown", + } + check_report["checks"][0].update(outcome=outcome, reason_code=reason) + report = CheckReport.from_mapping(check_report) + assert report.outcome == outcome + assert report.reason_code == reason + assert report.runtime["activity"] == "unknown" + + +@pytest.mark.parametrize("activity", ["stopping", "stopped"]) +def test_passing_health_rejects_shutdown_activity(check_report, activity): + check_report["runtime"]["activity"] = activity + with pytest.raises(FabricConfigError, match="The check report is invalid"): + CheckReport.from_mapping(check_report) + + async def test_sdk_checks_use_one_client_timer( check_environment, check_report, monkeypatch ): From fd3ebe99667a5bdd3fa1b4274fb0ce53864be3db Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Mon, 9 Nov 2026 16:13:08 -0800 Subject: [PATCH 16/27] docs(openclaw): organize adapter configuration guidance Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- .../harness/openclaw/openclaw-sdk.mdx | 8 ++ .../harness/openclaw/openclaw.mdx | 86 +++++++++---------- 2 files changed, 51 insertions(+), 43 deletions(-) diff --git a/docs/integrations/harness/openclaw/openclaw-sdk.mdx b/docs/integrations/harness/openclaw/openclaw-sdk.mdx index e090eddcb..589da8097 100644 --- a/docs/integrations/harness/openclaw/openclaw-sdk.mdx +++ b/docs/integrations/harness/openclaw/openclaw-sdk.mdx @@ -13,6 +13,14 @@ Use the [Code Review Example](../../../../examples/code_review_agent/README.md) SDK-only configurations retain existing behavior. When native interfaces are enabled, the same Gateway applies the configured system prompt through the shared plugin. Model, workspace, tools, MCP, and skills are generated once for that Gateway. SDK requests retain their configured generation parameters. Native turns do not create SDK invocation records. +## Usage Accounting + +The adapter treats Gateway usage as observed evidence. Reported counts do not establish whether they cover aggregate usage or a last-call fallback, and zero counters do not prove that no usage occurred. + +NeMo Fabric leaves standard complete counters unknown and preserves reported counts in `usage.extensions["nvidia.fabric.openclaw.usage_evidence.v1"].observed`. The evidence includes `scope_unverified` in `gaps`, plus `missing_usage` or `zero_unverified` when applicable. + +These counts do not establish complete coverage of retries, compaction, child agents, or background work. For endpoint streaming-usage settings, see [Agent Configuration](./openclaw.mdx#agent-configuration). + ## Use a Shared Service Call `prepare_service()` to map the normalized `FabricConfig` to diff --git a/docs/integrations/harness/openclaw/openclaw.mdx b/docs/integrations/harness/openclaw/openclaw.mdx index 815874525..8d57625d3 100644 --- a/docs/integrations/harness/openclaw/openclaw.mdx +++ b/docs/integrations/harness/openclaw/openclaw.mdx @@ -65,6 +65,8 @@ Managed runtimes and NeMo Fabric-owned services use temporary state directories, ## Configure the Adapter +### Runtime Startup + Select the adapter and, when necessary, specify the OpenClaw executable: ```python @@ -79,50 +81,48 @@ harness = HarnessConfig( ) ``` -Omit `openclaw_command` to resolve `openclaw` from `PATH`. A relative path that -contains a directory is resolved from the NeMo Fabric base directory. The adapter -uses the resolved executable for its version check, configuration validation, -and Gateway startup. - -`startup_timeout_seconds` sets one deadline for all of start, from checking the -`openclaw` command to the Gateway becoming ready. It defaults to 60 seconds and -can be at most 75 seconds, which keeps start within NeMo Fabric's 90-second -start limit. - -The adapter supports only OpenClaw's default `openclaw` agent runtime. - -The adapter accepts normalized model provider, model, base URL, temperature, -`top_p`, `max_tokens`, replacement system instruction, workspace, skills, and -MCP configuration. Normalized MCP authentication is not supported. For a -custom OpenAI-compatible endpoint, set the model's `base_url` and, when needed, -`api_key_env`. - -For an endpoint that supports `stream_options.include_usage`, set -`models..settings.supports_usage_in_streaming` to `true`. This maps to -OpenClaw's native `compat.supportsUsageInStreaming` and requires `base_url`. -Use `false` for an endpoint that rejects streaming usage, or omit the setting -to retain OpenClaw's endpoint capability detection. Attached services own -their model configuration and do not accept this setting. - -OpenClaw 2026.9.4's Gateway does not distinguish aggregate usage from its -last-call fallback, and converts missing usage to zero counters. NeMo Fabric -leaves standard complete counters unknown and preserves the Gateway's counts -in `usage.extensions["nvidia.fabric.openclaw.usage_evidence.v1"].observed`. -The evidence includes `scope_unverified` in `gaps`, plus `missing_usage` or -`zero_unverified` when applicable. Reported counts do not establish complete -coverage of retries, compaction, child agents, or background work. - -For a NeMo Fabric-owned service, `harness.settings.channel_config` accepts -OpenClaw-native `channels` and `bindings`. This supports multiple accounts for -Telegram and other OpenClaw channels without a NeMo Fabric-specific channel schema. -Every binding must target the configured `agent_id`; OpenClaw validates the -nested channel settings. Chat-channel traffic goes directly between the -channel and OpenClaw rather than through a NeMo Fabric runtime. - -By default, the adapter chooses an available local port range. Set `port_range` -to an inclusive consumer-allocated range with `start` and `end` fields. The -range must span at least 111 ports. OpenClaw's [derived-port mapping](https://docs.openclaw.ai/gateway/multiple-gateways#port-mapping-derived) uses `base_port + 2` for browser control and allocates browser CDP ports from `base_port + 11` through `base_port + 110`. The adapter verifies only that `base_port` and `base_port + 2` are available before startup. OpenClaw allocates the CDP ports on demand instead of reserving the complete range, so the adapter cannot guarantee that those ports will still be available when OpenClaw needs them. Keep the configured range reserved for the lifetime of the runtime or service when using OpenClaw browser features. +| Harness Setting | Behavior | +| --- | --- | +| `openclaw_command` | Omit to find `openclaw` on `PATH`. A relative path containing a directory is resolved from the NeMo Fabric base directory. The same executable is used for version checks, configuration validation, and Gateway startup. | +| `startup_timeout_seconds` | One deadline covering the executable check through Gateway readiness. Defaults to 60 seconds; maximum 75 seconds, within NeMo Fabric's 90-second start limit. | + +The adapter supports OpenClaw's default `openclaw` execution runtime. + +### Agent Configuration + +Set model provider, model, endpoint, generation parameters (`temperature`, `top_p`, and `max_tokens`), replacement system instructions, workspace, skills, and MCP servers through normalized `FabricConfig`. See [Shared Configuration](#shared-configuration) for how these settings reach all four client paths. Normalized MCP authentication is not supported. + +For a custom OpenAI-compatible endpoint, set the model's `base_url` and, when credentials are required, `api_key_env`. + +The optional `models..settings.supports_usage_in_streaming` setting controls OpenClaw's native `compat.supportsUsageInStreaming`: + +- Set `true` when the endpoint supports `stream_options.include_usage`. +- Set `false` when the endpoint rejects streaming usage. +- Omit it to retain OpenClaw's endpoint capability detection. + +This setting requires `base_url`. Attached services own their model configuration and do not accept it. Reported usage has separate completeness limits; see [SDK Usage Accounting](./openclaw-sdk.mdx#usage-accounting). + +### Gateway Ports + +By default, the adapter selects a local Gateway port range. To allocate the range yourself, set `port_range` with inclusive `start` and `end` values spanning at least 111 ports. + +OpenClaw's [derived-port mapping](https://docs.openclaw.ai/gateway/multiple-gateways#port-mapping-derived) uses: + +| Purpose | Port | +| --- | --- | +| Gateway | Selected base port | +| Browser control | Base port + 2 | +| Browser CDP connections | Base port + 11 through base port + 110 | + +Startup checks availability of the base port and base port + 2. OpenClaw allocates CDP ports on demand, so startup does not reserve or guarantee the rest of the range. Keep the full range reserved for the runtime or service lifetime when using browser features. + +For an exact dashboard base port, use the [native interface settings](#select-native-interfaces) instead of `port_range`. + +### Chat Channels + +For a [NeMo Fabric-owned service](./openclaw-sdk.mdx#use-a-shared-service), `harness.settings.channel_config` accepts OpenClaw-native `channels` and `bindings`, including multiple accounts for Telegram and other channels. +Every binding must target the configured `agent_id`. OpenClaw validates the nested channel settings. Channel traffic flows directly between the channel and OpenClaw; it does not pass through a NeMo Fabric runtime. ## Select Native Interfaces From c43cb06e8b04939adb9bd157dde9a9e98a3c4d8e Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Mon, 9 Nov 2026 16:18:31 -0800 Subject: [PATCH 17/27] docs(openclaw): clarify native API connection setup Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- .../integrations/harness/openclaw/openclaw-api.mdx | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/docs/integrations/harness/openclaw/openclaw-api.mdx b/docs/integrations/harness/openclaw/openclaw-api.mdx index 3e186883a..f05b982cf 100644 --- a/docs/integrations/harness/openclaw/openclaw-api.mdx +++ b/docs/integrations/harness/openclaw/openclaw-api.mdx @@ -11,7 +11,19 @@ Start with the [OpenClaw overview](./openclaw.mdx) for installation and configur The managed Gateway already serves `/v1/chat/completions` for SDK invocation. Native HTTP clients can call that same endpoint; there is no separate API server or `interfaces.api` setting. -Enable a dashboard or terminal interface to publish native connection discovery and credentials. Terminal-only is the headless option and does not require browser assets. Read `http_url`, `agent_id`, and `token_file` from the private `interfaces/gateway.json`; read the referenced token file and send the token as `Authorization: Bearer `. The HTTP client sends this header on each request. +Enable either the dashboard or terminal interface so your HTTP client can find the Gateway address and access token. For API-only use, enable the terminal interface. This mode needs no browser assets, and you do not need to launch the terminal client. + +When the Gateway is ready, the adapter writes its connection details to the private `interfaces/gateway.json` file: + +- `http_url`: the Gateway address for API requests. +- `agent_id`: the agent name to use in the request's `model` value. +- `token_file`: the name of the token file in the same directory. + +Read the token from that file and configure your HTTP client to send this header on every request: + +```http +Authorization: Bearer +``` ## Requests and Conversations From 8f696e1d2a23fd6dd9675eb3c79bf68128d49da1 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Mon, 9 Nov 2026 16:20:10 -0800 Subject: [PATCH 18/27] docs(openclaw): clarify default API availability Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- docs/integrations/harness/openclaw/openclaw-api.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/harness/openclaw/openclaw-api.mdx b/docs/integrations/harness/openclaw/openclaw-api.mdx index f05b982cf..b5ae9de01 100644 --- a/docs/integrations/harness/openclaw/openclaw-api.mdx +++ b/docs/integrations/harness/openclaw/openclaw-api.mdx @@ -9,7 +9,7 @@ Start with the [OpenClaw overview](./openclaw.mdx) for installation and configur ## API Ownership -The managed Gateway already serves `/v1/chat/completions` for SDK invocation. Native HTTP clients can call that same endpoint; there is no separate API server or `interfaces.api` setting. +The managed Gateway serves `/v1/chat/completions` by default for SDK invocation. Native HTTP clients can use the same endpoint; no separate API server or `interfaces.api` setting is needed. Enable either the dashboard or terminal interface so your HTTP client can find the Gateway address and access token. For API-only use, enable the terminal interface. This mode needs no browser assets, and you do not need to launch the terminal client. From 0bc4aba22d264dab27f71ad134fa343c3ad3637b Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Mon, 9 Nov 2026 16:22:11 -0800 Subject: [PATCH 19/27] docs(openclaw): show API-only interface configuration Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- docs/integrations/harness/openclaw/openclaw-api.mdx | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/docs/integrations/harness/openclaw/openclaw-api.mdx b/docs/integrations/harness/openclaw/openclaw-api.mdx index b5ae9de01..0b36cd1a3 100644 --- a/docs/integrations/harness/openclaw/openclaw-api.mdx +++ b/docs/integrations/harness/openclaw/openclaw-api.mdx @@ -11,7 +11,18 @@ Start with the [OpenClaw overview](./openclaw.mdx) for installation and configur The managed Gateway serves `/v1/chat/completions` by default for SDK invocation. Native HTTP clients can use the same endpoint; no separate API server or `interfaces.api` setting is needed. -Enable either the dashboard or terminal interface so your HTTP client can find the Gateway address and access token. For API-only use, enable the terminal interface. This mode needs no browser assets, and you do not need to launch the terminal client. +Enable either the dashboard or terminal interface so the adapter writes the Gateway address and access token to private connection files. For API-only use, configure the terminal interface: + +```python +from nemo_fabric import HarnessConfig + +harness = HarnessConfig( + adapter_id="nvidia.fabric.openclaw", + settings={"interfaces": {"terminal": {}}}, +) +``` + +Use this `harness` in your `FabricConfig` when starting the runtime. It starts the Gateway and publishes the connection files without requiring browser assets. The terminal client starts only when you run the generated launcher; HTTP clients can use the Gateway without launching it. When the Gateway is ready, the adapter writes its connection details to the private `interfaces/gateway.json` file: From 656b901c89caccabb4c0704e10120968ea5f2ae2 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Mon, 9 Nov 2026 16:24:14 -0800 Subject: [PATCH 20/27] docs(openclaw): explain HTTP requests and conversations Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- .../harness/openclaw/openclaw-api.mdx | 26 +++++++++++++++++-- 1 file changed, 24 insertions(+), 2 deletions(-) diff --git a/docs/integrations/harness/openclaw/openclaw-api.mdx b/docs/integrations/harness/openclaw/openclaw-api.mdx index 0b36cd1a3..8de3e0a71 100644 --- a/docs/integrations/harness/openclaw/openclaw-api.mdx +++ b/docs/integrations/harness/openclaw/openclaw-api.mdx @@ -38,9 +38,31 @@ Authorization: Bearer ## Requests and Conversations -Set `model` to `openclaw/` and supply a stable, distinct `user` for each HTTP conversation. Reusing the SDK runtime's selector can share its native session. Omission does not establish conversation isolation. +Send a `POST` request to `/v1/chat/completions` with these fields: + +- `model`: `openclaw/` followed by the `agent_id` from `gateway.json`. This selects the OpenClaw agent that handles the request. +- `messages`: the messages you want to send to the agent. +- `user`: a conversation name chosen by your HTTP client. + +For example, when `agent_id` is `default`, the request body can be: + +```json +{ + "model": "openclaw/default", + "user": "api-review-1", + "messages": [ + {"role": "user", "content": "Read notes.txt and summarize it."} + ] +} +``` + +Reuse `api-review-1` for follow-up requests in that conversation. Choose a new `user` value to start a new conversation. Include `user` explicitly on each request so you control which conversation receives it. + +Each SDK runtime uses its runtime ID as the `user` value. Choose a different value for HTTP requests to keep those conversations separate from the SDK conversation. Reusing the SDK value can direct HTTP requests into its native session. + +The Gateway uses the model endpoint and credentials generated from `FabricConfig`. It also supplies the configured system instructions, workspace, tools, MCP servers, skills, and supported generation defaults. Your HTTP client does not need to copy the system instructions into each request. -The selected managed agent uses the shared model, endpoint, credentials, supported generation parameters, instructions, workspace, tools, MCP, and skills. The HTTP caller does not need to copy system instructions into the request. Responses and any native streaming remain OpenClaw's HTTP behavior rather than Fabric `RunResult` or Relay streams. +Responses come directly from OpenClaw in its native HTTP format. If you request streaming, the stream also uses OpenClaw's native format. These calls do not produce SDK `RunResult` objects or NeMo Relay streams. ## Testing and Boundaries From 522ee5c711b0cdd44fed8b77b14501badadcf542 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Mon, 9 Nov 2026 16:30:25 -0800 Subject: [PATCH 21/27] refactor(examples): group native interfaces by harness Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- adapters/python/openclaw/README.md | 2 +- .../harness/hermes-interfaces.mdx | 2 +- .../harness/openclaw/openclaw-api.mdx | 2 +- .../harness/openclaw/openclaw-dashboard.mdx | 2 +- .../harness/openclaw/openclaw-tui.mdx | 2 +- .../harness/openclaw/openclaw.mdx | 2 +- examples/README.md | 2 +- examples/interfaces/README.md | 98 +------------------ examples/interfaces/hermes/README.md | 96 ++++++++++++++++++ examples/interfaces/{ => hermes}/hermes.py | 0 .../README.md} | 18 ++-- .../interfaces/{ => openclaw}/openclaw.py | 0 12 files changed, 117 insertions(+), 109 deletions(-) create mode 100644 examples/interfaces/hermes/README.md rename examples/interfaces/{ => hermes}/hermes.py (100%) rename examples/interfaces/{README-openclaw.md => openclaw/README.md} (82%) rename examples/interfaces/{ => openclaw}/openclaw.py (100%) diff --git a/adapters/python/openclaw/README.md b/adapters/python/openclaw/README.md index b53054edb..6255c9f4c 100644 --- a/adapters/python/openclaw/README.md +++ b/adapters/python/openclaw/README.md @@ -120,7 +120,7 @@ With native interfaces enabled, one Gateway owns all four client paths. A small After readiness, private `interfaces/gateway.json` discovery references `dashboard.token` or `gateway.token`. Terminal selection adds an executable `interfaces/terminal` and `terminal.running` marker; the marker is removed first on stop. The launcher uses private client configuration and an environment SecretRef, not token arguments. Terminal attachment currently requires POSIX. Pinned TUI `/quit` can use a native exit-code-130 fallback while the Gateway stays usable. -Refer to the [four-path architecture](../../../docs/integrations/harness/openclaw/openclaw.mdx) and [repeatable examples](../../../examples/interfaces/README-openclaw.md). Relay telemetry, ATIF/ATOF export, and native OpenTelemetry are not supported. +Refer to the [four-path architecture](../../../docs/integrations/harness/openclaw/openclaw.mdx) and [repeatable examples](../../../examples/interfaces/openclaw/README.md). Relay telemetry, ATIF/ATOF export, and native OpenTelemetry are not supported. With native browser or terminal access enabled, runtime activity is `unknown`; healthy endpoints can still pass normalized checks. SDK invocation state alone cannot account for native work. diff --git a/docs/integrations/harness/hermes-interfaces.mdx b/docs/integrations/harness/hermes-interfaces.mdx index 1fe7c0bfc..595a9a7b6 100644 --- a/docs/integrations/harness/hermes-interfaces.mdx +++ b/docs/integrations/harness/hermes-interfaces.mdx @@ -114,7 +114,7 @@ Native API responses remain native responses. Relay's standard artifact format p ## 5. Testing -See the [Hermes interfaces example](../../../examples/interfaces/README.md) for setup, manual testing, output verification, and Relay trajectory inspection. +See the [Hermes interfaces example](../../../examples/interfaces/hermes/README.md) for setup, manual testing, output verification, and Relay trajectory inspection. ## 6. Limitations and Planned Work diff --git a/docs/integrations/harness/openclaw/openclaw-api.mdx b/docs/integrations/harness/openclaw/openclaw-api.mdx index 8de3e0a71..d5fc227e8 100644 --- a/docs/integrations/harness/openclaw/openclaw-api.mdx +++ b/docs/integrations/harness/openclaw/openclaw-api.mdx @@ -66,4 +66,4 @@ Responses come directly from OpenClaw in its native HTTP format. If you request ## Testing and Boundaries -Follow the [HTTP manual test](../../../../examples/interfaces/README-openclaw.md#2-http-api). Direct requests do not increment SDK invocation accounting. There is no ATIF/ATOF export in this iteration. Fabric runtime shutdown revokes discovery and stops the owned Gateway; a client cannot retain the runtime merely by staying connected. +Follow the [HTTP manual test](../../../../examples/interfaces/openclaw/README.md#2-http-api). Direct requests do not increment SDK invocation accounting. There is no ATIF/ATOF export in this iteration. Fabric runtime shutdown revokes discovery and stops the owned Gateway; a client cannot retain the runtime merely by staying connected. diff --git a/docs/integrations/harness/openclaw/openclaw-dashboard.mdx b/docs/integrations/harness/openclaw/openclaw-dashboard.mdx index 22fb94e89..8fee346d2 100644 --- a/docs/integrations/harness/openclaw/openclaw-dashboard.mdx +++ b/docs/integrations/harness/openclaw/openclaw-dashboard.mdx @@ -60,4 +60,4 @@ Select the configured agent and create or select a distinct chat for browser wor Native `/healthz`, `/startupz`, `/v1/models`, and `/readyz` observations feed Fabric's normalized checks. With browser or terminal access enabled, runtime activity remains `unknown` because SDK invocation state does not account for native work. Checks do not submit a model turn. -Follow the [browser manual test](../../../../examples/interfaces/README-openclaw.md#3-browser-dashboard). NeMo Relay export is not supported. +Follow the [browser manual test](../../../../examples/interfaces/openclaw/README.md#3-browser-dashboard). NeMo Relay export is not supported. diff --git a/docs/integrations/harness/openclaw/openclaw-tui.mdx b/docs/integrations/harness/openclaw/openclaw-tui.mdx index d841c2ceb..20cfecd7d 100644 --- a/docs/integrations/harness/openclaw/openclaw-tui.mdx +++ b/docs/integrations/harness/openclaw/openclaw-tui.mdx @@ -23,4 +23,4 @@ Each attachment selects the configured agent and creates a new session by defaul Use `/quit` to leave a completed conversation. The managed Gateway and other clients remain available. The pinned native TUI sometimes invokes its own shutdown fallback and exits with code 130; the adapter preserves that native exit status. Runtime stop removes `terminal.running` before the remaining connection files and stops the Gateway. Health checks use native endpoint evidence and report activity as unknown while interactive access is enabled. -Follow the [terminal manual test](../../../../examples/interfaces/README-openclaw.md#4-terminal-tui). Active-turn detach, approval interaction, remote attachment, and native activity aggregation remain unqualified. NeMo Relay integration is deferred. +Follow the [terminal manual test](../../../../examples/interfaces/openclaw/README.md#4-terminal-tui). Active-turn detach, approval interaction, remote attachment, and native activity aggregation remain unqualified. NeMo Relay integration is deferred. diff --git a/docs/integrations/harness/openclaw/openclaw.mdx b/docs/integrations/harness/openclaw/openclaw.mdx index 8d57625d3..7f161f7f2 100644 --- a/docs/integrations/harness/openclaw/openclaw.mdx +++ b/docs/integrations/harness/openclaw/openclaw.mdx @@ -143,6 +143,6 @@ After readiness, the adapter publishes private connection material under ` -# NVIDIA NeMo Fabric Native Interface Examples +# NVIDIA NeMo Fabric Interface Examples -Choose the harness to test: +Choose a harness for its setup instructions, runnable examples, and manual tests: -- **Hermes:** the native-interface instructions below. -- **OpenClaw:** the [four-path OpenClaw examples](README-openclaw.md), sharing one native Gateway. +- [Hermes](hermes/README.md) +- [OpenClaw](openclaw/README.md) -This example is a work in progress. Its structure and user experience will be reworked as part of OpenClaw TUI support. - -Use native harness interfaces alongside a NeMo Fabric-managed runtime. Each harness example uses the public Python SDK for configuration and lifecycle, then sends input through the harness's native interface. - -## Hermes API and Relay - -[`hermes.py`](hermes.py) starts one managed Hermes API server, submits a real file task, verifies the generated file, and checks Relay ATOF events and ATIF tool steps. Its API response remains native; the SDK manages the runtime but does not convert this response into a NeMo Fabric `RunResult`. - -### Prepare the Environment - -Follow the [Hermes adapter installation guide](../../docs/integrations/harness/hermes.mdx#install-the-adapter). For source development, run from the repository root: - -```bash -just install-hermes-agent -export ADAPTER_PYTHON="$PWD/.venv-hermes/bin/python" -``` - -This prepares pinned Hermes v0.22.5, the adapter, and Relay 0.10. The application interpreter also needs the NeMo Fabric SDK. The command below uses the prepared Hermes environment for both application and adapter. - -Set your OpenAI-compatible model endpoint, served model name, and credential: - -```bash -export MODEL_BASE_URL="https://MODEL_HOST/v1" -export MODEL_NAME="YOUR_SERVED_MODEL_NAME" -export MODEL_API_KEY="YOUR_MODEL_API_KEY" -``` - -Use HTTPS for remote endpoints that receive credentials. For a local server, use a loopback URL such as `http://127.0.0.1:8000/v1`; an authenticated encrypted tunnel is another option. Use the credential value required by your endpoint. An endpoint without authentication can use a nonempty placeholder credential. To reference an existing credential variable instead, pass its name with `--api-key-env`. - -### Run a Real Task - -Run the example from the repository root: - -```bash -.venv-hermes/bin/python examples/interfaces/hermes.py \ - --base-url "$MODEL_BASE_URL" \ - --model "$MODEL_NAME" \ - --port 8642 -``` - -The example copies sample release notes into a new workspace, asks the native API to read them and write a rollout checklist, and stops the runtime. To use your own notes, add `--input-file /path/to/release-notes.md`. `--output-dir` selects a new evidence directory; the example refuses to overwrite an existing directory. `--keep-running` leaves the API available for additional requests until you press Enter. - -The model and port must be reachable from the adapter environment. The native API binds to loopback and uses a generated bearer token; the example reads the token file and sends the header without printing the token. - -The example prints its evidence directory and checks that: - -- The output file exists and is nonempty. -- ATOF records show `read_file` and `write_file` execution. -- A populated ATIF trajectory contains those tool steps. -- Stop removes the API token. - -It exits unsuccessfully if any check fails. An ATOF file alone does not establish ATIF export. - -### Inspect the Result and Trajectory - -Set `RUN_DIR` to the evidence directory printed by the example: - -```bash -RUN_DIR="outputs/interfaces/" -cat "$RUN_DIR/workspace/rollout-checklist.md" -jq . "$RUN_DIR/summary.json" - -ATIF=$(jq -r '.atif_files[0]' "$RUN_DIR/summary.json") -jq -r '.steps[] | - [.step_id, .source, ((.tool_calls // []) | map(.function_name) | join(","))] | - @tsv' "$ATIF" -``` - -For this task, expect user input, an agent `read_file` step with its observation, an agent `write_file` step with its observation, and a final response. Inspect complete tool arguments and observations with: - -```bash -jq '.steps[] | select(.tool_calls != null) | - {tool_calls, observation}' "$ATIF" -``` - -To inspect the raw event sequence: - -```bash -ATOF=$(jq -r '.atof_files[0]' "$RUN_DIR/summary.json") -jq -r 'select(.kind == "scope" and - (.category == "llm" or .category == "tool")) | - [.timestamp, .scope_category, .category, .name] | @tsv' "$ATOF" -``` - -### ATIF Finalization and Limits - -The pinned Hermes API path leaves its Relay conversation scope open after a turn. ATOF events can therefore exist without ATIF export. The managed native launcher finalizes and flushes an API turn's Relay segment when execution returns, including failed turns. It does not fire native conversation-end plugin hooks or delete conversation state. The conversation can continue; subsequent turns create new Relay segments and ATIF files. Finalization errors are logged without replacing the execution outcome, so consumers should check their artifacts explicitly. - -This example exercises the managed API path. It does not qualify browser chat, TUI, independently restarted gateways, approvals, or complete native-result and artifact normalization. Refer to [Hermes Native Interfaces](../../docs/integrations/harness/hermes-interfaces.mdx) for the configuration and ownership boundaries. +Run commands from the repository root unless the harness README says otherwise. diff --git a/examples/interfaces/hermes/README.md b/examples/interfaces/hermes/README.md new file mode 100644 index 000000000..9afefe1f0 --- /dev/null +++ b/examples/interfaces/hermes/README.md @@ -0,0 +1,96 @@ + + +# NVIDIA NeMo Fabric Hermes Interface Examples + +This example is a work in progress. Its structure and user experience will be reworked as part of OpenClaw TUI support. + +Use native harness interfaces alongside a NeMo Fabric-managed runtime. Each harness example uses the public Python SDK for configuration and lifecycle, then sends input through the harness's native interface. + +## Hermes API and Relay + +[`hermes.py`](hermes.py) starts one managed Hermes API server, submits a real file task, verifies the generated file, and checks Relay ATOF events and ATIF tool steps. Its API response remains native; the SDK manages the runtime but does not convert this response into a NeMo Fabric `RunResult`. + +### Prepare the Environment + +Follow the [Hermes adapter installation guide](../../../docs/integrations/harness/hermes.mdx#install-the-adapter). For source development, run from the repository root: + +```bash +just install-hermes-agent +export ADAPTER_PYTHON="$PWD/.venv-hermes/bin/python" +``` + +This prepares pinned Hermes v0.22.5, the adapter, and Relay 0.10. The application interpreter also needs the NeMo Fabric SDK. The command below uses the prepared Hermes environment for both application and adapter. + +Set your OpenAI-compatible model endpoint, served model name, and credential: + +```bash +export MODEL_BASE_URL="https://MODEL_HOST/v1" +export MODEL_NAME="YOUR_SERVED_MODEL_NAME" +export MODEL_API_KEY="YOUR_MODEL_API_KEY" +``` + +Use HTTPS for remote endpoints that receive credentials. For a local server, use a loopback URL such as `http://127.0.0.1:8000/v1`; an authenticated encrypted tunnel is another option. Use the credential value required by your endpoint. An endpoint without authentication can use a nonempty placeholder credential. To reference an existing credential variable instead, pass its name with `--api-key-env`. + +### Run a Real Task + +Run the example from the repository root: + +```bash +.venv-hermes/bin/python examples/interfaces/hermes/hermes.py \ + --base-url "$MODEL_BASE_URL" \ + --model "$MODEL_NAME" \ + --port 8642 +``` + +The example copies sample release notes into a new workspace, asks the native API to read them and write a rollout checklist, and stops the runtime. To use your own notes, add `--input-file /path/to/release-notes.md`. `--output-dir` selects a new evidence directory; the example refuses to overwrite an existing directory. `--keep-running` leaves the API available for additional requests until you press Enter. + +The model and port must be reachable from the adapter environment. The native API binds to loopback and uses a generated bearer token; the example reads the token file and sends the header without printing the token. + +The example prints its evidence directory and checks that: + +- The output file exists and is nonempty. +- ATOF records show `read_file` and `write_file` execution. +- A populated ATIF trajectory contains those tool steps. +- Stop removes the API token. + +It exits unsuccessfully if any check fails. An ATOF file alone does not establish ATIF export. + +### Inspect the Result and Trajectory + +Set `RUN_DIR` to the evidence directory printed by the example: + +```bash +RUN_DIR="outputs/interfaces/" +cat "$RUN_DIR/workspace/rollout-checklist.md" +jq . "$RUN_DIR/summary.json" + +ATIF=$(jq -r '.atif_files[0]' "$RUN_DIR/summary.json") +jq -r '.steps[] | + [.step_id, .source, ((.tool_calls // []) | map(.function_name) | join(","))] | + @tsv' "$ATIF" +``` + +For this task, expect user input, an agent `read_file` step with its observation, an agent `write_file` step with its observation, and a final response. Inspect complete tool arguments and observations with: + +```bash +jq '.steps[] | select(.tool_calls != null) | + {tool_calls, observation}' "$ATIF" +``` + +To inspect the raw event sequence: + +```bash +ATOF=$(jq -r '.atof_files[0]' "$RUN_DIR/summary.json") +jq -r 'select(.kind == "scope" and + (.category == "llm" or .category == "tool")) | + [.timestamp, .scope_category, .category, .name] | @tsv' "$ATOF" +``` + +### ATIF Finalization and Limits + +The pinned Hermes API path leaves its Relay conversation scope open after a turn. ATOF events can therefore exist without ATIF export. The managed native launcher finalizes and flushes an API turn's Relay segment when execution returns, including failed turns. It does not fire native conversation-end plugin hooks or delete conversation state. The conversation can continue; subsequent turns create new Relay segments and ATIF files. Finalization errors are logged without replacing the execution outcome, so consumers should check their artifacts explicitly. + +This example exercises the managed API path. It does not qualify browser chat, TUI, independently restarted gateways, approvals, or complete native-result and artifact normalization. Refer to [Hermes Native Interfaces](../../../docs/integrations/harness/hermes-interfaces.mdx) for the configuration and ownership boundaries. diff --git a/examples/interfaces/hermes.py b/examples/interfaces/hermes/hermes.py similarity index 100% rename from examples/interfaces/hermes.py rename to examples/interfaces/hermes/hermes.py diff --git a/examples/interfaces/README-openclaw.md b/examples/interfaces/openclaw/README.md similarity index 82% rename from examples/interfaces/README-openclaw.md rename to examples/interfaces/openclaw/README.md index 9e10f9a85..1166a270b 100644 --- a/examples/interfaces/README-openclaw.md +++ b/examples/interfaces/openclaw/README.md @@ -5,14 +5,14 @@ SPDX-License-Identifier: Apache-2.0 # NVIDIA NeMo Fabric OpenClaw Interface Examples -Start with the [OpenClaw architecture guide](../../docs/integrations/harness/openclaw/openclaw.mdx). These four paths share one managed Gateway, its selected agent, and translated Fabric configuration. SDK responses are normalized; other responses remain native. NeMo Relay integration and trajectory export are deferred. +Start with the [OpenClaw architecture guide](../../../docs/integrations/harness/openclaw/openclaw.mdx). These four paths share one managed Gateway, its selected agent, and translated Fabric configuration. SDK responses are normalized; other responses remain native. NeMo Relay integration and trajectory export are deferred. | Path | Example | Architecture | | --- | --- | --- | -| SDK | [Code Review Example](../code_review_agent/README.md) with `--variant openclaw` | [SDK](../../docs/integrations/harness/openclaw/openclaw-sdk.mdx) | -| HTTP | `openclaw.py --http-input ... --once` | [HTTP API](../../docs/integrations/harness/openclaw/openclaw-api.mdx) | -| Browser | `openclaw.py --interface dashboard`, then native chat | [Dashboard](../../docs/integrations/harness/openclaw/openclaw-dashboard.mdx) | -| Terminal | `openclaw.py --interface terminal`, then generated launcher | [Terminal TUI](../../docs/integrations/harness/openclaw/openclaw-tui.mdx) | +| SDK | [Code Review Example](../../code_review_agent/README.md) with `--variant openclaw` | [SDK](../../../docs/integrations/harness/openclaw/openclaw-sdk.mdx) | +| HTTP | `openclaw.py --http-input ... --once` | [HTTP API](../../../docs/integrations/harness/openclaw/openclaw-api.mdx) | +| Browser | `openclaw.py --interface dashboard`, then native chat | [Dashboard](../../../docs/integrations/harness/openclaw/openclaw-dashboard.mdx) | +| Terminal | `openclaw.py --interface terminal`, then generated launcher | [Terminal TUI](../../../docs/integrations/harness/openclaw/openclaw-tui.mdx) | ## Shared Setup @@ -34,7 +34,7 @@ Use a new output directory for each run; the example refuses to overwrite one. ` ## 1. SDK -Follow the [Code Review Example](../code_review_agent/README.md) with `--variant openclaw`. To compare an SDK turn with the native clients in this example, add `--sdk-input 'Read notes.txt and write sdk-result.md with a short checklist.'` to an owner command below. The result is saved as `sdk-result.json`. +Follow the [Code Review Example](../../code_review_agent/README.md) with `--variant openclaw`. To compare an SDK turn with the native clients in this example, add `--sdk-input 'Read notes.txt and write sdk-result.md with a short checklist.'` to an owner command below. The result is saved as `sdk-result.json`. ## 2. HTTP API @@ -42,7 +42,7 @@ Run a real file task, then stop the owner automatically: ```bash export RUN_DIR="$PWD/outputs/interfaces/openclaw-http-$(date +%Y%m%d-%H%M%S)" -.venv/bin/python examples/interfaces/openclaw.py \ +.venv/bin/python examples/interfaces/openclaw/openclaw.py \ --base-url "$MODEL_BASE_URL" --model "$MODEL_NAME" \ --interface terminal --output-dir "$RUN_DIR" \ --http-input 'Read notes.txt and write api-result.md with a short checklist.' --once @@ -59,7 +59,7 @@ In the owner terminal, choose an available Gateway base port and keep the owner ```bash export RUN_DIR="$PWD/outputs/interfaces/openclaw-browser-$(date +%Y%m%d-%H%M%S)" -.venv/bin/python examples/interfaces/openclaw.py \ +.venv/bin/python examples/interfaces/openclaw/openclaw.py \ --base-url "$MODEL_BASE_URL" --model "$MODEL_NAME" \ --interface dashboard --port 18789 --output-dir "$RUN_DIR" ``` @@ -76,7 +76,7 @@ In the owner terminal: ```bash export RUN_DIR="$PWD/outputs/interfaces/openclaw-terminal-$(date +%Y%m%d-%H%M%S)" -.venv/bin/python examples/interfaces/openclaw.py \ +.venv/bin/python examples/interfaces/openclaw/openclaw.py \ --base-url "$MODEL_BASE_URL" --model "$MODEL_NAME" \ --interface terminal --output-dir "$RUN_DIR" ``` diff --git a/examples/interfaces/openclaw.py b/examples/interfaces/openclaw/openclaw.py similarity index 100% rename from examples/interfaces/openclaw.py rename to examples/interfaces/openclaw/openclaw.py From 2616ae0d7da0abfd2adfc8e9900616fa4b4df436 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Mon, 9 Nov 2026 16:36:48 -0800 Subject: [PATCH 22/27] docs(openclaw): clarify terminal setup and usage Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- .../harness/openclaw/openclaw-tui.mdx | 53 +++++++++++++++---- 1 file changed, 44 insertions(+), 9 deletions(-) diff --git a/docs/integrations/harness/openclaw/openclaw-tui.mdx b/docs/integrations/harness/openclaw/openclaw-tui.mdx index 20cfecd7d..1566a6571 100644 --- a/docs/integrations/harness/openclaw/openclaw-tui.mdx +++ b/docs/integrations/harness/openclaw/openclaw-tui.mdx @@ -7,20 +7,55 @@ SPDX-License-Identifier: Apache-2.0 */} Start with the [OpenClaw overview](./openclaw.mdx) for shared installation, configuration, and ownership. -## Additional Setup +## Enable Terminal Access -Terminal attachment requires POSIX and the pinned OpenClaw executable with a supported Node runtime. The npm package provides the terminal renderer; no Fabric-specific frontend build is required. Browser assets are unnecessary when dashboard is disabled. +Complete the [shared installation](./openclaw.mdx#install-openclaw-and-the-adapter) first. Terminal access requires a POSIX host, an interactive terminal, and the supported OpenClaw and Node versions. The OpenClaw package includes the terminal UI; no separate frontend build is needed. -Enable `harness.settings.interfaces.terminal: {}`. There is no terminal port setting. The adapter starts one Gateway and publishes an owner-executable `interfaces/terminal` launcher after readiness. Run that launcher from a real terminal or use `openshell sandbox exec -n SANDBOX --tty -- ` when the runtime is inside an OpenShell sandbox. Local terminal attachment is qualified separately from the OpenShell transport. +Use this harness configuration when starting your managed runtime: -## Attachment and Conversations +```python +from nemo_fabric import HarnessConfig -The launcher reads owner-only discovery, marker, and credential files and checks the authenticated endpoint. It starts native `openclaw tui` using a private remote-client configuration and an environment SecretRef. No token is placed in command-line arguments, and ambient OpenClaw target settings are removed. Attachment does not start another Gateway, use native local embedded mode, or install dependencies. +harness = HarnessConfig( + adapter_id="nvidia.fabric.openclaw", + settings={"interfaces": {"terminal": {}}}, +) +``` -Each attachment selects the configured agent and creates a new session by default. Pass `--session NAME` to intentionally reuse a native session on that agent. This is a session name, not an agent override or a connection to a previous Fabric runtime. Browser and terminal can select the same conversation explicitly; they are not isolated users. +The adapter starts the Gateway and, once it is ready, creates an executable launcher at `/.fabric/openclaw/runtimes//interfaces/terminal`. The terminal connects to that Gateway, so there is no terminal port to configure. Browser assets are unnecessary when dashboard access is disabled. -## Detach, Health, and Testing +## Connect From a Terminal -Use `/quit` to leave a completed conversation. The managed Gateway and other clients remain available. The pinned native TUI sometimes invokes its own shutdown fallback and exits with code 130; the adapter preserves that native exit status. Runtime stop removes `terminal.running` before the remaining connection files and stops the Gateway. Health checks use native endpoint evidence and report activity as unknown while interactive access is enabled. +Run the generated `terminal` launcher from an interactive terminal. The [manual example](../../../../examples/interfaces/openclaw/README.md#4-terminal-tui) prints its full path as `terminal_launcher`. -Follow the [terminal manual test](../../../../examples/interfaces/openclaw/README.md#4-terminal-tui). Active-turn detach, approval interaction, remote attachment, and native activity aggregation remain unqualified. NeMo Relay integration is deferred. +The launcher checks that the runtime's private connection files are valid and that the Gateway accepts its credential. It then starts `openclaw tui` with the correct Gateway address and token. Authentication is automatic; you do not need to paste a token. The credential is supplied through the environment and a private client configuration, rather than command-line arguments. Existing OpenClaw connection settings in your shell are cleared for this client so it connects to the selected runtime. + +For a runtime inside an OpenShell sandbox, run the launcher through a TTY-enabled sandbox command: + +```bash +openshell sandbox exec -n SANDBOX --tty -- /path/to/interfaces/terminal +``` + +Replace `SANDBOX` and the launcher path with your runtime's values. Local attachment has been tested; the OpenShell terminal transport remains unqualified in this prototype. + +## Choose a Conversation + +- Run the launcher without `--session` to start a new conversation on the configured agent. +- Add `--session manual-review` to open or continue that named conversation. Reuse the name when reconnecting to the same runtime. Session names cannot contain spaces or colons. +- Browser and terminal clients can join the same conversation when they explicitly select the same native session. Separate clients do not provide user isolation. + +Session names apply only to the configured agent and current runtime. + +## Disconnect and Check Runtime Health + +After a turn completes, enter `/quit` to close the terminal client. The Gateway keeps running, and SDK, HTTP, browser, and other terminal clients can continue using it. The pinned terminal client can return exit code 130 through its native shutdown fallback; that exit code alone does not mean the Gateway stopped. + +Stop the owning runtime to shut down the Gateway. The adapter removes `terminal.running` first, then the remaining connection files and credentials. + +`Fabric.check()` uses native Gateway endpoints to check health. With browser or terminal access enabled, activity is reported as `unknown` because the adapter cannot observe all interactive work. A passing health check does not establish that the runtime is idle. + +## Try It and Review Limitations + +Follow the [terminal manual test](../../../../examples/interfaces/openclaw/README.md#4-terminal-tui) to send input, continue a conversation, inspect output, and stop the runtime. + +Active-turn detach, interactive approvals, remote attachment, and complete native activity discovery still need qualification. NeMo Relay integration is deferred. From 7942b94db6c6867b1f70b869690e5703b768f19c Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Mon, 9 Nov 2026 17:03:31 -0800 Subject: [PATCH 23/27] fix(openclaw): match canonical agent identities Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- .../src/nemo_fabric_adapters/openclaw/adapter.py | 3 ++- .../openclaw/native_config/index.mjs | 5 ++++- docs/integrations/harness/openclaw/openclaw-sdk.mdx | 2 ++ tests/adapters/test_openclaw.py | 9 +++++++-- tests/adapters/test_openclaw_native.py | 6 +++--- 5 files changed, 18 insertions(+), 7 deletions(-) diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py index 6715c54f7..c33efe992 100644 --- a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py @@ -1081,7 +1081,8 @@ def unique(pairs): valid and not service_host and not any( - model["id"] == f"openclaw/{agent_id}" for model in models + model["id"] == f"openclaw/{agent_id.lower()}" + for model in models ) ): return observed("failed", "endpoint_unavailable") diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/index.mjs b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/index.mjs index ed6b79383..8bb52e3b5 100644 --- a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/index.mjs +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/index.mjs @@ -1,14 +1,17 @@ // SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. // SPDX-License-Identifier: Apache-2.0 +import { normalizeAgentId } from "openclaw/plugin-sdk/routing"; + /** Apply the managed agent's replacement prompt at the shared Gateway boundary. */ export default { id: "fabric-shared-config", name: "NeMo Fabric shared configuration", register(api) { const { agentId, systemInstruction } = api.pluginConfig; + const managedAgentId = normalizeAgentId(agentId); api.on("before_prompt_build", (_event, context) => { - if (context.agentId === agentId) { + if (context.agentId === managedAgentId) { return { systemPrompt: systemInstruction }; } }, { priority: 1000 }); diff --git a/docs/integrations/harness/openclaw/openclaw-sdk.mdx b/docs/integrations/harness/openclaw/openclaw-sdk.mdx index 589da8097..5e66df470 100644 --- a/docs/integrations/harness/openclaw/openclaw-sdk.mdx +++ b/docs/integrations/harness/openclaw/openclaw-sdk.mdx @@ -13,6 +13,8 @@ Use the [Code Review Example](../../../../examples/code_review_agent/README.md) SDK-only configurations retain existing behavior. When native interfaces are enabled, the same Gateway applies the configured system prompt through the shared plugin. Model, workspace, tools, MCP, and skills are generated once for that Gateway. SDK requests retain their configured generation parameters. Native turns do not create SDK invocation records. +With browser or terminal access enabled, `Fabric.check()` reports activity as `unknown` because SDK invocation state does not cover work from native clients. A passing health check therefore does not establish that the Gateway is idle; callers that wait for `activity: idle` must handle this mode explicitly. SDK-only runtimes retain `idle`/`busy` reporting. See [health checks](../../../sdk/health-checks.mdx) for the shared contract. + ## Usage Accounting The adapter treats Gateway usage as observed evidence. Reported counts do not establish whether they cover aggregate usage or a last-call fallback, and zero counters do not prove that no usage occurred. diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index d3087d8b9..fe3b05e71 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -2500,8 +2500,9 @@ async def test_openclaw_gateway_stream_keeps_usage_observational(): ({"terminal": {}}, True), ], ) +@pytest.mark.parametrize("agent_id", ["default", "Reviewer"]) async def test_native_configuration_owns_prompt_once( - mock_openclaw, tmp_path, selection, shared + mock_openclaw, tmp_path, selection, shared, agent_id ): capture = tmp_path / "config.json" request_capture = tmp_path / "request.json" @@ -2509,6 +2510,7 @@ async def test_native_configuration_owns_prompt_once( os.environ["FAKE_OPENCLAW_REQUEST"] = str(request_capture) config = _config(mock_openclaw) config.harness.settings["interfaces"] = selection + config.harness.settings["agent_id"] = agent_id runtime = adapter.OpenClawRuntime() await _start(runtime, tmp_path, config) try: @@ -2524,7 +2526,7 @@ async def test_native_configuration_owns_prompt_once( if shared: entry = generated["plugins"]["entries"]["fabric-shared-config"] assert entry["config"] == { - "agentId": "default", + "agentId": agent_id, "systemInstruction": "Be concise.", } directory = _dashboard_token(tmp_path).parent @@ -2534,6 +2536,9 @@ async def test_native_configuration_owns_prompt_once( else: assert "plugins" not in generated assert not _dashboard_token(tmp_path).parent.exists() + for level in ("live", "active", "ready"): + report = await runtime.check(level) + assert report["outcome"] == "passed", report finally: await runtime.stop() assert not (_dashboard_token(tmp_path).parent / "terminal.running").exists() diff --git a/tests/adapters/test_openclaw_native.py b/tests/adapters/test_openclaw_native.py index 456684464..6cf5e82d1 100644 --- a/tests/adapters/test_openclaw_native.py +++ b/tests/adapters/test_openclaw_native.py @@ -19,8 +19,8 @@ ) -@pytest.fixture(name="native_config") -def native_config_fixture(tmp_path, api_server, unused_tcp_port): +@pytest.fixture(name="native_config", params=["reviewer", "Reviewer"]) +def native_config_fixture(tmp_path, api_server, unused_tcp_port, request): os.environ["ADAPTER_PYTHON"] = sys.executable os.environ["FABRIC_TEST_MODEL_KEY"] = "native-parity-test-key" marker = "FABRIC_SHARED_PROMPT_72931" @@ -36,7 +36,7 @@ def native_config_fixture(tmp_path, api_server, unused_tcp_port): "adapter_id": "nvidia.fabric.openclaw", "settings": { "openclaw_command": os.environ["FABRIC_OPENCLAW_TEST_COMMAND"], - "agent_id": "reviewer", + "agent_id": request.param, "interfaces": { "dashboard": {"port": unused_tcp_port}, "terminal": {}, From e4cc5fa78a99032159f88a0d21b19ed2f4337c77 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Mon, 9 Nov 2026 17:07:09 -0800 Subject: [PATCH 24/27] test: compare health timestamps chronologically Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- tests/python/runtime_server/test_process.py | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/tests/python/runtime_server/test_process.py b/tests/python/runtime_server/test_process.py index 0f4845960..4e2eea276 100644 --- a/tests/python/runtime_server/test_process.py +++ b/tests/python/runtime_server/test_process.py @@ -10,6 +10,7 @@ import sys import tempfile from contextlib import suppress +from datetime import datetime from pathlib import Path import pytest @@ -97,7 +98,9 @@ async def call(*arguments, expected_exit=0): assert response["result"]["server"] == {"state": "responding"} assert response["result"]["runtime"] is None assert "PRIVATE" not in json.dumps(response) - assert second["result"]["completed_at"] > first["result"]["completed_at"] + assert datetime.fromisoformat( + second["result"]["completed_at"] + ) > datetime.fromisoformat(first["result"]["completed_at"]) assert retained.read_text() == "KEEP" if busy: assert invocation.returncode is None From 17c9d16ae9ca5ef68817a666239dcd5fa50fa14e Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Mon, 9 Nov 2026 20:40:38 -0800 Subject: [PATCH 25/27] docs: clarify browser result inspection in another terminal Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- examples/interfaces/openclaw/README.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/examples/interfaces/openclaw/README.md b/examples/interfaces/openclaw/README.md index 1166a270b..16c0364bf 100644 --- a/examples/interfaces/openclaw/README.md +++ b/examples/interfaces/openclaw/README.md @@ -66,7 +66,14 @@ export RUN_DIR="$PWD/outputs/interfaces/openclaw-browser-$(date +%Y%m%d-%H%M%S)" Open the printed `http_url` in a browser. Read the printed token-file path privately and enter its value in the native Control UI sign-in field, or use OpenClaw's native token-fragment sign-in flow. The token authenticates to this Gateway; it is not the model API key. Select agent `reviewer` and create a distinct chat. -Send `Read notes.txt and write browser-result.md with a short checklist.` After completion, send `Read browser-result.md and add one verification step.` Inspect `$RUN_DIR/workspace/browser-result.md` in another terminal. +Send `Read notes.txt and write browser-result.md with a short checklist.` After completion, send `Read browser-result.md and add one verification step.` + +In another terminal, set `RUN_DIR` to the same output directory used by the owner. Use the parent directory of the `workspace` path printed by the owner, replacing the placeholder below with that exact path: + +```bash +export RUN_DIR="/absolute/path/to/openclaw-browser-YYYYMMDD-HHMMSS" +cat "$RUN_DIR/workspace/browser-result.md" +``` Press Enter in the owner terminal to stop. Check `cleanup.json` and confirm the browser can no longer submit work. Browser tabs share a native session when they select the same chat; another tab does not guarantee isolation. From 9af8ef8fb3be7cda840cf5c42afb511f4671062c Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Tue, 10 Nov 2026 09:30:08 -0800 Subject: [PATCH 26/27] docs: clarify Hermes interface example introduction Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- examples/interfaces/hermes/README.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/examples/interfaces/hermes/README.md b/examples/interfaces/hermes/README.md index 9afefe1f0..915ad1026 100644 --- a/examples/interfaces/hermes/README.md +++ b/examples/interfaces/hermes/README.md @@ -5,9 +5,7 @@ SPDX-License-Identifier: Apache-2.0 # NVIDIA NeMo Fabric Hermes Interface Examples -This example is a work in progress. Its structure and user experience will be reworked as part of OpenClaw TUI support. - -Use native harness interfaces alongside a NeMo Fabric-managed runtime. Each harness example uses the public Python SDK for configuration and lifecycle, then sends input through the harness's native interface. +Start with the [Hermes architecture guide](../../../docs/integrations/harness/hermes.mdx) for installation and SDK configuration, then see [native interfaces](../../../docs/integrations/harness/hermes-interfaces.mdx) for shared configuration and process ownership. This example tests the native HTTP API using a Fabric-managed runtime and translated Fabric configuration. SDK responses are normalized; API responses remain native. NeMo Relay provides ATOF events and ATIF trajectories. ## Hermes API and Relay From 1ea529c3616b1af2a534229fc370667f03aa9477 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Tue, 10 Nov 2026 09:54:30 -0800 Subject: [PATCH 27/27] fix(openclaw): verify shared instructions and preserve native guidance Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- adapters/python/openclaw/README.md | 4 +- .../openclaw/openclaw.fabric-adapter.json | 1 + .../nemo_fabric_adapters/openclaw/adapter.py | 40 +++++++- .../openclaw/native_config/index.mjs | 35 ++++++- .../harness/openclaw/openclaw-sdk.mdx | 2 +- .../harness/openclaw/openclaw.mdx | 8 +- .../nemo_fabric_adapter_catalog/catalog.json | 3 +- tests/_utils/mock_openclaw.py | 25 +++++ tests/adapters/test_openclaw.py | 94 +++++++++++++++++++ tests/adapters/test_openclaw_native.py | 63 ++++++++++++- 10 files changed, 261 insertions(+), 14 deletions(-) diff --git a/adapters/python/openclaw/README.md b/adapters/python/openclaw/README.md index 6255c9f4c..bad14ff6f 100644 --- a/adapters/python/openclaw/README.md +++ b/adapters/python/openclaw/README.md @@ -116,7 +116,9 @@ The following settings are specific to the OpenClaw adapter: OpenClaw's [derived-port mapping](https://docs.openclaw.ai/gateway/multiple-gateways#port-mapping-derived) uses `base_port + 2` for browser control and allocates browser CDP ports from `base_port + 11` through `base_port + 110`. Set `port_range` when the consumer reserves a port range before configuring NeMo Fabric; the adapter selects a base whose complete derived footprint fits inside that range. The adapter verifies only that `base_port` and `base_port + 2` are available before startup. OpenClaw allocates the CDP ports on demand instead of reserving the complete range, so the adapter cannot guarantee that those ports will still be available when OpenClaw needs them. Keep the configured range reserved for the lifetime of the runtime when using OpenClaw browser features. -With native interfaces enabled, one Gateway owns all four client paths. A small adapter-owned plugin applies replacement system instructions to the selected agent through the public `before_prompt_build` hook. SDK requests omit duplicate instruction injection in that mode; SDK-only and service behavior are preserved. OpenClaw appends its native model-identity sentence. Model, workspace, tools, MCP, and skill configuration are shared; native responses remain native. +With native interfaces enabled, one Gateway owns all four client paths. A small adapter-owned plugin adds the configured instruction for the selected agent through the public `before_prompt_build` hook while preserving OpenClaw's native prompt and tool guidance. SDK requests omit duplicate instruction injection in that mode; SDK-only and service behavior are preserved. The existing `replace` mode selects the Fabric instruction without replacing OpenClaw's internal prompt. Model, workspace, tools, MCP, and skill configuration are shared; native responses remain native. + +Startup verifies the loaded hook through an authenticated, model-free probe before publishing connection files. Missing, blocked, or mismatched hooks fail with `openclaw_shared_configuration_unavailable`. The plugin requires both `allowConversationAccess` and `allowPromptInjection`: pinned OpenClaw gates `before_prompt_build` behind both permissions for external plugins. After readiness, private `interfaces/gateway.json` discovery references `dashboard.token` or `gateway.token`. Terminal selection adds an executable `interfaces/terminal` and `terminal.running` marker; the marker is removed first on stop. The launcher uses private client configuration and an environment SecretRef, not token arguments. Terminal attachment currently requires POSIX. Pinned TUI `/quit` can use a native exit-code-130 fallback while the Gateway stays usable. diff --git a/adapters/python/openclaw/openclaw.fabric-adapter.json b/adapters/python/openclaw/openclaw.fabric-adapter.json index b66238528..f77440d86 100644 --- a/adapters/python/openclaw/openclaw.fabric-adapter.json +++ b/adapters/python/openclaw/openclaw.fabric-adapter.json @@ -18,6 +18,7 @@ "type": "string", "minLength": 1, "default": "default", + "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$", "description": "OpenClaw agent selected for SDK invocations and managed native clients." }, "channel_config": { diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py index c33efe992..1a0cb4815 100644 --- a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py @@ -196,13 +196,15 @@ def _dashboard_token_path(context: contract.RuntimeContext, base_dir: Path) -> P def _agent_id(settings: dict[str, Any]) -> str: value = settings.get("agent_id", "default") - if not isinstance(value, str) or not value.strip(): + if not isinstance(value, str) or not re.fullmatch( + r"[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}", value + ): raise lifecycle.LifecycleError( "openclaw_invalid_configuration", - "OpenClaw agent_id must be a non-empty string", + "OpenClaw agent_id must contain 1–64 ASCII letters, digits, underscores, or hyphens and start with a letter or digit", metadata={"field": "harness.settings.agent_id"}, ) - return value.strip() + return value def _channel_config( @@ -1111,6 +1113,7 @@ async def start(self, payload: dict[str, Any]) -> dict[str, Any] | None: "OpenClaw interfaces require a managed runtime", metadata={"field": "harness.settings.interfaces"}, ) + _agent_id(settings) dashboard_port = _dashboard_port(settings) if native_interfaces.enabled(settings, "terminal") and os.name != "posix": raise lifecycle.LifecycleError( @@ -1269,6 +1272,12 @@ def startup_remaining() -> float: ] self._install_signal_handlers() await self._wait_started(port, token, startup_remaining()) + if "fabric-shared-config" in generated.get("plugins", {}).get( + "entries", {} + ): + await self._verify_shared_configuration( + port, token, _agent_id(settings), startup_remaining() + ) if dashboard_port is not None: token_path = _dashboard_token_path(context, base_dir) local_interfaces.write_private_file(token_path, token) @@ -1726,6 +1735,31 @@ async def _wait_started(self, port: int, token: str, timeout: float) -> None: retryable=True, ) + async def _verify_shared_configuration( + self, port: int, token: str, agent_id: str, timeout: float + ) -> None: + try: + async with asyncio.timeout(timeout): + async with httpx.AsyncClient( + headers={"authorization": f"Bearer {token}"}, + timeout=min(timeout, 5.0), + trust_env=False, + ) as client: + response = await client.get( + f"http://127.0.0.1:{port}/fabric/shared-config/health" + ) + response.raise_for_status() + status = response.json() + if status == {"ready": True, "agent_id": agent_id.lower()}: + return + except (httpx.HTTPError, ValueError, TimeoutError): + pass + raise lifecycle.LifecycleError( + "openclaw_shared_configuration_unavailable", + "OpenClaw shared instruction plugin or before_prompt_build hook is unavailable for the selected agent", + metadata={"field": "instructions.system", "agent_id": agent_id}, + ) + async def invoke( self, request: contract.AgentRunRequest, diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/index.mjs b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/index.mjs index 8bb52e3b5..169499a67 100644 --- a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/index.mjs +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/native_config/index.mjs @@ -1,19 +1,50 @@ // SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. // SPDX-License-Identifier: Apache-2.0 +import { getGlobalHookRunner } from "openclaw/plugin-sdk/plugin-runtime"; import { normalizeAgentId } from "openclaw/plugin-sdk/routing"; -/** Apply the managed agent's replacement prompt at the shared Gateway boundary. */ +/** Add the managed instruction while retaining OpenClaw's native prompt. */ export default { id: "fabric-shared-config", name: "NeMo Fabric shared configuration", register(api) { const { agentId, systemInstruction } = api.pluginConfig; const managedAgentId = normalizeAgentId(agentId); + const instructionContext = `## Conversation Context\n${systemInstruction}`; api.on("before_prompt_build", (_event, context) => { if (context.agentId === managedAgentId) { - return { systemPrompt: systemInstruction }; + return { appendSystemContext: instructionContext }; } }, { priority: 1000 }); + api.registerHttpRoute({ + path: "/fabric/shared-config/health", + auth: "gateway", + match: "exact", + async handler(req, res) { + if (req.method !== "GET") { + res.writeHead(405, { Allow: "GET" }); + res.end(); + return; + } + let ready = false; + try { + const runner = getGlobalHookRunner(); + const result = await runner?.runBeforePromptBuild( + { prompt: "", messages: [] }, + { agentId: managedAgentId }, + ); + ready = result?.appendSystemContext === instructionContext + && result?.systemPrompt === undefined; + } catch { + // Startup fails closed without returning instructions or conversation data. + } + res.writeHead(ready ? 200 : 503, { + "Content-Type": "application/json", + "Cache-Control": "no-store", + }); + res.end(JSON.stringify({ ready, agent_id: managedAgentId })); + }, + }); }, }; diff --git a/docs/integrations/harness/openclaw/openclaw-sdk.mdx b/docs/integrations/harness/openclaw/openclaw-sdk.mdx index 5e66df470..4813000be 100644 --- a/docs/integrations/harness/openclaw/openclaw-sdk.mdx +++ b/docs/integrations/harness/openclaw/openclaw-sdk.mdx @@ -11,7 +11,7 @@ Start with the [OpenClaw overview](./openclaw.mdx) for installation, shared conf Use the [Code Review Example](../../../../examples/code_review_agent/README.md) with `--variant openclaw`. The adapter sends requests to its managed Gateway's Chat Completions endpoint, preserving the runtime ID as the SDK conversation selector and returning a normalized `RunResult`. -SDK-only configurations retain existing behavior. When native interfaces are enabled, the same Gateway applies the configured system prompt through the shared plugin. Model, workspace, tools, MCP, and skills are generated once for that Gateway. SDK requests retain their configured generation parameters. Native turns do not create SDK invocation records. +SDK-only configurations retain existing behavior. When native interfaces are enabled, the same Gateway adds the Fabric instruction through the shared plugin while retaining OpenClaw's native prompt and tool guidance. The SDK omits its separate instruction message in this mode to avoid duplication. Model, workspace, tools, MCP, and skills are generated once for that Gateway. SDK requests retain their configured generation parameters. Native turns do not create SDK invocation records. With browser or terminal access enabled, `Fabric.check()` reports activity as `unknown` because SDK invocation state does not cover work from native clients. A passing health check therefore does not establish that the Gateway is idle; callers that wait for `activity: idle` must handle this mode explicitly. SDK-only runtimes retain `idle`/`busy` reporting. See [health checks](../../../sdk/health-checks.mdx) for the shared contract. diff --git a/docs/integrations/harness/openclaw/openclaw.mdx b/docs/integrations/harness/openclaw/openclaw.mdx index 7f161f7f2..0dde11b6b 100644 --- a/docs/integrations/harness/openclaw/openclaw.mdx +++ b/docs/integrations/harness/openclaw/openclaw.mdx @@ -18,7 +18,11 @@ You can use OpenClaw through the NVIDIA NeMo Fabric adapter in four ways: All four paths execute through one OpenClaw Gateway and its native agent runtime. NeMo Fabric translates `FabricConfig` into one private `openclaw.json`, with a fresh state directory, configured model/endpoint/credential references, generation parameters, workspace, tool policy, MCP servers, and skill paths. -When a native interface is enabled, a small adapter-owned plugin applies replacement system instructions at OpenClaw's public `before_prompt_build` hook for the selected agent. SDK requests then omit their separate instruction injection, so all clients receive the configured prompt once. Pinned OpenClaw appends its native model-identity sentence after that prompt. Without native interfaces, existing SDK instruction handling is preserved. Omitted instructions preserve the native prompt; `append` remains unsupported. +When a native interface is enabled, a small adapter-owned plugin adds the configured instruction through OpenClaw's public `before_prompt_build` hook for the selected agent. It preserves OpenClaw's native system prompt, including tool guidance. SDK requests then omit their separate instruction injection, so each client receives the Fabric instruction once. SDK-only and service configurations retain their existing system-message handling. + +The adapter's existing `replace` mode selects the Fabric-provided instruction; it does not replace OpenClaw's internal system prompt. Omitted instructions preserve native behavior; `append` remains unsupported. + +Before publishing native connection files, startup makes an authenticated, model-free check that the loaded plugin's registered hook supplies the instruction for the selected agent. Missing, blocked, or mismatched hooks fail startup with `openclaw_shared_configuration_unavailable`. This startup check is separate from normalized runtime health checks. The generated configuration is read-only. Native clients share the configured backend but keep separate conversations when they select different native sessions. Filesystem access and Gateway credentials are shared within the runtime; this is not a user-isolation boundary. Native session/model overrides are not qualified; shared defaults do not enforce immutable policy. Native reconfiguration controls do not provide a supported way to change the Fabric-owned configuration. @@ -90,6 +94,8 @@ The adapter supports OpenClaw's default `openclaw` execution runtime. ### Agent Configuration +`harness.settings.agent_id` defaults to `default`. Use 1–64 ASCII letters, digits, underscores, or hyphens, starting with a letter or digit. IDs are case-insensitive; invalid IDs are rejected instead of relying on native character replacement or truncation. + Set model provider, model, endpoint, generation parameters (`temperature`, `top_p`, and `max_tokens`), replacement system instructions, workspace, skills, and MCP servers through normalized `FabricConfig`. See [Shared Configuration](#shared-configuration) for how these settings reach all four client paths. Normalized MCP authentication is not supported. For a custom OpenAI-compatible endpoint, set the model's `base_url` and, when credentials are required, `api_key_env`. diff --git a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json index d480c665c..f23440d47 100644 --- a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json +++ b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json @@ -2072,6 +2072,7 @@ "default": "default", "description": "OpenClaw agent selected for SDK invocations and managed native clients.", "minLength": 1, + "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$", "type": "string" }, "channel_config": { @@ -2221,7 +2222,7 @@ "name": "nemo-fabric-adapters-openclaw", "version": "0.7.0" }, - "sha256": "e09e634bdd1f9ac1c32bb6aa35e7bf572de3c7ed8c5ac610b0528ef4d996ebb1", + "sha256": "dbfb74e0d2a2ba4db50bdc0d93140c0de3abc07d90f6551b9dd1f28458b9cc59", "source": "adapters/python/openclaw/openclaw.fabric-adapter.json" }, "nvidia.fabric.opencode": { diff --git a/tests/_utils/mock_openclaw.py b/tests/_utils/mock_openclaw.py index 1c8fdeb29..fa4fdf0ee 100755 --- a/tests/_utils/mock_openclaw.py +++ b/tests/_utils/mock_openclaw.py @@ -55,6 +55,31 @@ def do_GET(self): self.send_header("Allow", "POST") self.end_headers() return + if self.path == "/fabric/shared-config/health": + if self.headers.get("Authorization") != f"Bearer {token}": + self.send_response(401) + self.end_headers() + return + mode = os.environ.get("FAKE_OPENCLAW_SHARED_CONFIG", "ready") + if mode == "missing": + self.send_response(404) + self.end_headers() + return + with open(os.environ["OPENCLAW_CONFIG_PATH"], encoding="utf-8") as stream: + generated = json.load(stream) + agent_id = next(iter(generated["agents"]["entries"])) + body = json.dumps( + { + "ready": mode != "inactive", + "agent_id": agent_id.lower() if mode != "wrong-agent" else "other", + } + ).encode() + self.send_response(200) + self.send_header("Content-Type", "application/json") + self.send_header("Content-Length", str(len(body))) + self.end_headers() + self.wfile.write(body) + return if self.path == "/healthz": body = json.dumps({"ok": True, "status": "live"}).encode() self.send_response(200) diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index fe3b05e71..499d1b951 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -241,6 +241,9 @@ def test_openclaw_rejects_invalid_port_range(settings: dict[str, object]): id="port-range-with-dashboard", ), pytest.param({"startup_timeout_seconds": 76}, id="startup-timeout-too-long"), + pytest.param({"agent_id": "my agent"}, id="agent-id-spaces"), + pytest.param({"agent_id": "a" * 65}, id="agent-id-too-long"), + pytest.param({"agent_id": "-agent"}, id="agent-id-prefix"), ], ) def test_openclaw_plan_rejects_invalid_settings( @@ -2542,3 +2545,94 @@ async def test_native_configuration_owns_prompt_once( finally: await runtime.stop() assert not (_dashboard_token(tmp_path).parent / "terminal.running").exists() + + +@pytest.mark.parametrize( + "agent_id", ["my agent", "-agent", "_agent", "a" * 65, "é", " reviewer "] +) +async def test_openclaw_rejects_noncanonical_agent_ids( + mock_openclaw, tmp_path, agent_id +): + config = _config(mock_openclaw) + config.harness.settings["agent_id"] = agent_id + runtime = adapter.OpenClawRuntime() + with pytest.raises(adapter.lifecycle.LifecycleError) as caught: + await _start(runtime, tmp_path, config) + assert caught.value.code == "openclaw_invalid_configuration" + assert caught.value.metadata == {"field": "harness.settings.agent_id"} + assert runtime._process is None + + +@pytest.mark.skipif(os.name != "posix", reason="The native terminal requires POSIX") +@pytest.mark.parametrize("mode", ["missing", "inactive", "wrong-agent"]) +async def test_shared_instruction_probe_fails_before_publishing_interfaces( + mock_openclaw, tmp_path, mode +): + os.environ["FAKE_OPENCLAW_SHARED_CONFIG"] = mode + os.environ["FAKE_OPENCLAW_CAPTURE"] = str(tmp_path / "config.json") + config = _config(mock_openclaw) + config.harness.settings["interfaces"] = {"terminal": {}} + runtime = adapter.OpenClawRuntime() + with pytest.raises(adapter.lifecycle.LifecycleError) as caught: + await _start(runtime, tmp_path, config) + assert caught.value.code == "openclaw_shared_configuration_unavailable" + assert runtime._process is None + assert not (_dashboard_token(tmp_path).parent / "gateway.json").exists() + assert not (_dashboard_token(tmp_path).parent / "terminal.running").exists() + + +@pytest.mark.skipif( + not os.environ.get("FABRIC_OPENCLAW_TEST_COMMAND"), + reason="Set FABRIC_OPENCLAW_TEST_COMMAND for actual plugin failure qualification", +) +@pytest.mark.parametrize( + "failure", + ["missing", "renamed", "conversation-denied", "prompt-denied", "wrong-agent"], +) +async def test_native_shared_hook_failures_reject_startup( + tmp_path, api_server, monkeypatch, failure +): + plugin = tmp_path / "plugin" + shutil.copytree(Path(adapter.__file__).with_name("native_config"), plugin) + entrypoint = plugin / "index.mjs" + if failure == "missing": + entrypoint.write_text( + 'throw new Error("plugin load failure for qualification");' + ) + elif failure == "renamed": + entrypoint.write_text( + entrypoint.read_text().replace( + 'api.on("before_prompt_build"', 'api.on("agent_end"' + ) + ) + original = adapter._openclaw_config + + def generated_config(*args, **kwargs): + generated = original(*args, **kwargs) + generated["plugins"]["load"]["paths"] = [str(plugin)] + shared = generated["plugins"]["entries"]["fabric-shared-config"] + if failure == "conversation-denied": + shared["hooks"]["allowConversationAccess"] = False + elif failure == "prompt-denied": + shared["hooks"]["allowPromptInjection"] = False + elif failure == "wrong-agent": + shared["config"]["agentId"] = "other" + return generated + + monkeypatch.setattr(adapter, "_openclaw_config", generated_config) + config = _config(Path(os.environ["FABRIC_OPENCLAW_TEST_COMMAND"])) + config.harness.settings["interfaces"] = {"terminal": {}} + config.models["default"].base_url = f"{api_server}/v1" + runtime = adapter.OpenClawRuntime() + with pytest.raises(adapter.lifecycle.LifecycleError) as caught: + await _start(runtime, tmp_path, config) + assert caught.value.code == "openclaw_shared_configuration_unavailable" + assert runtime._process is None + assert not (_dashboard_token(tmp_path).parent / "gateway.json").exists() + async with httpx.AsyncClient(trust_env=False) as client: + assert (await client.get(f"{api_server}/_requests")).json() == [] + + +@pytest.mark.parametrize("agent_id", ["Reviewer", "agent_1-A", "a" * 64]) +def test_openclaw_preserves_valid_agent_id_spelling(agent_id): + assert adapter._agent_id({"agent_id": agent_id}) == agent_id diff --git a/tests/adapters/test_openclaw_native.py b/tests/adapters/test_openclaw_native.py index 6cf5e82d1..ecb1a2343 100644 --- a/tests/adapters/test_openclaw_native.py +++ b/tests/adapters/test_openclaw_native.py @@ -310,14 +310,16 @@ def terminal_turns(): assert len(payloads) == 25 for payload in payloads: assert payload["model"] == "fabric-echo" - assert [ + system = "\n".join( message["content"] for message in payload["messages"] if message["role"] == "system" - ] == [ - marker - + "\n\nCurrent model identity: fabric-test/fabric-echo. If asked what model you are, answer with this value for the current run." - ] + ) + assert system.count(marker) == 1 + assert "## Tooling" in system + assert "## Tool Call Style" in system + assert "## Conversation Context" in system + assert "Current model identity: fabric-test/fabric-echo" in system assert payload["temperature"] == 0.2 assert payload["top_p"] == 0.8 assert ( @@ -555,3 +557,54 @@ async def terminal_turn(): if child is not None and child.isalive(): child.terminate(force=True) await browser.close() + + +async def test_native_selection_preserves_sdk_prompt_guidance( + tmp_path, api_server, native_config +): + selection = native_config.harness.settings.pop("interfaces") + prompts = [] + fabric = Fabric() + async with httpx.AsyncClient(trust_env=False, timeout=60) as client: + for interfaces in ({}, selection): + native_config.harness.settings["interfaces"] = interfaces + async with await fabric.start_runtime( + native_config, base_dir=tmp_path + ) as runtime: + if interfaces: + directory = ( + tmp_path + / "artifacts/.fabric/openclaw/runtimes" + / runtime.runtime_id + / "interfaces" + ) + connection = json.loads((directory / "gateway.json").read_text()) + url = connection["http_url"] + "/fabric/shared-config/health" + assert (await client.get(url)).status_code == 401 + token = (directory / connection["token_file"]).read_text().strip() + response = await client.get( + url, headers={"Authorization": f"Bearer {token}"} + ) + assert response.status_code == 200 + assert response.json() == {"ready": True, "agent_id": "reviewer"} + assert ( + native_config.instructions.system.content not in response.text + ) + result = await runtime.invoke(input="Check the configured instruction.") + assert result.status == "succeeded", result.to_mapping() + payloads = (await client.get(f"{api_server}/_requests")).json() + system = "\n".join( + message["content"] + for message in payloads[-1]["messages"] + if message["role"] == "system" + ) + prompts.append(system) + marker = native_config.instructions.system.content + for system in prompts: + assert system.count(marker) == 1 + for section in ("## Tooling", "## Tool Call Style", "## Conversation Context"): + assert section in system + assert system.index("## Tooling") < system.index(marker) + (tmp_path / "sdk-prompt-compatibility.json").write_text( + json.dumps(prompts, indent=2) + )