OpenClaw 支持通过环境变量（Environment Variables）进行灵活配置。本页面列出了所有可用的环境变量及其说明。
配置优先级
配置加载顺序（优先级从高到低）
- 环境变量— 最高优先级，覆盖一切
- 配置文件(
config.yaml) — 次优先级 - 默认值— 内置的默认配置
.env 文件支持
OpenClaw 会自动加载项目根目录下的.env文件：
# .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 |
网络代理
# 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 部署中可用的额外变量：
# 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 |
国内特别配置
# 国内镜像加速 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《DeepSeek高效数据分析：从数据清洗到行业案例》聚焦DeepSeek在数据分析领域的高效应用，是系统讲解其从数据处理到可视化全流程的实用指南。作者结合多年职场实战经验，不仅深入拆解DeepSeek数据分析的核心功能——涵盖数据采集、清洗、预处理、探索分析、建模（回归、聚类、时间序列等）及模型评估，更通过金融量化数据分析、电商平台数据分析等真实行业案例，搭配报告撰写技巧，提供独到见解与落地建议。助力职场人在激烈竞争中凭借先进技能突破瓶颈，实现职业进阶，开启发展新篇。
