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

# Node sorun giderme

Durumda bir Node görünürken Node araçları başarısız olduğunda bu sayfayı kullanın.

## Komut basamağı

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
```

Ardından Node'a özgü kontrolleri çalıştırın:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
```

Sağlıklı sinyaller:

* Node bağlıdır ve `node` rolü için eşleştirilmiştir.
* `nodes describe`, çağırdığınız yeteneği içerir.
* Exec onayları beklenen modu/izin listesini gösterir.

## Ön plan gereksinimleri

`canvas.*`, `camera.*` ve `screen.*`, iOS/Android Node'larında yalnızca ön planda kullanılabilir.

Hızlı kontrol ve düzeltme:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw nodes describe --node <idOrNameOrIp>
openclaw nodes canvas snapshot --node <idOrNameOrIp>
openclaw logs --follow
```

`NODE_BACKGROUND_UNAVAILABLE` görürseniz Node uygulamasını ön plana getirin ve yeniden deneyin.

## İzinler matrisi

| Yetenek                      | iOS                                     | Android                                       | macOS Node uygulaması              | Tipik hata kodu                |
| ---------------------------- | --------------------------------------- | --------------------------------------------- | ---------------------------------- | ------------------------------ |
| `camera.snap`, `camera.clip` | Kamera (klip sesi için mikrofonla)      | Kamera (klip sesi için mikrofonla)            | Kamera (klip sesi için mikrofonla) | `*_PERMISSION_REQUIRED`        |
| `screen.record`              | Ekran Kaydı (mikrofon isteğe bağlı)     | Ekran yakalama istemi (mikrofon isteğe bağlı) | Ekran Kaydı                        | `*_PERMISSION_REQUIRED`        |
| `location.get`               | Kullanırken veya Her Zaman (moda bağlı) | Moda göre ön plan/arka plan konumu            | Konum izni                         | `LOCATION_PERMISSION_REQUIRED` |
| `system.run`                 | yok (Node host yolu)                    | yok (Node host yolu)                          | Exec onayları gerekir              | `SYSTEM_RUN_DENIED`            |

## Eşleştirme ve onaylar

Bunlar farklı kapılardır:

1. **Cihaz eşleştirme**: Bu Node Gateway'e bağlanabilir mi?
2. **Gateway Node komut ilkesi**: RPC komut kimliğine `gateway.nodes.allowCommands` / `denyCommands` ve platform varsayılanları tarafından izin veriliyor mu?
3. **Exec onayları**: Bu Node belirli bir kabuk komutunu yerel olarak çalıştırabilir mi?

Hızlı kontroller:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw devices list
openclaw nodes status
openclaw approvals get --node <idOrNameOrIp>
openclaw approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"
```

Eşleştirme eksikse önce Node cihazını onaylayın.
`nodes describe` bir komutu göstermiyorsa Gateway Node komut ilkesini ve Node'un bağlanırken gerçekten o komutu bildirip bildirmediğini kontrol edin.
Eşleştirme düzgünse ancak `system.run` başarısız oluyorsa o Node'daki exec onaylarını/izin listesini düzeltin.

Node eşleştirme bir kimlik/güven kapısıdır, komut başına onay yüzeyi değildir. `system.run` için Node başına ilke, Gateway eşleştirme kaydında değil, o Node'un exec onayları dosyasında (`openclaw approvals get --node ...`) bulunur.

Onay destekli `host=node` çalıştırmaları için Gateway ayrıca yürütmeyi
hazırlanmış kanonik `systemRunPlan` değerine bağlar. Daha sonraki bir çağıran,
onaylanan çalıştırma iletilmeden önce komut/cwd veya oturum meta verilerini değiştirirse
Gateway, düzenlenen yükü güvenmek yerine çalıştırmayı onay uyumsuzluğu olarak reddeder.

## Yaygın Node hata kodları

* `NODE_BACKGROUND_UNAVAILABLE` → uygulama arka planda; ön plana getirin.
* `CAMERA_DISABLED` → Node ayarlarında kamera anahtarı devre dışı.
* `*_PERMISSION_REQUIRED` → işletim sistemi izni eksik/reddedilmiş.
* `LOCATION_DISABLED` → konum modu kapalı.
* `LOCATION_PERMISSION_REQUIRED` → istenen konum modu verilmemiş.
* `LOCATION_BACKGROUND_UNAVAILABLE` → uygulama arka planda, ancak yalnızca Kullanırken izni var.
* `SYSTEM_RUN_DENIED: approval required` → exec isteği açık onay gerektiriyor.
* `SYSTEM_RUN_DENIED: allowlist miss` → komut izin listesi modu tarafından engellendi.
  Windows Node host'larında, `cmd.exe /c ...` gibi kabuk sarmalayıcı biçimleri,
  soru akışı üzerinden onaylanmadıkça izin listesi modunda izin listesi kaçırmaları olarak ele alınır.

## Hızlı kurtarma döngüsü

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
openclaw logs --follow
```

Hâlâ takılı kaldıysanız:

* Cihaz eşleştirmesini yeniden onaylayın.
* Node uygulamasını yeniden açın (ön plan).
* İşletim sistemi izinlerini yeniden verin.
* Exec onay ilkesini yeniden oluşturun/ayarlayın.

## İlgili

* [Node'lara genel bakış](/tr/nodes)
* [Kamera Node'ları](/tr/nodes/camera)
* [Konum komutu](/tr/nodes/location-command)
* [Exec onayları](/tr/tools/exec-approvals)
* [Gateway eşleştirme](/tr/gateway/pairing)
* [Gateway sorun giderme](/tr/gateway/troubleshooting)
* [Kanal sorun giderme](/tr/channels/troubleshooting)