Coolify logoCoolify

OpenClaw

OpenClaw

什么是 OpenClaw?

OpenClaw Github 是一款 AI 驱动的编码助手。它支持超过 20 个 AI 提供商,内置浏览器自动化功能,并集成 Telegram、Discord、Slack 和 WhatsApp 等聊天平台。

需要 HTTPS

OpenClaw 需要 HTTPS 才能正常运行。请确保您的部署已启用 HTTPS。

身份验证

OpenClaw 使用 HTTP 基本身份验证。AUTH_USERNAMEAUTH_PASSWORD 环境变量由 Coolify 在部署期间自动生成。

还会生成一个网关令牌 (OPENCLAW_GATEWAY_TOKEN) 用于 API 访问。

AI 提供商

至少需要一个 AI 提供商的 API 密钥。为您的提供商设置相应的环境变量:

  • AnthropicANTHROPIC_API_KEY
  • OpenAIOPENAI_API_KEY
  • Google GeminiGEMINI_API_KEY
  • OpenRouterOPENROUTER_API_KEY
  • GroqGROQ_API_KEY
  • MistralMISTRAL_API_KEY
  • xAIXAI_API_KEY
  • CerebrasCEREBRAS_API_KEY
  • Amazon BedrockAWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION
  • Ollama (本地)OLLAMA_BASE_URL

使用 OPENCLAW_PRIMARY_MODEL 设置默认模型。

代理提供商的模型命名

当使用 OpenRouterOpenCode 等代理提供商时,您必须在模型名称前加上提供商路径。例如:

  • 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 anthropic

OpenAI (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)

链接

On this page