> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Nodes

# `openclaw nodes`

Verwalten Sie gekoppelte Nodes (Geräte) und führen Sie Node-Funktionen aus.

Verwandt:

* Nodes-Überblick: [Nodes](/nodes)
* Kamera: [Camera nodes](/nodes/camera)
* Bilder: [Image nodes](/nodes/images)

Häufige Optionen:

* `--url`, `--token`, `--timeout`, `--json`

## Häufige Befehle

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw nodes list
openclaw nodes list --connected
openclaw nodes list --last-connected 24h
openclaw nodes pending
openclaw nodes approve <requestId>
openclaw nodes status
openclaw nodes status --connected
openclaw nodes status --last-connected 24h
```

`nodes list` gibt Tabellen für ausstehende/gekoppelte Nodes aus. Gekoppelte Zeilen enthalten das Alter der letzten Verbindung (Last Connect).
Verwenden Sie `--connected`, um nur aktuell verbundene Nodes anzuzeigen. Verwenden Sie `--last-connected <duration>`, um
auf Nodes zu filtern, die sich innerhalb einer Dauer verbunden haben (z. B. `24h`, `7d`).

## Aufrufen / Ausführen

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw nodes invoke --node <id|name|ip> --command <command> --params <json>
openclaw nodes run --node <id|name|ip> <command...>
openclaw nodes run --raw "git status"
openclaw nodes run --agent main --node <id|name|ip> --raw "git status"
```

Invoke-Flags:

* `--params <json>`: JSON-Objekt-String (Standard `{}`).
* `--invoke-timeout <ms>`: Node-Invoke-Timeout (Standard `15000`).
* `--idempotency-key <key>`: optionaler Idempotenzschlüssel.

### Exec-ähnliche Standardwerte

`nodes run` spiegelt das Exec-Verhalten des Modells wider (Standards + Genehmigungen):

* Liest `tools.exec.*` (plus `agents.list[].tools.exec.*`-Überschreibungen).
* Verwendet Exec-Genehmigungen (`exec.approval.request`) vor dem Aufruf von `system.run`.
* `--node` kann weggelassen werden, wenn `tools.exec.node` gesetzt ist.
* Erfordert einen Node, der `system.run` bewirbt (macOS-Companion-App oder headless Node-Host).

Flags:

* `--cwd <path>`: Arbeitsverzeichnis.
* `--env <key=val>`: Env-Override (wiederholbar). Hinweis: Node-Hosts ignorieren `PATH`-Überschreibungen (und `tools.exec.pathPrepend` wird auf Node-Hosts nicht angewendet).
* `--command-timeout <ms>`: Befehls-Timeout.
* `--invoke-timeout <ms>`: Node-Invoke-Timeout (Standard `30000`).
* `--needs-screen-recording`: Bildschirmaufnahmeberechtigung erforderlich.
* `--raw <command>`: eine Shell-Zeichenkette ausführen (`/bin/sh -lc` oder `cmd.exe /c`).
* `--agent <id>`: agentenbezogene Genehmigungen/Allowlists (Standard: konfigurierter Agent).
* `--ask <off|on-miss|always>`, `--security <deny|allowlist|full>`: Überschreibungen.
