macOS Sequoia OpenClaw + Ollama 本地离线部署（免API、Apple Silicon金属加速）

整体分4步：安装Ollama→下载适配机型本地模型→OpenClaw绑定Ollama→启动Web面板测试，全程离线可用、不需要任何云端Key。

一、安装Ollama（macOS一键）

方式1：终端一键安装（推荐）

bash 复制代码

curl -fsSL https://ollama.com/install.sh | sh

方式2：图形安装包

官网下载：https://ollama.com/download → 下载Ollama.dmg，拖入应用程序，打开后顶部菜单栏出现🦙图标，Ollama后台自动启动服务（默认端口11434）。

验证Ollama服务正常

bash 复制代码

# 查看版本
ollama --version
# 测试本地API是否通，返回Ollama is running即成功
curl http://127.0.0.1:11434

二、根据Mac内存下载本地模型（关键）

Apple Silicon自动启用Metal GPU加速，按统一内存选模型，推荐通义千问Qwen2.5系列（中文最优、Agent工具调用强）

bash 复制代码

# 查看已装模型
ollama list

Mac内存	推荐模型（终端拉取命令）	占用空间
8GB	ollama pull qwen2.5:3b	~2G
16GB⭐优选	ollama pull qwen2.5:7b	~5.5G
24GB+	ollama pull qwen2.5:14b	~10G
32GB+	ollama pull qwen2.5-coder:32b	~20G（代码/Agent最强）

示例（16G Mac执行）：

bash 复制代码

ollama pull qwen2.5:7b

等待下载完成，不要关闭Ollama程序。

三、OpenClaw对接Ollama（2种配置方法）

方法1：命令行交互式配置（新手首选）

bash 复制代码

openclaw onboard

配置向导分步选择：

模型提供商：Ollama(Local)（不要选OpenAI）
Ollama BaseURL：默认http://127.0.0.1:11434（不用改）
API Key：随便填ollama-local（本地不需要真实密钥）
默认模型：填写刚才下载的模型名，如qwen2.5:7b
运行模式：Local(仅本地模型)，保存配置

方法2：手动修改配置文件（进阶）

配置文件路径：~/.openclaw/openclaw.json

bash 复制代码

# 写入环境变量临时生效
export OLLAMA_API_KEY="ollama-local"
# 命令写入配置
openclaw config set models.providers.ollama.baseUrl "http://127.0.0.1:11434"
openclaw config set models.providers.ollama.apiKey "ollama-local"
# 设置默认本地模型
openclaw models set ollama/qwen2.5:7b

四、启动OpenClaw、打开Web控制台

bash 复制代码

# 后台常驻启动
openclaw start --detach
# 一键打开浏览器Web管理面板（默认http://127.0.0.1:18789）
openclaw dashboard

进入网页设置→LLM提供商，确认当前为Ollama、模型名称一致，在对话框发送消息，本地Ollama推理回复=部署成功。

五、日常运维常用命令

bash 复制代码

# 查看OpenClaw运行状态
openclaw status
# 重启服务（改配置后必用）
openclaw restart
# 查看本地可用模型列表
openclaw models list
# 停止后台服务
openclaw stop

六、常见报错修复

连接失败：无法访问11434

bash 复制代码

# 手动拉起Ollama服务
ollama serve

新开终端再启动OpenClaw。

模型名称报错

模型名必须和ollama list显示完全一致，不能多空格、改版本号。
终端提示command not found

bash 复制代码

source ~/.zshrc

七、拓展：离线无网使用

提前下载好模型（联网时pull）
断开Mac网络，Ollama保持运行，OpenClaw全程本地推理、不走外网。