Skills Config

Toute la configuration liée aux Skills se trouve sous skills dans ~/.openclaw/openclaw.json.

{
  skills: {
    allowBundled: ["gemini", "peekaboo"],
    load: {
      extraDirs: ["~/Projects/agent-scripts/skills", "~/Projects/oss/some-skill-pack/skills"],
      watch: true,
      watchDebounceMs: 250,
    },
    install: {
      preferBrew: true,
      nodeManager: "npm", // npm | pnpm | yarn | bun (Gateway runtime still Node; bun not recommended)
    },
    entries: {
      "image-lab": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // or plaintext string
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

Pour la génération/édition d’images intégrée, privilégiez agents.defaults.imageGenerationModel plus le image_generate tool central. skills.entries.* est destiné uniquement aux flux de travail de compétences personnalisés ou tiers.

Si vous sélectionnez un fournisseur/modèle d’image spécifique, configurez également la clé d’authentification/API de ce fournisseur. Exemples typiques : GEMINI_API_KEY ou GOOGLE_API_KEY pour google/*, OPENAI_API_KEY pour openai/*, et FAL_KEY pour fal/*.

Exemples :

Configuration native de style Nano Banana : agents.defaults.imageGenerationModel.primary: "google/gemini-3-pro-image-preview"
Configuration native de fal : agents.defaults.imageGenerationModel.primary: "fal/fal-ai/flux/dev"

Champs

Les racines des compétences intégrées incluent toujours ~/.openclaw/skills, ~/.agents/skills, <workspace>/.agents/skills et <workspace>/skills.
allowBundled : liste blanche facultative pour les compétences intégrées uniquement. Lorsqu’elle est définie, seules les compétences intégrées de la liste sont éligibles (les compétences gérées, d’agent et d’espace de travail ne sont pas concernées).
load.extraDirs : répertoires de compétences supplémentaires à scanner (la priorité la plus basse).
load.watch : surveiller les dossiers de compétences et actualiser l’instantané des compétences (par défaut : true).
load.watchDebounceMs : délai d’attente (debounce) pour les événements du surveillant de compétences en millisecondes (par défaut : 250).
install.preferBrew : préférer les installateurs brew lorsqu’ils sont disponibles (par défaut : true).
install.nodeManager : préférence de l’installateur node (npm | pnpm | yarn | bun, par défaut : npm). Cela n’affecte que les installations de compétences ; l’exécution du Gateway doit toujours être Node (Bun non recommandé pour WhatsApp/Telegram).
entries.<skillKey> : substitutions par compétence.

Champs par compétence :

enabled : définissez false pour désactiver une compétence même si elle est groupée/installée.
env : variables d’environnement injectées pour l’exécution de l’agent (uniquement si elles ne sont pas déjà définies).
apiKey : commodité optionnelle pour les compétences qui déclarent une env var principale. Prend en charge les chaînes en texte brut ou les objets SecretRef ({ source, provider, id }).

Notes

Par défaut, les clés sous entries correspondent au nom de la compétence. Si une compétence définit metadata.openclaw.skillKey, utilisez plutôt cette clé.
La priorité de chargement est <workspace>/skills → <workspace>/.agents/skills → ~/.agents/skills → ~/.openclaw/skills → compétences groupées → skills.load.extraDirs.
Les modifications apportées aux compétences sont prises en compte au prochain tour de l’agent lorsque l’observateur est activé.

Sandboxed skills + env vars

Lorsqu’une session est sandboxed, les processus de compétences s’exécutent dans Docker. Le bac à sable n’hérite pas du process.env de l’hôte.

Utilisez l’une des options suivantes :

agents.defaults.sandbox.docker.env (ou par agent agents.list[].sandbox.docker.env)
intégrez l’env dans votre image de bac à sable personnalisée

Les env et skills.entries.<skill>.env/apiKey globaux s’appliquent uniquement aux exécutions hôte.