Знакът на КАГАМИ КАГАМИ
kagami.bg/academy · lesson · machine-readable viewUPDATED 2026-10-03
IDENTITY
module
GX10-04-32 · NemoClaw: OpenClaw in a sandbox on GX10
series
GX10 (local AI server class: NVIDIA GB10, e.g. ASUS Ascent GX10 / DGX Spark)
level
Intermediate
duration
about 1.5 h
prerequisites
Lesson 04-31 (OpenClaw on GX10); a GB10-class machine with DGX OS, terminal access, internet; Docker (the installer can install it); 8 GB RAM minimum (16 recommended) and 20 GB free disk minimum (40 recommended); Node.js 22.19+ and npm 10+
trust_label
UPDATED 2026-10-03 (against the NVIDIA NemoClaw repository and documentation). NOT TESTED: the installer was not run on a GB10 machine. NemoClaw is an alpha project
versions
Hosted installer follows the last-known-good release; repository package version 0.1.0 (2026-10-03). Apache-2.0
language
human view: bg · english edition: /en/academy/gx10/ (same file name)
previous / next
04-31_OpenClaw_Agent.html / GX10 series index
PURPOSE

Understand NVIDIA NemoClaw, an open-source reference stack that runs agents such as OpenClaw inside NVIDIA OpenShell sandboxes, check its requirements, install it with the hosted installer, complete onboarding, verify the sandbox and reach the dashboard remotely through an SSH tunnel.

KEY CONCEPTS
COMMANDS / PATHS
CHECKLIST
NEXT MODULE

Series index: kagami.bg/academy/gx10/ · previous: 04-31 OpenClaw on GX10 · related series: kagami.bg/academy/openclaw/ (security lesson) · offer: Quick experiment (kagami.bg/stalbata/)

SOURCES
TAGS
gx10nvidia-gb10arm64nemoclawopenshellopenclawsandboxai-agentalpha
ОБНОВЕНО · 03.10.2026

NemoClaw: OpenClaw в пясъчник на GX10

Агент с инструменти трябва да е затворен в клетка, която ти контролираш. NemoClaw е референтен стек с отворен код на NVIDIA, който пуска агенти като OpenClaw в изолирани среди (пясъчници) на OpenShell — с мрежова политика, ключове извън пясъчника и управляван достъп до модела. Тук разбираме как се подрежда и го пускаме на сървър от класа NVIDIA GB10.

⏱ ~1,5 ч Средно GX10 NVIDIA GB10 · Docker · OpenShell ранен (alpha) проект
NemoClaw · OpenShell (пясъчникът)🔒 локално Docker🔒 локално Модел: локален (vLLM или Ollama)🔒 локално Модел: облачен доставчик (по избор)🌐 глобален
🔄
ОБНОВЕНО · 03.10.2026 — какво
Урокът е написан наново. Старата версия описваше „NemoClaw“ като гласово управление на роботизирана ръка: разпознаване на реч, модел за зрение и агент, с обещано забавяне „~800 ms“ и размери на модели. Това не е NemoClaw. По официалното хранилище и документацията на NVIDIA NemoClaw е референтен стек за пускане на агенти (OpenClaw, Hermes, LangChain Deep Agents Code) в пясъчници на OpenShell, с Apache-2.0 лиценз. Затова махнахме гласовия конвейер, кода и числата за забавяне и памет. Добавихме: как се подрежда стекът (OpenClaw · OpenShell · NemoClaw), хардуерни и софтуерни изисквания, инсталатор и съветник, проверка, достъп до таблото и правилата за поддръжка. Гласът в OpenClaw е в отделен урок. Хранилището е с отворен код, но е ранен (alpha) проект — командите и поведението могат да се променят.
⚠️
Какво не сме пускали сами
Нямахме машина от класа GB10 и не сме пускали инсталатора. Всичко по-долу е по официалните страници на NVIDIA от 03.10.2026, затова няма етикет „ТЕСТВАНО“. NVIDIA води „DGX OS (Spark) с Docker“ като тествана платформа; ASUS Ascent GX10 не е назован в таблицата им, а само общият клас GB10 — ⚠️ провери при теб. Не сме проверявали и колко време отнема настройването, нито поведението на конкретен модел.

