Skip to content
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
64 commits
Select commit Hold shift + click to select a range
14e32af
feat(network): support trusted private endpoints
ericksoa Aug 5, 2026
5f90e35
fix(policy): preserve sequential directory apply
ericksoa Aug 5, 2026
c9d7fd2
fix(security): address trusted endpoint review
ericksoa Aug 5, 2026
522c5cb
Merge remote-tracking branch 'origin/main' into feat/trusted-private-mcp
ericksoa Aug 5, 2026
6cc9226
fix(shields): admit recorded private MCP pins
ericksoa Aug 5, 2026
440705d
fix(security): reject mixed trusted policy answers
ericksoa Aug 5, 2026
d1006cb
test(shields): bind restore runner mock
ericksoa Aug 5, 2026
124fffa
merge: resolve conflicts with main
github-actions[bot] Aug 5, 2026
ea10bf2
ci: refresh exact-head validation gates
ericksoa Aug 5, 2026
96a26ac
fix(security): reject mixed inference DNS answers
ericksoa Aug 5, 2026
cb9780b
fix(security): preserve mixed-answer diagnostic
ericksoa Aug 5, 2026
f30d76c
test(e2e): prove trusted-private MCP rebinding
ericksoa Aug 5, 2026
8072597
Merge remote-tracking branch 'origin/main' into feat/trusted-private-mcp
ericksoa Aug 5, 2026
e24a3cf
test(e2e): keep live MCP test linear
ericksoa Aug 5, 2026
39c235b
fix(mcp): trust private endpoint CAs in proxy
ericksoa Aug 5, 2026
a36d289
docs(mcp): explain private endpoint CA trust
ericksoa Aug 5, 2026
de9235e
merge: resolve conflicts with main
github-actions[bot] Aug 5, 2026
c0ecd8b
test(mcp): accept rejected public drift details
ericksoa Aug 5, 2026
aa16bee
merge: resolve conflicts with main
github-actions[bot] Aug 5, 2026
6d319be
chore(ci): validate merged main
ericksoa Aug 5, 2026
affd931
merge: sync main
ericksoa Aug 5, 2026
605fe3f
chore(architecture): lower merged main budgets
ericksoa Aug 5, 2026
2078d41
Merge remote-tracking branch 'origin/main' into feat/trusted-private-mcp
ericksoa Aug 5, 2026
1211a42
chore(ci): retry hosted E2E port collision
ericksoa Aug 5, 2026
565a212
Merge remote-tracking branch 'origin/main' into feat/trusted-private-mcp
ericksoa Aug 5, 2026
714131e
fix(ci): restore complete CLI build artifact
ericksoa Aug 5, 2026
faeb93c
ci(e2e): pin complete CLI artifact restore
ericksoa Aug 5, 2026
8998ef1
test(ci): keep artifact fixtures branchless
ericksoa Aug 5, 2026
f138384
merge: resolve conflicts with main
github-actions[bot] Aug 5, 2026
6f1f960
Merge remote-tracking branch 'origin/main' into feat/trusted-private-mcp
ericksoa Aug 5, 2026
5b2a9bb
test(snapshot): align private restore expectation
ericksoa Aug 5, 2026
dc342e6
merge: resolve conflicts with main
github-actions[bot] Aug 5, 2026
3db5944
Merge remote-tracking branch 'origin/main' into feat/trusted-private-mcp
ericksoa Aug 5, 2026
70a0a0d
merge: resolve conflicts with main
github-actions[bot] Aug 5, 2026
601a856
merge: synchronize trusted private MCP with main
ericksoa Aug 5, 2026
9998eda
fix(hermes): recheck post-restore gateway health
ericksoa Aug 5, 2026
5ee988d
test(hermes): accept flattened cron state
ericksoa Aug 5, 2026
7a7160a
test(hermes): preserve cron receipt redaction
ericksoa Aug 5, 2026
5a5bb70
test(hermes): exercise scheduled cron drain
ericksoa Aug 5, 2026
2b95154
fix(hermes): stabilize scheduler and integrity probes
ericksoa Aug 5, 2026
613f933
test(hermes): tolerate restart pid gap
ericksoa Aug 5, 2026
57f1828
Merge remote-tracking branch 'origin/main' into feat/trusted-private-mcp
ericksoa Aug 5, 2026
9e4c7f3
Merge remote-tracking branch 'origin/main' into feat/trusted-private-mcp
ericksoa Aug 5, 2026
60b058b
Merge remote-tracking branch 'origin/main' into feat/trusted-private-mcp
ericksoa Aug 5, 2026
01e8976
merge: resolve conflicts with main
github-actions[bot] Aug 5, 2026
ac87bce
Merge remote-tracking branch 'origin/main' into feat/trusted-private-mcp
ericksoa Aug 5, 2026
82e5131
fix(hermes): recover raced MCP apply snapshot
ericksoa Aug 5, 2026
f28ac2b
fix(mcp): retry provider detach conflicts
ericksoa Aug 5, 2026
59476e2
fix(ci): scale PR E2E evidence budget
ericksoa Aug 6, 2026
0e4e246
Merge remote-tracking branch 'origin/main' into feat/trusted-private-mcp
ericksoa Aug 6, 2026
c8132c0
Merge remote-tracking branch 'origin/main' into feat/trusted-private-mcp
ericksoa Aug 6, 2026
4c881ae
Merge remote-tracking branch 'origin/main' into feat/trusted-private-mcp
ericksoa Aug 6, 2026
f8cf0f7
fix(ci): compact successful E2E evidence
ericksoa Aug 6, 2026
7d19939
Merge remote-tracking branch 'origin/main' into feat/trusted-private-mcp
ericksoa Aug 6, 2026
56907fc
Merge remote-tracking branch 'origin/main' into feat/trusted-private-mcp
ericksoa Aug 6, 2026
6fe3590
Merge remote-tracking branch 'origin/main' into feat/trusted-private-mcp
ericksoa Aug 6, 2026
442630d
Merge remote-tracking branch 'origin/main' into feat/trusted-private-mcp
ericksoa Aug 6, 2026
6f26510
fix(inference): reconcile serving resolver changes
ericksoa Aug 6, 2026
5daa043
Merge remote-tracking branch 'origin/main' into feat/trusted-private-mcp
ericksoa Aug 6, 2026
00fbb3b
merge: resolve conflicts with main
github-actions[bot] Aug 6, 2026
66bfa77
merge: resolve conflicts with main
github-actions[bot] Aug 6, 2026
1be4214
merge: resolve conflicts with main
github-actions[bot] Aug 6, 2026
cd31190
fix(ci): remove obsolete PR gate evidence code
ericksoa Aug 6, 2026
ec2e203
Merge remote-tracking branch 'origin/main' into feat/trusted-private-mcp
ericksoa Aug 6, 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
6 changes: 5 additions & 1 deletion docs/inference/custom-endpoint-security.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -33,10 +33,14 @@ It also rejects public hostnames that resolve to a private address.
Managed provider defaults that do not provide an explicit custom endpoint through these paths are unaffected.

