基于Docker安装OpenClaw 本地 AI 助手教程

本文介绍了OpenClaw Gateway服务的部署指南。环境要求包括Linux/macOS/Windows系统、Docker及2GB+内存。核心步骤：1)通过离线包下载镜像并加载；2)使用docker run或docker-compose启动服务，需设置网关token；3)验证服务状态并访问WebUI（http://IP:18789）。首次登录后需配置AI模型API Key（如DeepSeek、

小灰灰__

830人浏览 · 2026-03-13 15:03:45

小灰灰__ · 2026-03-13 15:03:45 发布

一、环境要求

组件	最低要求	推荐配置
操作系统	Linux (Ubuntu 20.04+), macOS 12+, Windows 10+ (WSL2)	Ubuntu 22.04 LTS
Docker	Docker Engine 20.10+	Docker Compose v2.0+
内存	2 GB	4 GB+
存储	5 GB	10 GB+

二、核心步骤：拉取国内镜像

由于镜像在国内网络环境下拉取困难，我们直接通过离线下载的方式。

1. 拉取镜像

镜像下载地址，下载完成后在终端执行以下命令，将镜像拉取到本地

我用夸克网盘给你分享了「openclaw」，点击链接或复制整段内容，打开「夸克网盘APP」即可获取。
/~48b93M1xLP~:/
链接：https://pan.quark.cn/s/0b9b526fa98d

docker load --input openclaw.tar

2. 查看镜像是否下载成功

docker images -a

三、启动 OpenClaw Gateway 服务

镜像拉取成功后，使用以下命令启动服务。注意：镜像标签较长，建议使用 docker images查看镜像 ID 后使用 ID 启动，或使用以下完整命令。

使用 Docker Run 启动

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  --user root \
  -e OPENCLAW_GATEWAY_TOKEN=testtoken \
  telecom-eci-huadong1-crs-registry.crs-huadong1.ctyun.cn/base_image/openclaw:2026-01-30 \
  openclaw gateway run

或者使用 Docker Compose (推荐)

创建 docker-compose.yml文件：

version: '3.8'
services:
  openclaw:
    image: telecom-eci-huadong1-crs-registry.crs-huadong1.ctyun.cn/base_image/openclaw:2026-01-30
    container_name: openclaw
    ports:
      - "18789:18789"
    environment:
      - OPENCLAW_GATEWAY_TOKEN=your_custom_token_here
    command: openclaw gateway run
    restart: unless-stopped

启动服务：

docker-compose up -d

四、验证与访问

查看容器状态：docker logs -f openclaw
访问 Web UI：浏览器打开 http://你的服务器IP:18789?token=testtoken
输入 Token：在登录界面输入 docker-compose.yml中设置的 OPENCLAW_GATEWAY_TOKEN值（如未设置，查看启动日志获取随机生成的 Token）。

五、修改配置

首次登录后，需在 Web UI 或通过命令行配置 AI 模型 API Key（如 OpenAI、Claude 或国内通义千问、DeepSeek 等），OpenClaw 才能正常进行推理和对话。

这里直接贴出修改的json文件

{
  "meta": {
    "lastTouchedVersion": "2026.1.29",
    "lastTouchedAt": "2026-03-01T16:53:34.972Z"
  },
  "wizard": {
    "lastRunAt": "2026-03-01T16:53:34.961Z",
    "lastRunVersion": "2026.1.29",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "browser": {
    "enabled": true,
    "executablePath": "/usr/bin/chromium",
    "headless": true,
    "noSandbox": true
  },
  "models": {
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.siliconflow.cn/v1",
        "apiKey": "sk-xxxxxx",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-ai/DeepSeek-R1-Distill-Qwen-7B",
            "name": "deepseek-ai/DeepSeek-R1-Distill-Qwen-7B",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 32768,
            "maxTokens": 32768
          },
          {
            "id": "Pro/MiniMaxAI/MiniMax-M2.5",
            "name": "Pro/MiniMaxAI/MiniMax-M2.5",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "deepseek-ai/DeepSeek-V3.2",
            "name": "deepseek-ai/DeepSeek-V3.2",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      },
      "minimax": {
        "baseUrl": "https://api.minimaxi.com/v1",
        "apiKey": "sk-xxxxx",
        "api": "openai-completions",
        "models": [
          {
            "id": "MiniMax-M2.5",
            "name": "MiniMax M2.5",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "MiniMax-M2.5-highspeed",
            "name": "MiniMax M2.5 Highspeed",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "MiniMax-M2.1",
            "name": "MiniMax M2.1",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "MiniMax-M2.1-highspeed",
            "name": "MiniMax M2.1 Highspeed",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "MiniMax-M2",
            "name": "MiniMax M2",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-ai/DeepSeek-V3.2"
      },
      "workspace": "/home/node/.openclaw/workspace",
      "compaction": {
        "mode": "default"
      },
      "heartbeat": {
        "model": "minimax/MiniMax-M2.5"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto"
  },
  "gateway": {
    "port": 28789,
    "mode": "local",
    "bind": "loopback",
    "controlUi": {
      "allowInsecureAuth": true
    },
    "auth": {
      "mode": "token",
      "token": "xxxxx"
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    }
  },
  "skills": {
    "install": {
      "nodeManager": "npm"
    }
  }
}