Plugin izin istekleri

​

Doğru geçidi seçme

​

Araç çağrısından önce onay isteme

import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";

export default definePluginEntry({
  id: "deploy-policy",
  name: "Dağıtım Politikası",
  register(api) {
    api.on("before_tool_call", async (event) => {
      if (event.toolName !== "deploy_service") {
        return;
      }

      const environment =
        typeof event.params.environment === "string" ? event.params.environment : "unknown";

      return {
        requireApproval: {
          title: "Hizmeti dağıt",
          description: `Hizmeti ${environment} ortamına dağıt.`,
          severity: environment === "production" ? "critical" : "warning",
          allowedDecisions:
            environment === "production"
              ? ["allow-once", "deny"]
              : ["allow-once", "allow-always", "deny"],
          timeoutMs: 120_000,
          onResolution(decision) {
            console.log(`dağıtım onayı sonuçlandı: ${decision}`);
          },
        },
      };
    });
  },
});

• title değerini kısa ve eylem odaklı tutun; Gateway bunu 80 karakterle sınırlar.
• description değerini belirli ve sınırlı tutun; Gateway bunu 512 karakterle sınırlar.
• Eylemi, hedefi ve riski belirtin. Sohbet onay yüzeylerinde görünmemesi gereken gizli bilgileri, belirteçleri veya özel yükleri eklemeyin.
• severity belirtilmediğinde varsayılan olarak "warning" kullanılır. "critical" değerini yalnızca yanlış kararın üretim ortamında hasara veya veri kaybına yol açabileceği eylemler için kullanın.
• allowedDecisions belirtilmediğinde varsayılan olarak ["allow-once", "allow-always", "deny"] kullanılır. Söz konusu eylem için kalıcı güven uygun değilse ["allow-once", "deny"] değerini geçirin.
• timeoutMs varsayılan olarak 120000 (2 dakika) değerindedir ve istenen değerden bağımsız olarak en fazla 600000 (10 dakika) olabilir.

​

Karar davranışı

​

Onay istemlerini yönlendirme

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

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

​

Codex yerel izinleri

• Codex uygulama sunucusu onay istekleri, Codex incelemesinden sonra OpenClaw üzerinden yönlendirilir.
• Yerel permission_request kanca aktarıcısı etkinleştirildiğinde plugin.approval.request üzerinden istekte bulunabilir.
• Codex, _meta.codex_approval_kind öğesini "mcp_tool_call" olarak işaretlediğinde MCP araç onayı talepleri Plugin onayları üzerinden yönlendirilir.

​

Sorun giderme

​

İlgili konular

• Plugin kancaları
• Plugin oluşturma
• Gelişmiş yürütme onayları
• Gateway protokolü
• Codex çalıştırma altyapısı çalışma zamanı