Custom endpoint onboarding has one narrower operator-controlled exception for corporate inference gateways.
Set `NEMOCLAW_TRUSTED_PRIVATE_INFERENCE_HOSTS` to a comma-separated list of exact hostnames or IP literals to admit an endpoint on RFC1918, CGNAT, or IPv6 ULA space.
Set `NEMOCLAW_TRUSTED_PRIVATE_HOSTS` to a comma-separated list of exact hostnames or IP literals to admit an endpoint on RFC1918, carrier-grade network address translation (CGNAT), or IPv6 unique local address space.
NemoClaw still resolves DNS, pins the validation connection, and rejects wildcard or suffix matches, link-local metadata, reserved destinations, and resolver failures.
This allowlist does not relax direct blueprint, `config set`, or unrelated persisted-URL validation.

`NEMOCLAW_TRUSTED_PRIVATE_INFERENCE_HOSTS` remains an inference-only compatibility alias.
Inference onboarding combines exact entries from the generic variable and the compatibility alias.
New configurations should use `NEMOCLAW_TRUSTED_PRIVATE_HOSTS`.

After onboarding records an admitted custom endpoint, `inference set` accepts that same canonical URL for a model change without resolving it again.
The registry must record onboarding as the endpoint source, and the supplied URL must match exactly after normalization.
Legacy entries without a source, endpoints recorded by `inference set`, and different URLs still pass through the full server-side request forgery validation path.
Expand Down
7 changes: 4 additions & 3 deletions docs/inference/set-up-openai-compatible-endpoint.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -123,7 +123,8 @@ NEMOCLAW_PROVIDER=custom \
| `NEMOCLAW_MODEL` | Model ID reported by the server. |
| `NEMOCLAW_COMPATIBLE_AUTH_MODE` | Set to `none` to explicitly select no authentication for an HTTP endpoint using `localhost`, `127.0.0.1`, or `[::1]` and port `8000`, `11434`, or `11435`. |
| `NEMOCLAW_REASONING` | Enables reasoning-only validation with the case-insensitive true values `true`, `1`, `yes`, and `y`. |
| `NEMOCLAW_TRUSTED_PRIVATE_INFERENCE_HOSTS` | Optional comma-separated exact hostnames or IP literals for operator-owned private inference endpoints. Wildcards are not supported. |
| `NEMOCLAW_TRUSTED_PRIVATE_HOSTS` | Optional comma-separated exact hostnames or IP literals for operator-owned private endpoints. Wildcards are not supported. |
| `NEMOCLAW_TRUSTED_PRIVATE_INFERENCE_HOSTS` | Inference-only compatibility alias for `NEMOCLAW_TRUSTED_PRIVATE_HOSTS`. Inference onboarding combines entries from both variables. |
| `COMPATIBLE_API_KEY` | Endpoint API key. Required unless loopback no-auth mode is selected. |

