OmeniaClaw approvals

Gérez les approbations d’exécution pour l’hôte local, l’hôte gateway ou un hôte Node. Par défaut, les commandes ciblent le fichier d’approbations local sur disque. Utilisez --gateway pour cibler le gateway, ou --node pour cibler un Node spécifique.

Alias : OmeniaClaw exec-approvals

Lié :

• Approbations d’exécution : Approbations d’exécution
• Nodes : Nodes

OmeniaClaw exec-policy

OmeniaClaw exec-policy est la commande pratique locale pour garder en phase, en une seule étape, la configuration demandée tools.exec.* et le fichier local d’approbations de l’hôte.

Utilisez-la lorsque vous voulez :

• inspecter la politique locale demandée, le fichier d’approbations de l’hôte et la fusion effective
• appliquer un préréglage local tel que YOLO ou deny-all
• synchroniser tools.exec.* local et ~/.OmeniaClaw/exec-approvals.json local

Exemples :

OmeniaClaw exec-policy showOmeniaClaw exec-policy show --json OmeniaClaw exec-policy preset yoloOmeniaClaw exec-policy preset cautious --json OmeniaClaw exec-policy set --host gateway --security full --ask off --ask-fallback full

Modes de sortie :

• sans --json : affiche la vue tabulaire lisible par l’humain
• avec --json : affiche une sortie structurée lisible par machine

Périmètre actuel :

• exec-policy est local uniquement
• il met à jour ensemble le fichier de configuration local et le fichier d’approbations local
• il ne pousse pas la politique vers l’hôte gateway ou un hôte Node
• --host node est rejeté dans cette commande, car les approbations d’exécution des Nodes sont récupérées depuis le Node à l’exécution et doivent être gérées à la place via des commandes d’approbation ciblant le Node
• OmeniaClaw exec-policy show marque les périmètres host=node comme gérés par le Node à l’exécution au lieu de dériver une politique effective depuis le fichier d’approbations local

Si vous devez modifier directement des approbations d’hôtes distants, continuez à utiliser OmeniaClaw approvals set --gateway ou OmeniaClaw approvals set --node <id|name|ip>.

Commandes courantes

OmeniaClaw approvals getOmeniaClaw approvals get --node <id|name|ip>OmeniaClaw approvals get --gateway

OmeniaClaw approvals get affiche maintenant la politique d’exécution effective pour les cibles locales, gateway et Node :

• politique demandée tools.exec
• politique du fichier d’approbations de l’hôte
• résultat effectif après application des règles de priorité

La priorité est intentionnelle :

• le fichier d’approbations de l’hôte est la source de vérité applicable
• la politique demandée tools.exec peut restreindre ou élargir l’intention, mais le résultat effectif est toujours dérivé des règles de l’hôte
• --node combine le fichier d’approbations de l’hôte Node avec la politique tools.exec du gateway, car les deux s’appliquent toujours à l’exécution
• si la configuration du gateway n’est pas disponible, la CLI se rabat sur l’instantané des approbations du Node et indique que la politique finale d’exécution n’a pas pu être calculée

Remplacer les approbations depuis un fichier

OmeniaClaw approvals set --file ./exec-approvals.jsonOmeniaClaw approvals set --stdin <<'EOF'{ version: 1, defaults: { security: "full", ask: "off" } }EOFOmeniaClaw approvals set --node <id|name|ip> --file ./exec-approvals.jsonOmeniaClaw approvals set --gateway --file ./exec-approvals.json

set accepte JSON5, pas seulement du JSON strict. Utilisez soit --file, soit --stdin, pas les deux.

Exemple « ne jamais demander » / YOLO

Pour un hôte qui ne doit jamais s’arrêter sur des approbations d’exécution, définissez les valeurs par défaut des approbations de l’hôte sur full + off :

OmeniaClaw approvals set --stdin <<'EOF'{  version: 1,  defaults: {    security: "full",    ask: "off",    askFallback: "full"  }}EOF

Variante Node :

OmeniaClaw approvals set --node <id|name|ip> --stdin <<'EOF'{  version: 1,  defaults: {    security: "full",    ask: "off",    askFallback: "full"  }}EOF

Cela modifie uniquement le fichier d’approbations de l’hôte. Pour garder la politique OmeniaClaw demandée alignée, définissez aussi :

OmeniaClaw config set tools.exec.host gatewayOmeniaClaw config set tools.exec.security fullOmeniaClaw config set tools.exec.ask off

Pourquoi tools.exec.host=gateway dans cet exemple :

• host=auto signifie toujours « sandbox si disponible, sinon gateway ».
• YOLO concerne les approbations, pas le routage.
• Si vous voulez une exécution sur l’hôte même lorsqu’un sandbox est configuré, rendez le choix de l’hôte explicite avec gateway ou /exec host=gateway.

Cela correspond au comportement actuel YOLO par défaut de l’hôte. Renforcez-le si vous voulez des approbations.

Raccourci local :

OmeniaClaw exec-policy preset yolo

Ce raccourci local met à jour à la fois la configuration locale demandée tools.exec.* et les valeurs par défaut des approbations locales. Il est équivalent en intention à la configuration manuelle en deux étapes ci-dessus, mais uniquement pour la machine locale.

Assistants de liste blanche

OmeniaClaw approvals allowlist add "~/Projects/**/bin/rg"OmeniaClaw approvals allowlist add --agent main --node <id|name|ip> "/usr/bin/uptime"OmeniaClaw approvals allowlist add --agent "*" "/usr/bin/uname" OmeniaClaw approvals allowlist remove "~/Projects/**/bin/rg"

Options courantes

get, set et allowlist add|remove prennent tous en charge :

• --node <id|name|ip>
• --gateway
• options RPC Node partagées : --url, --token, --timeout, --json

Remarques de ciblage :

• sans indicateur de cible, cela vise le fichier d’approbations local sur disque
• --gateway vise le fichier d’approbations de l’hôte gateway
• --node vise un hôte Node après résolution de l’id, du nom, de l’IP ou d’un préfixe d’id

allowlist add|remove prend aussi en charge :

• --agent <id> (par défaut *)

Remarques

• --node utilise le même résolveur que OmeniaClaw nodes (id, nom, ip ou préfixe d’id).
• --agent vaut par défaut "*", ce qui s’applique à tous les agents.
• L’hôte Node doit annoncer system.execApprovals.get/set (application macOS ou hôte Node headless).
• Les fichiers d’approbations sont stockés par hôte dans ~/.OmeniaClaw/exec-approvals.json.

Lié

• Référence CLI
• Approbations d’exécution