核心功能特性

  - 开源免费:Ollama 核心框架为开源免费,个人与企业日常本地部署、二次开发及商业集成均无费用,且官方支持商用。

  - 跨平台:对 Windows、macOS、Linux 等主流桌面与服务器系统均原生支持。

  - 配置简单且功能强大:Ollama 会自动检测你的硬件(GPU、CPU),优先放到显存,显存不够的部分,自动放到内存,推理时,GPU 层和 CPU 层接力计算,用户完全无感知,无需复杂配置,就能最大化利用本地算力。

  - 流式输出:Ollama 支持逐字实时返回模型生成内容,无需等待完整响应生成完成,实现类似 ChatGPT 的“边想边说”效果。

  - 深度思考:支持模型多步推理、逻辑拆解、复杂问题分步思考,模拟人类“先想后答”的思维过程,提升复杂任务的回答准确性。

  - 结构化输出:强制模型生成符合指定格式的结构化数据,如 JSON、XML、CSV 等,确保输出可直接被程序解析,无需额外清洗。

  - 多模态视觉理解:支持图像输入与理解,模型可识别图片内容、OCR 文字、图表、截图等,实现图文混合交互。

  - 向量化:将文本等内容转换为向量,用于语义相似度计算、检索增强生成(RAG)等场景。

  - 工具调用:模型可自动识别并调用外部工具 / 函数,如计算器、API 接口、本地脚本、数据库查询等,扩展模型能力边界。

  - 联网搜索:模型可实时联网获取最新信息,补充模型静态知识,回答时效性强、动态变化的问题。

安装部署

  Ollama 支持 Windows、macOS 和 Linux 三大主流系统,安装过程非常直观。(仅介绍常用的 Windows 安装,其他方式请参考官网文档)

Windows 上安装 Ollama

Step 01 官网下载安装程序

    - https://ollama.com/download/windows

Step 02 运行程序并修改配置

1

  Ollama 运行本地模型时,免费且没有限制,无需登录。但是 Ollama 云端模型和联网搜索功能,必须登录 Ollama 账号才能使用。

  Ollama 的定价参考:https://ollama.com/pricing

3

Step 03 下载模型并验证

5

模型选择

  Ollama 官方库中拥有大量模型,选择合适的模型是关键。

4

模型命名   

  首先,要了解大模型的命名规则为:

<品牌+版本>:<参数><方向><量化><特殊标签>

  命名不是强制要求,部分会忽略,只显示用户最关心的参数,所以不同模型会让人感觉命名规则不标准。   比如:

  - qwen3.5:9b:通义千问 3.5 系列 : 90 亿(9 Billion)参数规模

  - qwen3.5:397b-cloud:通义千问 3.5 系列 : 3970 亿(397 Billion)参数规模 - 云端运行模型

  - qwen3-coder:30b:通义千问 3 编码系列 : 300 亿(30 Billion)参数规模

  - qwen3-vl:8b:通义千问 3 视觉 - 语言多模态系列 : 80 亿参数(8 Billion)参数规模

按硬件配置选择

硬件配置 推荐模型 特点
4GB 显存 / 8GB 内存

qwen3.5:2b

轻量、快速,适合简单问答
8GB 显存 / 16GB 内存

qwen3.5:9b

适合个人电脑本地部署使用
16GB+ 显存 / 32GB+ 内存

qwen3.5:35b

能力强大,适合深度推理、长文档处理、专业场景处理等

按使用场景选择

  - 通用对话及写作:qwen3.5:9b 等

  - 代码开发:qwen3-coder:30b, deepseek-coder-v2:16b 等

  - 图文理解:qwen3-vl:8b 等

使用方式选择

  - 本地模型:免费,没有限制,运行占用本地现显存/内存

  - 云端模型:需要登录 Ollama 账号,有额度和限制,占用 Ollama 官方服务器资源,不占用本地资源

常用命令

命令

作用

示例

ollama --version

查看 Ollama 程序的当前版本号,验证安装是否成功

ollama --version

ollama list

列出本地已下载的所有模型

ollama list

ollama pull <模型>

拉取(下载)指定的模型到本地

ollama pull qwen3:8b

ollama push <模型>

将本地的自定义模型推送到远程仓库(需登录账号)

ollama push my-custom-model:latest

ollama run <模型>

运行指定模型并进入交互式对话模式;若模型未拉取,会自动先拉取再运行

ollama run qwen3:8bollama run qwen3:8b --verbose

ollama show <模型>

查看模型的详细信息

ollama show qwen3:8b

ollama show qwen3:8b --modelfile

