Ana içeriğe atla

​
Gmail Pub/Sub -> OpenClaw

Amaç: Gmail watch -> Pub/Sub push -> gog gmail watch serve -> OpenClaw webhook.

​
Önkoşullar

  • gcloud kurulu ve oturum açılmış (kurulum kılavuzu).
  • gog (gogcli) kurulu ve Gmail hesabı için yetkilendirilmiş (gogcli.sh).
  • OpenClaw hooks etkin (bkz. Webhooks).
  • tailscale ile oturum açılmış (tailscale.com). Desteklenen kurulum, herkese açık HTTPS uç noktası için Tailscale Funnel kullanır. Diğer tünel servisleri çalışabilir, ancak DIY/desteklenmez ve manuel kablolama gerektirir. Şu anda desteklediğimiz çözüm Tailscale’dir.
Örnek hook yapılandırması (Gmail ön ayar eşlemesini etkinleştirir): 
{
  hooks: {
    enabled: true,
    token: "OPENCLAW_HOOK_TOKEN",
    path: "/hooks",
    presets: ["gmail"],
  },
}
Gmail özetini bir sohbet yüzeyine iletmek için, deliver + isteğe bağlı channel/to ayarlayan bir eşleme ile ön ayarı geçersiz kılın: 
{
  hooks: {
    enabled: true,
    token: "OPENCLAW_HOOK_TOKEN",
    presets: ["gmail"],
    mappings: [
      {
        match: { path: "gmail" },
        action: "agent",
        wakeMode: "now",
        name: "Gmail",
        sessionKey: "hook:gmail:{{messages[0].id}}",
        messageTemplate: "New email from {{messages[0].from}}\nSubject: {{messages[0].subject}}\n{{messages[0].snippet}}\n{{messages[0].body}}",
        model: "openai/gpt-5.2-mini",
        deliver: true,
        channel: "last",
        // to: "+15551234567"
      },
    ],
  },
}
Sabit bir kanal istiyorsanız channel + to ayarlayın. Aksi halde channel: "last" son teslim rotasını kullanır (WhatsApp’a geri düşer). Gmail çalıştırmaları için daha ucuz bir modeli zorlamak üzere eşlemede model ayarlayın (provider/model veya takma ad). agents.defaults.models dayatıyorsanız, bunu da buraya ekleyin. Gmail hook’ları için varsayılan bir model ve düşünme seviyesi ayarlamak üzere yapılandırmanıza hooks.gmail.model / hooks.gmail.thinking ekleyin: 
{
  hooks: {
    gmail: {
      model: "openrouter/meta-llama/llama-3.3-70b-instruct:free",
      thinking: "off",
    },
  },
}
Notlar:
  • Eşlemedeki hook başına model/thinking yine de bu varsayılanları geçersiz kılar.
  • Geri dönüş sırası: hooks.gmail.model → agents.defaults.model.fallbacks → birincil (kimlik doğrulama/hız sınırı/zaman aşımı).
  • agents.defaults.models ayarlıysa, Gmail modeli izin listesinde olmalıdır.
  • Gmail hook içeriği varsayılan olarak harici içerik güvenlik sınırlarıyla sarılır. Devre dışı bırakmak için (tehlikeli), hooks.gmail.allowUnsafeExternalContent: true ayarlayın.
Yükü daha fazla özelleştirmek için hooks.mappings ekleyin veya hooks.transformsDir altında bir JS/TS dönüşüm modülü ekleyin (bkz. Webhooks).

​
Sihirbaz (önerilir)

Her şeyi birlikte kablolamak için OpenClaw yardımcı aracını kullanın (macOS’ta bağımlılıkları brew ile kurar): 
openclaw webhooks gmail setup \
  --account [email protected]
Varsayılanlar:
  • Herkese açık push uç noktası için Tailscale Funnel kullanır.
  • openclaw webhooks gmail run için hooks.gmail yapılandırmasını yazar.
  • Gmail hook ön ayarını etkinleştirir (hooks.presets: ["gmail"]).
