---
read_when:
    - Sesli uyandırma ifadelerinin davranışını veya varsayılanlarını değiştirme
    - Uyandırma kelimesi senkronizasyonu gerektiren yeni Node platformları ekleme
summary: Küresel sesli uyandırma sözcükleri (Gateway tarafından yönetilir) ve bunların düğümler arasında nasıl senkronize olduğu
title: Sesle uyandırma
x-i18n:
    generated_at: "2026-05-06T09:21:06Z"
    model: gpt-5.5
    provider: openai
    source_hash: a284cbe3e12784a8d7a3eab6ba8ae230123557bca7593c956111199b94b91b73
    source_path: nodes/voicewake.md
    workflow: 16
---

OpenClaw, **uyandırma sözcüklerini Gateway’in sahibi olduğu tek bir genel liste** olarak ele alır.

- **Düğüm başına özel uyandırma sözcükleri yoktur**.
- **Herhangi bir düğüm/uygulama kullanıcı arayüzü listeyi düzenleyebilir**; değişiklikler Gateway tarafından kalıcı hale getirilir ve herkese yayınlanır.
- macOS ve iOS yerel **Sesle Uyandırma etkin/devre dışı** anahtarlarını korur (yerel kullanıcı deneyimi + izinler farklıdır).
- Android şu anda Sesle Uyandırma’yı kapalı tutar ve Ses sekmesinde manuel mikrofon akışı kullanır.

## Depolama (Gateway ana makinesi)

Uyandırma sözcükleri gateway makinesinde şurada saklanır:

- `~/.openclaw/settings/voicewake.json`

Biçim:

```json
{ "triggers": ["openclaw", "claude", "computer"], "updatedAtMs": 1730000000000 }
```

## Protokol

### Yöntemler

- `voicewake.get` → `{ triggers: string[] }`
- `{ triggers: string[] }` parametreleriyle `voicewake.set` → `{ triggers: string[] }`

Notlar:

- Tetikleyiciler normalleştirilir (baştaki/sondaki boşluklar kırpılır, boş değerler atılır). Boş listeler varsayılanlara geri döner.
- Güvenlik için sınırlar uygulanır (sayı/uzunluk üst sınırları).

### Yönlendirme yöntemleri (tetikleyici → hedef)

- `voicewake.routing.get` → `{ config: VoiceWakeRoutingConfig }`
- `{ config: VoiceWakeRoutingConfig }` parametreleriyle `voicewake.routing.set` → `{ config: VoiceWakeRoutingConfig }`

`VoiceWakeRoutingConfig` biçimi:

```json
{
  "version": 1,
  "defaultTarget": { "mode": "current" },
  "routes": [{ "trigger": "robot wake", "target": { "sessionKey": "agent:main:main" } }],
  "updatedAtMs": 1730000000000
}
```

Rota hedefleri tam olarak şunlardan birini destekler:

- `{ "mode": "current" }`
- `{ "agentId": "main" }`
- `{ "sessionKey": "agent:main:main" }`

### Olaylar

- `voicewake.changed` yükü `{ triggers: string[] }`
- `voicewake.routing.changed` yükü `{ config: VoiceWakeRoutingConfig }`

Bunu kim alır:

- Tüm WebSocket istemcileri (macOS uygulaması, WebChat vb.)
- Tüm bağlı düğümler (iOS/Android) ve ayrıca düğüm bağlandığında ilk “geçerli durum” gönderimi olarak.

## İstemci davranışı

### macOS uygulaması

- `VoiceWakeRuntime` tetikleyicilerini denetlemek için genel listeyi kullanır.
- Sesle Uyandırma ayarlarında “Tetikleyici sözcükler”i düzenlemek `voicewake.set` çağrısı yapar ve ardından diğer istemcileri eşitlenmiş halde tutmak için yayına güvenir.

### iOS düğümü

- `VoiceWakeManager` tetikleyici algılaması için genel listeyi kullanır.
- Ayarlar’da Uyandırma Sözcükleri’ni düzenlemek `voicewake.set` çağrısı yapar (Gateway WS üzerinden) ve ayrıca yerel uyandırma sözcüğü algılamasını duyarlı tutar.

### Android düğümü

- Sesle Uyandırma şu anda Android çalışma zamanı/Ayarlar’da devre dışıdır.
- Android sesi, uyandırma sözcüğü tetikleyicileri yerine Ses sekmesinde manuel mikrofon yakalama kullanır.

## İlgili

- [Konuşma modu](/tr/nodes/talk)
- [Ses ve sesli notlar](/tr/nodes/audio)
- [Medya anlama](/tr/nodes/media-understanding)