<AgentOnly variant="openclaw">
Expand All @@ -141,7 +142,7 @@ Private and reserved addresses are blocked by default.
To use an inference gateway on a trusted corporate network, list only its exact host and keep the endpoint URL on that host:

```bash
NEMOCLAW_TRUSTED_PRIVATE_INFERENCE_HOSTS=llm.corp.example \
NEMOCLAW_TRUSTED_PRIVATE_HOSTS=llm.corp.example \
NEMOCLAW_PROVIDER=custom \
NEMOCLAW_ENDPOINT_URL=https://llm.corp.example/v1 \
NEMOCLAW_MODEL=your-model \
Expand All @@ -150,7 +151,7 @@ NEMOCLAW_TRUSTED_PRIVATE_INFERENCE_HOSTS=llm.corp.example \
```

NemoClaw still resolves the host before probing and pins the probe to the resolved address.
Only RFC1918, CGNAT, and IPv6 ULA destinations can be admitted; link-local metadata and other reserved ranges remain blocked.
Only RFC1918, carrier-grade network address translation (CGNAT), and IPv6 unique local address (ULA) destinations can be admitted; link-local metadata and other reserved ranges remain blocked.
An unlisted private host, a hostname suffix match, or a DNS failure also remains blocked.

## Related Topics
Expand Down
86 changes: 81 additions & 5 deletions docs/manage-sandboxes/add-mcp-server.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@
# SPDX-License-Identifier: Apache-2.0
title: "Add an MCP Server"
sidebar-title: "Add an MCP Server"
description: "Register an authenticated Streamable HTTP MCP server with a NemoClaw sandbox."
description-agent: "Explains mcp add inputs, credential-name restrictions, URL and DNS validation, policy pinning, and agent capability checks. Use when adding a managed MCP server."
keywords: ["nemoclaw mcp add", "streamable http mcp", "mcp bearer credential"]
description: "Register an authenticated public or trusted private Streamable HTTP MCP server with a NemoClaw sandbox."
description-agent: "Explains mcp add inputs, trusted private endpoints, credential-name restrictions, URL and DNS validation, policy pinning, and agent capability checks. Use when adding a managed MCP server."
keywords: ["nemoclaw mcp add", "streamable http mcp", "mcp bearer credential", "trusted private mcp"]
content:
type: "how_to"
skill:
Expand Down Expand Up @@ -48,6 +48,74 @@ NemoClaw persists only the variable name, writes `openshell:resolve:env:KEY` int
After `mcp add` commits, NemoClaw performs a fresh status inspection and runs the gated credential-resolution probe once unless you pass `--no-probe`.
If readiness is inconclusive, the command reports a probe skip without failing the committed add.

## Add a Trusted Private Server

Use an exact trusted private host when the MCP endpoint must remain on an operator-controlled private network.
This flow is the same for OpenClaw, Hermes, and Deep Agents Code.

Before registration, configure an HTTPS endpoint that meets these requirements:

- The endpoint hostname resolves to stable RFC1918, carrier-grade network address translation (CGNAT), or IPv6 unique local addresses, or the URL uses one exact private IPv4 literal.
- The OpenShell gateway can route to every resolved address.
- The Transport Layer Security (TLS) certificate matches the endpoint hostname and chains to a trust root available to the managed runtime.
- A host firewall limits the listener to the OpenShell gateway or the required deployment subnet.
- The endpoint exposes only the required MCP path and methods.

For a host-local MCP process, keep the process bound to loopback when practical.
Place an operator-managed HTTPS reverse proxy on one stable, routed private address.
Bind the proxy to the exact private interface instead of every host interface.
NemoClaw preserves the URL hostname for TLS Server Name Indication and certificate validation.
A direct private IPv4 URL requires a certificate with the matching IP subject alternative name.
Use a DNS hostname for an IPv6 unique local address.
OpenShell `v0.0.85` cannot safely represent a direct IPv6 literal as a proxy target, so NemoClaw rejects that URL form.

Direct `127.0.0.1`, `::1`, and hostnames that resolve to loopback remain rejected.
Sandbox loopback is not the host service, and trusted-private admission does not create a route to it.

<Warning>
The `--trusted-private-host` option and `NEMOCLAW_TRUSTED_PRIVATE_HOSTS` admit private network access to the matching exact host for this registration.
Confirm that you operate the endpoint and its network before you run the command.
</Warning>

Export one dedicated bearer credential, then register the endpoint with its exact URL hostname:

```bash
export LOCAL_MCP_TOKEN='replace-with-secret-manager-value'
$$nemoclaw my-sandbox mcp add local-tools \
--url https://mcp-host.corp.example/mcp \
--env LOCAL_MCP_TOKEN \
--trusted-private-host mcp-host.corp.example
unset LOCAL_MCP_TOKEN
```

The declaration must equal the normalized host from `--url`.
NemoClaw rejects unused, unrelated, wildcard, suffix, CIDR, URL-shaped, duplicate, or malformed `--trusted-private-host` declarations before mutation.
It also rejects a hostname when any answer is outside the admitted private ranges or otherwise disallowed.

As an alternative, set `NEMOCLAW_TRUSTED_PRIVATE_HOSTS` to a comma-separated list of exact hosts for the current command.
NemoClaw combines the environment list with any `--trusted-private-host` options.
It normalizes and deduplicates environment entries, ignores entries unrelated to this URL, and persists only the matching private host.
The command records the resulting exact trust intent, so later lifecycle commands do not depend on the ambient environment.

NemoClaw records the normalized trust intent and every validated address as exact policy pins.
The raw bearer value passes transiently to the OpenShell provider and remains absent from NemoClaw state, sandbox configuration, command arguments, and logs.
The sandbox configuration contains only the `openshell:resolve:env:LOCAL_MCP_TOKEN` credential placeholder.
You can unset the host variable after `mcp add` returns because OpenShell retains the credential.
An exported replacement updates it during restart, and `mcp remove` or sandbox destroy deletes the registry-owned provider.

Inspect the registration after the add returns:

```bash
$$nemoclaw my-sandbox mcp status local-tools --json
```

The JSON field `trustedPrivateTarget.state` must report `match`.
The ordinary provider, policy, and adapter checks must also report readiness.

<Note>
NemoClaw does not start, configure, monitor, or retain the reverse proxy, MCP process, certificate, DNS record, or host firewall state.
</Note>

## Choose a Dedicated Credential Name

Do not reuse OpenShell Google Cloud compatibility names such as `GCP_PROJECT_ID`, `GOOGLE_CLOUD_PROJECT`, `CLOUD_ML_REGION`, `GCP_LOCATION`, `GCP_SERVICE_ACCOUNT_EMAIL`, `GOOSE_PROVIDER`, `ANTHROPIC_VERTEX_PROJECT_ID`, or `VERTEX_LOCATION`.
Expand Down Expand Up @@ -84,14 +152,22 @@ Deep Agents Code supports at most 64 managed MCP servers in one sandbox.
Endpoint paths cannot contain percent escapes, backslashes, semicolons, or OpenShell glob metacharacters.
Endpoint URLs cannot use port `0`.

