OpenClaw + Docker + MiniMax 本地部署方案

项目	要求
操作系统	macOS 12+ (Monterey 或更高)
内存	建议 8GB+
磁盘空间	至少 20GB 可用空间
CPU	Apple Silicon (M1/M2/M3) 或 Intel

OpenClaw + Docker + MiniMax 本地部署方案 | 极客日志

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js 22+
brew install node@22
# 验证 Node.js 版本
node --version
# 应显示 v22.x.x 或更高
# 安装 Colima (Docker 替代方案，无需安装 Docker Desktop)
brew install colima
# 安装 Docker CLI
brew install docker docker-compose

# Colima 配置
cpu: 4
memory: 8
disk: 60
# 网络配置
network:
  address: true
  # 允许容器访问主机网络
  # 端口转发
portForwarding:
  - 18789:18789 # OpenClaw Gateway
  - 18790:18790 # OpenClaw Canvas
# 挂载点
mounts:
  - location: ~/openclaw-workspace
    writable: true
  - location: ~/.openclaw
    writable: true
# 环境变量
env:
  - NODE_ENV=production

# 创建工作目录
mkdir -p ~/openclaw-workspace
mkdir -p ~/.openclaw
# 启动 Colima
colima start --cpu 4 --memory 8 --disk 60
# 验证 Docker 运行状态
docker ps

# 创建专用网络
docker network create openclaw-net
# 验证网络
docker network ls | grep openclaw

# 创建配置目录
mkdir -p ~/openclaw-deploy/{config,workspace,logs}
# 设置权限
chmod 700 ~/openclaw-deploy

services:
  openclaw-gateway:
    image: node:22
    container_name: openclaw
    hostname: openclaw
    environment:
      - NODE_ENV=production
      - OPENCLAW_STATE_DIR=/home/node/.openclaw
      - OPENCLAW_WORKSPACE_DIR=/home/node/workspace
      - OPENCLAW_GATEWAY_PORT=18789
      - MINIMAX_API_KEY=${MINIMAX_API_KEY}
      - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}
      - npm_config_registry=https://registry.npmmirror.com
    volumes:
      - ./config:/home/node/.openclaw:rw
      - ./workspace:/home/node/workspace:rw
      - ./logs:/home/node/logs:rw
    ports:
      - "127.0.0.1:18789:18789"
      - "127.0.0.1:18790:18790"
    working_dir: /home/node
    command: >
      bash -c " apt-get update && apt-get install -y git curl cmake make gcc g++ python3 && npm config set registry https://registry.npmmirror.com && npm install -g openclaw@latest && openclaw gateway --port 18789 --bind lan "
    restart: unless-stopped
    networks:
      - openclaw-net
    security_opt:
      - no-new-privileges:true
networks:
  openclaw-net:
    driver: bridge

# MiniMax API 密钥（从 MiniMax 平台获取）
# https://platform.minimaxi.com
MINIMAX_API_KEY=your-minimax-api-key-here
# Gateway 访问令牌（请设置强密码）
OPENCLAW_GATEWAY_TOKEN=your-secure-token-here

