要求

• Docker Desktop（或 Docker Engine）+ Docker Compose v2

• 足够的磁盘空间用于镜像 + 日志

github拉取

git clone https://github.com/openclaw/openclaw.git

在openclaw目录下运行

./docker-setup.sh # 快速安装脚本

此脚本：

• 构建 Gateway 网关镜像

• 运行新手引导向导

• 打印可选的提供商设置提示

• 通过 Docker Compose 启动 Gateway 网关

• 生成 Gateway 网关令牌并写入 .env

可选环境变量：

• OPENCLAW_DOCKER_APT_PACKAGES — 在构建期间安装额外的 apt 包

• OPENCLAW_EXTRA_MOUNTS — 添加额外的主机绑定挂载

• OPENCLAW_HOME_VOLUME — 在命名卷中持久化 /home/node

完成后：

• 在浏览器中打开 http://127.0.0.1:18789/。

• 将令牌粘贴到控制 UI（设置 → token）。

• 需要再次获取带令牌的 URL？运行 docker compose run --rm openclaw-cli dashboard --no-open。

它在主机上写入配置/工作区：

• ~/.openclaw/

• ~/.openclaw/workspace

安装选择

1. 确认使用模式

   • 选择个人使用模式（Yes）

2. 选择配置模式

   • 选择 QuickStart 快速启动模式

   • 网关配置：端口 18789，绑定 Loopback (127.0.0.1)，Token 认证

3. 配置 AI 模型（关键步骤）

   • 选择 OpenAI 作为提供商

   • 重要：选择 ○ OpenAI API key（而不是 OpenAI Codex）

   • 输入 DeepSeek API Key：sk-bc96***************8f57

   • 手动输入模型：deepseek-chat

   • API Base URL：https://api.deepseek.com/v1

⏭️ 跳过的配置项（可后续添加）

您明智地选择了跳过以下非核心配置：

• ✅ 聊天渠道 - 选了 Skip for now（Telegram/WhatsApp等）

• ✅ 联网搜索 - 选了 Skip for now（Brave/Perplexity等）

• ✅ 技能依赖 - 全选 No（1password/github/obsidian等）

• ✅ API Keys - 全选 No（Google Places/Gemini/Notion/OpenAI Whisper/ElevenLabs）

• ✅ 钩子功能 - 选了 Skip for now

其他bug

1. origin not allowed (open the Control UI from the gateway host or allow it in gateway.controlUi.allowedOrigins)

这是配置文件不认可你访问的ip

nano ~/.openclaw/openclaw.json

# 修改
"controlUi": {
  "allowedOrigins": [
    "http://localhost:18789",
    "http://127.0.0.1:18789",
    "http://172.20.106.123:18789",
    "http://192.168.1.2:18789"
  ]
}

2. control ui requires device identity (use HTTPS or localhost secure context)

“不安全访问”被拒绝，可以在配置文件里修改，但安全性降低

建议使用“http://localhost:18789”

3. pairing required

这个错误说明需要配对设备。OpenClaw 的 Control UI 在非 localhost 访问时需要设备配对。
参考：OpenClaw Pairing required 错误解决方案详解 - 知乎

4.对话是出现：⚠️ Agent failed before reply: Unknown model: anthropic/deepseek-chat.Logs: openclaw logs --follow （这是使用deepseek 的原因）

这是因为openclaw官方没有适配deepseek 请求模型

可以参考：[功能]：支持DeepSeek API作为一流大型语言模型提供商 ·问题 #7309 ·OpenClaw/OpenClaw

也可以更换支持的模型（如下）：

     Model/auth provider
    │  ○ OpenAI
    │  ○ Anthropic
    │  ○ Chutes
    │  ○ vLLM
    │  ● MiniMax
    │  ○ Moonshot AI (Kimi K2.5)
    │  ○ Google
    │  ○ xAI (Grok)
    │  ○ OpenRouter
    │  ○ Qwen (OAuth)
    │  ○ Z.AI
    │  ○ Qianfan
    │  ○ Copilot
    │  ○ Vercel AI Gateway
    │  ○ OpenCode Zen
    │  ○ Xiaomi
    │  ○ Synthetic
    │  ○ Together AI
    │  ○ Hugging Face
    │  ○ Venice AI
    │  ○ LiteLLM
    │  ○ Cloudflare AI Gateway
    │  ○ Custom Provider
    │  ○ Skip for now​

适用于deepseek

    {
      env: {
        DEEPSEEK_API_KEY: "sk-..."
      },
      models: {
        mode: "merge",
        providers: {
          deepseek: {
            baseUrl: "https://api.deepseek.com/v1",
            apiKey: "${DEEPSEEK_API_KEY}",
            api: "openai-completions",
            models: [
              {
                id: "deepseek-chat",
                name: "DeepSeek Chat",
                api: "openai-completions",
                reasoning: false,
                input: ["text"],
                cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
                contextWindow: 128000,
                maxTokens: 8192
              }
            ]
          }
        }
      },
      agents: {
        defaults: {
          model: {
            primary: "deepseek/deepseek-chat"
          }
        }
      }
    }