大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



随着 AI 大模型的快速发展，越来越多的开发者希望在本地搭建自己的 AI 助手。OpenClaw 是一款开源的 AI Agent 框架，支持多种大模型后端，可以轻松构建智能对话系统。MiniMax M2.5 是国内领先的 AI 大模型，具有强大的推理能力和优秀的中文理解能力。

本文将介绍如何在 macOS 系统上，通过 Docker + Colima 部署 OpenClaw，并配置 MiniMax M2.5 作为大模型后端，同时支持 机器人接入，实现多渠道的 AI 助手服务。

方案优势：

• 完全本地化部署，数据安全可控
• 支持多种大模型切换（MiniMax、DeepSeek、OpenAI 等）
• 支持 机器人接入，扩展应用场景
• 安全配置完善，防止数据泄露

快速部署建议 ：下载 Trae 国内版，让 Trae 按照本部署方案自动执行部署，省去手动输入命令的繁琐步骤。

---

1.1 系统要求

1.2 安装 Homebrew

如果尚未安装 Homebrew，请执行：

 
1.3 安装必要工具
 
   
    
     
 
     

Colima 是 macOS 上的轻量级 Docker 运行时，相比 Docker Desktop 更加轻量和高效。

2.1 创建 Colima 配置文件

创建 ：

 
2.2 启动 Colima
 
2.3 配置 Docker 网络
 
   
    
     
 
     

3.1 创建目录结构

 
3.2 创建 Docker Compose 文件
 

创建 ：

 
重要说明：
 

• 使用 (Debian) 而非 ，因为 Alpine 缺少编译 llama.cpp 所需的系统头文件
• 配置淘宝 npm 镜像加速下载

3.3 创建环境变量文件

创建 ：

 
安全提示 ：请将 和 替换为您的实际值。
 

---

4.1 获取 MiniMax API Key

1. 访问 MiniMax 开放平台：
   • 国内版：https://platform.minimaxi.com/user-center/basic-info
   • 国际版：https://platform.minimax.io/user-center/basic-info
2. 注册/登录账号
3. 在「API Keys」页面创建新的 API Key
4. 复制 API Key 并保存到 文件

4.2 创建 OpenClaw 配置文件

创建 ：

4.3 配置字段说明

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

这是关键步骤！ OpenClaw 会读取 文件中的配置：

4.5 MiniMax M2.5 模型列表

4.6 重要注意事项

1. API 端点选择：
   • Anthropic 兼容端点（推荐） ：
     • API 模式：
     • 支持推理（reasoning）功能
   • OpenAI 兼容端点：
     • API 模式：
     • 不支持推理功能
2. 必须更新 models.json：
   • 仅修改 不够，OpenClaw 会从 读取实际配置
   • 中的 字段必须与 匹配
3. 模型 ID 大小写敏感：
   • 正确：、
   • 错误：、

---

5.1 限制文件访问

 
5.2 限制危险操作
 
说明：
 

• - 限制文件操作仅在工作空间内
• - 禁止执行命令
• - 禁用提权操作

5.3 网络隔离

6.1 启动服务

 
6.2 验证服务状态
 
6.3 验证 MiniMax API 连接
 
6.4 访问 Web 界面
 

打开浏览器访问：

首次访问需要输入 Gateway Token（在 文件中配置的 ）。

---

OpenClaw 支持通过 官方机器人平台接入，实现 用户与 AI 助手的交互。官方龙虾专用入口。

7.1 功能特性

• 支持私聊和群聊（@机器人触发）
• OpenClaw 被动接收消息，不能主动发起 消息
• 支持沙箱测试环境

7.2 创建 机器人

1. 访问 开放平台：https://bot.q..com
2. 完成开发者认证
3. 创建机器人，获取 AppID 和 App Secret

7.3 配置环境变量

在 文件中添加：

 
7.4 安装中国区插件
 
7.5 配置通道
 

在 中添加：

 
7.6 重启服务
 
7.7 验证连接
 
      
    
        
 
        

8.1 模型配置错误

问题 :

解决 : 使用正确的模型格式 ：

8.2 MiniMax API 404 错误

问题 : Web 界面发送消息返回

原因 : 中 字段与 不匹配

解决:

• Anthropic 端点： +
• OpenAI 端点： +

8.3 网络连接问题

问题 :

解决: 配置淘宝镜像源：

8.4 Colima 端口转发问题

问题 : 浏览器无法访问

解决:

1. 在 docker-compose.yml 的启动命令中添加 参数
2. 在 openclaw.json 中添加 配置

8.5 Gateway Token 认证问题

问题: 界面显示 "unauthorized: gateway token missing"

解决:

1. 方式一：在界面 Settings 中输入 Token
2. 方式二：通过 URL 参数传递 Token：

---

9.1 日常运维命令

 
9.2 日志管理
 
       
    
         
 
         

OpenClaw 支持多种兼容 OpenAI API 的模型提供商，切换方式类似。

10.1 国内其他模型提供商

10.2 切换步骤

1. 修改 文件中的 API Key
2. 修改 中的环境变量引用
3. 修改 中的模型提供商配置
4. 重启服务：

---

本文详细介绍了在 macOS 上通过 Docker + Colima 部署 OpenClaw，并配置 MiniMax M2.5 作为大模型后端的完整方案。主要内容包括：

1. 环境准备：安装 Colima、Docker CLI 等必要工具
2. OpenClaw 部署：通过 Docker Compose 快速部署
3. MiniMax 配置：详细说明 API 端点选择和 models.json 配置
4. 安全配置：文件访问限制、网络隔离等安全措施
5. 机器人接入：扩展应用场景
6. 故障排查：常见问题及解决方案

通过本方案，您可以快速搭建一个安全、可控的本地 AI 助手服务，并根据需要切换不同的大模型后端。

---

• OpenClaw 官网：https://openclaw.ai
• OpenClaw GitHub：https://github.com/openclaw/openclaw
• MiniMax 开放平台：https://platform.minimaxi.com
• 开放平台：https://bot.q..com
• OpenClaw 文档：https://docs.openclaw.ai