Metadata-Version: 2.4
Name: nemo-fabric-adapters-openclaw
Version: 0.7.0
Summary: OpenClaw adapter for NeMo Fabric
Author: NVIDIA Corporation
License-Expression: Apache-2.0
Project-URL: Repository, https://github.com/NVIDIA/NeMo-Fabric
Project-URL: Homepage, https://github.com/NVIDIA/NeMo-Fabric
Project-URL: Issues, https://github.com/NVIDIA/NeMo-Fabric/issues
Project-URL: Documentation, https://docs.nvidia.com/nemo/fabric
Keywords: agents,ai,nemo-fabric,openclaw,runtime,tools
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: nemo-fabric-adapter-contract==0.7.0
Requires-Dist: nemo-fabric-adapters-common==0.7.0
Requires-Dist: httpx[http2]~=0.28
Requires-Dist: websockets~=15.0
Dynamic: license-file

<!--
SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
SPDX-License-Identifier: Apache-2.0
-->

# NVIDIA NeMo Fabric OpenClaw Adapter

[![License](https://img.shields.io/github/license/NVIDIA/NeMo-Fabric)](https://github.com/NVIDIA/NeMo-Fabric/blob/main/LICENSE)
[![GitHub](https://img.shields.io/badge/github-repo-blue?logo=github)](https://github.com/NVIDIA/NeMo-Fabric/)

`nemo-fabric-adapters-openclaw` provides the OpenClaw adapter for NVIDIA NeMo
Fabric. It starts an isolated OpenClaw Gateway and invokes its OpenAI-compatible
Chat Completions endpoint.

Install OpenClaw separately with npm, then install the adapter:

```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]"
```

The adapter supports only OpenClaw's default `openclaw` agent runtime. It does
not install OpenClaw. Relay telemetry is not supported.

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 NeMo Fabric runtimes start with fresh temporary state.
