核心前提

• 系统支持：Windows 10+/macOS 12+/Linux（Ubuntu 20.04+）
• 无需提前装 Python/CUDA（Ollama 自动封装依赖）

---

一、步骤 1：安装 Ollama（全系统通用）

1. 下载安装包

• 官网（推荐）：https://ollama.com/
  • macOS：下载 DMG 文件，双击拖入 Applications 安装
  • Windows：下载 EXE 文件，双击运行（勾选“Add to PATH”）
  • Linux：终端一键安装

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

2. 验证安装成功

打开终端/命令提示符，执行：

ollama -v

输出类似 ollama version 0.1.50 即安装成功（版本号以实际为准）。

---

二、步骤 2：部署模型（核心操作）

Ollama 部署模型只有 1 条核心命令，格式：ollama run 模型名称（自动下载+运行，无需手动解压/配置）。

1. 常用模型一键部署（按需选）

模型类型	命令（复制即用）	硬件要求
超轻量（中文）	ollama run qwen:0.5b	1GB 内存
轻量（工具调用）	ollama run llama3.2:3b	4GB 内存/显存
平衡型	ollama run gemma:2b	2GB 内存
小钢炮	ollama run phi3	4GB 内存/显存

2. 部署过程说明

• 执行命令后，Ollama 会自动：
  1. 下载模型量化包（进度条显示，国内可能慢，耐心等）
  2. 解压并加载模型到本地
  3. 启动模型对话界面
• 首次下载：Qwen 0.5B 约 400MB，Llama 3.2-3B 约 2GB，时间取决于网速。

---

三、步骤 3：运行模型（对话/测试）

1. 基础对话（直接交互）

部署完成后自动进入对话界面，输入任意指令即可测试：

>>> 你好，介绍下自己
>>> 帮我写一个整理桌面文件的步骤

• 退出对话：按 Ctrl + D（Windows/macOS/Linux 通用）。

2. 后台运行（供 OpenClaw 调用）

如果要给 OpenClaw 用，无需停留在对话界面，执行：

# 启动 Ollama 后台服务（默认端口 11434）
ollama serve

• 保持终端窗口打开，模型会在后台持续运行，OpenClaw 可通过 http://localhost:11434 调用。

3. 常用运维命令（管理模型）

功能	命令	说明
查看已部署模型	ollama list	显示本地所有模型
停止模型	ollama stop 模型名	如 ollama stop qwen:0.5b
删除模型	ollama rm 模型名	释放磁盘空间
重启 Ollama	ollama restart	解决模型加载异常

---

四、步骤 4：验证模型可被调用（关键！）

确保模型能被 OpenClaw/其他工具调用，执行：

# 用 curl 测试模型响应（替换 qwen:0.5b 为你的模型名）
curl http://localhost:11434/api/generate -d '{
  "model": "qwen:0.5b",
  "prompt": "你好",
  "stream": false
}'

• 输出包含 "response":"你好！..." 即调用成功。

---

五、适配 OpenClaw 的关键配置

1. 确保 Ollama 后台服务在运行（ollama serve）
2. 修改 OpenClaw 的 .env 文件：

   OLLAMA_BASE_URL=http://localhost:11434
   OLLAMA_MODEL=qwen:0.5b  # 替换为你部署的模型名
   

3. 重启 OpenClaw 即可联动。

---

六、常见问题解决

1. 下载慢：切换国内镜像（临时生效）

   # macOS/Linux
   export OLLAMA_MIRROR=https://mirror.ollama.com
   ollama run qwen:0.5b
   
   # Windows（命令提示符）
   set OLLAMA_MIRROR=https://mirror.ollama.com
   ollama run qwen:0.5b
   

2. 端口被占用：修改 Ollama 端口

   # 比如改用 11435 端口
   ollama serve --host 0.0.0.0:11435
   # 同时修改 OpenClaw 的 OLLAMA_BASE_URL=http://localhost:11435
   

3. Windows 启动失败：以管理员身份运行终端，执行 ollama serve 查看具体报错。

---

总结

1. Ollama 部署模型核心：ollama run 模型名（自动下载+运行）
2. 供 OpenClaw 调用需启动后台服务：ollama serve
3. 验证可用性：用 curl 测试 11434 端口的 API 响应
4. 低配电脑优先选 qwen:0.5b，4GB 内存选 llama3.2:3b