OpenClaw
什么是 OpenClaw?
OpenClaw Github 是一款 AI 驱动的编码助手。它支持超过 20 个 AI 提供商,内置浏览器自动化功能,并集成 Telegram、Discord、Slack 和 WhatsApp 等聊天平台。
需要 HTTPS
OpenClaw 需要 HTTPS 才能正常运行。请确保您的部署已启用 HTTPS。
身份验证
OpenClaw 使用 HTTP 基本身份验证。AUTH_USERNAME 和 AUTH_PASSWORD 环境变量由 Coolify 在部署期间自动生成。
还会生成一个网关令牌 (OPENCLAW_GATEWAY_TOKEN) 用于 API 访问。
AI 提供商
至少需要一个 AI 提供商的 API 密钥。为您的提供商设置相应的环境变量:
- Anthropic —
ANTHROPIC_API_KEY - OpenAI —
OPENAI_API_KEY - Google Gemini —
GEMINI_API_KEY - OpenRouter —
OPENROUTER_API_KEY - Groq —
GROQ_API_KEY - Mistral —
MISTRAL_API_KEY - xAI —
XAI_API_KEY - Cerebras —
CEREBRAS_API_KEY - Amazon Bedrock —
AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY,AWS_REGION - Ollama (本地) —
OLLAMA_BASE_URL
使用 OPENCLAW_PRIMARY_MODEL 设置默认模型。
代理提供商的模型命名
当使用 OpenRouter 或 OpenCode 等代理提供商时,您必须在模型名称前加上提供商路径。例如:
- OpenRouter:
OPENCLAW_PRIMARY_MODEL=openrouter/google/gemini-2.5-flash - OpenCode:
OPENCLAW_PRIMARY_MODEL=opencode/google/gemini-2.5-flash
仅使用 google/gemini-2.5-flash 而不带提供商前缀将无法工作。请始终使用完整的 provider/model 路径。
基于订阅的身份验证
如果您拥有 Anthropic (Claude) 或 OpenAI (Codex) 的订阅,您可以使用它们的 CLI 登录流程进行身份验证,而不是 API 密钥。在 OpenClaw 容器中打开终端并运行:
Anthropic (Claude):
openclaw models auth login --provider anthropicOpenAI (Codex):
openclaw models auth login --provider openai或者,使用引导向导以交互方式设置身份验证:
openclaw onboard您可以使用以下命令验证您的身份验证状态:
openclaw models status有关支持的所有提供商和配置选项的完整列表,请参阅 GitHub 仓库。
浏览器
/browser 端点打开由 OpenClaw 通过 Chrome DevTools 协议 (CDP) 控制的远程浏览器。这对于 OAuth 流程、2FA、验证码解决和经过身份验证的网络抓取非常有用。
浏览器会话通过专用卷在重启后持久保存。您可以使用以下环境变量配置浏览器:
BROWSER_DEFAULT_PROFILE— 浏览器配置文件名称 (默认值:openclaw)BROWSER_SNAPSHOT_MODE— 快照模式 (默认值:efficient)BROWSER_EVALUATE_ENABLED— 启用 JavaScript 评估 (默认值:true)