01Какво ще научиш

02Преди да започнеш

РесурсМинимумПрепоръчано
Процесор4 vCPU4+ vCPU
Памет8 GB16 GB
Диск20 GB свободни40 GB свободни

Източник: изискванията в документацията на NemoClaw, 03.10.2026. Образът на пясъчника е около 2,4 GB в компресиран вид. При под 8 GB памет документацията предупреждава за срив поради липса на памет и препоръчва поне 8 GB swap. Софтуер: Node.js 22.19+, npm 10+, Python 3 и контейнерна среда (по подразбиране Docker). Инсталаторът може сам да инсталира Docker и да те добави към групата docker.

⚠️
Групата docker е като root
Документацията предупреждава: членовете на групата docker управляват демона с права, равни на root. Давай този достъп само на доверени локални акаунти.

03Стъпки

  1. Как се подрежда стекът

    Три отделни проекта, всеки със своя обхват (по страницата „Ecosystem“ в документацията на NemoClaw):

    ПроектКакво е
    OpenClawАсистентът: изпълнение, инструменти, памет, поведение — вътре в контейнера
    OpenShellСредата за изпълнение: живот на пясъчника, мрежова, файлова и процесна политика, насочване на заявките към модела
    NemoClawКомандният ред и планът над тях: настройване, управление на жизнения цикъл, състояние, снимки (snapshots), възстановяване

    Накратко: NemoClaw оркестрира OpenShell, а OpenShell изолира и пуска OpenClaw. Заявките към модела минават през вътрешния адрес inference.local, а ключовете на доставчика остават извън пясъчника — те са у OpenShell. Мрежовият излаз е ограничен от политика; нова връзка се разрешава или отказва от оператор.

    💡
    Пясъчникът не е гаранция
    NVIDIA описва NemoClaw като референтен стек, който пуска агентите „по-безопасно“, не като пълна защита. Проектът е в ранен (alpha) стадий, а поддръжката е „по най-добро усилие“. Пази същите правила като в урока за OpenClaw: само познати хора, одобрение на всяко действие с реален ефект, нищо ценно на първо пускане.
  2. Провери машината

    bash · на машината
    uname -m
    docker --version
    node --version
    free -h
    df -h ~

    Очакваш aarch64, а паметта и дискът да отговарят на таблицата. Ако Docker липсва, инсталаторът ще предложи да го инсталира; ако искаш да го инсталираш сам, направи го преди това по документацията на Docker.

  3. Инсталирай NemoClaw

    Официалният инсталатор се тегли от сайта на NVIDIA. Както при всеки скрипт, пуснат през | bash, добре е да го свалиш и прочетеш първо; документацията дава и този начин за пускане, и версия за автоматизация.

    bash · на машината
    curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash

    Приеми известието за софтуер на трети страни, когато го поиска. На DGX Spark, на подходяща DGX Station и на WSL инсталаторът може да покаже въпроса Run express install with these settings? [Y/n] — отговор с Enter значи препоръчаните настройки за платформата и завършване без повече въпроси. Отговор n води към ръчен избор на агент, доставчик, модел и име на пясъчника. Ако искаш да закрепиш версия, документацията показва променливата NEMOCLAW_INSTALL_TAG (на страната на bash, не пред curl).

  4. Съветникът за настройване

    Съветникът прави предварителни проверки, пуска (или преизползва) шлюза на OpenShell, пита за агент, доставчик на модел и име на пясъчника. За първо пускане документацията съветва:

    • за агент избери OpenClaw (той е по подразбиране);
    • за доставчик — по твой избор: NVIDIA Endpoints, OpenRouter, OpenAI, Anthropic, Google Gemini, съвместим адрес, локален Ollama или управляван модел. Облачните са 🌐 глобален; локалните — 🔒 локално. На DGX Spark, ако не зададеш доставчик при неинтерактивно пускане, се избира локален vLLM автоматично;
    • за име приеми предложеното my-assistant;
    • пропусни по желание търсенето в мрежата и каналите за съобщения (можеш да ги добавиш по-късно, като пуснеш настройването пак и приемеш пресъздаване на пясъчника);
    • приеми предложената политика за мрежата.

    Ако настройването се прекъсне, продължи или започни наново:

    bash
    nemoclaw onboard --resume    # продължава прекъснато настройване
    nemoclaw onboard --fresh     # започва наново
  5. Провери, че пясъчникът е готов

    След обобщението за готовност провери състоянието му. Настройването само проверява връзката на пясъчника, пренасочването на таблото и маршрута inference.local; недостъпен маршрут или грешка HTTP 5xx значи неуспешна проверка — пясъчникът не е готов и настройването излиза с грешка.

    bash
    nemoclaw my-assistant status
  6. Първа заявка

    Адресът на таблото се отпечатва от първата команда; отвори го в браузър. Втората команда стартира текстовия интерфейс на OpenClaw в терминала. Можеш да влезеш и в обвивка на пясъчника и да го пуснеш сам.

    bash
    nemoclaw my-assistant dashboard-url --quiet
    nemoclaw launch my-assistant

    или:

    bash
    nemoclaw my-assistant connect
    openclaw tui

    Първата заявка е безобидна: „Кажи ми с какви инструменти разполагаш.“ След това — задача само за четене. Не давай на агента нещо, което не бива да се губи.

  7. Достъп до таблото от друг компютър

    Адресът на таблото е на самата машина (127.0.0.1) и портът е избран при настройването. От друг компютър стигаш до него през SSH тунел, а не като отваряш порт към мрежата. Документацията за асистирана инсталация изрично казва: за отдалечено табло ползвай частно пренасочване през SSH и третирай адресите с вграден достъп като тайна.

    bash · на твоя компютър
    ssh -L <порт>:127.0.0.1:<порт> <потребител>@<адрес-на-машината>

    Заменяш <порт> с порта от адреса на таблото. ⚠️ Този тунел не сме го пускали с NemoClaw. Допълнително има страница „Deploy to a Headless Server“ в документацията.

  8. Мрежова политика — кой какво може да достига

    По подразбиране пясъчникът има основна мрежова политика. Когато агентът поиска връзка извън нея, оператор я одобрява или отказва; политиката се настройва статично или динамично, а има и готови набори. Правило: отваряй само каквото ти трябва, по една връзка. Пълният ред е в страниците „Network Policies“ и „Customize Network Policy“ на NVIDIA — тук не го повтаряме, за да не остарее.

    ✅
    Две неща не правиш директно
    Документацията съветва: за среди, управлявани от NemoClaw, не пускай openshell self-update, npm update -g openshell и openshell sandbox create. Ползвай nemoclaw onboard; ако смениш OpenShell на ръка, пусни след това nemoclaw onboard пак.
  9. Поддръжка в общи линии

    Инсталаторът третира вече регистрирани пясъчници като обновяване и възстановяване, а не създава нов; преди да смени шлюза, изисква пресно резервно копие на всеки регистриран пясъчник. Страниците „Update Sandboxes“, „Recover and Rebuild Sandboxes“ и „Uninstall NemoClaw“ описват подробно всеки случай. Не сме ги пускали.

04Проверка

Тест

1. Какво е NemoClaw?

2. Къде стоят ключовете на доставчика на модела в този стек?

3. В какъв стадий е проектът NemoClaw по неговото хранилище?

4. Как стигаш до таблото на отдалечена машина?

05Какво следва

06Източници

  1. NVIDIA NemoClaw в GitHub 🌐 глобален — описание, поддържани агенти, Apache-2.0, alpha.
  2. NemoClaw: преглед · екосистема — как се подреждат OpenClaw, OpenShell и NemoClaw.
  3. NemoClaw: изисквания — хардуер, софтуер, таблица на платформите (DGX OS Spark — тествана).
  4. NemoClaw: бърз старт с OpenClaw — инсталатор, съветник, status, launch, connect.
  5. NemoClaw: добри практики за сигурност · NVIDIA Spark: NemoClaw playbook — проверен от NVIDIA път за DGX Spark.
  6. OpenClaw: OpenShell като backend за пясъчник — другият начин: Gateway на машината, инструментите в OpenShell.