环境变量

OpenClaw 从多个来源读取环境变量，提供灵活的配置方式。

来源优先级

1. 进程环境变量 - 从父进程继承
2. .env 文件 - 当前工作目录
3. 全局 .env - ~/.openclaw/.env
4. 配置中的 env 块 - 内联环境变量

配置示例

{
  env: {
    // 来自进程环境或 .env 文件
    OPENAI_API_KEY: "sk-...",
    
    // 配置中的内联变量
    vars: {
      CUSTOM_API_KEY: "xxx"
    },
    
    // Shell 环境集成（可选）
    shellEnv: {
      enabled: true,
      timeoutMs: 15000
    }
  }
}

常用环境变量

变量	用途
OPENAI_API_KEY	OpenAI API 密钥
ANTHROPIC_API_KEY	Anthropic API 密钥
OPENCLAW_GATEWAY_TOKEN	网关认证令牌
OPENCLAW_STATE_DIR	状态目录覆盖
NO_COLOR	禁用 ANSI 颜色

相关文档

• 网关配置 - 完整配置选项
• 认证 - OAuth 配置