功能完备且自动化的 OpenClaw Docker 图像
Openclaw 自动构建 快速入门 最小版本(Docker run)
ANTHROPIC_API_KEY — 任何支持的提供商密钥都可以使用(OpenAI, Gemini 等)AUTH_PASSWORD — 使用 HTTP 基本身份验证保护 Web UI(默认用户为 admin, 可通过 AUTH_USERNAME 重写)OPENCLAW_GATEWAY_TOKEN — 内部 API 令牌; 如果省略则自动生成,但要明确设置以获得稳定的 API 访问OPENCLAW_ALLOWED_ORIGINS — (必需) 设置为 http://localhost:5173 或您的前端源,以便为控制 UI 启用 CORS启动后:
http://localhost:8080 (登录: 你的 AUTH_USERNAME / AUTH_PASSWORD)`http://localhost:8080/browser/ (登录: 你的 AUTH_USERNAME / 浏览器 PASSWORD) — 使用此方法登录需要身份验证的网站(如 OAuth、2FA、验证码)。Openclaw 通过 CDP 重用会话。触发器: schedule: '0 */6 * * *' + workflow_dispatch (版本,强制重建,跳过最新标签)。需要的秘密(仓库设置)
| 变量 | 描述 |
|---|---|
ANTHROPIC_API_KEY |
Anthropic API 密钥。配置 Claude 模型（Opus 4.5、Sonnet 4.5、Haiku 4.5）。如果存在，则设置为主密钥。 |
OPENAI_API_KEY |
OpenAI API 密钥。配置 GPT 模型（5.2、5、4.5-preview）。如果没有 Anthropic 密钥，则设置为主密钥。 |
OPENROUTER_API_KEY |
OpenRouter API 密钥。如果没有 Anthropic/OpenAI 密钥，则设置为主密钥。 |
GEMINI_API_KEY |
Google Gemini API 密钥。如果没有其他提供商密钥设置，则设置为主密钥。 |
XAI_API_KEY |
xAI API 密钥。配置 Grok 模型。 |
GROQ_API_KEY |
Groq API 密钥。在 Groq 硬件上配置 LLaMA 模型。 |
MISTRAL_API_KEY |
Mistral API 密钥。配置 Mistral Large 和其他模型。 |
CEREBRAS_API_KEY |
Cerebras API 密钥。在 Cerebras 硬件上配置 LLaMA 模型。 |
VENICE_API_KEY |
Venice AI API 密钥（与 OpenAI 兼容）。配置 LLaMA 3.3 70B。 |
MOONSHOT_API_KEY |
Moonshot API 密钥（与 OpenAI 兼容）。配置 Kimi K2.5。 |
KIMI_API_KEY |
Kimi Coding API 密钥（与 Anthropic 兼容）。配置 K2P5。 |
MINIMAX_API_KEY |
MiniMax API 密钥（与 Anthropic 兼容）。配置 MiniMax M2.1。 |
ZAI_API_KEY |
ZAI API 密钥。配置 GLM 模型。 |
AI_GATEWAY_API_KEY |
Vercel AI Gateway API 密钥。 |
OPENCODE_API_KEY |
OpenCode API 密钥。也可作为 OPENCODE_ZEN_API_KEY 使用。 |
SYNTHETIC_API_KEY |
Synthetic API 密钥（与 Anthropic 兼容）。 |
COPILOT_GITHUB_TOKEN |
GitHub Copilot 令牌。通过 GitHub 配置 Claude 模型。 |
XIAOMI_API_KEY |
Xiaomi MiMo API 密钥（与 Anthropic 兼容）。配置 MiMo v2 Flash。 |
可以同时设置多个提供商。主要模型的优先级: Anthropic > OpenAI > OpenRouter > Gemini > OpenCode > GitHub Copilot > xAI > Groq > Mistral > Cerebras > Venice > Moonshot > Kimi > MiniMax > Synthetic > ZAI > AI Gateway > Xiaomi > Bedrock > Ollama。
| 变量 | 默认值 | 描述 |
|---|---|---|
AWS_ACCESS_KEY_ID |
AWS 访问密钥。AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY 两者均必需。 |
在通过 Coolify 部署时缺少 allowedOrigins 的 https:// 协议 - 导致控制 UI WebSocket 连接断开
由于 SSRF 策略阻止私有网络,Docker 编写浏览器侧车会默默失败
浏览器图像选择
[错误] Docker 图像标签 2026.8.1 显示内部版本为 2026.7.1-2
手动更新图像为 2026.3.28 - 网关不再通过子域名和公共互联网进行访问
登录后 Nginx 基本身份验证持续提示 (最新版本中的回退问题)
升级到 2026.4.21 或更高版本后,Docker 无法登录
它一直在加载,但从未正常工作
自定义提供程序 API 密钥
CLI 示例开始