## Fehlerbehebung

---

### Häufige Fehler

---

#### Kein Profil konfiguriert

```
Error: No profile configured. Run 'rbw config create-profile' first.
```

**Lösung**: Erstellen Sie ein Profil mit:

```bash
rbw config create-profile
```

#### Authentifizierungsfehler (401)

```
Error: 401 Unauthorized
```

**Mögliche Ursachen**:
- Abgelaufene oder falsche Zugangsdaten
- Gesperrter API-Schlüssel
- Abgelaufenes OAuth-Token

**Lösungen**:
- Zugangsdaten prüfen: `rbw config show-profile`
- Profil aktualisieren: `rbw config update-profile <name>`
- Für OAUTH: Anmeldevorgang erneut durchführen

#### Modul nicht gefunden (ERR_MODULE_NOT_FOUND)

```
Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'xyz'
```

**Lösung**: Paket neu installieren:

```bash
npm install -g rainbow-cli-ng
```

#### Schlüsselbund nicht zugänglich

Auf manchen Linux-Systemen ohne grafische Sitzung (CI-Server, Docker-Container) ist der System-Schlüsselbund möglicherweise nicht verfügbar.

**Lösung**: Headless-Schlüsselbund konfigurieren oder `gnome-keyring` mit D-Bus verwenden:

```bash
eval $(gnome-keyring-daemon --start)
export GNOME_KEYRING_CONTROL
```

#### Zugriff verweigert für rbw-Befehl

```
permission denied: rbw
```

**Lösung**: Prüfen Sie, ob das globale npm-bin-Verzeichnis in Ihrem `PATH` enthalten ist:

```bash
npm config get prefix
# <prefix>/bin zum PATH hinzufügen falls nötig
```

### Debugging

---

#### Detaillierte Protokolle aktivieren

```bash
rbw --debug <befehl>
rbw --verbose <befehl>
```

Die Option `--debug` zeigt HTTP-Anfragen, Authentifizierungsheader (maskiert) und vollständige Antworten an.

#### Protokolle in eine Datei schreiben

```bash
rbw --log debug.log <befehl>
```

Nützlich zur Analyse von Problemen in Produktionsumgebungen, ohne die Konsole zu überfüllen.

#### Installierte Version prüfen

```bash
rbw --version
```

### Hilfe erhalten

---

- Integrierte Hilfe: `rbw --help` oder `rbw <befehl> --help`
- Online-Dokumentation: [developers.openrainbow.com](https://developers.openrainbow.com)
- Rainbow-Support: [support@openrainbow.com](mailto:support@openrainbow.com)
