Çalıştırma onayları — gelişmiş

​

Güvenli ikili dosyalar (yalnızca stdin)

​

Argv doğrulaması ve reddedilen bayraklar

• grep: --dereference-recursive, --directories, --exclude-from, --file, --recursive, -R, -d, -f, -r
• jq: --argfile, --from-file, --library-path, --rawfile, --slurpfile, -L, -f
• sort: --compress-program, --files0-from, --output, --random-source, --temporary-directory, -T, -o
• tail: --follow, --retry, -F, -f
• wc: --files0-from

​

Güvenilir ikili dosya dizinleri

​

Kabuk zincirleme, sarmalayıcılar ve çoklayıcılar

​

Güvenli ikili dosyalar ile izin verilenler listesinin karşılaştırması

• safeBins, yapılandırmadan (tools.exec.safeBins veya ajan başına agents.entries.*.tools.exec.safeBins) gelir.
• safeBinTrustedDirs, yapılandırmadan (tools.exec.safeBinTrustedDirs veya ajan başına agents.entries.*.tools.exec.safeBinTrustedDirs) gelir.
• safeBinProfiles, yapılandırmadan (tools.exec.safeBinProfiles veya ajan başına agents.entries.*.tools.exec.safeBinProfiles) gelir. Ajan başına profil anahtarları genel anahtarları geçersiz kılar.
• izin verilenler listesi girdileri, agents.<id>.allowlist altındaki ana bilgisayara yerel onay dosyasında (veya Control UI / openclaw approvals allowlist ... aracılığıyla) bulunur.
• openclaw security audit, yorumlayıcı/çalışma zamanı ikili dosyaları açık profiller olmadan safeBins içinde göründüğünde tools.exec.safe_bins_interpreter_unprofiled ile uyarır.
• openclaw doctor --fix, eksik özel safeBinProfiles.<bin> girdilerini {} olarak oluşturabilir (sonrasında inceleyip sıkılaştırın). Yorumlayıcı/çalışma zamanı ikili dosyaları otomatik olarak oluşturulmaz.

{
  tools: {
    exec: {
      safeBins: ["myfilter"],
      safeBinProfiles: {
        myfilter: {
          minPositional: 0,
          maxPositional: 0,
          allowedValueFlags: ["-n", "--limit"],
          deniedFlags: ["-f", "--file", "-c", "--command"],
        },
      },
    },
  },
}

​

Yorumlayıcı/çalışma zamanı komutları

• Tam argv/cwd/env bağlamı her zaman bağlanır.
• Doğrudan kabuk betiği ve doğrudan çalışma zamanı dosyası biçimleri, mümkün olan en iyi çabayla tek bir somut yerel dosya anlık görüntüsüne bağlanır.
• Yine de tek bir doğrudan yerel dosyaya çözümlenen yaygın paket yöneticisi sarmalayıcı biçimleri (örneğin pnpm exec, pnpm node, npm exec, npx) bağlamadan önce açılır.
• OpenClaw bir yorumlayıcı/çalışma zamanı komutu için tam olarak bir somut yerel dosya belirleyemezse (örneğin paket betikleri, değerlendirme biçimleri, çalışma zamanına özgü yükleyici zincirleri veya belirsiz çok dosyalı biçimler), sahip olmadığı anlamsal kapsamı sağladığını iddia etmek yerine onay destekli yürütme reddedilir.
• Bu iş akışlarında korumalı alan kullanmayı, ayrı bir ana bilgisayar sınırını veya operatörün daha geniş çalışma zamanı anlamlarını kabul ettiği açıkça güvenilir bir izin verilenler listesi/tam iş akışını tercih edin.

​

Takip teslimatı davranışı

• Geçerli bir harici teslimat hedefi varsa (teslim edilebilir kanal ve hedef to), takip teslimatı bu kanalı kullanır.
• Harici hedefi olmayan yalnızca web sohbeti veya dahili oturum akışlarında takip teslimatı yalnızca oturumda kalır (deliver: false).
• Bir çağıran, çözümlenebilir harici kanal olmadan açıkça katı harici teslimat isterse istek INVALID_REQUEST ile başarısız olur.
• bestEffortDeliver etkinse ve hiçbir harici kanal çözümlenemiyorsa teslimat başarısız olmak yerine yalnızca oturuma indirgenir.

