1. 项目概述
这个项目展示了如何在macOS系统上搭建一个本地化的AI助手系统。核心组件包括OpenClaw框架、Docker容器化技术和MiniMax M2.5大模型。我最近在实际工作中部署了这个方案,发现它特别适合需要数据隐私保护的场景,比如企业内部知识库问答系统。
OpenClaw是一个开源的AI Agent框架,它的模块化设计让开发者可以灵活切换不同的大模型后端。我选择MiniMax M2.5是因为它在中文理解能力上表现出色,而且提供了稳定的API服务。通过Docker部署可以避免环境配置的麻烦,Colima则让整个过程在macOS上更加顺畅。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备
2.1 系统要求检查
在开始之前,建议先确认你的macOS系统满足以下要求:
- 操作系统:macOS 12 Monterey或更高版本
- 内存:至少8GB(处理大模型时建议16GB以上)
- 存储空间:至少20GB可用空间
- CPU:Apple Silicon(M1/M2/M3)或Intel处理器
我使用的是M1 Pro芯片的MacBook Pro,16GB内存。在实际测试中,这个配置运行MiniMax M2.5的API调用非常流畅。如果你用的是Intel芯片,建议确保CPU支持AVX指令集,这对AI模型的运行效率有很大影响。
2.2 必备工具安装
首先需要安装Homebrew,这是macOS上最常用的包管理工具。打开终端执行:
bash复制/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后,建议将Homebrew添加到PATH环境变量:
bash复制echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc
接下来安装必要的软件包:
bash复制# 安装Node.js 22+
brew install node@22
# 验证Node.js版本
node --version # 应该显示v22.x.x
# 安装Colima(比Docker Desktop更轻量)
brew install colima
# 安装Docker命令行工具
brew install docker docker-compose
这里我选择Node.js 22是因为OpenClaw的最新版本对其有更好的支持。Colima是一个轻量级的Docker运行时,相比Docker Desktop占用资源更少,特别适合开发环境使用。
3. Colima配置与启动
3.1 创建Colima配置文件
在~/.colima/default/目录下创建colima.yaml配置文件:
yaml复制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
这个配置中我分配了4个CPU核心和8GB内存给Colima。根据我的经验,这个配置可以很好地平衡性能和资源占用。端口转发设置确保我们能从主机访问容器内的服务。
3.2 启动Colima环境
执行以下命令启动Colima:
bash复制# 创建工作目录
mkdir -p ~/openclaw-workspace
mkdir -p ~/.openclaw
# 启动Colima
colima start --cpu 4 --memory 8 --disk 60
# 验证Docker运行状态
docker ps
启动过程可能需要几分钟时间。我第一次运行时遇到了磁盘空间不足的问题,所以建议确保你的Mac有足够的可用空间。可以通过colima status命令查看运行状态。
3.3 创建Docker专用网络
为了更好的隔离性,我们创建一个专用网络:
bash复制docker network