ollama rm <模型>

从本地删除模型

ollama rm qwen3:8b

ollama ps

查看当前正在运行的模型进程及状态

ollama ps

ollama create <新模型>

根据一个 Modelfile 文件,基于现有模型创建全新的自定义模型

ollama create code-assistant -f Modelfile

ollama cp <源模型> <目标模型>

复制模型,常用于给模型创建别名、备份

ollama cp qwen3:8b qwen3:8b-chat

ollama launch <工具名>

启动 Ollama 服务 + 自动配置并打开对应工具

ollama launch openclaw

ollama launch claude

自定义模型

  Ollama 允许通过创建 Modelfile,打造一个拥有独特个性和能力的专属模型。

  Modelfile 文件写法参考:https://github.com/ollama/ollama/blob/main/docs/modelfile.mdx

创建 Modelfile

  新建一个名为 devQwen 的 Modelfile 的文本文件,写入以下内容:

9

创建新模型

8

运行新模型

11

通过 Ollama 启动 OpenClaw

  安装前,请先安装 Node.js 与 Git,然后运行:

ollama launch openclaw

  或

ollama launch openclaw --model kimi-k2.5:cloud

  Ollama 将自动完成以下操作:

  安装 —— 若未安装 OpenClaw,Ollama 会提示通过 npm 进行安装

16

  安全 —— 首次启动时,安全须知会说明工具访问存在的相关风险

18

  模型 —— 从选择器中挑选本地或云端模型

17

  初始化引导 —— Ollama 配置服务提供商、安装网关守护进程、将所选模型设为默认主模型,并安装网页搜索与内容抓取插件(网页搜索与内容抓取会自动启用)

  网关 —— 在后台启动程序并打开 OpenClaw 终端交互界面

19

      运行后,可访问 OpenClaw:

21

推荐模型

  - kimi-k2.5:cloud 

  - minimax-m2.7:cloud 

  - glm-5:cloud 

  - glm-4.7-flash 

推荐上下文长度

  建议至少采用 64k 的上下文长度。

停止运行 OpenClaw

openclaw gateway stop

通过 Ollama 启动 Claude Code

  开源模型可通过 Ollama 兼容 Anthropic 的接口接入 Claude Code,支持 qwen3.5、glm-5:cloud、kimi-k2.5:cloud 等模型。

Windows 安装 Claude Code

irm https://claude.ai/install.ps1 | iex

启动 Claude Code

ollama launch claude

  或

ollama launch claude --model kimi-k2.5:cloud

推荐模型

  - kimi-k2.5:cloud

  - glm-5:cloud

  - minimax-m2.7:cloud

  - qwen3.5:cloud

  - glm-4.7-flash

  - qwen3.5

推荐上下文长度

  建议至少采用 64k 的上下文长度。

接口

  可通过接口调用将 Ollama 集成至你的应用中,其安默认访问地址为:

  - 本地地址:http://localhost:11434/api

  - 云端地址:https://ollama.com/api

  在本地访问无需身份验证,云端访问则需要进行身份验证。Ollama 支持本地登录和 API Key 两种身份验证方式。

流式传输

  部分 API 接口默认以流式形式返回响应结果,采用换行分隔的 JSON 格式(application/x-ndjson 内容类型)进行传输,其形如:

{"model":"gemma3","created_at":"2025-10-26T17:15:24.097767Z","response":"That","done":false}
{"model":"gemma3","created_at":"2025-10-26T17:15:24.109172Z","response":"'","done":false}
{"model":"gemma3","created_at":"2025-10-26T17:15:24.121485Z","response":"s","done":false}
{"model":"gemma3","created_at":"2025-10-26T17:15:24.132802Z","response":" a","done":false}
{"model":"gemma3","created_at":"2025-10-26T17:15:24.143931Z","response":" fantastic","done":false}
{"model":"gemma3","created_at":"2025-10-26T17:15:24.155176Z","response":" question","done":false}
{"model":"gemma3","created_at":"2025-10-26T17:15:24.166576Z","response":"!","done":true, "done_reason": "stop"}

  可通过在请求体中传入{"stream": false}来关闭流式传输,响应将以application/json 内容类型返回。

返回值

  返回值形如:

{
  "model": "gemma3",
  "created_at": "2025-10-17T23:14:07.414671Z",
  "response": "Hello! How can I help you today?",
  "done": true,
  "done_reason": "stop", 
  "total_duration": 174560334, 
  "load_duration": 101397084,
  "prompt_eval_count": 11,
  "prompt_eval_duration": 13074791,
  "eval_count": 18,

更多推荐