​

Üçüncü taraf istemciler için asgari kapsamlar

​

Onayların sohbet kanallarına iletilmesi

{
  approvals: {
    exec: {
      enabled: true,
      mode: "session", // "session" | "targets" | "both"
      agentFilter: ["main"],
      sessionFilter: ["discord"], // alt dize veya düzenli ifade
      targets: [
        { channel: "slack", to: "U12345678" },
        { channel: "telegram", to: "123456789" },
      ],
    },
  },
}

/approve <id> allow-once
/approve <id> allow-always
/approve <id> deny

​

Plugin onaylarını iletme

{
  approvals: {
    plugin: {
      enabled: true,
      mode: "targets",
      agentFilter: ["main"],
      targets: [
        { channel: "slack", to: "U12345678" },
        { channel: "telegram", to: "123456789" },
      ],
    },
  },
}

​

Herhangi bir kanalda aynı sohbetten onaylar

​

Yerel onay teslimi

• ana makinenin çalıştırma ilkesi, çalıştırma onayının gerekli olup olmadığına karar vermeye devam eder
• approvals.exec, onay istemlerinin diğer sohbet hedeflerine iletilmesini denetler
• channels.<channel>.execApprovals, Discord, Slack, Telegram, QQ bot ve benzeri kanala özgü yerel istemcilerin etkin olup olmadığını denetler
• İstek Slack’ten geldiğinde ve Slack plugin onaylayanları çözümlendiğinde Slack plugin onayları, Slack’in yerel onay istemcisini kullanabilir; approvals.plugin, Slack çalıştırma onayları devre dışı bırakılmış olsa bile plugin onaylarını Slack oturumlarına veya hedeflerine yönlendirebilir
• Google Chat yerel onay kartları, kararlı users/<id> onaylayanları dm.allowFrom veya defaultTo üzerinden çözümlendiğinde Google Chat alanlarından veya ileti dizilerinden kaynaklanan çalıştırma ve plugin onaylarını işler; kararlar için tepki olaylarını kullanmazlar
• WhatsApp ve Signal tepkiyle onay teslimi, approvals.exec ve approvals.plugin tarafından denetlenir; channels.<channel>.execApprovals blokları yoktur

• kanal yerel onay teslimini destekler
• onaylayanlar açık execApprovals.approvers veya commands.ownerAllowFrom gibi sahip kimliğinden çözümlenebilir
• channels.<channel>.execApprovals.enabled ayarlanmamıştır veya "auto"

• Discord: channels.discord.execApprovals.*
• Slack: channels.slack.execApprovals.*
• Telegram: channels.telegram.execApprovals.*
• QQ bot: channels.qqbot.execApprovals.*
• Google Chat: kararlı onaylayanları channels.googlechat.dm.allowFrom veya channels.googlechat.defaultTo ile yapılandırın; execApprovals bloğu gerekli değildir
• WhatsApp: onay istemlerini WhatsApp’a yönlendirmek için approvals.exec ve approvals.plugin kullanın
• Signal: onay istemlerini Signal’e yönlendirmek için approvals.exec ve approvals.plugin kullanın

