Żądania uprawnień Pluginu

​

Wybór właściwej bramy

​

Żądanie zatwierdzenia przed wywołaniem narzędzia

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

export default definePluginEntry({
  id: "deploy-policy",
  name: "Deploy Policy",
  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: "Deploy service",
          description: `Deploy service to ${environment}.`,
          severity: environment === "production" ? "critical" : "warning",
          allowedDecisions:
            environment === "production"
              ? ["allow-once", "deny"]
              : ["allow-once", "allow-always", "deny"],
          timeoutMs: 120_000,
          onResolution(decision) {
            console.log(`deploy approval resolved: ${decision}`);
          },
        },
      };
    });
  },
});

• Pole title powinno być krótkie i skoncentrowane na działaniu; Gateway ogranicza je do 80 znaków.
• Pole description powinno być konkretne i precyzyjnie ograniczone; Gateway ogranicza je do 512 znaków.
• Należy uwzględnić działanie, cel i ryzyko. Nie należy podawać sekretów, tokenów ani prywatnych ładunków, które nie powinny pojawiać się w interfejsach zatwierdzania na czacie.
• Jeśli pominięto severity, domyślnie przyjmuje ono wartość "warning". Wartości "critical" należy używać wyłącznie w przypadku działań, przy których błędna decyzja może spowodować szkody w środowisku produkcyjnym lub utratę danych.
• Jeśli pominięto allowedDecisions, domyślnie przyjmuje ono wartość ["allow-once", "allow-always", "deny"]. Wartość ["allow-once", "deny"] należy przekazać, gdy trwałe zaufanie jest niebezpieczne dla danego działania.
• Domyślna wartość timeoutMs wynosi 120000 (2 minuty), a maksymalna 600000 (10 minut), niezależnie od żądanej wartości.

​

Sposób obsługi decyzji

​

Kierowanie monitów zatwierdzania

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

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

​

Natywne uprawnienia Codex

• Żądania zatwierdzenia serwera aplikacji Codex są kierowane przez OpenClaw po weryfikacji przez Codex.
• Przekaźnik natywnego hooka permission_request może wysyłać żądania przez plugin.approval.request, gdy ten przekaźnik jest włączony.
• Żądania zatwierdzenia narzędzi MCP są kierowane przez zatwierdzenia Pluginu, gdy Codex oznaczy _meta.codex_approval_kind jako "mcp_tool_call".

​

Rozwiązywanie problemów

​

Powiązane

• Hooki Pluginu
• Tworzenie Pluginów
• Zaawansowane zatwierdzenia wykonywania
• Protokół Gateway
• Środowisko wykonawcze uprzęży Codex