Variables d’environnement

OpenClaw charge les variables d’environnement à partir de plusieurs sources. La règle est de ne jamais écraser les valeurs existantes.

Priorité (de la plus élevée à la plus basse)

Environnement du processus (ce que le processus de la Gateway (passerelle) possède déjà depuis le shell/le démon parent).
.env dans le répertoire de travail courant (valeur par défaut de dotenv ; n’écrase pas).
.env global à ~/.openclaw/.env (alias $OPENCLAW_STATE_DIR/.env ; n’écrase pas).
Bloc de configuration env dans ~/.openclaw/openclaw.json (appliqué uniquement si manquant).
Import facultatif du shell de connexion (env.shellEnv.enabled ou OPENCLAW_LOAD_SHELL_ENV=1), appliqué uniquement pour les clés attendues manquantes.

Si le fichier de configuration est entièrement absent, l’étape 4 est ignorée ; l’import du shell s’exécute toujours s’il est activé.

Bloc de configuration `env`

Deux façons équivalentes de définir des variables d’environnement inline (les deux sans écrasement) :

{
  env: {
    OPENROUTER_API_KEY: "sk-or-...",
    vars: {
      GROQ_API_KEY: "gsk-...",
    },
  },
}

Import des variables d’environnement du shell

env.shellEnv lance votre shell de connexion et importe uniquement les clés attendues manquantes :

{
  env: {
    shellEnv: {
      enabled: true,
      timeoutMs: 15000,
    },
  },
}

Env var équivalents:

OPENCLAW_LOAD_SHELL_ENV=1
OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000

Substitution de variables d’environnement dans la configuration

Vous pouvez référencer des variables d’environnement directement dans les valeurs de chaînes de la configuration en utilisant la syntaxe ${VAR_NAME} :

{
  models: {
    providers: {
      "vercel-gateway": {
        apiKey: "${VERCEL_GATEWAY_API_KEY}",
      },
    },
  },
}

Voir Configuration : substitution de variables d’environnement pour plus de détails.

Variable	Objectif
`OPENCLAW_HOME`	Remplacer le répertoire personnel utilisé pour toute la résolution interne des chemins (`~/.openclaw/`, répertoires des agents, sessions, identifiants). Useful when running OpenClaw as a dedicated service user.
`OPENCLAW_STATE_DIR`	Remplacer le répertoire d’état (par défaut `~/.openclaw`).
`OPENCLAW_CONFIG_PATH`	Remplacer le chemin du fichier de configuration (par défaut `~/.openclaw/openclaw.json`).

`OPENCLAW_HOME`

Lorsqu’il est défini, OPENCLAW_HOME remplace le répertoire personnel du système ($HOME / os.homedir()) pour toute la résolution interne des chemins. Cela permet une isolation complète du système de fichiers pour les comptes de service sans interface graphique. Priorité : OPENCLAW_HOME > $HOME > USERPROFILE > os.homedir() Exemple (LaunchDaemon macOS) :

<key>EnvironmentVariables</key>
<dict>
  <key>OPENCLAW_HOME</key>
  <string>/Users/kira</string>
</dict>

OPENCLAW_HOME peut également être défini avec un chemin utilisant le tilde (par ex. ~/svc), qui est développé à l’aide de $HOME avant utilisation.

Aide

Communauté

Environnement et débogage

Runtime Node

Internes de compaction

Configuration développeur

Méta documentation

Variables d'environnement

Variables d’environnement

Priorité (de la plus élevée à la plus basse)

Bloc de configuration `env`

Import des variables d’environnement du shell

Substitution de variables d’environnement dans la configuration

`OPENCLAW_HOME`

Liens connexes

​Variables d’environnement

​Priorité (de la plus élevée à la plus basse)

​Bloc de configuration env

​Import des variables d’environnement du shell

​Substitution de variables d’environnement dans la configuration

​Path-related env vars

​OPENCLAW_HOME

​Liens connexes

Variables d’environnement

Priorité (de la plus élevée à la plus basse)

Bloc de configuration `env`

Import des variables d’environnement du shell

Substitution de variables d’environnement dans la configuration

Path-related env vars

`OPENCLAW_HOME`

Liens connexes