Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
33 commits
Select commit Hold shift + click to select a range
e3eb9bd
fix: stop agents where group signals are denied
cv Nov 1, 2026
7bb12a1
fix: bound OpenClaw's whole start by one deadline
cv Nov 1, 2026
f638e44
feat: serve OpenClaw's Control UI from managed runtimes
cv Nov 1, 2026
dde1815
test: skip the OpenClaw tests that run the mock script where CI can't
cv Nov 1, 2026
075f8c4
docs: correct OpenClaw's dashboard port and token file claims
cv Nov 2, 2026
e9d3336
test: cover a disabled OpenClaw dashboard and token cleanup after fai…
cv Nov 2, 2026
427a3e3
fix: don't signal a child's PID after it exits
cv Nov 2, 2026
532424e
fix: end OpenClaw's readiness check at the startup deadline
cv Nov 2, 2026
4a6009a
docs: describe OpenClaw's startup deadline
cv Nov 2, 2026
e395dc9
Merge branch 'main' into pr/04-openclaw-control-ui
cv Nov 4, 2026
1b969f9
Merge branch 'main' into pr/04-openclaw-control-ui
cv Nov 5, 2026
838f0bc
fix: retry removing the OpenClaw dashboard token after a failed stop
cv Nov 5, 2026
e3b2537
Merge branch 'main' into pr/04-openclaw-control-ui
cv Nov 6, 2026
13b8724
test: share the OpenClaw dashboard tests' start payload
cv Nov 8, 2026
58b3926
fix: preserve passing native health with unknown activity
AnuradhaKaruppiah Nov 9, 2026
dac140c
feat(openclaw): share configuration across native clients
AnuradhaKaruppiah Nov 9, 2026
015ef45
docs(openclaw): explain and demonstrate four invocation paths
AnuradhaKaruppiah Nov 9, 2026
181e6c2
fix: accept healthy runtimes with unknown activity
AnuradhaKaruppiah Nov 9, 2026
c6c52d4
chore: merge main into OpenClaw shared configuration
AnuradhaKaruppiah Nov 9, 2026
0c5ef0e
chore: incorporate shared health contract prerequisite
AnuradhaKaruppiah Nov 9, 2026
5fba860
chore: refresh OpenClaw on merged shared health contract
AnuradhaKaruppiah Nov 9, 2026
fd3ebe9
docs(openclaw): organize adapter configuration guidance
AnuradhaKaruppiah Nov 10, 2026
c43cb06
docs(openclaw): clarify native API connection setup
AnuradhaKaruppiah Nov 10, 2026
8f696e1
docs(openclaw): clarify default API availability
AnuradhaKaruppiah Nov 10, 2026
0bc4aba
docs(openclaw): show API-only interface configuration
AnuradhaKaruppiah Nov 10, 2026
656b901
docs(openclaw): explain HTTP requests and conversations
AnuradhaKaruppiah Nov 10, 2026
522ee5c
refactor(examples): group native interfaces by harness
AnuradhaKaruppiah Nov 10, 2026
2616ae0
docs(openclaw): clarify terminal setup and usage
AnuradhaKaruppiah Nov 10, 2026
7942b94
fix(openclaw): match canonical agent identities
AnuradhaKaruppiah Nov 10, 2026
e4cc5fa
test: compare health timestamps chronologically
AnuradhaKaruppiah Nov 10, 2026
17c9d16
docs: clarify browser result inspection in another terminal
AnuradhaKaruppiah Nov 10, 2026
9af8ef8
docs: clarify Hermes interface example introduction
AnuradhaKaruppiah Nov 10, 2026
1ea529c
fix(openclaw): verify shared instructions and preserve native guidance
AnuradhaKaruppiah Nov 10, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 12 additions & 2 deletions adapters/python/openclaw/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -104,17 +104,27 @@ 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`, 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. |
| `read_timeout_seconds` | None | Local HTTP response timeout. When unset, the invocation timeout bounds the response. |

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 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.

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.

## Gateway Health

Expand Down
55 changes: 54 additions & 1 deletion adapters/python/openclaw/openclaw.fabric-adapter.json
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,8 @@
"type": "string",
"minLength": 1,
"default": "default",
"description": "OpenClaw agent selected for NeMo Fabric-originated invocations."
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
"description": "OpenClaw agent selected for SDK invocations and managed native clients."
},
"channel_config": {
"type": "object",
Expand Down Expand Up @@ -64,6 +65,55 @@
"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. 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"
],
"additionalProperties": false,
"description": "OpenClaw's Control UI. After the Gateway starts, the adapter writes its sign-in token to <artifact root>/.fabric/openclaw/runtimes/<runtime-id>/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,
"description": "Native interfaces served by a managed runtime. Services reject interfaces."
},
"startup_timeout_seconds": {
"type": "number",
"exclusiveMinimum": 0,
Expand All @@ -89,6 +139,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": {
Expand Down
3 changes: 3 additions & 0 deletions adapters/python/openclaw/pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -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"]

Expand Down
Loading
Loading