NemoClaw resolves public hostnames before registration, rejects private, local, and special-use targets, and pins the resolved addresses in the generated policy.
NemoClaw resolves hostnames before registration and pins the validated addresses in the generated policy.
Public endpoints need no trusted-private declaration.
Private endpoints require an exact trust declaration and can use only RFC1918, CGNAT, or IPv6 unique local addresses.
Supply the declaration with `--trusted-private-host` or the generic `NEMOCLAW_TRUSTED_PRIVATE_HOSTS` environment variable.
NemoClaw continues to reject loopback, link-local, metadata, unspecified, multicast, documentation, translation, benchmarking, and other reserved ranges.
OpenShell re-resolves the hostname for each new connection, requires every current answer to match the pinned `allowed_ips`, and connects to the validated socket addresses.

A DNS change to a private, special-use, or otherwise unpinned address fails closed instead of widening the route.

Cloudflare Quick Tunnels and other endpoints with rotating address sets are not durable managed MCP deployments.
A named tunnel can stabilize the hostname without stabilizing its exact address set.
Use stable private DNS and a routed private HTTPS endpoint when you operate the MCP server locally.

Authenticated MCP rejects `host.openshell.internal`, `host.docker.internal`, and `host.containers.internal` on stable OpenShell `v0.0.85`.
That release has a trusted-gateway branch for one narrow link-local topology, but it does not expose an attested driver gateway address that NemoClaw can pin.
Use a normal HTTPS DNS endpoint with public address records until OpenShell exposes attested gateway state for exact policy pinning.
Use a routed HTTPS endpoint on a stable private address instead.

## Understand the Generated Method Profile

Expand Down
37 changes: 33 additions & 4 deletions docs/manage-sandboxes/manage-mcp-servers.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@
# SPDX-License-Identifier: Apache-2.0
title: "Manage MCP Servers"
sidebar-title: "Manage MCP Servers"
description: "Inspect advertised tools, probe, rotate, restart, remove, rebuild, and destroy NemoClaw-managed MCP servers."
description-agent: "Explains managed MCP status, advertised tool discovery, credential-resolution probes, credential rotation, restart, removal, rebuild restoration, destroy recovery, and lifecycle locking. Use after an MCP server is registered."
keywords: ["nemoclaw mcp status", "mcp tool discovery", "nemoclaw mcp restart", "nemoclaw mcp remove", "mcp credential rotation"]
description: "Inspect advertised tools and DNS pins, probe, rotate, restart, remove, rebuild, and destroy NemoClaw-managed MCP servers."
description-agent: "Explains managed MCP status, DNS pin drift, advertised tool discovery, credential-resolution probes, credential rotation, restart, removal, rebuild restoration, destroy recovery, and lifecycle locking. Use after an MCP server is registered."
keywords: ["nemoclaw mcp status", "mcp dns pin drift", "mcp tool discovery", "nemoclaw mcp restart", "nemoclaw mcp remove", "mcp credential rotation"]
content:
type: "how_to"
skill:
Expand All @@ -29,6 +29,11 @@ The `env.missing` field lists recorded host variable names that are currently un
An existing valid provider can remain ready when a host variable is unset because OpenShell retains the credential.
The JSON value `support.mode: "bridge"` identifies the agent's config-adapter capability, not a host-side traffic bridge.

For a trusted private server, status resolves the endpoint without changing managed state.
Text output reports `private address pins: match`, `drift`, or `unresolved`.
JSON output reports the same value in `trustedPrivateTarget.state` and includes the recorded pins.
Status never adds a new address to the policy.

## Discover Advertised Tools

Pass `--tools` with one server name to request the server's advertised tool names:
Expand Down Expand Up @@ -119,7 +124,9 @@ unset GITHUB_MCP_TOKEN
`restart` requires a successful provider update, waits until the sandbox receives a new opaque provider revision, reapplies policy, and refreshes the adapter.
An ambiguous or failed update is not treated as successful merely because another writer advanced the provider revision.

Restart resolves the endpoint hostname again before updating its pinned network policy.
For a trusted-private entry, restart replays the exact address pins recorded by `mcp add`.
It does not resolve that endpoint again or widen its policy from ambient DNS.
For a public entry, restart resolves the hostname again and refreshes the generated policy with the current validated public addresses.

