chore(i18n): refresh tr translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
52b3f49d42
commit
ed778887e2
@ -1,51 +1,52 @@
|
||||
---
|
||||
read_when:
|
||||
- Bir OpenClaw ajanının Google Meet çağrısına katılmasını istiyorsunuz
|
||||
- Google Meet taşıması olarak Chrome, Chrome node veya Twilio yapılandırıyorsunuz
|
||||
summary: 'Google Meet Plugin: Chrome veya Twilio üzerinden açık Meet URL''lerine katılma; varsayılan olarak gerçek zamanlı ses ayarlarıyla'
|
||||
title: Google Meet Plugin
|
||||
- Bir OpenClaw agentinin bir Google Meet görüşmesine katılmasını istiyorsunuz
|
||||
- Google Meet aktarımı olarak Chrome, Chrome node veya Twilio yapılandırıyorsunuz
|
||||
summary: 'Google Meet Plugin''i: gerçek zamanlı ses varsayılanlarıyla belirli Meet URL''lerine Chrome veya Twilio üzerinden katılın'
|
||||
title: Google Meet Plugin'i
|
||||
x-i18n:
|
||||
generated_at: "2026-04-24T09:21:19Z"
|
||||
generated_at: "2026-04-24T10:25:42Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 8d430a1f2d6ee7fc1d997ef388a2e0d2915a6475480343e7060edac799dfc027
|
||||
source_hash: f1673ac4adc9cf163194a340dd6e451d0e4d28bb62adeb126898298e62106d43
|
||||
source_path: plugins/google-meet.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Google Meet (Plugin)
|
||||
|
||||
Google Meet katılımcı desteği OpenClaw için.
|
||||
OpenClaw için Google Meet katılımcı desteği.
|
||||
|
||||
Plugin tasarım gereği açık davranır:
|
||||
Plugin tasarım gereği açık bir yapıya sahiptir:
|
||||
|
||||
- Yalnızca açık bir `https://meet.google.com/...` URL'sine katılır.
|
||||
- `realtime` ses, varsayılan moddur.
|
||||
- Gerçek zamanlı ses, daha derin akıl yürütme veya araçlar gerektiğinde tam OpenClaw ajanına geri çağrı yapabilir.
|
||||
- Varsayılan mod `realtime` sestir.
|
||||
- Gerçek zamanlı ses, daha derin muhakeme veya araçlar gerektiğinde tam OpenClaw agentine geri çağrı yapabilir.
|
||||
- Kimlik doğrulama, kişisel Google OAuth veya zaten oturum açılmış bir Chrome profiliyle başlar.
|
||||
- Otomatik onay duyurusu yoktur.
|
||||
- Varsayılan Chrome ses arka ucu `BlackHole 2ch` olur.
|
||||
- Chrome yerelde veya paired bir Node ana bilgisayarında çalışabilir.
|
||||
- Twilio, bir çevirmeli arama numarasını ve isteğe bağlı PIN veya DTMF dizisini kabul eder.
|
||||
- CLI komutu `googlemeet` olur; `meet`, daha geniş ajan telekonferans iş akışları için ayrılmıştır.
|
||||
- Varsayılan Chrome ses arka ucu `BlackHole 2ch`'dir.
|
||||
- Chrome yerel olarak veya eşlenmiş bir Node ana bilgisayarında çalışabilir.
|
||||
- Twilio, isteğe bağlı PIN veya DTMF dizisiyle birlikte bir aramalı katılım numarasını kabul eder.
|
||||
- CLI komutu `googlemeet`'tir; `meet`, daha geniş agent telekonferans iş akışları için ayrılmıştır.
|
||||
|
||||
## Hızlı başlangıç
|
||||
|
||||
Yerel ses bağımlılıklarını yükleyin ve gerçek zamanlı sağlayıcının OpenAI kullanabildiğinden emin olun:
|
||||
Yerel ses bağımlılıklarını yükleyin ve bir arka uç gerçek zamanlı ses sağlayıcısı yapılandırın. Varsayılan OpenAI'dir; Google Gemini Live da `realtime.provider: "google"` ile çalışır:
|
||||
|
||||
```bash
|
||||
brew install blackhole-2ch sox
|
||||
export OPENAI_API_KEY=sk-...
|
||||
# veya
|
||||
export GEMINI_API_KEY=...
|
||||
```
|
||||
|
||||
`blackhole-2ch`, `BlackHole 2ch` sanal ses aygıtını yükler. Homebrew yükleyicisi,
|
||||
macOS bu aygıtı görünür kılmadan önce yeniden başlatma gerektirir:
|
||||
`blackhole-2ch`, `BlackHole 2ch` sanal ses aygıtını yükler. Homebrew yükleyicisi, macOS'in aygıtı göstermesinden önce yeniden başlatma gerektirir:
|
||||
|
||||
```bash
|
||||
sudo reboot
|
||||
```
|
||||
|
||||
Yeniden başlattıktan sonra ikisini de doğrulayın:
|
||||
Yeniden başlattıktan sonra her iki parçayı da doğrulayın:
|
||||
|
||||
```bash
|
||||
system_profiler SPAudioDataType | grep -i BlackHole
|
||||
@ -67,7 +68,7 @@ Plugin'i etkinleştirin:
|
||||
}
|
||||
```
|
||||
|
||||
Kurulumu kontrol edin:
|
||||
Kurulumu denetleyin:
|
||||
|
||||
```bash
|
||||
openclaw googlemeet setup
|
||||
@ -79,7 +80,7 @@ Bir toplantıya katılın:
|
||||
openclaw googlemeet join https://meet.google.com/abc-defg-hij
|
||||
```
|
||||
|
||||
Veya bir ajanın `google_meet` aracı üzerinden katılmasına izin verin:
|
||||
Veya bir agentin `google_meet` aracı üzerinden katılmasını sağlayın:
|
||||
|
||||
```json
|
||||
{
|
||||
@ -88,67 +89,57 @@ Veya bir ajanın `google_meet` aracı üzerinden katılmasına izin verin:
|
||||
}
|
||||
```
|
||||
|
||||
Chrome, oturum açılmış Chrome profili olarak katılır. Meet içinde,
|
||||
OpenClaw'ın kullandığı mikrofon/hoparlör yolu için `BlackHole 2ch` seçin. Temiz
|
||||
çift yönlü ses için ayrı sanal aygıtlar veya Loopback tarzı bir grafik kullanın; tek
|
||||
bir BlackHole aygıtı ilk smoke test için yeterlidir ancak yankı yapabilir.
|
||||
Chrome, oturum açılmış Chrome profili olarak katılır. Meet içinde, OpenClaw'ın kullandığı mikrofon/hoparlör yolu için `BlackHole 2ch` seçin. Temiz çift yönlü ses için ayrı sanal aygıtlar veya Loopback tarzı bir grafik kullanın; tek bir BlackHole aygıtı ilk duman testi için yeterlidir ancak yankı yapabilir.
|
||||
|
||||
### Yerel Gateway + Parallels Chrome
|
||||
|
||||
Bir macOS VM'in yalnızca Chrome'u sahiplenmesi için VM içinde tam bir OpenClaw Gateway veya model API anahtarına ihtiyacınız **yoktur**.
|
||||
Gateway'i ve ajanı yerelde çalıştırın, ardından VM içinde bir
|
||||
Node ana bilgisayarı çalıştırın. Node'un Chrome komutunu ilan etmesi için
|
||||
paketle gelen Plugin'i VM içinde bir kez etkinleştirin:
|
||||
Bir macOS sanal makinesinin Chrome'u sahiplenmesi için sanal makine içinde tam bir OpenClaw Gateway veya model API anahtarı gerekmez. Gateway'i ve agenti yerel olarak çalıştırın, ardından sanal makinede bir Node ana bilgisayarı çalıştırın. Node'un Chrome komutunu duyurması için paketlenmiş plugin'i sanal makinede bir kez etkinleştirin:
|
||||
|
||||
Nerede ne çalışır:
|
||||
|
||||
- Gateway ana bilgisayarı: OpenClaw Gateway, ajan çalışma alanı, model/API anahtarları, realtime
|
||||
sağlayıcısı ve Google Meet Plugin yapılandırması.
|
||||
- Parallels macOS VM: OpenClaw CLI/Node ana bilgisayarı, Google Chrome, SoX, BlackHole 2ch
|
||||
ve Google'da oturum açmış bir Chrome profili.
|
||||
- VM içinde gerekmez: Gateway hizmeti, ajan yapılandırması, OpenAI/GPT anahtarı veya model
|
||||
sağlayıcı kurulumu.
|
||||
- Gateway ana bilgisayarı: OpenClaw Gateway, agent çalışma alanı, model/API anahtarları, gerçek zamanlı sağlayıcı ve Google Meet Plugin yapılandırması.
|
||||
- Parallels macOS sanal makinesi: OpenClaw CLI/Node ana bilgisayarı, Google Chrome, SoX, BlackHole 2ch ve Google'da oturum açılmış bir Chrome profili.
|
||||
- Sanal makinede gerekmez: Gateway hizmeti, agent yapılandırması, OpenAI/GPT anahtarı veya model sağlayıcı kurulumu.
|
||||
|
||||
VM bağımlılıklarını kurun:
|
||||
Sanal makine bağımlılıklarını yükleyin:
|
||||
|
||||
```bash
|
||||
brew install blackhole-2ch sox
|
||||
```
|
||||
|
||||
macOS `BlackHole 2ch` aygıtını görünür kılsın diye BlackHole kurulumundan sonra VM'i yeniden başlatın:
|
||||
macOS'in `BlackHole 2ch` aygıtını göstermesi için BlackHole'u kurduktan sonra sanal makineyi yeniden başlatın:
|
||||
|
||||
```bash
|
||||
sudo reboot
|
||||
```
|
||||
|
||||
Yeniden başlattıktan sonra VM'in ses aygıtını ve SoX komutlarını görebildiğini doğrulayın:
|
||||
Yeniden başlattıktan sonra sanal makinenin ses aygıtını ve SoX komutlarını görebildiğini doğrulayın:
|
||||
|
||||
```bash
|
||||
system_profiler SPAudioDataType | grep -i BlackHole
|
||||
command -v rec play
|
||||
```
|
||||
|
||||
VM içinde OpenClaw'ı kurun veya güncelleyin, ardından paketle gelen Plugin'i orada etkinleştirin:
|
||||
OpenClaw'ı sanal makinede kurun veya güncelleyin, ardından paketlenmiş plugin'i orada etkinleştirin:
|
||||
|
||||
```bash
|
||||
openclaw plugins enable google-meet
|
||||
```
|
||||
|
||||
VM içinde Node ana bilgisayarını başlatın:
|
||||
Sanal makinede Node ana bilgisayarını başlatın:
|
||||
|
||||
```bash
|
||||
openclaw node run --host <gateway-host> --port 18789 --display-name parallels-macos
|
||||
```
|
||||
|
||||
`<gateway-host>` bir LAN IP'siyse ve TLS kullanmıyorsanız, Node
|
||||
bu güvenilir özel ağ için açıkça izin vermediğiniz sürece düz metin WebSocket'i reddeder:
|
||||
`<gateway-host>` bir LAN IP'siyse ve TLS kullanmıyorsanız, güvenilir özel ağ için açıkça izin vermediğiniz sürece Node düz metin WebSocket'i reddeder:
|
||||
|
||||
```bash
|
||||
OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \
|
||||
openclaw node run --host <gateway-lan-ip> --port 18789 --display-name parallels-macos
|
||||
```
|
||||
|
||||
Node'u LaunchAgent olarak kurarken de aynı ortam değişkenini kullanın:
|
||||
Node'u bir LaunchAgent olarak kurarken de aynı ortam değişkenini kullanın:
|
||||
|
||||
```bash
|
||||
OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \
|
||||
@ -156,24 +147,22 @@ OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \
|
||||
openclaw node restart
|
||||
```
|
||||
|
||||
`OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1`, bir `openclaw.json` ayarı değil,
|
||||
süreç ortamıdır. `openclaw node install`, bu değişken kurulum komutunda mevcut olduğunda
|
||||
onu LaunchAgent ortamına kaydeder.
|
||||
`OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1`, bir `openclaw.json` ayarı değil, süreç ortamıdır. `openclaw node install`, kurulum komutunda mevcut olduğunda bunu LaunchAgent ortamına kaydeder.
|
||||
|
||||
Node'u Gateway ana bilgisayarından onaylayın:
|
||||
Gateway ana bilgisayarından Node'u onaylayın:
|
||||
|
||||
```bash
|
||||
openclaw devices list
|
||||
openclaw devices approve <requestId>
|
||||
```
|
||||
|
||||
Gateway'in Node'u gördüğünü ve `googlemeet.chrome` ilan ettiğini doğrulayın:
|
||||
Gateway'in Node'u gördüğünü ve `googlemeet.chrome` duyurduğunu doğrulayın:
|
||||
|
||||
```bash
|
||||
openclaw nodes status
|
||||
```
|
||||
|
||||
Meet'i Gateway ana bilgisayarında o Node üzerinden yönlendirin:
|
||||
Meet'i Gateway ana bilgisayarında bu Node üzerinden yönlendirin:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -198,69 +187,48 @@ Meet'i Gateway ana bilgisayarında o Node üzerinden yönlendirin:
|
||||
}
|
||||
```
|
||||
|
||||
Şimdi Gateway ana bilgisayarından normal şekilde katılın:
|
||||
Artık Gateway ana bilgisayarından normal şekilde katılın:
|
||||
|
||||
```bash
|
||||
openclaw googlemeet join https://meet.google.com/abc-defg-hij
|
||||
```
|
||||
|
||||
veya ajandan `transport: "chrome-node"` ile `google_meet` aracını kullanmasını isteyin.
|
||||
veya agentten `transport: "chrome-node"` ile `google_meet` aracını kullanmasını isteyin.
|
||||
|
||||
`chromeNode.node` atlanırsa OpenClaw yalnızca tam olarak bir
|
||||
bağlı Node `googlemeet.chrome` ilan ediyorsa otomatik seçim yapar. Birden fazla uygun Node
|
||||
bağlıysa `chromeNode.node` değerini Node kimliği, görünen ad veya uzak IP olarak ayarlayın.
|
||||
`chromeNode.node` atlanırsa OpenClaw yalnızca tam olarak bir bağlı Node `googlemeet.chrome` duyurduğunda otomatik seçim yapar. Birden fazla uygun Node bağlıysa `chromeNode.node` değerini Node kimliği, görünen adı veya uzak IP olarak ayarlayın.
|
||||
|
||||
Yaygın hata denetimleri:
|
||||
|
||||
- `No connected Google Meet-capable node`: VM içinde `openclaw node run` başlatın,
|
||||
pairing'i onaylayın ve `openclaw plugins enable google-meet` komutunun
|
||||
VM içinde çalıştırıldığından emin olun. Ayrıca Gateway ana bilgisayarının
|
||||
`gateway.nodes.allowCommands: ["googlemeet.chrome"]` ile Node komutuna izin verdiğini doğrulayın.
|
||||
- `BlackHole 2ch audio device not found on the node`: VM içinde `blackhole-2ch`
|
||||
kurun ve VM'i yeniden başlatın.
|
||||
- Chrome açılıyor ama katılamıyor: VM içindeki Chrome'da oturum açın ve bu
|
||||
profilin Meet URL'sine elle katılabildiğini doğrulayın.
|
||||
- Ses yok: Meet içinde mikrofon/hoparlörü OpenClaw'ın kullandığı sanal ses
|
||||
aygıtı yoluna yönlendirin; temiz çift yönlü ses için ayrı sanal aygıtlar veya
|
||||
Loopback tarzı yönlendirme kullanın.
|
||||
- `No connected Google Meet-capable node`: sanal makinede `openclaw node run` başlatın, eşlemeyi onaylayın ve sanal makinede `openclaw plugins enable google-meet` çalıştırıldığından emin olun. Ayrıca Gateway ana bilgisayarının şu komutla Node komutuna izin verdiğini doğrulayın: `gateway.nodes.allowCommands: ["googlemeet.chrome"]`.
|
||||
- `BlackHole 2ch audio device not found on the node`: sanal makinede `blackhole-2ch` yükleyin ve sanal makineyi yeniden başlatın.
|
||||
- Chrome açılıyor ama katılamıyor: sanal makine içinde Chrome'da oturum açın ve bu profilin Meet URL'sine elle katılabildiğini doğrulayın.
|
||||
- Ses yok: Meet içinde mikrofon/hoparlörü OpenClaw'ın kullandığı sanal ses aygıtı yolu üzerinden yönlendirin; temiz çift yönlü ses için ayrı sanal aygıtlar veya Loopback tarzı yönlendirme kullanın.
|
||||
|
||||
## Kurulum notları
|
||||
|
||||
Chrome gerçek zamanlı varsayılanı iki harici araç kullanır:
|
||||
|
||||
- `sox`: komut satırı ses yardımcı aracı. Plugin, varsayılan 8 kHz G.711 mu-law
|
||||
ses köprüsü için bunun `rec` ve `play` komutlarını kullanır.
|
||||
- `blackhole-2ch`: macOS sanal ses sürücüsü. Chrome/Meet'in
|
||||
yönlendirebileceği `BlackHole 2ch` ses aygıtını oluşturur.
|
||||
- `sox`: komut satırı ses yardımcı programı. Plugin, varsayılan 8 kHz G.711 mu-law ses köprüsü için `rec` ve `play` komutlarını kullanır.
|
||||
- `blackhole-2ch`: macOS sanal ses sürücüsü. Chrome/Meet'in yönlendirebileceği `BlackHole 2ch` ses aygıtını oluşturur.
|
||||
|
||||
OpenClaw bu iki paketi de paketlemez veya yeniden dağıtmaz. Belgeler,
|
||||
kullanıcılardan bunları Homebrew üzerinden ana bilgisayar bağımlılıkları olarak kurmalarını ister. SoX lisansı
|
||||
`LGPL-2.0-only AND GPL-2.0-only`; BlackHole ise GPL-3.0'dır. BlackHole'u OpenClaw ile
|
||||
paketleyen bir yükleyici veya cihaz oluşturuyorsanız BlackHole'un
|
||||
yukarı akış lisans koşullarını gözden geçirin veya Existential Audio'dan ayrı lisans alın.
|
||||
OpenClaw bu paketlerin hiçbirini paketlemez veya yeniden dağıtmaz. Belgeler, kullanıcıların bunları Homebrew üzerinden ana bilgisayar bağımlılıkları olarak yüklemesini ister. SoX, `LGPL-2.0-only AND GPL-2.0-only`; BlackHole ise GPL-3.0 lisanslıdır. BlackHole'u OpenClaw ile birlikte paketleyen bir yükleyici veya cihaz oluşturuyorsanız BlackHole'un yukarı akış lisans koşullarını inceleyin veya Existential Audio'dan ayrı bir lisans alın.
|
||||
|
||||
## Taşımalar
|
||||
## Aktarımlar
|
||||
|
||||
### Chrome
|
||||
|
||||
Chrome taşıması Meet URL'sini Google Chrome'da açar ve oturum açılmış
|
||||
Chrome profili olarak katılır. macOS'ta Plugin başlatmadan önce `BlackHole 2ch` varlığını kontrol eder.
|
||||
Yapılandırılmışsa ayrıca Chrome'u açmadan önce bir ses köprüsü sağlık komutu ve başlangıç komutu da çalıştırır.
|
||||
Chrome/ses Gateway ana bilgisayarında yaşıyorsa `chrome` kullanın;
|
||||
Chrome/ses Parallels macOS VM gibi paired bir Node üzerinde yaşıyorsa `chrome-node` kullanın.
|
||||
Chrome aktarımı, Meet URL'sini Google Chrome'da açar ve oturum açılmış Chrome profili olarak katılır. macOS'te plugin, başlatmadan önce `BlackHole 2ch` olup olmadığını denetler. Yapılandırılmışsa Chrome'u açmadan önce bir ses köprüsü sağlık komutu ve başlangıç komutu da çalıştırır. Chrome/ses Gateway ana bilgisayarında yaşıyorsa `chrome` kullanın; Chrome/ses Parallels macOS sanal makinesi gibi eşlenmiş bir Node üzerinde yaşıyorsa `chrome-node` kullanın.
|
||||
|
||||
```bash
|
||||
openclaw googlemeet join https://meet.google.com/abc-defg-hij --transport chrome
|
||||
openclaw googlemeet join https://meet.google.com/abc-defg-hij --transport chrome-node
|
||||
```
|
||||
|
||||
Chrome mikrofon ve hoparlör sesini yerel OpenClaw ses
|
||||
köprüsü üzerinden yönlendirin. `BlackHole 2ch` kurulu değilse katılım,
|
||||
sessizce ses yolu olmadan katılmak yerine bir kurulum hatasıyla başarısız olur.
|
||||
Chrome mikrofon ve hoparlör sesini yerel OpenClaw ses köprüsü üzerinden yönlendirin. `BlackHole 2ch` kurulu değilse, ses yolu olmadan sessizce katılmak yerine katılım bir kurulum hatasıyla başarısız olur.
|
||||
|
||||
### Twilio
|
||||
|
||||
Twilio taşıması, Voice Call Plugin'ine devredilen katı bir arama planıdır. Meet sayfalarını telefon numaraları için ayrıştırmaz.
|
||||
Twilio aktarımı, Voice Call Plugin'e devredilen katı bir arama planıdır. Telefon numaraları için Meet sayfalarını ayrıştırmaz.
|
||||
|
||||
```bash
|
||||
openclaw googlemeet join https://meet.google.com/abc-defg-hij \
|
||||
@ -280,16 +248,13 @@ openclaw googlemeet join https://meet.google.com/abc-defg-hij \
|
||||
|
||||
## OAuth ve ön kontrol
|
||||
|
||||
Google Meet Media API erişimi önce kişisel bir OAuth istemcisi kullanır.
|
||||
`oauth.clientId` ve isteğe bağlı olarak `oauth.clientSecret` yapılandırın, ardından şunu çalıştırın:
|
||||
Google Meet Media API erişimi önce kişisel bir OAuth istemcisi kullanır. `oauth.clientId` ve isteğe bağlı olarak `oauth.clientSecret` yapılandırın, sonra şunu çalıştırın:
|
||||
|
||||
```bash
|
||||
openclaw googlemeet auth login --json
|
||||
```
|
||||
|
||||
Komut, yenileme belirteci içeren bir `oauth` yapılandırma bloğu yazdırır. PKCE,
|
||||
`http://localhost:8085/oauth2callback` üzerinde localhost callback ve
|
||||
`--manual` ile elle kopyala/yapıştır akışı kullanır.
|
||||
Komut, yenileme belirteci içeren bir `oauth` yapılandırma bloğu yazdırır. PKCE, `http://localhost:8085/oauth2callback` üzerindeki localhost geri çağrısı ve `--manual` ile elle kopyala/yapıştır akışı kullanır.
|
||||
|
||||
Şu ortam değişkenleri yedek olarak kabul edilir:
|
||||
|
||||
@ -302,30 +267,29 @@ Komut, yenileme belirteci içeren bir `oauth` yapılandırma bloğu yazdırır.
|
||||
- `OPENCLAW_GOOGLE_MEET_DEFAULT_MEETING` veya `GOOGLE_MEET_DEFAULT_MEETING`
|
||||
- `OPENCLAW_GOOGLE_MEET_PREVIEW_ACK` veya `GOOGLE_MEET_PREVIEW_ACK`
|
||||
|
||||
Bir Meet URL'si, kodu veya `spaces/{id}` değerini `spaces.get` üzerinden çözümleyin:
|
||||
Bir Meet URL'sini, kodunu veya `spaces/{id}` değerini `spaces.get` üzerinden çözümleyin:
|
||||
|
||||
```bash
|
||||
openclaw googlemeet resolve-space --meeting https://meet.google.com/abc-defg-hij
|
||||
```
|
||||
|
||||
Medya çalışmalarından önce ön kontrol çalıştırın:
|
||||
Medya çalışmasından önce ön kontrolü çalıştırın:
|
||||
|
||||
```bash
|
||||
openclaw googlemeet preflight --meeting https://meet.google.com/abc-defg-hij
|
||||
```
|
||||
|
||||
`preview.enrollmentAcknowledged: true` değerini yalnızca Cloud
|
||||
projenizin, OAuth principal'ınızın ve toplantı katılımcılarının Meet medya API'leri için Google
|
||||
Workspace Developer Preview Program'a kayıtlı olduğunu doğruladıktan sonra ayarlayın.
|
||||
`preview.enrollmentAcknowledged: true` değerini yalnızca Cloud projenizin, OAuth sorumlusunun ve toplantı katılımcılarının Meet media API'leri için Google Workspace Developer Preview Program'a kayıtlı olduğunu doğruladıktan sonra ayarlayın.
|
||||
|
||||
## Yapılandırma
|
||||
|
||||
Yaygın Chrome gerçek zamanlı yolu için yalnızca Plugin'in etkin olması, BlackHole, SoX
|
||||
ve bir OpenAI anahtarı gerekir:
|
||||
Yaygın Chrome gerçek zamanlı yolu için yalnızca plugin'in etkin olması, BlackHole, SoX ve bir arka uç gerçek zamanlı ses sağlayıcı anahtarı gerekir. Varsayılan OpenAI'dir; Google Gemini Live kullanmak için `realtime.provider: "google"` ayarlayın:
|
||||
|
||||
```bash
|
||||
brew install blackhole-2ch sox
|
||||
export OPENAI_API_KEY=sk-...
|
||||
# veya
|
||||
export GEMINI_API_KEY=...
|
||||
```
|
||||
|
||||
Plugin yapılandırmasını `plugins.entries.google-meet.config` altında ayarlayın:
|
||||
@ -349,16 +313,13 @@ Varsayılanlar:
|
||||
- `defaultMode: "realtime"`
|
||||
- `chromeNode.node`: `chrome-node` için isteğe bağlı Node kimliği/adı/IP'si
|
||||
- `chrome.audioBackend: "blackhole-2ch"`
|
||||
- `chrome.audioInputCommand`: stdout'a 8 kHz G.711 mu-law
|
||||
ses yazan SoX `rec` komutu
|
||||
- `chrome.audioOutputCommand`: stdin'den 8 kHz G.711 mu-law
|
||||
sesi okuyan SoX `play` komutu
|
||||
- `chrome.audioInputCommand`: stdout'a 8 kHz G.711 mu-law ses yazan SoX `rec` komutu
|
||||
- `chrome.audioOutputCommand`: stdin'den 8 kHz G.711 mu-law ses okuyan SoX `play` komutu
|
||||
- `realtime.provider: "openai"`
|
||||
- `realtime.toolPolicy: "safe-read-only"`
|
||||
- `realtime.instructions`: daha derin yanıtlar için
|
||||
`openclaw_agent_consult` ile kısa konuşma yanıtları
|
||||
- `realtime.introMessage`: gerçek zamanlı köprü bağlandığında kısa konuşmalı hazır olma kontrolü;
|
||||
sessiz katılmak için bunu `""` yapın
|
||||
`openclaw_agent_consult` içeren kısa sözlü yanıtlar
|
||||
- `realtime.introMessage`: gerçek zamanlı köprü bağlandığında kısa bir sözlü hazır olma denetimi; sessiz katılmak için bunu `""` olarak ayarlayın
|
||||
|
||||
İsteğe bağlı geçersiz kılmalar:
|
||||
|
||||
@ -374,8 +335,15 @@ Varsayılanlar:
|
||||
node: "parallels-macos",
|
||||
},
|
||||
realtime: {
|
||||
provider: "google",
|
||||
toolPolicy: "owner",
|
||||
introMessage: "Şunu aynen söyle: Ben buradayım.",
|
||||
introMessage: "Tam olarak şunu söyle: Buradayım.",
|
||||
providers: {
|
||||
google: {
|
||||
model: "gemini-2.5-flash-native-audio-preview-12-2025",
|
||||
voice: "Kore",
|
||||
},
|
||||
},
|
||||
},
|
||||
}
|
||||
```
|
||||
@ -397,7 +365,7 @@ Yalnızca Twilio yapılandırması:
|
||||
|
||||
## Araç
|
||||
|
||||
Ajanlar `google_meet` aracını kullanabilir:
|
||||
Agentler `google_meet` aracını kullanabilir:
|
||||
|
||||
```json
|
||||
{
|
||||
@ -408,77 +376,53 @@ Ajanlar `google_meet` aracını kullanabilir:
|
||||
}
|
||||
```
|
||||
|
||||
Chrome Gateway ana bilgisayarında çalışıyorsa `transport: "chrome"` kullanın.
|
||||
Chrome, Parallels
|
||||
VM gibi paired bir Node üzerinde çalışıyorsa `transport: "chrome-node"` kullanın. Her iki durumda da gerçek zamanlı model ve `openclaw_agent_consult`
|
||||
Gateway ana bilgisayarında çalışır, böylece model kimlik bilgileri orada kalır.
|
||||
Chrome Gateway ana bilgisayarında çalışıyorsa `transport: "chrome"` kullanın. Chrome, Parallels sanal makinesi gibi eşlenmiş bir Node üzerinde çalışıyorsa `transport: "chrome-node"` kullanın. Her iki durumda da gerçek zamanlı model ve `openclaw_agent_consult` Gateway ana bilgisayarında çalışır; böylece model kimlik bilgileri orada kalır.
|
||||
|
||||
Etkin oturumları listelemek veya bir oturum kimliğini incelemek için `action: "status"` kullanın.
|
||||
Gerçek zamanlı ajanın hemen konuşmasını sağlamak için `sessionId` ve `message` ile
|
||||
`action: "speak"` kullanın. Bir oturumu sona ermiş olarak işaretlemek için `action: "leave"` kullanın.
|
||||
Etkin oturumları listelemek veya bir oturum kimliğini incelemek için `action: "status"` kullanın. Gerçek zamanlı agentin hemen konuşmasını sağlamak için `sessionId` ve `message` ile `action: "speak"` kullanın. Bir oturumun sona erdiğini işaretlemek için `action: "leave"` kullanın.
|
||||
|
||||
```json
|
||||
{
|
||||
"action": "speak",
|
||||
"sessionId": "meet_...",
|
||||
"message": "Şunu aynen söyle: Buradayım ve dinliyorum."
|
||||
"message": "Tam olarak şunu söyle: Buradayım ve dinliyorum."
|
||||
}
|
||||
```
|
||||
|
||||
## Realtime ajan danışması
|
||||
## Realtime agent consult
|
||||
|
||||
Chrome gerçek zamanlı modu canlı ses döngüsü için optimize edilmiştir. Realtime ses
|
||||
sağlayıcısı toplantı sesini duyar ve yapılandırılmış ses köprüsü üzerinden konuşur.
|
||||
Gerçek zamanlı model daha derin akıl yürütme, güncel bilgi veya normal
|
||||
OpenClaw araçlarına ihtiyaç duyduğunda `openclaw_agent_consult` çağırabilir.
|
||||
Chrome gerçek zamanlı modu, canlı bir ses döngüsü için optimize edilmiştir. Gerçek zamanlı ses sağlayıcısı toplantı sesini duyar ve yapılandırılmış ses köprüsü üzerinden konuşur. Gerçek zamanlı model daha derin muhakemeye, güncel bilgilere veya normal OpenClaw araçlarına ihtiyaç duyduğunda `openclaw_agent_consult` çağırabilir.
|
||||
|
||||
Danışma aracı, perde arkasında normal OpenClaw ajanını son
|
||||
toplantı transkript bağlamıyla çalıştırır ve gerçek zamanlı
|
||||
ses oturumuna kısa, konuşulabilir bir yanıt döndürür. Ses modeli daha sonra bu yanıtı toplantıda tekrar seslendirebilir.
|
||||
Danışma aracı, yakın tarihli toplantı dökümü bağlamıyla perde arkasında normal OpenClaw agentini çalıştırır ve gerçek zamanlı ses oturumuna kısa, sözlü bir yanıt döndürür. Ses modeli daha sonra bu yanıtı toplantıya geri söyleyebilir.
|
||||
|
||||
`realtime.toolPolicy`, danışma çalıştırmasını denetler:
|
||||
|
||||
- `safe-read-only`: danışma aracını açığa çıkarır ve normal ajanı
|
||||
`read`, `web_search`, `web_fetch`, `x_search`, `memory_search` ve
|
||||
`memory_get` ile sınırlar.
|
||||
- `owner`: danışma aracını açığa çıkarır ve normal ajanın
|
||||
olağan ajan araç ilkesini kullanmasına izin verir.
|
||||
- `none`: danışma aracını gerçek zamanlı ses modeline açığa çıkarmaz.
|
||||
- `safe-read-only`: danışma aracını gösterir ve normal agenti `read`, `web_search`, `web_fetch`, `x_search`, `memory_search` ve `memory_get` ile sınırlar.
|
||||
- `owner`: danışma aracını gösterir ve normal agentin olağan agent araç ilkesini kullanmasına izin verir.
|
||||
- `none`: danışma aracını gerçek zamanlı ses modeline göstermez.
|
||||
|
||||
Danışma oturum anahtarı her Meet oturumu için kapsamlıdır; bu nedenle takip eden danışma çağrıları
|
||||
aynı toplantı sırasında önceki danışma bağlamını yeniden kullanabilir.
|
||||
Danışma oturumu anahtarı Meet oturumu başına kapsamlandırılır; böylece takip eden danışma çağrıları aynı toplantı sırasında önceki danışma bağlamını yeniden kullanabilir.
|
||||
|
||||
Chrome çağrıya tamamen katıldıktan sonra konuşmalı hazır olma kontrolünü zorlamak için:
|
||||
Chrome aramaya tam olarak katıldıktan sonra sözlü bir hazır olma denetimini zorlamak için:
|
||||
|
||||
```bash
|
||||
openclaw googlemeet speak meet_... "Şunu aynen söyle: Buradayım ve dinliyorum."
|
||||
openclaw googlemeet speak meet_... "Say exactly: I'm here and listening."
|
||||
```
|
||||
|
||||
## Notlar
|
||||
|
||||
Google Meet'in resmi medya API'si alma odaklıdır, bu nedenle bir Meet
|
||||
çağrısında konuşmak hâlâ bir katılımcı yolu gerektirir. Bu Plugin bu sınırı görünür
|
||||
tutar: Chrome tarayıcı katılımını ve yerel ses yönlendirmesini yönetir;
|
||||
Twilio telefonla katılımı yönetir.
|
||||
Google Meet'in resmi medya API'si alım odaklıdır, bu nedenle bir Meet görüşmesinde konuşmak hâlâ bir katılımcı yolu gerektirir. Bu Plugin bu sınırı görünür tutar: Chrome tarayıcı katılımını ve yerel ses yönlendirmesini yönetir; Twilio telefonla aramalı katılımı yönetir.
|
||||
|
||||
Chrome gerçek zamanlı modu şunlardan birine ihtiyaç duyar:
|
||||
|
||||
- `chrome.audioInputCommand` artı `chrome.audioOutputCommand`: OpenClaw
|
||||
gerçek zamanlı model köprüsünün sahibidir ve bu
|
||||
komutlar ile seçili gerçek zamanlı ses sağlayıcısı arasında 8 kHz G.711 mu-law sesi borulandırır.
|
||||
- `chrome.audioBridgeCommand`: harici bir köprü komutu tüm yerel
|
||||
ses yolunun sahibidir ve daemon'unu başlattıktan veya doğruladıktan sonra çıkmalıdır.
|
||||
- `chrome.audioInputCommand` artı `chrome.audioOutputCommand`: OpenClaw gerçek zamanlı model köprüsünü sahiplenir ve bu komutlarla seçili gerçek zamanlı ses sağlayıcısı arasında 8 kHz G.711 mu-law sesi aktarır.
|
||||
- `chrome.audioBridgeCommand`: harici bir köprü komutu tüm yerel ses yolunu sahiplenir ve daemon'unu başlattıktan veya doğruladıktan sonra çıkmalıdır.
|
||||
|
||||
Temiz çift yönlü ses için Meet çıkışını ve Meet mikrofonunu ayrı
|
||||
sanal aygıtlar veya Loopback tarzı sanal aygıt grafiği üzerinden yönlendirin. Tek bir ortak
|
||||
BlackHole aygıtı diğer katılımcıları tekrar çağrıya yankılayabilir.
|
||||
Temiz çift yönlü ses için Meet çıkışını ve Meet mikrofonunu ayrı sanal aygıtlar veya Loopback tarzı bir sanal aygıt grafiği üzerinden yönlendirin. Paylaşılan tek bir BlackHole aygıtı diğer katılımcıları aramaya geri yankılayabilir.
|
||||
|
||||
`googlemeet speak`, bir Chrome
|
||||
oturumu için etkin gerçek zamanlı ses köprüsünü tetikler. `googlemeet leave` bu köprüyü durdurur. Voice Call Plugin üzerinden devredilmiş Twilio oturumlarında
|
||||
`leave`, alttaki sesli çağrıyı da kapatır.
|
||||
`googlemeet speak`, bir Chrome oturumu için etkin gerçek zamanlı ses köprüsünü tetikler. `googlemeet leave` bu köprüyü durdurur. Voice Call Plugin üzerinden devredilen Twilio oturumlarında `leave`, alttaki sesli aramayı da kapatır.
|
||||
|
||||
## İlgili
|
||||
|
||||
- [Voice Call Plugin](/tr/plugins/voice-call)
|
||||
- [Talk mode](/tr/nodes/talk)
|
||||
- [Konuşma modu](/tr/nodes/talk)
|
||||
- [Plugin oluşturma](/tr/plugins/building-plugins)
|
||||
|
||||
@ -1,47 +1,47 @@
|
||||
---
|
||||
read_when:
|
||||
- OpenClaw'dan giden bir sesli arama başlatmak istiyorsunuz
|
||||
- Voice Call Plugin'ini yapılandırıyor veya geliştiriyorsunuz
|
||||
summary: 'Voice Call Plugin''i: Twilio/Telnyx/Plivo üzerinden giden + gelen aramalar (Plugin kurulumu + yapılandırma + CLI)'
|
||||
title: Voice Call Plugin'i
|
||||
- OpenClaw'dan giden bir sesli arama yapmak istiyorsunuz
|
||||
- Sesli arama Plugin'ini yapılandırıyor veya geliştiriyorsunuz
|
||||
summary: 'Voice Call Plugin: Twilio/Telnyx/Plivo üzerinden giden + gelen aramalar (Plugin kurulumu + yapılandırma + CLI)'
|
||||
title: Voice call Plugin
|
||||
x-i18n:
|
||||
generated_at: "2026-04-24T09:24:13Z"
|
||||
generated_at: "2026-04-24T10:25:41Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 4cd57118133506c22604ab9592a823546a91795ab425de4b7a81edbbb8374e6d
|
||||
source_hash: 6aed4e33ce090c86f43c71280f033e446f335c53d42456fdc93c9938250e9af6
|
||||
source_path: plugins/voice-call.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Voice Call (Plugin)
|
||||
|
||||
OpenClaw için Plugin üzerinden sesli aramalar. Giden bildirimleri ve
|
||||
Bir Plugin üzerinden OpenClaw için sesli aramalar. Giden bildirimleri ve
|
||||
gelen ilkelerle çok turlu konuşmaları destekler.
|
||||
|
||||
Geçerli sağlayıcılar:
|
||||
Mevcut sağlayıcılar:
|
||||
|
||||
- `twilio` (Programmable Voice + Media Streams)
|
||||
- `telnyx` (Call Control v2)
|
||||
- `plivo` (Voice API + XML transfer + GetInput speech)
|
||||
- `plivo` (Voice API + XML aktarımı + GetInput konuşma)
|
||||
- `mock` (geliştirme/ağ yok)
|
||||
|
||||
Hızlı zihinsel model:
|
||||
|
||||
- Plugin'i kur
|
||||
- Gateway'i yeniden başlat
|
||||
- `plugins.entries.voice-call.config` altında yapılandır
|
||||
- `openclaw voicecall ...` veya `voice_call` aracını kullan
|
||||
- Plugin'i kurun
|
||||
- Gateway'i yeniden başlatın
|
||||
- `plugins.entries.voice-call.config` altında yapılandırın
|
||||
- `openclaw voicecall ...` veya `voice_call` aracını kullanın
|
||||
|
||||
## Nerede çalışır (yerel ve uzak)
|
||||
## Nerede çalışır (yerel vs uzak)
|
||||
|
||||
Voice Call Plugin'i **Gateway sürecinin içinde** çalışır.
|
||||
Voice Call Plugin'i **Gateway süreci içinde** çalışır.
|
||||
|
||||
Uzak bir Gateway kullanıyorsanız, Plugin'i **Gateway'i çalıştıran makinede**
|
||||
kurun/yapılandırın, ardından yüklenmesi için Gateway'i yeniden başlatın.
|
||||
Uzak bir Gateway kullanıyorsanız, Plugin'i **Gateway'i çalıştıran makineye**
|
||||
kurup yapılandırın, ardından yüklenmesi için Gateway'i yeniden başlatın.
|
||||
|
||||
## Kurulum
|
||||
|
||||
### Seçenek A: npm'den kur (önerilen)
|
||||
### Seçenek A: npm'den kurulum (önerilir)
|
||||
|
||||
```bash
|
||||
openclaw plugins install @openclaw/voice-call
|
||||
@ -49,7 +49,7 @@ openclaw plugins install @openclaw/voice-call
|
||||
|
||||
Ardından Gateway'i yeniden başlatın.
|
||||
|
||||
### Seçenek B: yerel klasörden kur (geliştirme, kopyalama yok)
|
||||
### Seçenek B: yerel bir klasörden kurulum (geliştirme, kopyalama yok)
|
||||
|
||||
```bash
|
||||
PLUGIN_SRC=./path/to/local/voice-call-plugin
|
||||
@ -82,8 +82,8 @@ Yapılandırmayı `plugins.entries.voice-call.config` altında ayarlayın:
|
||||
telnyx: {
|
||||
apiKey: "...",
|
||||
connectionId: "...",
|
||||
// Telnyx Mission Control Portal'dan alınan Telnyx webhook genel anahtarı
|
||||
// (Base64 dizesi; TELNYX_PUBLIC_KEY ile de ayarlanabilir).
|
||||
// Telnyx Mission Control Portal'dan Telnyx webhook genel anahtarı
|
||||
// (Base64 dizgesi; TELNYX_PUBLIC_KEY ile de ayarlanabilir).
|
||||
publicKey: "...",
|
||||
},
|
||||
|
||||
@ -98,7 +98,7 @@ Yapılandırmayı `plugins.entries.voice-call.config` altında ayarlayın:
|
||||
path: "/voice/webhook",
|
||||
},
|
||||
|
||||
// Webhook güvenliği (tüneller/proxy'ler için önerilen)
|
||||
// Webhook güvenliği (tüneller/proxy'ler için önerilir)
|
||||
webhookSecurity: {
|
||||
allowedHosts: ["voice.example.com"],
|
||||
trustedProxyIPs: ["100.64.0.1"],
|
||||
@ -115,7 +115,7 @@ Yapılandırmayı `plugins.entries.voice-call.config` altında ayarlayın:
|
||||
|
||||
streaming: {
|
||||
enabled: true,
|
||||
provider: "openai", // isteğe bağlı; ayarlı değilse ilk kayıtlı gerçek zamanlı transcription sağlayıcısı
|
||||
provider: "openai", // isteğe bağlı; ayarlanmadığında ilk kayıtlı gerçek zamanlı transkripsiyon sağlayıcısı
|
||||
streamPath: "/voice/stream",
|
||||
providers: {
|
||||
openai: {
|
||||
@ -130,6 +130,17 @@ Yapılandırmayı `plugins.entries.voice-call.config` altında ayarlayın:
|
||||
maxPendingConnectionsPerIp: 4,
|
||||
maxConnections: 128,
|
||||
},
|
||||
|
||||
realtime: {
|
||||
enabled: false,
|
||||
provider: "google", // isteğe bağlı; ayarlanmadığında ilk kayıtlı gerçek zamanlı ses sağlayıcısı
|
||||
providers: {
|
||||
google: {
|
||||
model: "gemini-2.5-flash-native-audio-preview-12-2025",
|
||||
voice: "Kore",
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
@ -139,46 +150,131 @@ Yapılandırmayı `plugins.entries.voice-call.config` altında ayarlayın:
|
||||
|
||||
Notlar:
|
||||
|
||||
- Twilio/Telnyx **genel olarak erişilebilir** bir Webhook URL'si gerektirir.
|
||||
- Plivo **genel olarak erişilebilir** bir Webhook URL'si gerektirir.
|
||||
- `mock`, yerel geliştirme sağlayıcısıdır (ağ çağrısı yok).
|
||||
- Eski yapılandırmalar hâlâ `provider: "log"`, `twilio.from` veya eski `streaming.*` OpenAI anahtarlarını kullanıyorsa, bunları yeniden yazmak için `openclaw doctor --fix` çalıştırın.
|
||||
- `skipSignatureVerification` true olmadığı sürece Telnyx, `telnyx.publicKey` (veya `TELNYX_PUBLIC_KEY`) gerektirir.
|
||||
- Twilio/Telnyx için **genel erişime açık** bir webhook URL'si gerekir.
|
||||
- Plivo için **genel erişime açık** bir webhook URL'si gerekir.
|
||||
- `mock`, yerel bir geliştirme sağlayıcısıdır (ağ çağrısı yok).
|
||||
- Eski yapılandırmalar hâlâ `provider: "log"`, `twilio.from` veya eski `streaming.*` OpenAI anahtarlarını kullanıyorsa, yeniden yazmak için `openclaw doctor --fix` çalıştırın.
|
||||
- `skipSignatureVerification` true değilse Telnyx, `telnyx.publicKey` (veya `TELNYX_PUBLIC_KEY`) gerektirir.
|
||||
- `skipSignatureVerification` yalnızca yerel test içindir.
|
||||
- Ngrok ücretsiz katmanını kullanıyorsanız `publicUrl` değerini tam ngrok URL'si olarak ayarlayın; imza doğrulaması her zaman zorlanır.
|
||||
- `tunnel.allowNgrokFreeTierLoopbackBypass: true`, yalnızca `tunnel.provider="ngrok"` ve `serve.bind` loopback olduğunda (ngrok yerel ajanı) geçersiz imzalara sahip Twilio Webhook'larına izin verir. Yalnızca yerel geliştirme için kullanın.
|
||||
- Ngrok ücretsiz katman URL'leri değişebilir veya ara ekran davranışı ekleyebilir; `publicUrl` kayarsa Twilio imzaları başarısız olur. Üretim için kararlı bir alan adı veya Tailscale Funnel tercih edin.
|
||||
- Akış güvenliği varsayılanları:
|
||||
- ngrok ücretsiz katmanını kullanıyorsanız, `publicUrl` değerini tam ngrok URL'si olarak ayarlayın; imza doğrulaması her zaman zorunludur.
|
||||
- `tunnel.allowNgrokFreeTierLoopbackBypass: true`, Twilio webhook'larına geçersiz imzalarla **yalnızca** `tunnel.provider="ngrok"` ve `serve.bind` loopback olduğunda (ngrok yerel aracısı) izin verir. Yalnızca yerel geliştirme için kullanın.
|
||||
- Ngrok ücretsiz katman URL'leri değişebilir veya ara sayfa davranışı ekleyebilir; `publicUrl` kayarsa Twilio imzaları başarısız olur. Üretim için kararlı bir alan adı veya Tailscale funnel tercih edin.
|
||||
- `realtime.enabled`, tam sesten sese konuşmaları başlatır; bunu `streaming.enabled` ile birlikte etkinleştirmeyin.
|
||||
- Streaming güvenliği varsayılanları:
|
||||
- `streaming.preStartTimeoutMs`, hiçbir zaman geçerli bir `start` çerçevesi göndermeyen soketleri kapatır.
|
||||
- `streaming.maxPendingConnections`, toplam kimliği doğrulanmamış başlangıç öncesi soket sayısını sınırlar.
|
||||
- `streaming.maxPendingConnectionsPerIp`, kaynak IP başına kimliği doğrulanmamış başlangıç öncesi soket sayısını sınırlar.
|
||||
- `streaming.maxPendingConnectionsPerIp`, kaynak IP başına kimliği doğrulanmamış başlangıç öncesi soketleri sınırlar.
|
||||
- `streaming.maxConnections`, toplam açık medya akışı soketlerini (bekleyen + etkin) sınırlar.
|
||||
- Çalışma zamanı geri dönüşü şimdilik bu eski voice-call anahtarlarını kabul etmeye devam eder, ancak yeniden yazma yolu `openclaw doctor --fix`'tir ve uyumluluk katmanı geçicidir.
|
||||
- Çalışma zamanı geri dönüşü, şimdilik bu eski voice-call anahtarlarını hâlâ kabul eder, ancak yeniden yazma yolu `openclaw doctor --fix` olup uyumluluk katmanı geçicidir.
|
||||
|
||||
## Akış halinde transcription
|
||||
## Gerçek zamanlı sesli konuşmalar
|
||||
|
||||
`streaming`, canlı çağrı sesi için bir gerçek zamanlı transcription sağlayıcısı seçer.
|
||||
`realtime`, canlı çağrı sesi için tam çift yönlü bir gerçek zamanlı ses sağlayıcısı seçer.
|
||||
Bu, sesi yalnızca gerçek zamanlı transkripsiyon sağlayıcılarına ileten
|
||||
`streaming`'den ayrıdır.
|
||||
|
||||
Geçerli çalışma zamanı davranışı:
|
||||
Mevcut çalışma zamanı davranışı:
|
||||
|
||||
- `streaming.provider` isteğe bağlıdır. Ayarlı değilse Voice Call ilk
|
||||
kayıtlı gerçek zamanlı transcription sağlayıcısını kullanır.
|
||||
- Paketlenmiş gerçek zamanlı transcription sağlayıcıları arasında Deepgram (`deepgram`),
|
||||
- `realtime.enabled`, Twilio Media Streams için desteklenir.
|
||||
- `realtime.enabled`, `streaming.enabled` ile birleştirilemez.
|
||||
- `realtime.provider` isteğe bağlıdır. Ayarlanmazsa Voice Call ilk
|
||||
kayıtlı gerçek zamanlı ses sağlayıcısını kullanır.
|
||||
- Paketle gelen gerçek zamanlı ses sağlayıcıları, sağlayıcı Plugin'leri tarafından
|
||||
kaydedilen Google Gemini Live (`google`) ve OpenAI (`openai`) içerir.
|
||||
- Sağlayıcıya ait ham yapılandırma `realtime.providers.<providerId>` altında bulunur.
|
||||
- `realtime.provider`, kayıtlı olmayan bir sağlayıcıyı işaret ediyorsa veya hiç
|
||||
gerçek zamanlı ses sağlayıcısı kayıtlı değilse, Voice Call bir uyarı günlüğe yazar ve
|
||||
tüm Plugin'i başarısız kılmak yerine gerçek zamanlı medyayı atlar.
|
||||
|
||||
Google Gemini Live gerçek zamanlı varsayılanları:
|
||||
|
||||
- API anahtarı: `realtime.providers.google.apiKey`, `GEMINI_API_KEY` veya
|
||||
`GOOGLE_GENERATIVE_AI_API_KEY`
|
||||
- model: `gemini-2.5-flash-native-audio-preview-12-2025`
|
||||
- voice: `Kore`
|
||||
|
||||
Örnek:
|
||||
|
||||
```json5
|
||||
{
|
||||
plugins: {
|
||||
entries: {
|
||||
"voice-call": {
|
||||
config: {
|
||||
provider: "twilio",
|
||||
inboundPolicy: "allowlist",
|
||||
allowFrom: ["+15550005678"],
|
||||
realtime: {
|
||||
enabled: true,
|
||||
provider: "google",
|
||||
instructions: "Kısa konuşun ve araçları kullanmadan önce sorun.",
|
||||
providers: {
|
||||
google: {
|
||||
apiKey: "${GEMINI_API_KEY}",
|
||||
model: "gemini-2.5-flash-native-audio-preview-12-2025",
|
||||
voice: "Kore",
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
}
|
||||
```
|
||||
|
||||
Bunun yerine OpenAI kullanın:
|
||||
|
||||
```json5
|
||||
{
|
||||
plugins: {
|
||||
entries: {
|
||||
"voice-call": {
|
||||
config: {
|
||||
realtime: {
|
||||
enabled: true,
|
||||
provider: "openai",
|
||||
providers: {
|
||||
openai: {
|
||||
apiKey: "${OPENAI_API_KEY}",
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
}
|
||||
```
|
||||
|
||||
Sağlayıcıya özgü gerçek zamanlı ses seçenekleri için
|
||||
[Google provider](/tr/providers/google) ve [OpenAI provider](/tr/providers/openai)
|
||||
sayfalarına bakın.
|
||||
|
||||
## Streaming transkripsiyon
|
||||
|
||||
`streaming`, canlı çağrı sesi için bir gerçek zamanlı transkripsiyon sağlayıcısı seçer.
|
||||
|
||||
Mevcut çalışma zamanı davranışı:
|
||||
|
||||
- `streaming.provider` isteğe bağlıdır. Ayarlanmazsa Voice Call ilk
|
||||
kayıtlı gerçek zamanlı transkripsiyon sağlayıcısını kullanır.
|
||||
- Paketle gelen gerçek zamanlı transkripsiyon sağlayıcıları Deepgram (`deepgram`),
|
||||
ElevenLabs (`elevenlabs`), Mistral (`mistral`), OpenAI (`openai`) ve xAI
|
||||
(`xai`) bulunur; bunlar kendi sağlayıcı Plugin'leri tarafından kaydedilir.
|
||||
- Sağlayıcıya ait ham yapılandırma `streaming.providers.<providerId>` altında yaşar.
|
||||
- `streaming.provider` kayıtlı olmayan bir sağlayıcıyı işaret ederse veya hiç gerçek zamanlı
|
||||
transcription sağlayıcısı kayıtlı değilse, Voice Call tüm Plugin'i başarısız kılmak yerine
|
||||
bir uyarı günlüğe kaydeder ve medya akışını atlar.
|
||||
(`xai`) içerir; bunlar sağlayıcı Plugin'leri tarafından kaydedilir.
|
||||
- Sağlayıcıya ait ham yapılandırma `streaming.providers.<providerId>` altında bulunur.
|
||||
- `streaming.provider`, kayıtlı olmayan bir sağlayıcıyı işaret ediyorsa veya hiç
|
||||
gerçek zamanlı transkripsiyon sağlayıcısı kayıtlı değilse, Voice Call bir uyarı günlüğe yazar ve
|
||||
tüm Plugin'i başarısız kılmak yerine medya akışını atlar.
|
||||
|
||||
OpenAI akış halinde transcription varsayılanları:
|
||||
OpenAI streaming transkripsiyon varsayılanları:
|
||||
|
||||
- API anahtarı: `streaming.providers.openai.apiKey` veya `OPENAI_API_KEY`
|
||||
- model: `gpt-4o-transcribe`
|
||||
- `silenceDurationMs`: `800`
|
||||
- `vadThreshold`: `0.5`
|
||||
|
||||
xAI akış halinde transcription varsayılanları:
|
||||
xAI streaming transkripsiyon varsayılanları:
|
||||
|
||||
- API anahtarı: `streaming.providers.xai.apiKey` veya `XAI_API_KEY`
|
||||
- uç nokta: `wss://api.x.ai/v1/stt`
|
||||
@ -242,7 +338,7 @@ Bunun yerine xAI kullanın:
|
||||
}
|
||||
```
|
||||
|
||||
Eski anahtarlar hâlâ `openclaw doctor --fix` tarafından otomatik taşınır:
|
||||
Eski anahtarlar hâlâ `openclaw doctor --fix` ile otomatik olarak taşınır:
|
||||
|
||||
- `streaming.sttProvider` → `streaming.provider`
|
||||
- `streaming.openaiApiKey` → `streaming.providers.openai.apiKey`
|
||||
@ -252,15 +348,17 @@ Eski anahtarlar hâlâ `openclaw doctor --fix` tarafından otomatik taşınır:
|
||||
|
||||
## Eski çağrı temizleyicisi
|
||||
|
||||
Hiçbir zaman sonlandırıcı bir Webhook almayan çağrıları
|
||||
(örneğin hiç tamamlanmayan notify modu çağrıları) bitirmek için `staleCallReaperSeconds` kullanın. Varsayılan `0`
|
||||
Hiçbir zaman terminal webhook almayan çağrıları sonlandırmak için
|
||||
`staleCallReaperSeconds` kullanın
|
||||
(örneğin, hiçbir zaman tamamlanmayan notify modu çağrıları). Varsayılan değer `0`'dır
|
||||
(devre dışı).
|
||||
|
||||
Önerilen aralıklar:
|
||||
|
||||
- **Üretim:** notify tarzı akışlar için `120`–`300` saniye.
|
||||
- Normal çağrıların
|
||||
tamamlanabilmesi için bu değeri **`maxDurationSeconds` değerinden daha yüksek** tutun. İyi bir başlangıç noktası `maxDurationSeconds + 30–60` saniyedir.
|
||||
tamamlanabilmesi için bu değeri **`maxDurationSeconds` değerinden yüksek** tutun. İyi bir başlangıç noktası
|
||||
`maxDurationSeconds + 30–60` saniyedir.
|
||||
|
||||
Örnek:
|
||||
|
||||
@ -281,28 +379,29 @@ Hiçbir zaman sonlandırıcı bir Webhook almayan çağrıları
|
||||
|
||||
## Webhook Güvenliği
|
||||
|
||||
Bir proxy veya tünel Gateway'in önünde durduğunda Plugin,
|
||||
imza doğrulaması için genel URL'yi yeniden oluşturur. Bu seçenekler hangi yönlendirilmiş
|
||||
başlıkların güvenilir olduğunu kontrol eder.
|
||||
Bir proxy veya tünel Gateway'in önünde yer aldığında, Plugin imza doğrulaması için
|
||||
genel URL'yi yeniden oluşturur. Bu seçenekler hangi iletilen
|
||||
üstbilgilere güvenileceğini kontrol eder.
|
||||
|
||||
`webhookSecurity.allowedHosts`, yönlendirme başlıklarından gelen host'ları izin listesine alır.
|
||||
`webhookSecurity.allowedHosts`, iletme üstbilgilerindeki host'ları izin listesine alır.
|
||||
|
||||
`webhookSecurity.trustForwardingHeaders`, izin listesi olmadan yönlendirilmiş başlıklara güvenir.
|
||||
`webhookSecurity.trustForwardingHeaders`, izin listesi olmadan iletilen üstbilgilere güvenir.
|
||||
|
||||
`webhookSecurity.trustedProxyIPs`, yalnızca istek
|
||||
uzak IP'si listedekilerle eşleştiğinde yönlendirilmiş başlıklara güvenir.
|
||||
`webhookSecurity.trustedProxyIPs`, yalnızca isteğin uzak IP'si
|
||||
listeyle eşleştiğinde iletilen üstbilgilere güvenir.
|
||||
|
||||
Webhook tekrar oynatma koruması Twilio ve Plivo için etkindir. Tekrar oynatılan geçerli Webhook
|
||||
istekleri onaylanır ama yan etkiler için atlanır.
|
||||
Webhook tekrar oynatma koruması Twilio ve Plivo için etkindir. Yeniden oynatılan geçerli webhook
|
||||
istekleri onaylanır ancak yan etkiler için atlanır.
|
||||
|
||||
Twilio konuşma turları, `<Gather>` geri çağrılarında tur başına bir belirteç içerir; böylece
|
||||
eski/tekrar oynatılmış konuşma geri çağrıları daha yeni bir bekleyen döküm turunu karşılayamaz.
|
||||
Twilio konuşma turları `<Gather>` geri çağrılarında tur başına bir belirteç içerir, böylece
|
||||
eski/yeniden oynatılan konuşma geri çağrıları daha yeni bekleyen bir transkript turunu
|
||||
karşılayamaz.
|
||||
|
||||
Kimliği doğrulanmamış Webhook istekleri, sağlayıcının gerekli imza başlıkları eksikse
|
||||
Kimliği doğrulanmamış webhook istekleri, sağlayıcının gerekli imza üstbilgileri eksik olduğunda
|
||||
gövde okunmadan önce reddedilir.
|
||||
|
||||
Voice Call Webhook'u, imza doğrulamasından önce paylaşılan ön-auth gövde profilini (64 KB / 5 saniye)
|
||||
ve IP başına uçuş halindeki istek üst sınırını kullanır.
|
||||
voice-call webhook'u, imza doğrulamasından önce paylaşılan kimlik doğrulama öncesi gövde profilini
|
||||
(64 KB / 5 saniye) ve IP başına işlem içi sınırı kullanır.
|
||||
|
||||
Kararlı bir genel host ile örnek:
|
||||
|
||||
@ -325,8 +424,8 @@ Kararlı bir genel host ile örnek:
|
||||
|
||||
## Aramalar için TTS
|
||||
|
||||
Voice Call, çağrılarda
|
||||
akışlı konuşma için çekirdek `messages.tts` yapılandırmasını kullanır. Bunu Plugin yapılandırması altında
|
||||
Voice Call, aramalarda
|
||||
akış hâlinde konuşma için çekirdek `messages.tts` yapılandırmasını kullanır. Bunu Plugin yapılandırması altında
|
||||
**aynı şekille** geçersiz kılabilirsiniz — `messages.tts` ile derinlemesine birleştirilir.
|
||||
|
||||
```json5
|
||||
@ -345,11 +444,11 @@ akışlı konuşma için çekirdek `messages.tts` yapılandırmasını kullanır
|
||||
|
||||
Notlar:
|
||||
|
||||
- Plugin yapılandırması içindeki eski `tts.<provider>` anahtarları (`openai`, `elevenlabs`, `microsoft`, `edge`) yükleme sırasında otomatik olarak `tts.providers.<provider>` şekline taşınır. Commit edilmiş yapılandırmada `providers` şeklini tercih edin.
|
||||
- **Microsoft speech, sesli aramalar için yok sayılır** (telefon sesi PCM gerektirir; mevcut Microsoft taşıması telefon PCM çıktısı açığa çıkarmaz).
|
||||
- Twilio medya akışı etkinse çekirdek TTS kullanılır; aksi halde aramalar sağlayıcıya özgü yerel seslere geri döner.
|
||||
- Bir Twilio medya akışı zaten etkinken Voice Call, TwiML `<Say>` yoluna geri dönmez. Bu durumda telefon TTS kullanılamıyorsa iki oynatma yolunu karıştırmak yerine oynatma isteği başarısız olur.
|
||||
- Telefon TTS ikincil sağlayıcıya geri döndüğünde Voice Call, hata ayıklama için sağlayıcı zinciri (`from`, `to`, `attempts`) ile bir uyarı günlüğe kaydeder.
|
||||
- Plugin yapılandırması içindeki eski `tts.<provider>` anahtarları (`openai`, `elevenlabs`, `microsoft`, `edge`) yükleme sırasında otomatik olarak `tts.providers.<provider>` yapısına taşınır. Kaydedilmiş yapılandırmada `providers` yapısını tercih edin.
|
||||
- **Microsoft konuşma, sesli aramalarda yok sayılır** (telefon sesinin PCM olması gerekir; mevcut Microsoft taşıma katmanı telefon için PCM çıkışını açığa çıkarmıyor).
|
||||
- Twilio medya akışı etkin olduğunda çekirdek TTS kullanılır; aksi takdirde aramalar sağlayıcının yerel seslerine geri döner.
|
||||
- Bir Twilio medya akışı zaten etkinken, Voice Call TwiML `<Say>` kullanımına geri dönmez. Bu durumda telefon TTS kullanılamıyorsa, iki oynatma yolunu karıştırmak yerine oynatma isteği başarısız olur.
|
||||
- Telefon TTS ikincil bir sağlayıcıya geri döndüğünde, Voice Call hata ayıklama için sağlayıcı zincirini (`from`, `to`, `attempts`) içeren bir uyarıyı günlüğe yazar.
|
||||
|
||||
### Daha fazla örnek
|
||||
|
||||
@ -368,7 +467,7 @@ Yalnızca çekirdek TTS kullanın (geçersiz kılma yok):
|
||||
}
|
||||
```
|
||||
|
||||
Yalnızca çağrılar için ElevenLabs'a geçersiz kılın (çekirdek varsayılanı başka yerde koruyun):
|
||||
Yalnızca aramalar için ElevenLabs'a geçersiz kılın (çekirdek varsayılanı başka yerlerde koruyun):
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -393,7 +492,7 @@ Yalnızca çağrılar için ElevenLabs'a geçersiz kılın (çekirdek varsayıla
|
||||
}
|
||||
```
|
||||
|
||||
Yalnızca çağrılar için OpenAI modelini geçersiz kılın (derin birleştirme örneği):
|
||||
Yalnızca aramalar için OpenAI modelini geçersiz kılın (derin birleştirme örneği):
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -418,56 +517,56 @@ Yalnızca çağrılar için OpenAI modelini geçersiz kılın (derin birleştirm
|
||||
|
||||
## Gelen aramalar
|
||||
|
||||
Gelen ilkesi varsayılan olarak `disabled` durumundadır. Gelen aramaları etkinleştirmek için şunu ayarlayın:
|
||||
Gelen çağrı ilkesi varsayılan olarak `disabled` değerindedir. Gelen çağrıları etkinleştirmek için şunu ayarlayın:
|
||||
|
||||
```json5
|
||||
{
|
||||
inboundPolicy: "allowlist",
|
||||
allowFrom: ["+15550001234"],
|
||||
inboundGreeting: "Hello! How can I help?",
|
||||
inboundGreeting: "Merhaba! Nasıl yardımcı olabilirim?",
|
||||
}
|
||||
```
|
||||
|
||||
`inboundPolicy: "allowlist"`, düşük güvenceye sahip bir arayan numarası ekranıdır. Plugin,
|
||||
sağlayıcının verdiği `From` değerini normalize eder ve `allowFrom` ile karşılaştırır.
|
||||
Webhook doğrulaması sağlayıcı teslimatını ve payload bütünlüğünü doğrular, ancak
|
||||
PSTN/VoIP arayan numara sahipliğini kanıtlamaz. `allowFrom` değerini güçlü arayan kimliği olarak değil,
|
||||
arayan numarası filtrelemesi olarak değerlendirin.
|
||||
`inboundPolicy: "allowlist"`, düşük güvenceli bir arayan kimliği taramasıdır. Plugin,
|
||||
sağlayıcının verdiği `From` değerini normalleştirir ve `allowFrom` ile karşılaştırır.
|
||||
Webhook doğrulaması, sağlayıcı teslimatını ve yük bütünlüğünü doğrular, ancak
|
||||
PSTN/VoIP arayan numara sahipliğini kanıtlamaz. `allowFrom` değerini güçlü bir arayan kimliği yerine
|
||||
arayan kimliği filtrelemesi olarak değerlendirin.
|
||||
|
||||
Otomatik yanıtlar aracı sistemini kullanır. Şunlarla ayarlayın:
|
||||
Otomatik yanıtlar agent sistemini kullanır. Şunlarla ince ayar yapın:
|
||||
|
||||
- `responseModel`
|
||||
- `responseSystemPrompt`
|
||||
- `responseTimeoutMs`
|
||||
|
||||
### Konuşulan çıktı sözleşmesi
|
||||
### Sözlü çıktı sözleşmesi
|
||||
|
||||
Otomatik yanıtlar için Voice Call, sistem istemine katı bir konuşulan çıktı sözleşmesi ekler:
|
||||
Otomatik yanıtlar için Voice Call, sistem istemine katı bir sözlü çıktı sözleşmesi ekler:
|
||||
|
||||
- `{"spoken":"..."}`
|
||||
|
||||
Voice Call sonra konuşma metnini savunmacı şekilde çıkarır:
|
||||
Voice Call ardından konuşma metnini savunmacı biçimde çıkarır:
|
||||
|
||||
- Muhakeme/hata içeriği olarak işaretlenmiş payload'ları yok sayar.
|
||||
- Doğrudan JSON, çitlenmiş JSON veya satır içi `"spoken"` anahtarlarını ayrıştırır.
|
||||
- Akıl yürütme/hata içeriği olarak işaretlenmiş yükleri yok sayar.
|
||||
- Doğrudan JSON'u, çevrili JSON'u veya satır içi `"spoken"` anahtarlarını ayrıştırır.
|
||||
- Düz metne geri döner ve olası planlama/meta giriş paragraflarını kaldırır.
|
||||
|
||||
Bu, konuşulan oynatmanın arayan kullanıcıya dönük metne odaklı kalmasını sağlar ve planlama metninin sese sızmasını önler.
|
||||
Bu, sözlü oynatmanın arayan kişiye dönük metne odaklanmasını sağlar ve planlama metninin sese sızmasını önler.
|
||||
|
||||
### Konuşma başlangıç davranışı
|
||||
### Konuşma başlatma davranışı
|
||||
|
||||
Giden `conversation` çağrıları için ilk mesaj işleme, canlı oynatma durumuna bağlıdır:
|
||||
Giden `conversation` aramaları için ilk mesaj işleme, canlı oynatma durumuna bağlıdır:
|
||||
|
||||
- Araya girme kuyruk temizleme ve otomatik yanıt, yalnızca ilk selamlama aktif olarak konuşurken bastırılır.
|
||||
- Araya girme kuyruğu temizleme ve otomatik yanıt, yalnızca ilk karşılama etkin biçimde konuşulurken bastırılır.
|
||||
- İlk oynatma başarısız olursa, çağrı `listening` durumuna döner ve ilk mesaj yeniden deneme için kuyrukta kalır.
|
||||
- Twilio akışı için ilk oynatma, ekstra gecikme olmadan akış bağlantısında başlar.
|
||||
- Twilio streaming için ilk oynatma, ek gecikme olmadan akış bağlantısında başlar.
|
||||
|
||||
### Twilio akış bağlantı kesilmesi ek süresi
|
||||
### Twilio akış bağlantı kesilmesi toleransı
|
||||
|
||||
Bir Twilio medya akışının bağlantısı kesildiğinde, Voice Call çağrıyı otomatik sonlandırmadan önce `2000ms` bekler:
|
||||
|
||||
- Akış bu pencere içinde yeniden bağlanırsa, otomatik sonlandırma iptal edilir.
|
||||
- Ek süre bittikten sonra hiçbir akış yeniden kaydedilmezse, takılı kalan etkin çağrıları önlemek için çağrı sonlandırılır.
|
||||
- Tolerans süresi sonrası hiçbir akış yeniden kaydedilmezse, takılı kalmış etkin çağrıları önlemek için çağrı sonlandırılır.
|
||||
|
||||
## CLI
|
||||
|
||||
@ -480,16 +579,16 @@ openclaw voicecall dtmf --call-id <id> --digits "ww123456#"
|
||||
openclaw voicecall end --call-id <id>
|
||||
openclaw voicecall status --call-id <id>
|
||||
openclaw voicecall tail
|
||||
openclaw voicecall latency # günlüklerden tur gecikmesini özetle
|
||||
openclaw voicecall latency # günlüklerden dönüş gecikmesini özetler
|
||||
openclaw voicecall expose --mode funnel
|
||||
```
|
||||
|
||||
`latency`, varsayılan voice-call depolama yolundaki `calls.jsonl` dosyasını okur.
|
||||
Farklı bir günlüğü işaret etmek için `--file <path>`, analizi son N kayıtla sınırlandırmak için
|
||||
`--last <n>` kullanın (varsayılan 200). Çıktı, tur gecikmesi ve dinleme-bekleme süreleri için
|
||||
p50/p90/p99 değerlerini içerir.
|
||||
`latency`, varsayılan voice-call depolama yolundan `calls.jsonl` dosyasını okur. Başka bir günlüğü işaret etmek için
|
||||
`--file <path>`, analizi son N kayda sınırlamak için
|
||||
`--last <n>` kullanın (varsayılan 200). Çıktı, dönüş
|
||||
gecikmesi ve dinleme-bekleme süreleri için p50/p90/p99 değerlerini içerir.
|
||||
|
||||
## Aracı aracı
|
||||
## Agent aracı
|
||||
|
||||
Araç adı: `voice_call`
|
||||
|
||||
@ -502,7 +601,7 @@ Eylemler:
|
||||
- `end_call` (callId)
|
||||
- `get_status` (callId)
|
||||
|
||||
Bu depo, `skills/voice-call/SKILL.md` konumunda eşleşen bir skill belgesi içerir.
|
||||
Bu repo, `skills/voice-call/SKILL.md` konumunda eşleşen bir beceri belgesi gönderir.
|
||||
|
||||
## Gateway RPC
|
||||
|
||||
@ -516,5 +615,5 @@ Bu depo, `skills/voice-call/SKILL.md` konumunda eşleşen bir skill belgesi içe
|
||||
## İlgili
|
||||
|
||||
- [Metinden konuşmaya](/tr/tools/tts)
|
||||
- [Talk mode](/tr/nodes/talk)
|
||||
- [Voice wake](/tr/nodes/voicewake)
|
||||
- [Konuşma modu](/tr/nodes/talk)
|
||||
- [Sesle uyandırma](/tr/nodes/voicewake)
|
||||
|
||||
@ -1,84 +1,86 @@
|
||||
---
|
||||
read_when:
|
||||
- Medya yeteneklerine genel bakış arıyorsunuz
|
||||
- Medya yeteneklerine genel bir bakış mı arıyorsunuz?
|
||||
- Hangi medya sağlayıcısını yapılandıracağınıza karar verme
|
||||
- Eşzamansız medya üretiminin nasıl çalıştığını anlama
|
||||
summary: Medya üretimi, anlama ve speech yetenekleri için birleşik açılış sayfası
|
||||
title: Medya genel bakışı
|
||||
summary: Medya üretimi, anlama ve konuşma özellikleri için birleşik açılış sayfası
|
||||
title: Medyaya genel bakış
|
||||
x-i18n:
|
||||
generated_at: "2026-04-24T09:36:00Z"
|
||||
generated_at: "2026-04-24T10:25:41Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 469fb173ac3853011b8cd4f89f3ab97dd7d14e12e4e1d7d87e84de05d025a593
|
||||
source_hash: 39848c6104ebd4feeb37b233b70f3312fa076b535c3b3780336729eb9fdfa4e6
|
||||
source_path: tools/media-overview.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Medya Üretimi ve Anlama
|
||||
|
||||
OpenClaw görüntü, video ve müzik üretir; gelen medyayı (görüntü, ses, video) anlar ve metinden konuşmaya ile yanıtları sesli olarak okur. Tüm medya yetenekleri araç güdümlüdür: aracı bunları konuşmaya göre ne zaman kullanacağına karar verir ve her araç yalnızca en az bir destekleyici sağlayıcı yapılandırıldığında görünür.
|
||||
OpenClaw görüntüler, videolar ve müzik üretir, gelen medyayı (görüntü, ses, video) anlar ve metinden konuşmaya ile yanıtları sesli olarak okur. Tüm medya yetenekleri araç odaklıdır: aracı bunları ne zaman kullanacağına konuşmaya göre karar verir ve her araç yalnızca en az bir arka uç sağlayıcı yapılandırıldığında görünür.
|
||||
|
||||
## Yeteneklere hızlı bakış
|
||||
## Bir bakışta yetenekler
|
||||
|
||||
| Yetenek | Araç | Sağlayıcılar | Ne yapar |
|
||||
| -------------------- | ---------------- | --------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
|
||||
| Görüntü üretimi | `image_generate` | ComfyUI, fal, Google, MiniMax, OpenAI, Vydra, xAI | Metin istemlerinden veya başvurulardan görüntü oluşturur ya da düzenler |
|
||||
| Video üretimi | `video_generate` | Alibaba, BytePlus, ComfyUI, fal, Google, MiniMax, OpenAI, Qwen, Runway, Together, Vydra, xAI | Metinden, görüntülerden veya mevcut videolardan video oluşturur |
|
||||
| Müzik üretimi | `music_generate` | ComfyUI, Google, MiniMax | Metin istemlerinden müzik veya ses parçaları oluşturur |
|
||||
| Metinden konuşmaya (TTS) | `tts` | ElevenLabs, Microsoft, MiniMax, OpenAI, xAI | Giden yanıtları konuşulan sese dönüştürür |
|
||||
| Medya anlama | (otomatik) | Görüntü/ses yetenekli herhangi bir model sağlayıcısı, artı CLI geri dönüşleri | Gelen görüntüleri, sesleri ve videoları özetler |
|
||||
| Yetenek | Araç | Sağlayıcılar | Ne yapar |
|
||||
| -------------------- | ---------------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
|
||||
| Görüntü üretimi | `image_generate` | ComfyUI, fal, Google, MiniMax, OpenAI, Vydra, xAI | Metin istemlerinden veya referanslardan görüntü oluşturur ya da düzenler |
|
||||
| Video üretimi | `video_generate` | Alibaba, BytePlus, ComfyUI, fal, Google, MiniMax, OpenAI, Qwen, Runway, Together, Vydra, xAI | Metinden, görüntülerden veya mevcut videolardan videolar oluşturur |
|
||||
| Müzik üretimi | `music_generate` | ComfyUI, Google, MiniMax | Metin istemlerinden müzik veya ses parçaları oluşturur |
|
||||
| Metinden konuşmaya (TTS) | `tts` | ElevenLabs, Google, Microsoft, MiniMax, OpenAI, xAI | Giden yanıtları konuşulan sese dönüştürür |
|
||||
| Medya anlama | (otomatik) | Herhangi bir görüntü/ses destekli model sağlayıcısı ve CLI yedekleri | Gelen görüntüleri, sesleri ve videoları özetler |
|
||||
|
||||
## Sağlayıcı yetenek matrisi
|
||||
|
||||
Bu tablo, platform genelinde hangi sağlayıcıların hangi medya yeteneklerini desteklediğini gösterir.
|
||||
|
||||
| Sağlayıcı | Görüntü | Video | Müzik | TTS | STT / Transcription | Medya Anlama |
|
||||
| ---------- | ------- | ----- | ----- | --- | ------------------- | ------------ |
|
||||
| Alibaba | | Evet | | | | |
|
||||
| BytePlus | | Evet | | | | |
|
||||
| ComfyUI | Evet | Evet | Evet | | | |
|
||||
| Deepgram | | | | | Evet | |
|
||||
| ElevenLabs | | | | Evet | Evet | |
|
||||
| fal | Evet | Evet | | | | |
|
||||
| Google | Evet | Evet | Evet | | | Evet |
|
||||
| Microsoft | | | | Evet | | |
|
||||
| MiniMax | Evet | Evet | Evet | Evet | | |
|
||||
| Mistral | | | | | Evet | |
|
||||
| OpenAI | Evet | Evet | | Evet | Evet | Evet |
|
||||
| Qwen | | Evet | | | | |
|
||||
| Runway | | Evet | | | | |
|
||||
| Together | | Evet | | | | |
|
||||
| Vydra | Evet | Evet | | | | |
|
||||
| xAI | Evet | Evet | | Evet | Evet | Evet |
|
||||
| Sağlayıcı | Görüntü | Video | Müzik | TTS | STT / Transkripsiyon | Gerçek Zamanlı Ses | Medya Anlama |
|
||||
| --------- | ------- | ----- | ----- | --- | -------------------- | ------------------ | ------------ |
|
||||
| Alibaba | | Evet | | | | | |
|
||||
| BytePlus | | Evet | | | | | |
|
||||
| ComfyUI | Evet | Evet | Evet | | | | |
|
||||
| Deepgram | | | | | Evet | | |
|
||||
| ElevenLabs | | | | Evet | Evet | | |
|
||||
| fal | Evet | Evet | | | | | |
|
||||
| Google | Evet | Evet | Evet | Evet | | Evet | Evet |
|
||||
| Microsoft | | | | Evet | | | |
|
||||
| MiniMax | Evet | Evet | Evet | Evet | | | |
|
||||
| Mistral | | | | | Evet | | |
|
||||
| OpenAI | Evet | Evet | | Evet | Evet | Evet | Evet |
|
||||
| Qwen | | Evet | | | | | |
|
||||
| Runway | | Evet | | | | | |
|
||||
| Together | | Evet | | | | | |
|
||||
| Vydra | Evet | Evet | | | | | |
|
||||
| xAI | Evet | Evet | | Evet | Evet | | Evet |
|
||||
|
||||
<Note>
|
||||
Medya anlama, sağlayıcı yapılandırmanızda kayıtlı görüntü yetenekli veya ses yetenekli herhangi bir modeli kullanır. Yukarıdaki tablo özel medya anlama desteği olan sağlayıcıları vurgular; çok modlu modellere sahip çoğu LLM sağlayıcısı (Anthropic, Google, OpenAI vb.) etkin yanıt modeli olarak yapılandırıldığında gelen medyayı da anlayabilir.
|
||||
Medya anlama, sağlayıcı yapılandırmanızda kayıtlı olan herhangi bir görüntü destekli veya ses destekli modeli kullanır. Yukarıdaki tablo, özel medya anlama desteğine sahip sağlayıcıları vurgular; çok kipli modellere sahip çoğu LLM sağlayıcısı (Anthropic, Google, OpenAI vb.) etkin yanıt modeli olarak yapılandırıldığında gelen medyayı da anlayabilir.
|
||||
</Note>
|
||||
|
||||
## Eşzamansız üretim nasıl çalışır
|
||||
|
||||
Video ve müzik üretimi arka plan görevleri olarak çalışır çünkü sağlayıcı işleme genellikle 30 saniyeden birkaç dakikaya kadar sürer. Aracı `video_generate` veya `music_generate` çağırdığında OpenClaw isteği sağlayıcıya gönderir, hemen bir görev kimliği döndürür ve işi görev defterinde izler. İş çalışırken aracı diğer mesajlara yanıt vermeye devam eder. Sağlayıcı işi bitirdiğinde OpenClaw aracıyı uyandırır; böylece tamamlanan medyayı özgün kanala geri gönderebilir. Görüntü üretimi ve TTS eşzamanlıdır ve yanıtla birlikte satır içinde tamamlanır.
|
||||
Video ve müzik üretimi, sağlayıcı işlemesi genellikle 30 saniye ile birkaç dakika sürdüğü için arka plan görevleri olarak çalışır. Aracı `video_generate` veya `music_generate` çağırdığında, OpenClaw isteği sağlayıcıya gönderir, hemen bir görev kimliği döndürür ve işi görev defterinde izler. İş çalışırken aracı diğer mesajlara yanıt vermeye devam eder. Sağlayıcı tamamladığında OpenClaw aracıyı uyandırır, böylece tamamlanan medyayı özgün kanala geri gönderebilir. Görüntü üretimi ve TTS eşzamanlıdır ve yanıtla satır içi olarak tamamlanır.
|
||||
|
||||
Deepgram, ElevenLabs, Mistral, OpenAI ve xAI yapılandırıldığında gelen
|
||||
sesi toplu `tools.media.audio` yolu üzerinden yazıya dökebilir. Deepgram,
|
||||
ElevenLabs, Mistral, OpenAI ve xAI ayrıca Voice Call akışlı STT
|
||||
sağlayıcılarını da kaydeder; böylece canlı telefon sesi, tamamlanmış bir kaydı beklemeden
|
||||
seçilen satıcıya iletilebilir.
|
||||
sesi toplu `tools.media.audio` yolu üzerinden transkribe edebilir. Deepgram,
|
||||
ElevenLabs, Mistral, OpenAI ve xAI ayrıca Sesli Arama akış STT
|
||||
sağlayıcılarını da kaydeder; böylece canlı telefon sesi, tamamlanmış bir
|
||||
kaydı beklemeden seçilen satıcıya iletilebilir.
|
||||
|
||||
OpenAI, OpenClaw'ın görüntü, video, toplu TTS, toplu STT, Voice Call
|
||||
akışlı STT, gerçek zamanlı ses ve memory embedding yüzeylerine eşlenir. xAI şu anda
|
||||
OpenClaw'ın görüntü, video, arama, kod yürütme, toplu TTS, toplu STT
|
||||
ve Voice Call akışlı STT yüzeylerine eşlenir. xAI Realtime voice yukarı akış
|
||||
bir yetenektir, ancak paylaşılan gerçek zamanlı
|
||||
ses sözleşmesi bunu temsil edene kadar OpenClaw içinde kaydedilmez.
|
||||
Google, OpenClaw'ın görüntü, video, müzik, toplu TTS, arka uç gerçek zamanlı
|
||||
ses ve medya anlama yüzeylerine eşlenir. OpenAI, OpenClaw'ın görüntü,
|
||||
video, toplu TTS, toplu STT, Sesli Arama akış STT, arka uç gerçek zamanlı ses
|
||||
ve bellek yerleştirme yüzeylerine eşlenir. xAI şu anda OpenClaw'ın görüntü, video,
|
||||
arama, kod yürütme, toplu TTS, toplu STT ve Sesli Arama akış STT
|
||||
yüzeylerine eşlenir. xAI Realtime voice yukarı akışta bir yetenektir, ancak
|
||||
paylaşılan gerçek zamanlı ses sözleşmesi bunu temsil edene kadar
|
||||
OpenClaw içinde kaydedilmez.
|
||||
|
||||
## Hızlı bağlantılar
|
||||
|
||||
- [Image Generation](/tr/tools/image-generation) -- görüntü üretme ve düzenleme
|
||||
- [Video Generation](/tr/tools/video-generation) -- metinden videoya, görüntüden videoya ve videodan videoya
|
||||
- [Music Generation](/tr/tools/music-generation) -- müzik ve ses parçaları oluşturma
|
||||
- [Text-to-Speech](/tr/tools/tts) -- yanıtları konuşulan sese dönüştürme
|
||||
- [Media Understanding](/tr/nodes/media-understanding) -- gelen görüntüleri, sesleri ve videoları anlama
|
||||
- [Görüntü Üretimi](/tr/tools/image-generation) -- görüntü oluşturma ve düzenleme
|
||||
- [Video Üretimi](/tr/tools/video-generation) -- metinden videoya, görüntüden videoya ve videodan videoya
|
||||
- [Müzik Üretimi](/tr/tools/music-generation) -- müzik ve ses parçaları oluşturma
|
||||
- [Metinden Konuşmaya](/tr/tools/tts) -- yanıtları konuşulan sese dönüştürme
|
||||
- [Medya Anlama](/tr/nodes/media-understanding) -- gelen görüntüleri, sesleri ve videoları anlama
|
||||
|
||||
## İlgili
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user