.env 文件内容

OpenClaw 的环境变量配置通常用于设置其运行时参数、路径和其他配置选项，以下是常见的配置方法：

Linux/macOS 环境配置

临时设置（当前会话有效）

export OPENCLAW_API_KEY="your-api-key"
export OPENCLAW_MODEL_PATH="/path/to/models"
export OPENCLAW_LOG_LEVEL="DEBUG"
export OPENCLAW_CACHE_DIR="/path/to/cache"

永久设置

添加到 ~/.bashrc 或 ~/.zshrc：

echo 'export OPENCLAW_API_KEY="your-api-key"' >> ~/.bashrc
echo 'export OPENCLAW_MODEL_PATH="$HOME/.openclaw/models"' >> ~/.bashrc
echo 'export OPENCLAW_CACHE_DIR="$HOME/.openclaw/cache"' >> ~/.bashrc
source ~/.bashrc

使用环境变量文件： 创建 .env 文件：

OPENCLAW_BASE_URL=https://api.example.com
OPENCLAW_TIMEOUT=30
OPENCLAW_MAX_RETRIES=3

加载环境文件：

# 手动加载
source .env
# 或在程序中自动加载
python -c "from dotenv import load_dotenv; load_dotenv()"

Windows 环境配置

命令行临时设置

set OPENCLAW_API_KEY=your-api-key
set OPENCLAW_MODEL_PATH=C:\path\to\models

永久系统设置

1. 通过图形界面：

   • 右键点击"此电脑" → 属性
   • 高级系统设置 → 环境变量
   • 在"系统变量"或"用户变量"中添加

2. 使用 PowerShell：

   # 用户级别

系统级别（需要管理员权限）

## 3. **常用环境变量**
### 核心配置
```bash
# API 相关
OPENCLAW_API_KEY="sk-..."          # API密钥
OPENCLAW_BASE_URL="https://..."    # API基础URL
OPENCLAW_ORGANIZATION="org-..."    # 组织ID
# 模型相关
OPENCLAW_MODEL="gpt-4"             # 默认模型
OPENCLAW_MODEL_PATH="/models"      # 本地模型路径
# 网络设置
OPENCLAW_TIMEOUT=30                # 请求超时（秒）
OPENCLAW_MAX_RETRIES=5             # 最大重试次数
OPENCLAW_PROXY="http://proxy:port" # 代理设置
# 日志和调试
OPENCLAW_LOG_LEVEL="INFO"          # 日志级别
OPENCLAW_DEBUG=true                # 调试模式
OPENCLAW_VERBOSE=true              # 详细输出

性能优化

# 缓存设置
OPENCLAW_CACHE_DIR="$HOME/.cache/openclaw"
OPENCLAW_CACHE_SIZE="10GB"
OPENCLAW_CACHE_TTL="86400"
# 并发设置
OPENCLAW_MAX_CONNECTIONS=100
OPENCLAW_POOL_SIZE=10

在代码中使用环境变量

Python 示例

import os
from openclaw import OpenClaw
# 读取环境变量
api_key = os.getenv("OPENCLAW_API_KEY")
model = os.getenv("OPENCLAW_MODEL", "gpt-3.5-turbo")  # 提供默认值
# 初始化客户端
client = OpenClaw(
    api_key=api_key,
    model=model,
    base_url=os.getenv("OPENCLAW_BASE_URL"),
    timeout=int(os.getenv("OPENCLAW_TIMEOUT", 30))
)

使用 python-dotenv

from dotenv import load_dotenv
import os
# 加载 .env 文件
load_dotenv()
# 现在可以访问环境变量
api_key = os.getenv("OPENCLAW_API_KEY")

Docker 环境配置

Dockerfile 中设置

ENV OPENCLAW_API_KEY="your-key"
ENV OPENCLAW_MODEL_PATH="/app/models"
ENV OPENCLAW_CACHE_DIR="/app/cache"

docker-compose.yml 中设置

version: '3.8'
services:
  openclaw-app:
    image: openclaw:latest
    environment:
      - OPENCLAW_API_KEY=${OPENCLAW_API_KEY}
      - OPENCLAW_MODEL=gpt-4
      - OPENCLAW_LOG_LEVEL=INFO
    env_file:
      - .env  # 从文件加载

验证配置

检查环境变量是否正确设置：

# Linux/macOS
echo $OPENCLAW_API_KEY
env | grep OPENCLAW
# Windows
echo %OPENCLAW_API_KEY%
set OPENCLAW
# PowerShell
Get-ChildItem Env: | Where-Object Name -like "OPENCLAW*"

安全建议

1. 不要硬编码密钥：始终使用环境变量

2. 使用 .env 文件：方便管理，但不要提交到版本控制

3. 添加 .env 到 .gitignore：

   # .gitignore
   .env
   *.env.local

4. 使用密钥管理服务：生产环境推荐使用：

   • AWS Secrets Manager
   • HashiCorp Vault
   • Azure Key Vault

故障排除

如果环境变量未生效：

# 检查是否在正确的 shell 中
echo $SHELL
# 重新加载配置文件
source ~/.bashrc  # 或 ~/.zshrc
# 检查变量是否被覆盖
env | sort | grep OPENCLAW
# 重启终端或 IDE

这些配置方法应该能满足大多数 OpenClaw 的使用场景，具体变量名称和用途请参考 OpenClaw 的官方文档。

标签： 环境变量 配置文件