The raw value passes only through the OpenShell provider command's process environment and is not added to argv, NemoClaw state, or sandbox config.
Revoke the old credential upstream after restart succeeds.
Expand All @@ -132,6 +139,26 @@ If the provider is missing, export the recorded variable before retrying.
Running restart without a server name refreshes every managed server.
Export only the variables whose credentials you intend to replace.

## Change Endpoint Pins

For a trusted-private server, review every destination change before NemoClaw records new pins.
Neither status, restart, rebuild, nor restore changes the recorded address set.

If the endpoint moves to another address, remove and re-add the server:

```bash
export LOCAL_MCP_TOKEN='replace-with-secret-manager-value'
$$nemoclaw my-sandbox mcp remove local-tools
$$nemoclaw my-sandbox mcp add local-tools \
--url https://mcp-host.corp.example/mcp \
--env LOCAL_MCP_TOKEN \
--trusted-private-host mcp-host.corp.example
unset LOCAL_MCP_TOKEN
```

Removing the server deletes the registry-owned provider, policy, and adapter state after the existing ownership checks pass.
The re-add performs a new DNS preflight and records the reviewed exact address set.

## Remove a Server

```bash
Expand All @@ -154,6 +181,8 @@ It never detaches the provider from other sandboxes.

`rebuild` preserves providers that match the recorded ID, type, and credential-key metadata.
It removes adapter entries and detaches providers before replacing the sandbox, then reattaches providers, waits for credential readiness, reapplies policy, and restores adapters.
For a trusted-private entry, the restored policy uses the recorded exact address pins and does not widen them from current DNS answers.
Public entries continue to resolve and validate their endpoint addresses during restoration.

<AgentOnly variant="deepagents">
NemoClaw revalidates the prepared Deep Agents replacement after MCP preparation and before stopping inference or deleting the old sandbox.
Expand Down
37 changes: 37 additions & 0 deletions docs/network-policy/create-custom-policy-presets.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,43 @@ NemoClaw rejects that field in files passed through `--from-file` or `--from-dir
Use hostnames, ports, protocols, methods, paths, and binary restrictions instead.
The only exception is the `host.openshell.internal` bridge endpoint for explicit sandbox-to-host service access.

## Admit an Exact Private Host

Use explicit private-host trust when a custom preset targets an operator-controlled endpoint on RFC1918, carrier-grade network address translation (CGNAT), or IPv6 unique local address space.
This flow applies to REST, WebSocket, JSON-RPC, and MCP endpoint protocols.

<Warning>
The `--trusted-private-host` option and `NEMOCLAW_TRUSTED_PRIVATE_HOSTS` grant the custom preset access to each matching exact private host.
Review the preset, resolved addresses, requesting binaries, methods, and paths before you apply it.
</Warning>

Pass the exact endpoint host with `--from-file` or `--from-dir`:

```bash
$$nemoclaw my-assistant policy add \
--from-file ./presets/my-internal-api.yaml \
--trusted-private-host api.corp.example \
--dry-run
```

The option is invalid for a built-in preset because maintained presets own their reviewed destinations.
NemoClaw rejects unused, unrelated, wildcard, suffix, CIDR, URL-shaped, duplicate, or malformed `--trusted-private-host` declarations.
It also rejects loopback, link-local, metadata, unspecified, multicast, documentation, translation, benchmarking, and other reserved ranges.

As an alternative, set `NEMOCLAW_TRUSTED_PRIVATE_HOSTS` to a comma-separated list of exact hosts for the current command.
NemoClaw combines the environment list with any `--trusted-private-host` options.
It normalizes and deduplicates environment entries and ignores entries unrelated to the custom preset batch.

After schema validation, NemoClaw resolves each declared endpoint and inserts every validated address as an exact `allowed_ips` value in memory.
The dry-run output shows the generated pins for review.
NemoClaw applies and records the transformed preset instead of the unpinned source file.
Rebuild replays recorded pins from the sandbox registry without depending on the ambient environment.
A snapshot does not grant private-host authority to a clean target by itself; reapply the source preset with explicit trust after a cross-sandbox restore.

To change a recorded address set, apply the source preset again with explicit trust.
NemoClaw performs a new preflight and shows the changed pins before it applies them.
Do not add `allowed_ips` to the source YAML.

## Apply a Single File

Preview the file before you apply it:
Expand Down
Loading
Loading