如何将OpenClaw无缝接入本地Ollama？
- 内容介绍
- 文章标签
- 相关推荐
你有没有试过那种感觉？就是你刚装完一个新软件，后来啊发现它根本跑不起来或者跑起来了但就是连不上模型。你点开文档，发现全是“请参考官方文档”、“请确保环境正确配置”这种废话。 我们都经历过... 今天我们就来聊聊， 怎么把OpenClaw和Ollama这两个玩意儿，真正地“无缝”地连起来——不是那种“按道理讲可以”，而是你照着做，它就真的能跑起来的那种。
一、环境准备
先说说你得有个能跑得动的环境。别跟我说你还在用XP系统，那我们没得聊了。你至少得有个现代点的操作系统，比如Windows 10、macOS、 纯正。 或者Linux。然后你得有Node.js和Docker。当然如果你是那种“我只用原生”的硬核玩家，那也行，反正我们都能跑。
不过说真的，你要是连Node.js都没装，那我建议你先去装一下。别告诉我你连npm都不会用，那我只能祝你好运了。
二、 第一步：安装 OpenClaw
安装OpenClaw其实挺简单的，你只需要在终端里敲几行命令：
$ npm install -g openclaw
然后你就可以在终端里输入openclaw --version看看是不是真的装好了。如果看到版本号，那恭喜你，你已经成功迈出了第一步。如果没看到，那可能你得检查一下你的Node.js是不是装对了地方，你没事吧？。
三、 第二步：安装并配置 Ollama
Ollama是个好东西，它能让你在本地跑大模型，不用联网，不用等API，不用看别人脸色。 盘它... 安装它也很简单，特别是你用的是macOS或者Linux：
$ brew install ollama
Windows用户？别担心，你也可以用Docker来跑Ollama。不过如果你是那种“我只用Windows”的用户， 好家伙... 那我建议你还是先装个WSL，不然你可能真的会卡住。
装好之后你得配置一下Ollama。比如 你要跑哪个模型，得先拉一下：
$ ollama run qwen3:1.7b
当然你也可以跑别的模型，比如Llama、Mistral、DeepSeek，随便你。不过我建议你先从Qwen3开始，毕竟它比较轻量，适合你这种“我就是想试试”的用户。
四、 第三步：配置 OpenClaw 使用本地模型
现在你已经装好了OpenClaw和Ollama，接下来就是把它们连起来。这一步其实挺关键的， 妥妥的！ 主要原因是如果你不配置好，OpenClaw根本不知道你本地有模型。
先说说你得告诉OpenClaw，你本地的Ollama服务在哪。比如 你得设置一下API Key：
$ openclaw config set models.providers.ollama.apiKey local-ollama
然后你得告诉它，Ollama的地址是啥：
$ openclaw config set models.providers.ollama.baseUrl http://localhost:11434
这样，OpenClaw就能知道，你本地的模型在哪了。当然 如果你是那种“我就是想跑个模型”的用户，那你可以直接用openclaw onboard这个命令，它会自动帮你配置，琢磨琢磨。。
五、 第四步：测试运行
这东西... 现在你已经把OpenClaw和Ollama连起来了接下来就是测试一下。你可以在终端里输入：
$ openclaw run "你好， 世界"
如果一切正常，你应该能看到一个AI回复你“你好，世界”。如果没看到，那可能你得检查一下你的配置是不是对的。
六、常见问题排查
纯属忽悠。 如果你在配置过程中遇到了问题，别慌，这很正常。我们来列几个常见的：
1. Ollama没跑起来
有啥用呢？ 你可能看到类似“Connection refused”的错误。这时候你得检查一下Ollama是不是真的在跑。你可以用ollama --version看看它是不是真的装好了或者用docker ps看看它是不是真的在跑。
2. OpenClaw找不到模型
盘它。 你可能看到类似“model not found”的错误。这时候你得检查一下你是不是真的把模型拉下来了。你可以用ollama list看看你本地有哪些模型，或者用ollama run看看它是不是真的能跑。
3. API Key不对
你可能看到类似“unauthorized”的错误。这时候你得检查一下你的API Key是不是对的。你可以用openclaw config get models.providers.ollama.apiKey看看你设置的是啥，层次低了。。
七、 5个新手即拿即用、效果立竿见影的OpenClaw实用技巧
1. 自动补全你可以在OpenClaw里设置自动补全， 啊这... 这样你就不需要每次都手动输入命令了。
2. 模型缓存你可以把模型缓存到本地，这样你就不需要每次都从网上拉模型了。
绝了... 3. 多模型切换你可以在OpenClaw里设置多个模型，这样你就可以了。
就这样吧... 4. 命令行快捷键你可以设置一些快捷键，这样你就可以快速调用一些常用的命令了。
5. 日志查看你可以用openclaw logs查看日志，这样你就可以知道模型是不是真的在跑，又爱又恨。。
八、 模型对比表
| 模型名称 | 大小 | 用途 | 是否支持本地 |
|---|---|---|---|
| Qwen3 | 1.7B | 通用对话 | 是 |
| Llama 3 | 8B | 复杂推理 | 是 |
| Mistral | 7B | 代码生成 | 是 |
| Gemma | 2B | 轻量级任务 | 是 |
| Phi-3 | 3.8B | 对话+推理 | 是 |
好了现在你已经知道怎么把OpenClaw和Ollama连起来了。如果你还卡在某个步骤，别急，多试几次总会有跑通的一天。实在不行，就去问Google，或者Stack Overflow，别问我，我真的不会修电脑。
你有没有试过那种感觉？就是你刚装完一个新软件，后来啊发现它根本跑不起来或者跑起来了但就是连不上模型。你点开文档，发现全是“请参考官方文档”、“请确保环境正确配置”这种废话。 我们都经历过... 今天我们就来聊聊， 怎么把OpenClaw和Ollama这两个玩意儿，真正地“无缝”地连起来——不是那种“按道理讲可以”，而是你照着做，它就真的能跑起来的那种。
一、环境准备
先说说你得有个能跑得动的环境。别跟我说你还在用XP系统，那我们没得聊了。你至少得有个现代点的操作系统，比如Windows 10、macOS、 纯正。 或者Linux。然后你得有Node.js和Docker。当然如果你是那种“我只用原生”的硬核玩家，那也行，反正我们都能跑。
不过说真的，你要是连Node.js都没装，那我建议你先去装一下。别告诉我你连npm都不会用，那我只能祝你好运了。
二、 第一步：安装 OpenClaw
安装OpenClaw其实挺简单的，你只需要在终端里敲几行命令：
$ npm install -g openclaw
然后你就可以在终端里输入openclaw --version看看是不是真的装好了。如果看到版本号，那恭喜你，你已经成功迈出了第一步。如果没看到，那可能你得检查一下你的Node.js是不是装对了地方，你没事吧？。
三、 第二步：安装并配置 Ollama
Ollama是个好东西，它能让你在本地跑大模型，不用联网，不用等API，不用看别人脸色。 盘它... 安装它也很简单，特别是你用的是macOS或者Linux：
$ brew install ollama
Windows用户？别担心，你也可以用Docker来跑Ollama。不过如果你是那种“我只用Windows”的用户， 好家伙... 那我建议你还是先装个WSL，不然你可能真的会卡住。
装好之后你得配置一下Ollama。比如 你要跑哪个模型，得先拉一下：
$ ollama run qwen3:1.7b
当然你也可以跑别的模型，比如Llama、Mistral、DeepSeek，随便你。不过我建议你先从Qwen3开始，毕竟它比较轻量，适合你这种“我就是想试试”的用户。
四、 第三步：配置 OpenClaw 使用本地模型
现在你已经装好了OpenClaw和Ollama，接下来就是把它们连起来。这一步其实挺关键的， 妥妥的！ 主要原因是如果你不配置好，OpenClaw根本不知道你本地有模型。
先说说你得告诉OpenClaw，你本地的Ollama服务在哪。比如 你得设置一下API Key：
$ openclaw config set models.providers.ollama.apiKey local-ollama
然后你得告诉它，Ollama的地址是啥：
$ openclaw config set models.providers.ollama.baseUrl http://localhost:11434
这样，OpenClaw就能知道，你本地的模型在哪了。当然 如果你是那种“我就是想跑个模型”的用户，那你可以直接用openclaw onboard这个命令，它会自动帮你配置，琢磨琢磨。。
五、 第四步：测试运行
这东西... 现在你已经把OpenClaw和Ollama连起来了接下来就是测试一下。你可以在终端里输入：
$ openclaw run "你好， 世界"
如果一切正常，你应该能看到一个AI回复你“你好，世界”。如果没看到，那可能你得检查一下你的配置是不是对的。
六、常见问题排查
纯属忽悠。 如果你在配置过程中遇到了问题，别慌，这很正常。我们来列几个常见的：
1. Ollama没跑起来
有啥用呢？ 你可能看到类似“Connection refused”的错误。这时候你得检查一下Ollama是不是真的在跑。你可以用ollama --version看看它是不是真的装好了或者用docker ps看看它是不是真的在跑。
2. OpenClaw找不到模型
盘它。 你可能看到类似“model not found”的错误。这时候你得检查一下你是不是真的把模型拉下来了。你可以用ollama list看看你本地有哪些模型，或者用ollama run看看它是不是真的能跑。
3. API Key不对
你可能看到类似“unauthorized”的错误。这时候你得检查一下你的API Key是不是对的。你可以用openclaw config get models.providers.ollama.apiKey看看你设置的是啥，层次低了。。
七、 5个新手即拿即用、效果立竿见影的OpenClaw实用技巧
1. 自动补全你可以在OpenClaw里设置自动补全， 啊这... 这样你就不需要每次都手动输入命令了。
2. 模型缓存你可以把模型缓存到本地，这样你就不需要每次都从网上拉模型了。
绝了... 3. 多模型切换你可以在OpenClaw里设置多个模型，这样你就可以了。
就这样吧... 4. 命令行快捷键你可以设置一些快捷键，这样你就可以快速调用一些常用的命令了。
5. 日志查看你可以用openclaw logs查看日志，这样你就可以知道模型是不是真的在跑，又爱又恨。。
八、 模型对比表
| 模型名称 | 大小 | 用途 | 是否支持本地 |
|---|---|---|---|
| Qwen3 | 1.7B | 通用对话 | 是 |
| Llama 3 | 8B | 复杂推理 | 是 |
| Mistral | 7B | 代码生成 | 是 |
| Gemma | 2B | 轻量级任务 | 是 |
| Phi-3 | 3.8B | 对话+推理 | 是 |
好了现在你已经知道怎么把OpenClaw和Ollama连起来了。如果你还卡在某个步骤，别急，多试几次总会有跑通的一天。实在不行，就去问Google，或者Stack Overflow，别问我，我真的不会修电脑。