环境变量参考
OpenClaw 支持通过环境变量（Environment Variables）进行灵活配置。本页面列出了所有可用的环境变量及其说明。
配置优先级
配置加载顺序（优先级从高到低）
- 环境变量 — 最高优先级，覆盖一切
- 配置文件 (
config.yaml) — 次优先级 - 默认值 — 内置的默认配置
.env 文件支持
OpenClaw 会自动加载项目根目录下的 .env 文件：
bash
# .env 文件示例
OPENCLAW_HOME=/opt/openclaw
OPENCLAW_LOG_LEVEL=info
OPENAI_API_KEY=sk-xxxxxxxxxxxx
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxx安全提示
.env 文件包含敏感的 API Key，请确保：
- 已添加到
.gitignore中，避免提交到版本库 - 文件权限设置为
600（仅所有者可读写）
核心变量
| 变量名 | 说明 | 默认值 | 示例 |
|---|---|---|---|
OPENCLAW_HOME | OpenClaw 数据主目录 | ~/.openclaw | /opt/openclaw |
OPENCLAW_CONFIG_PATH | 配置文件路径 | $OPENCLAW_HOME/config.yaml | /etc/openclaw/config.yaml |
OPENCLAW_PORT | Gateway（网关）监听端口 | 7681 | 8080 |
OPENCLAW_HOST | 监听地址 | 127.0.0.1 | 0.0.0.0 |
OPENCLAW_MODE | 运行模式 | production | development |
模型提供商密钥
海外模型
| 变量名 | 模型提供商 | 获取地址 |
|---|---|---|
OPENAI_API_KEY | OpenAI (GPT-4o 等) | platform.openai.com |
ANTHROPIC_API_KEY | Anthropic (Claude 等) | console.anthropic.com |
GOOGLE_API_KEY | Google (Gemini 等) | aistudio.google.com |
国产模型
| 变量名 | 模型提供商 | 获取地址 |
|---|---|---|
DEEPSEEK_API_KEY | DeepSeek（深度求索） | platform.deepseek.com |
DASHSCOPE_API_KEY | 通义千问 (Qwen) | bailian.aliyun.com |
MOONSHOT_API_KEY | Moonshot（月之暗面 / Kimi） | platform.moonshot.cn |
ZHIPUAI_API_KEY | 智谱 AI (GLM) | open.bigmodel.cn |
BAIDU_API_KEY | 百度（文心一言 / ERNIE） | cloud.baidu.com |
MINIMAX_API_KEY | MiniMax（稀宇科技） | platform.minimaxi.com |
通道令牌（Channel Tokens）
| 变量名 | 通道 | 说明 |
|---|---|---|
TELEGRAM_BOT_TOKEN | Telegram（电报） | BotFather 生成的 Bot Token |
SLACK_BOT_TOKEN | Slack | OAuth Bot Token，以 xoxb- 开头 |
DISCORD_BOT_TOKEN | Discord | Developer Portal 生成的 Token |
WECOM_CORP_ID | 企业微信 | 企业 ID |
WECOM_AGENT_ID | 企业微信 | 应用 AgentId |
WECOM_SECRET | 企业微信 | 应用 Secret |
DINGTALK_APP_KEY | 钉钉（DingTalk） | 应用 AppKey |
DINGTALK_APP_SECRET | 钉钉 | 应用 AppSecret |
FEISHU_APP_ID | 飞书（Feishu / Lark） | 应用 App ID |
FEISHU_APP_SECRET | 飞书 | 应用 App Secret |
网络代理
bash
# HTTP/HTTPS 代理
HTTP_PROXY=http://127.0.0.1:7890
HTTPS_PROXY=http://127.0.0.1:7890
# 不使用代理的地址列表
NO_PROXY=localhost,127.0.0.1,.aliyuncs.com,.tencent.com国内用户代理建议
仅在访问海外模型 API（OpenAI、Anthropic 等）和海外通道（Telegram、Slack 等）时需要代理。国产模型和国内通道无需代理，建议在 NO_PROXY 中排除国内域名。详见 国内网络配置。
数据库配置
| 变量名 | 说明 | 默认值 |
|---|---|---|
OPENCLAW_DB_PATH | SQLite 数据库文件路径 | $OPENCLAW_HOME/data/openclaw.db |
OPENCLAW_DB_WAL | 启用 WAL（预写式日志）模式 | true |
OPENCLAW_DB_BACKUP_INTERVAL | 自动备份间隔（小时） | 24 |
日志配置
| 变量名 | 说明 | 默认值 | 可选值 |
|---|---|---|---|
OPENCLAW_LOG_LEVEL | 日志级别 | info | trace, debug, info, warn, error |
OPENCLAW_LOG_FILE | 日志文件路径 | $OPENCLAW_HOME/logs/openclaw.log | 任意文件路径 |
OPENCLAW_LOG_MAX_SIZE | 单个日志文件最大大小 | 50m | 如 100m, 1g |
OPENCLAW_LOG_MAX_FILES | 保留的日志文件数量 | 10 | 任意正整数 |
OPENCLAW_LOG_FORMAT | 日志格式 | text | text, json |
Docker 专属变量
在 Docker 部署中可用的额外变量：
bash
# Docker Compose 示例
services:
openclaw:
image: registry.cn-hangzhou.aliyuncs.com/openclaw/openclaw:latest
environment:
- OPENCLAW_HOST=0.0.0.0
- OPENCLAW_PORT=7681
- OPENCLAW_LOG_LEVEL=info
- OPENCLAW_DB_PATH=/app/data/openclaw.db
- TZ=Asia/Shanghai
volumes:
- ./data:/app/data
- ./logs:/app/logs
ports:
- "7681:7681"| 变量名 | 说明 | 默认值 |
|---|---|---|
TZ | 容器时区 | UTC |
PUID | 运行用户 UID | 1000 |
PGID | 运行用户 GID | 1000 |
🇨🇳 国内特别配置
bash
# 国内镜像加速
NPM_REGISTRY=https://registry.npmmirror.com
# 代理配置（仅海外服务需要）
HTTP_PROXY=http://127.0.0.1:7890
HTTPS_PROXY=http://127.0.0.1:7890
NO_PROXY=localhost,127.0.0.1,.deepseek.com,.aliyuncs.com,.tencent.com,.baidu.com
# 国产模型 API Key
DEEPSEEK_API_KEY=sk-your-deepseek-key
DASHSCOPE_API_KEY=sk-your-dashscope-key