Yol notu: tailscale.mode etkinleştirildiğinde, OpenClaw otomatik olarak hooks.gmail.serve.path’ü / olarak ayarlar ve herkese açık yolu hooks.gmail.tailscale.path’da tutar (varsayılan /gmail-pubsub), çünkü Tailscale proxy’lemeden önce set-path önekini kaldırır. Arka ucun önekli yolu alması gerekiyorsa, hooks.gmail.tailscale.target (veya --tailscale-target) değerini http://127.0.0.1:8788/gmail-pubsub gibi tam bir URL olarak ayarlayın ve hooks.gmail.serve.path ile eşleştirin. Özel bir uç nokta mı istiyorsunuz? --push-endpoint <url> veya --tailscale off kullanın. Platform notu: macOS’ta sihirbaz gcloud, gogcli ve tailscale’yı Homebrew üzerinden kurar; Linux’ta önce bunları manuel olarak kurun. Gateway otomatik başlatma (önerilir):
  • hooks.enabled=true ve hooks.gmail.account ayarlandığında, Gateway gog gmail watch serve’u açılışta başlatır ve watch’ı otomatik yeniler.
  • Devre dışı bırakmak için OPENCLAW_SKIP_GMAIL_WATCHER=1 ayarlayın (daemon’ı kendiniz çalıştırıyorsanız faydalıdır).
  • Manuel daemon’ı aynı anda çalıştırmayın; aksi halde listen tcp 127.0.0.1:8788: bind: address already in use ile karşılaşırsınız.
Manuel daemon (gog gmail watch serve başlatır + otomatik yenileme): 
openclaw webhooks gmail run

​
Tek seferlik kurulum

  1. gog tarafından kullanılan OAuth istemcisinin sahibi olan GCP projesini seçin.
gcloud auth login
gcloud config set project <project-id>
Not: Gmail watch, Pub/Sub konusunun OAuth istemcisiyle aynı projede olmasını gerektirir.
  1. API’leri etkinleştirin:
gcloud services enable gmail.googleapis.com pubsub.googleapis.com
  1. Bir konu oluşturun:
gcloud pubsub topics create gog-gmail-watch
  1. Gmail push’un yayımlamasına izin verin:
gcloud pubsub topics add-iam-policy-binding gog-gmail-watch \
  --member=serviceAccount:[email protected] \
  --role=roles/pubsub.publisher

​
Watch’ı başlatın

gog gmail watch start \
  --account [email protected] \
  --label INBOX \
  --topic projects/<project-id>/topics/gog-gmail-watch
Çıktıdaki history_id’ü kaydedin (hata ayıklama için).

​
Push işleyicisini çalıştırın

Yerel örnek (paylaşılan belirteç kimlik doğrulaması): 
gog gmail watch serve \
  --account [email protected] \
  --bind 127.0.0.1 \
  --port 8788 \
  --path /gmail-pubsub \
  --token <shared> \
  --hook-url http://127.0.0.1:18789/hooks/gmail \
  --hook-token OPENCLAW_HOOK_TOKEN \
  --include-body \
  --max-bytes 20000
Notlar:
  • --token, push uç noktasını korur (x-gog-token veya ?token=).
  • --hook-url, OpenClaw /hooks/gmail’a işaret eder (eşlenmiş; izole çalıştırma + ana hatta özet).
  • --include-body ve --max-bytes, OpenClaw’a gönderilen gövde parçasını kontrol eder.
Önerilir: openclaw webhooks gmail run aynı akışı sarar ve watch’ı otomatik yeniler.

​
İşleyiciyi dışa açın (gelişmiş, desteklenmez)

Tailscale dışı bir tünele ihtiyacınız varsa, manuel olarak bağlayın ve push aboneliğinde herkese açık URL’yi kullanın (desteklenmez, koruma yoktur): 
cloudflared tunnel --url http://127.0.0.1:8788 --no-autoupdate
Oluşturulan URL’yi push uç noktası olarak kullanın: 
gcloud pubsub subscriptions create gog-gmail-watch-push \
  --topic gog-gmail-watch \
  --push-endpoint "https://<public-url>/gmail-pubsub?token=<shared>"
Üretim: kararlı bir HTTPS uç noktası kullanın ve Pub/Sub OIDC JWT’yi yapılandırın, ardından çalıştırın: 
gog gmail watch serve --verify-oidc --oidc-email <svc@...>

​
Test

İzlenen gelen kutusuna bir mesaj gönderin: 
gog gmail send \
  --account [email protected] \
  --to [email protected] \
  --subject "watch test" \
  --body "ping"
Watch durumunu ve geçmişi kontrol edin: 
gog gmail watch status --account [email protected]
gog gmail history --account [email protected] --since <historyId>

​
Sorun Giderme

  • Invalid topicName: proje uyuşmazlığı (konu OAuth istemcisi projesinde değil).
  • User not authorized: konuda roles/pubsub.publisher eksik.
  • Boş mesajlar: Gmail push yalnızca historyId sağlar; gog gmail history üzerinden alın.

​
Temizlik

gog gmail watch stop --account [email protected]
gcloud pubsub subscriptions delete gog-gmail-watch-push
gcloud pubsub topics delete gog-gmail-watch