openclaw docker部署必须手动注入环境变量，否则服务初始化失败；需先确认镜像存在，再通过docker run -e、--env-file或docker-compose.yml方式注入openclaw_api_key等必要变量。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw Docker部署时需手动注入环境变量，否则容器启动后服务无法读取配置参数导致初始化失败。
确认OpenClaw镜像已拉取并存在本地
执行 docker images | grep openclaw，确保输出中包含类似 openclaw/openclaw latest xxxMB 的条目。若无结果，先运行 docker pull openclaw/openclaw:latest。
这一步不能跳过——镜像不存在时后续所有环境变量设置都无效。
使用 -e 参数在运行时注入单个变量
方法一：直接命令行传参
运行 docker run -d --name openclaw-core -e OPENCLAW_API_KEY=abc123 -e OPENCLAW_ENV=prod -p 8080:8080 openclaw/openclaw:latest。
【OPENCLAW_API_KEY 必须设置，缺失将触发容器内鉴权拒绝，进程立即退出】
方法二：批量传参用 --env-file
新建文本文件 openclaw.env，每行写一个 KEY=VALUE，例如：
OPENCLAW_API_KEY=xyz789<br>OPENCLAW_DB_HOST=db.example.com<br>OPENCLAW_LOG_LEVEL=debug
然后执行 docker run -d --name openclaw-core --env-file ./openclaw.env -p 8080:8080 openclaw/openclaw:latest。
通过 docker-compose.yml 持久化环境变量配置
第一步：创建 docker-compose.yml 文件
第二步：写入以下内容（注意缩进必须为两个空格）：
version: "3.8"<br>services:<br> openclaw:<br> image: openclaw/openclaw:latest<br> environment:<br> - OPENCLAW_API_KEY=your_real_key_here<br> - OPENCLAW_ENV=prod<br> - OPENCLAW_TIMEOUT=30000<br> ports:<br> - "8080:8080"
第三步：执行 docker-compose up -d 启动服务。
第四步：验证变量是否生效，进入容器执行 docker exec -it openclaw sh -c 'printenv | grep OPENCLAW'，应看到全部设置的变量名与值。