• Telegram varsayılan olarak onaylayanlara doğrudan mesajları (target: "dm") kullanır. Onay istemlerini kaynak Telegram sohbetinde/konusunda da göstermek için channel veya both seçeneğine geçin. Telegram forum konularında OpenClaw, onay istemi ve onay sonrası takip iletisi için konuyu korur.
• Discord ve Telegram onaylayanları açıkça belirtilebilir (execApprovals.approvers) veya commands.ownerAllowFrom üzerinden çıkarılabilir; yalnızca çözümlenmiş onaylayanlar onaylayabilir veya reddedebilir.
• Slack onaylayanları açıkça belirtilebilir (execApprovals.approvers) veya commands.ownerAllowFrom üzerinden çıkarılabilir. Slack plugin onayı doğrudan mesajları, Slack çalıştırma onaylayanlarını değil allowFrom içindeki Slack plugin onaylayanlarını ve hesap varsayılan yönlendirmesini kullanır. Slack yerel düğmeleri onay kimliği türünü korur; böylece plugin: kimlikleri ikinci bir Slack’e özgü geri dönüş katmanı olmadan plugin onaylarını çözebilir.
• Google Chat yerel kartları, ileti metnindeki manuel /approve geri dönüşünü korur ancak kart düğmesi geri çağrıları yalnızca opak eylem belirteçleri taşır; onay kimliği ve karar sunucu tarafındaki bekleyen durumdan alınır.
• WhatsApp emoji onayları, eşleşen üst düzey iletme ailesi WhatsApp’a yönlendirildiğinde hem çalıştırma hem de plugin istemlerini işler. Yerel kaynaklı istemler doğrudan bağlanır; paylaşılan hedef modundaki teslim, aynı türü belirlenmiş onay meta verilerini kabul edilen WhatsApp ileti makbuzuna bağlar.
• Signal tepki onayları, yalnızca eşleşen üst düzey iletme ailesi etkinleştirildiğinde ve Signal’e yönlendirildiğinde hem çalıştırma hem de plugin istemlerini işler. Doğrudan aynı sohbetten Signal çalıştırma onayları, açık onaylayanlar olmadan yerel /approve geri dönüşünü engelleyebilir; Signal tepki çözümlemesi yine de channels.signal.allowFrom veya defaultTo üzerinden açıkça belirtilmiş Signal onaylayanları gerektirir.
• Matrix yerel doğrudan mesaj/kanal yönlendirmesi ve tepki kısayolları hem çalıştırma hem de plugin onaylarını işler; plugin yetkilendirmesi yine channels.matrix.dm.allowFrom üzerinden gelir. Matrix yerel istemleri, ilk istem olayında com.openclaw.approval özel olay içeriğini barındırır; böylece OpenClaw uyumlu Matrix istemcileri yapılandırılmış onay durumunu okuyabilirken standart istemciler düz metin /approve geri dönüşünü korur.
• Yerel Discord ve Telegram onay düğmeleri, taşıma katmanına özel geri çağrı verilerinde açık bir çalıştırma veya plugin sahibi türü taşır ve yalnızca o sahibi çözümler. Tür içermeyen eski /approve denetimleri sınırlı bir uyumluluk yolu olarak kalır: yalnızca aktörün onaylayabileceği sahip türlerini dener, yalnızca onay bulunamadı sonucundan sonra devam eder ve hiçbir zaman onay kimliğinden sahipliği çıkarmaz.
• İstekte bulunan kişinin onaylayan olması gerekmez.
• Hiçbir operatör kullanıcı arayüzü veya yapılandırılmış onay istemcisi isteği kabul edemiyorsa istem, askFallback değerine geri döner.

• Discord
• Telegram
• QQ bot

​

Resmî mobil operatör uygulamaları

​

macOS IPC akışı

Gateway -> Node Hizmeti (WS)
                 |  IPC (UDS + belirteç + HMAC + TTL)
                 v
             Mac Uygulaması (kullanıcı arayüzü + onaylar + system.run)

• Unix yuvası modu 0600, belirteç exec-approvals.json içinde saklanır.
• Aynı UID’ye sahip eş denetimi.
• Sınama/yanıt (tek kullanımlık değer + HMAC belirteci + istek karması) + kısa TTL.

​

SSS

​

Bir onay hedefinde accountId ve threadId ne zaman kullanılır?

{
  approvals: {
    exec: {
      enabled: true,
      mode: "targets",
      targets: [
        {
          channel: "telegram",
          to: "-1001234567890",
          accountId: "ops-bot",
          threadId: "77",
        },
      ],
    },
  },
  channels: {
    telegram: {
      accounts: {
        default: {
          name: "Primary bot",
          botToken: "env:TELEGRAM_PRIMARY_BOT_TOKEN",
        },
        "ops-bot": {
          name: "Operations bot",
          botToken: "env:TELEGRAM_OPS_BOT_TOKEN",
        },
      },
    },
  },
}

​

Onaylar bir oturuma gönderildiğinde, o oturumdaki herkes bunları onaylayabilir mi?

​

İlgili

• Yürütme onayları — temel politika ve onay akışı
• Yürütme aracı
• Yükseltilmiş mod
• Skills — skill destekli otomatik izin verme davranışı