OpenClaw Docker MiniMax 本地养“龙虾”方案前言随着 AI 大模型的快速发展越来越多的开发者希望在本地搭建自己的 AI 助手。OpenClaw 是一款开源的 AI Agent 框架支持多种大模型后端可以轻松构建智能对话系统。MiniMax M2.5 是国内领先的 AI 大模型具有强大的推理能力和优秀的中文理解能力。本文将介绍如何在 macOS 系统上通过 Docker Colima 部署 OpenClaw并配置 MiniMax M2.5 作为大模型后端同时支持 QQ 机器人接入实现多渠道的 AI 助手服务。方案优势完全本地化部署数据安全可控支持多种大模型切换MiniMax、DeepSeek、OpenAI 等支持 QQ 机器人接入扩展应用场景安全配置完善防止数据泄露快速部署建议下载 Trae 国内版让 Trae 按照本部署方案自动执行部署省去手动输入命令的繁琐步骤。一、环境准备1.1 系统要求项目要求操作系统macOS 12 (Monterey 或更高)内存建议 8GB磁盘空间至少 20GB 可用空间CPUApple Silicon (M1/M2/M3) 或 Intel1.2 安装 Homebrew如果尚未安装 Homebrew请执行/bin/bash-c$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)1.3 安装必要工具# 安装 Node.js 22brewinstallnode22# 验证 Node.js 版本node--version# 应显示 v22.x.x 或更高# 安装 Colima (Docker 替代方案无需安装 Docker Desktop)brewinstallcolima# 安装 Docker CLIbrewinstalldockerdocker-compose二、Colima 安装与配置Colima 是 macOS 上的轻量级 Docker 运行时相比 Docker Desktop 更加轻量和高效。2.1 创建 Colima 配置文件创建~/.colima/default/colima.yaml# Colima 配置cpu:4memory:8disk:60# 网络配置network:address:true# 允许容器访问主机网络# 端口转发portForwarding:-18789:18789# OpenClaw Gateway-18790:18790# OpenClaw Canvas# 挂载点mounts:-location:~/openclaw-workspacewritable:true-location:~/.openclawwritable:true# 环境变量env:-NODE_ENVproduction2.2 启动 Colima# 创建工作目录mkdir-p~/openclaw-workspacemkdir-p~/.openclaw# 启动 Colimacolima start--cpu4--memory8--disk60# 验证 Docker 运行状态dockerps2.3 配置 Docker 网络# 创建专用网络dockernetwork create openclaw-net# 验证网络dockernetworkls|grepopenclaw三、OpenClaw Docker 部署3.1 创建目录结构# 创建配置目录mkdir-p~/openclaw-deploy/{config,workspace,logs}# 设置权限chmod700~/openclaw-deploy3.2 创建 Docker Compose 文件创建~/openclaw-deploy/docker-compose.ymlservices:openclaw-gateway:image:node:22container_name:openclawhostname:openclawenvironment:-NODE_ENVproduction-OPENCLAW_STATE_DIR/home/node/.openclaw-OPENCLAW_WORKSPACE_DIR/home/node/workspace-OPENCLAW_GATEWAY_PORT18789-MINIMAX_API_KEY${MINIMAX_API_KEY}-OPENCLAW_GATEWAY_TOKEN${OPENCLAW_GATEWAY_TOKEN}-npm_config_registryhttps://registry.npmmirror.comvolumes:-./config:/home/node/.openclaw:rw-./workspace:/home/node/workspace:rw-./logs:/home/node/logs:rwports:-127.0.0.1:18789:18789-127.0.0.1:18790:18790working_dir:/home/nodecommand: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 openclawlatest openclaw gateway --port 18789 --bind lan restart:unless-stoppednetworks:-openclaw-netsecurity_opt:-no-new-privileges:truenetworks:openclaw-net:driver:bridge重要说明使用node:22(Debian) 而非node:22-alpine因为 Alpine 缺少编译 llama.cpp 所需的系统头文件配置淘宝 npm 镜像加速下载3.3 创建环境变量文件创建~/openclaw-deploy/.env# MiniMax API 密钥从 MiniMax 平台获取# https://platform.minimaxi.comMINIMAX_API_KEYyour-minimax-api-key-here# Gateway 访问令牌请设置强密码OPENCLAW_GATEWAY_TOKENyour-secure-token-here安全提示请将your-minimax-api-key-here和your-secure-token-here替换为您的实际值。四、MiniMax M2.5 模型配置4.1 获取 MiniMax API Key访问 MiniMax 开放平台国内版https://platform.minimaxi.com/user-center/basic-info国际版https://platform.minimax.io/user-center/basic-info注册/登录账号在「API Keys」页面创建新的 API Key复制 API Key 并保存到.env文件4.2 创建 OpenClaw 配置文件创建~/openclaw-deploy/config/openclaw.json{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}}}4.3 配置字段说明配置项说明baseUrlMiniMax API 地址推荐使用 Anthropic 兼容端点apiKey从环境变量${MINIMAX_API_KEY}读取避免硬编码models必须是数组格式agents.defaults.model必须是字符串格式provider/model-id4.4 更新 models.json 文件重要这是关键步骤OpenClaw 会读取models.json文件中的配置# 进入容器更新 models.jsondockerexecopenclawsh-cAPI_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\} } } EOF4.5 MiniMax M2.5 模型列表模型 ID说明上下文长度MiniMax-M2.5M2.5 完整版推荐204800MiniMax-M2.5-highspeedM2.5 高速版2048004.6 重要注意事项API 端点选择Anthropic 兼容端点推荐https://api.minimaxi.com/anthropicAPI 模式anthropic-messages支持推理reasoning功能OpenAI 兼容端点https://api.minimaxi.com/v1API 模式openai-completions不支持推理功能必须更新 models.json仅修改openclaw.json不够OpenClaw 会从models.json读取实际配置models.json中的api字段必须与baseUrl匹配模型 ID 大小写敏感正确MiniMax-M2.5、MiniMax-M2.5-highspeed错误minimax-m2.5、MiniMax-m2.5五、安全配置5.1 限制文件访问{agents:{defaults:{workspace:/home/node/workspace,sandbox:{mode:off}}},tools:{fs:{workspaceOnly:true}}}5.2 限制危险操作{tools:{profile:minimal,fs:{workspaceOnly:true},exec:{security:deny},elevated:{enabled:false}}}说明tools.fs.workspaceOnly: true- 限制文件操作仅在工作空间内tools.exec.security: deny- 禁止执行命令tools.elevated.enabled: false- 禁用提权操作5.3 网络隔离ports:# 仅绑定本地回环地址-127.0.0.1:18789:18789-127.0.0.1:18790:18790六、验证与测试6.1 启动服务cd~/openclaw-deploy# 启动 Colima如未启动colima start# 启动 OpenClawdocker-composeup-d# 查看日志docker-composelogs-fopenclaw-gateway6.2 验证服务状态# 检查容器状态dockerps|grepopenclaw# 检查端口监听lsof-i:18789# 测试 Web 界面curl-shttp://127.0.0.1:18789/|head-206.3 验证 MiniMax API 连接# 测试 API 连接dockerexecopenclawsh-ccurl -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\}]}6.4 访问 Web 界面打开浏览器访问http://127.0.0.1:18789首次访问需要输入 Gateway Token在.env文件中配置的OPENCLAW_GATEWAY_TOKEN。七、QQ 机器人接入可选OpenClaw 支持通过 QQ 官方机器人平台接入实现 QQ 用户与 AI 助手的交互。QQ官方龙虾专用入口。7.1 功能特性支持私聊和群聊机器人触发OpenClaw 被动接收消息不能主动发起 QQ 消息支持沙箱测试环境7.2 创建 QQ 机器人访问 QQ 开放平台https://bot.q.qq.com完成开发者认证创建机器人获取 AppID 和 App Secret7.3 配置环境变量在.env文件中添加QQ_APP_IDyour-qq-app-id-hereQQ_APP_SECRETyour-qq-app-secret-here7.4 安装中国区插件dockerexecopenclaw openclaw pluginsinstallopenclaw-china/channels7.5 配置通道在config/openclaw.json中添加{channels:{qqbot:{enabled:true,appId:${QQ_APP_ID},clientSecret:${QQ_APP_SECRET},dmPolicy:open,groupPolicy:open}}}7.6 重启服务docker-composerestart openclaw-gateway7.7 验证连接dockerlogs openclaw21|grepqqbot# 应看到: [qqbot] gateway ready八、故障排查8.1 模型配置错误问题:agents.defaults.model: Invalid input解决: 使用正确的模型格式provider/model-id// 正确格式model:minimax/MiniMax-M2.58.2 MiniMax API 404 错误问题: Web 界面发送消息返回HTTP 404: 404 page not found原因:models.json中api字段与baseUrl不匹配解决:Anthropic 端点baseUrl: https://api.minimaxi.com/anthropicapi: anthropic-messagesOpenAI 端点baseUrl: https://api.minimaxi.com/v1api: openai-completions8.3 网络连接问题问题:npm error code ECONNRESET解决: 配置淘宝镜像源npmconfigsetregistry https://registry.npmmirror.com8.4 Colima 端口转发问题问题: 浏览器无法访问http://127.0.0.1:18789解决:在 docker-compose.yml 的启动命令中添加--bind lan参数在 openclaw.json 中添加controlUi.allowedOrigins配置8.5 Gateway Token 认证问题问题: 界面显示 “unauthorized: gateway token missing”解决:方式一在界面 Settings 中输入 Token方式二通过 URL 参数传递 Tokenhttp://127.0.0.1:18789/?tokenyour-token-here九、运维指南9.1 日常运维命令# 查看服务状态docker-composeps# 查看实时日志docker-composelogs-f--tail100openclaw-gateway# 重启服务docker-composerestart openclaw-gateway# 停止服务docker-composedown# 更新 OpenClawdocker-composedowndocker-composeup-d9.2 日志管理# 日志位置~/openclaw-deploy/logs/# 日志轮转配置添加到 crontab00* * *find~/openclaw-deploy/logs-name*.log-mtime7-delete十、切换其他模型扩展OpenClaw 支持多种兼容 OpenAI API 的模型提供商切换方式类似。10.1 国内其他模型提供商提供商API 地址获取 API Key模型示例DeepSeekhttps://api.deepseek.com/v1https://platform.deepseek.comdeepseek-chat智谱 AIhttps://open.bigmodel.cn/api/paas/v4https://open.bigmodel.cnglm-4阿里通义https://dashscope.aliyuncs.com/compatible-mode/v1https://dashscope.console.aliyun.comqwen-turbo10.2 切换步骤修改.env文件中的 API Key修改docker-compose.yml中的环境变量引用修改config/openclaw.json中的模型提供商配置重启服务docker-compose restart openclaw-gateway总结本文详细介绍了在 macOS 上通过 Docker Colima 部署 OpenClaw并配置 MiniMax M2.5 作为大模型后端的完整方案。主要内容包括环境准备安装 Colima、Docker CLI 等必要工具OpenClaw 部署通过 Docker Compose 快速部署MiniMax 配置详细说明 API 端点选择和 models.json 配置安全配置文件访问限制、网络隔离等安全措施QQ 机器人接入扩展应用场景故障排查常见问题及解决方案通过本方案您可以快速搭建一个安全、可控的本地 AI 助手服务并根据需要切换不同的大模型后端。参考链接OpenClaw 官网https://openclaw.aiOpenClaw GitHubhttps://github.com/openclaw/openclawMiniMax 开放平台https://platform.minimaxi.comQQ 开放平台https://bot.q.qq.comOpenClaw 文档https://docs.openclaw.ai