{
  "gateway": {
    "mode": "local",
    "port": 18789,
    "auth": {
      "mode": "token",
      "token": "${OPENCLAW_GATEWAY_TOKEN}"
    },
    "controlUi": {
      "allowedOrigins": ["http://127.0.0.1:18789", "http://localhost:18789"]
    }
  },
  "models": {
    "providers": {
      "minimax": {
        "baseUrl": "https://api.minimaxi.com/anthropic",
        "apiKey": "${MINIMAX_API_KEY}",
        "models": [
          { "id": "MiniMax-M2.5", "name": "MiniMax M2.5" },
          { "id": "MiniMax-M2.5-highspeed", "name": "MiniMax M2.5 Highspeed" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": "minimax/MiniMax-M2.5",
      "workspace": "/home/node/workspace",
      "sandbox": {
        "mode": "off"
      }
    }
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "tools": {
    "profile": "minimal",
    "deny": ["gateway", "cron", "sessions_spawn", "sessions_send"],
    "fs": {
      "workspaceOnly": true
    },
    "exec": {
      "security": "deny"
    },
    "elevated": {
      "enabled": false
    }
  },
  "logging": {
    "redactSensitive": "tools"
  },
  "discovery": {
    "mdns": {
      "mode": "off"
    }
  }
}

配置项	说明
`baseUrl`	MiniMax API 地址（推荐使用 Anthropic 兼容端点）
`apiKey`	从环境变量 `${MINIMAX_API_KEY}` 读取，避免硬编码
`models`	必须是数组格式
`agents.defaults.model`	必须是字符串格式 `provider/model-id`

docker exec openclaw sh -c "API_KEY=\$MINIMAX_API_KEY && cat > /home/node/.openclaw/agents/main/agent/models.json << EOF
{
  \"providers\": {
    \"minimax\": {
      \"baseUrl\": \"https://api.minimaxi.com/anthropic\",
      \"api\": \"anthropic-messages\",
      \"models\": [
        {
          \"id\": \"MiniMax-M2.5\",
          \"name\": \"MiniMax M2.5\",
          \"reasoning\": true,
          \"input\": [\"text\"],
          \"cost\": {\"input\": 0.3, \"output\": 1.2, \"cacheRead\": 0.03, \"cacheWrite\": 0.12},
          \"contextWindow\": 204800,
          \"maxTokens\": 8192
        },
        {
          \"id\": \"MiniMax-M2.5-highspeed\",
          \"name\": \"MiniMax M2.5 Highspeed\",
          \"reasoning\": true,
          \"input\": [\"text\"],
          \"cost\": {\"input\": 0.1, \"output\": 0.8, \"cacheRead\": 0.01, \"cacheWrite\": 0.08},
          \"contextWindow\": 204800,
          \"maxTokens\": 8192
        }
      ],
      \"apiKey\": \"\$API_KEY\"
    }
  }
}
EOF"

模型 ID	说明	上下文长度
`MiniMax-M2.5`	M2.5 完整版（推荐）	204800
`MiniMax-M2.5-highspeed`	M2.5 高速版	204800

{
  "agents": {
    "defaults": {
      "workspace": "/home/node/workspace",
      "sandbox": {
        "mode": "off"
      }
    }
  },
  "tools": {
    "fs": {
      "workspaceOnly": true
    }
  }
}

{
  "tools": {
    "profile": "minimal",
    "fs": {
      "workspaceOnly": true
    },
    "exec": {
      "security": "deny"
    },
    "elevated": {
      "enabled": false
    }
  }
}

ports:
  # 仅绑定本地回环地址
  - "127.0.0.1:18789:18789"
  - "127.0.0.1:18790:18790"

cd ~/openclaw-deploy
# 启动 Colima（如未启动）
colima start
# 启动 OpenClaw
docker-compose up -d
# 查看日志
docker-compose logs -f openclaw-gateway

# 检查容器状态
docker ps | grep openclaw
# 检查端口监听
lsof -i :18789
# 测试 Web 界面
curl -s http://127.0.0.1:18789/ | head -20

docker exec openclaw sh -c 'curl -s -X POST https://api.minimaxi.com/anthropic/v1/messages \
-H "x-api-key: $MINIMAX_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d "{\"model\":\"MiniMax-M2.5\",\"max_tokens\":10,\"messages\":[{\"role\":\"user\",\"content\":\"Hi\"}]}"'

QQ_APP_ID=your-qq-app-id-here
QQ_APP_SECRET=your-qq-app-secret-here

docker exec openclaw openclaw plugins install @openclaw-china/channels

{
  "channels": {
    "qqbot": {
      "enabled": true,
      "appId": "${QQ_APP_ID}",
      "clientSecret": "${QQ_APP_SECRET}",
      "dmPolicy": "open",
      "groupPolicy": "open"
    }
  }
}

docker-compose restart openclaw-gateway

docker logs openclaw 2>&1 | grep qqbot
# 应看到：[qqbot] gateway ready

// 正确格式
"model": "minimax/MiniMax-M2.5"

npm config set registry https://registry.npmmirror.com

# 查看服务状态
docker-compose ps
# 查看实时日志
docker-compose logs -f --tail=100 openclaw-gateway
# 重启服务
docker-compose restart openclaw-gateway
# 停止服务
docker-compose down
# 更新 OpenClaw
docker-compose down
docker-compose up -d

# 日志位置
~/openclaw-deploy/logs/
# 日志轮转配置（添加到 crontab）
00 * * * find ~/openclaw-deploy/logs -name"*.log" -mtime +7 -delete

提供商	API 地址	获取 API Key	模型示例
DeepSeek	https://api.deepseek.com/v1	https://platform.deepseek.com	deepseek-chat
智谱 AI	https://open.bigmodel.cn/api/paas/v4	https://open.bigmodel.cn	glm-4
阿里通义	https://dashscope.aliyuncs.com/compatible-mode/v1	https://dashscope.console.aliyun.com	qwen-turbo

OpenClaw + Docker + MiniMax 本地部署方案

OpenClaw + Docker + MiniMax 本地部署方案

前言

一、环境准备

1.1 系统要求

1.2 安装 Homebrew

1.3 安装必要工具

二、Colima 安装与配置

2.1 创建 Colima 配置文件

2.2 启动 Colima

2.3 配置 Docker 网络

三、OpenClaw Docker 部署

3.1 创建目录结构

3.2 创建 Docker Compose 文件

3.3 创建环境变量文件

四、MiniMax M2.5 模型配置

4.1 获取 MiniMax API Key

4.2 创建 OpenClaw 配置文件

4.3 配置字段说明

4.4 更新 models.json 文件（重要！）

4.5 MiniMax M2.5 模型列表

4.6 重要注意事项

五、安全配置

5.1 限制文件访问

5.2 限制危险操作

5.3 网络隔离

六、验证与测试

6.1 启动服务

6.2 验证服务状态

6.3 验证 MiniMax API 连接

6.4 访问 Web 界面

七、QQ 机器人接入（可选）

7.1 功能特性

7.2 创建 QQ 机器人

7.3 配置环境变量

7.4 安装中国区插件

7.5 配置通道

7.6 重启服务

7.7 验证连接

八、故障排查

8.1 模型配置错误

8.2 MiniMax API 404 错误

8.3 网络连接问题

8.4 Colima 端口转发问题

8.5 Gateway Token 认证问题

九、运维指南

9.1 日常运维命令

9.2 日志管理

十、切换其他模型（扩展）

10.1 国内其他模型提供商

10.2 切换步骤

总结

参考链接

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具