跳到主要内容
从零部署 Ollama + Qwen 3.5 + OpenClawbot 本地 AI 助手 | 极客日志
Shell / Bash Node.js AI
从零部署 Ollama + Qwen 3.5 + OpenClawbot 本地 AI 助手 综述由AI生成 如何在本地单机环境部署 Ollama、Qwen 3.5 模型及 OpenClawbot 智能代理。步骤包括安装 Ollama 引擎,拉取 Qwen 3.5 模型,通过 npm 安装 OpenClaw,配置 config.yaml 连接本地 API,最后启动网关与终端界面实现对话。同时提供了接入 Telegram 的可选方案及常见问题排查方法,适合开发者快速搭建本地免费 AI 助手。
城市逃兵 发布于 2026/4/6 更新于 2026/5/22 32 浏览从零部署 Ollama + Qwen 3.5 + OpenClawbot 本地 AI 助手
本文旨在帮助你在单机上完成 Ollama + Qwen 3.5 + OpenClaw 的整套环境部署,并验证正常聊天功能。内容侧重于命令操作、配置说明与排错,适合边看边敲。
一、整体架构先说清楚
这一套技术栈中各组件的分工如下:
Ollama :本地大模型运行引擎,相当于'模型服务端'
Qwen 3.5 :具体的大模型(如 qwen3.5-0.8b),在 Ollama 里运行
OpenClaw / OpenClawbot :在上面封装一层'智能代理 + 多通道机器人'(终端、Telegram 等)
简单理解为:
用户 → OpenClawbot → Ollama API (http://localhost:11434 ) → Qwen 3.5 模型
部署顺序为:
安装并启动 Ollama
在 Ollama 中拉取 Qwen 3.5 模型
安装 OpenClaw / OpenClawbot
配置 OpenClaw 使用 Ollama+Qwen 3.5
启动并确认对话正常
二、环境与准备
1. 操作系统和硬件建议
系统 :
推荐:macOS / Ubuntu 20.04+ / 22.04+
Windows:建议使用 WSL2 + Ubuntu 运行 Ollama 和 OpenClaw
硬件 (跑 Qwen 3.5 0.8B 这种小模型):
CPU:4 核以上
内存:8GB 起
磁盘:预留 10GB+
GPU:可选;没有 GPU 也能跑 0.8B 模型
如果只是想体验,用一台 8G 内存的笔记本即可跑通。
2. 需要的软件
curl(拉安装脚本)
Node.js + npm(用来装 OpenClaw)
git(可选,用于查看 OpenClaw 源码)
Ubuntu 一键安装:
sudo apt update && sudo apt install -y curl nodejs npm git
macOS 建议先装 Homebrew,再执行:
brew install node git
三、第一步:安装并验证 Ollama
1. 安装 Ollama
官方安装脚本(macOS / Linux):
curl -fsSL https://ollama.com/install.sh | sh
Windows 则去官网下载安装包,或者在 WSL2 Ubuntu 里使用上面的命令。
2. 验证 Ollama 安装
ollama --version
看到类似 ollama version 0.17.0 即表示 OK。
3. 启动 Ollama 服务 大多数系统安装后会自动以守护进程方式运行,你可以手动确认:
ss -lntp | grep 11434
curl http://localhost:11434
如果返回类似 {"models": [...]},说明 Ollama 服务正常在 http://localhost:11434 运行。
四、第二步:在 Ollama 中拉取 Qwen 3.5 模型
1. 选择合适的 Qwen 3.5 版本
qwen3.5-0.8b:只有 0.8B 参数,可以在纯 CPU 上跑 ,占空间大概 1GB 左右
适合入门 / VPS / 老电脑
如果你的 GPU 和内存都比较强,也可以尝试更大的版本(14B 等),但本篇先以 0.8B 为主。
2. 拉取模型
3. 在命令行直接试一下模型 ollama run qwen3.5-0.8b "用一句话介绍一下你自己。"
Ollama 安装 OK
Qwen 3.5 模型拉取 OK
本地推理能力没问题
五、第三步:安装 OpenClaw / OpenClawbot
说明:目前社区普遍说的'OpenClawbot',本质上就是基于 OpenClaw 做的一套机器人/代理配置,这里统一用 OpenClaw 命令来装和配。
1. 通过 npm 全局安装 OpenClaw sudo npm install -g openclaw
2. (可选)用 Ollama 的一键命令安装 ollama launch openclaw --model qwen3.5-0.8b
来触发自动检查与安装。如果你偏向'自动化安装',可以考虑这条路线;如果你想'自己掌控配置',建议用 npm install -g openclaw 再手动改配置文件。
六、第四步:配置 OpenClaw 连接 Ollama + Qwen 3.5 OpenClaw 的核心配置在一个 config.yaml 里(默认在 ~/.config/openclaw/config.yaml)。
1. 找到/创建配置文件 mkdir -p ~/.config/openclaw
nano ~/.config/openclaw/config.yaml
2. 写入一个最小可用配置(终端机器人版) gateway:
host: 127.0 .0 .1
port: 3000
providers:
ollama:
type: ollama
base_url: http://localhost:11434
model: qwen3.5-0.8b
agents:
default:
provider: ollama
system_prompt: >
你是一个中文 AI 助手,回答要简洁、友好,可以适当给出示例。
channels:
terminal:
enabled: true
type: terminal
base_url 必须指向你本机的 Ollama 接口,一般就是 http://localhost:11434
model 字段要与 ollama list 里显示的 完全一致 ,区分大小写与横杠
agents.default.provider 对应上方 providers 中你起的名字(这里是 ollama)
3. 检查配置是否正确 OpenClaw 一般会提供简单检查命令,你可以先直接尝试运行(有错误会提示)。
七、第五步:启动 OpenClaw 网关与 TUI(终端界面)
1. 更新并启动网关
openclaw gateway update
openclaw gateway restart
如果你遇到 token 相关提示(例如'unauthorized token'),可以创建/配置 token:
openclaw token create
openclaw gateway restart
2. 启动 OpenClaw 终端界面(OpenClawbot 的本地控制台) 成功的话,你会看到一个基于 TUI 的聊天界面(类似一个终端聊天窗口),此时输入一句中文:
OpenClaw 已经成功通过 providers.ollama 调用了本地 Ollama
Ollama 内部调起了 Qwen 3.5 模型
整个 'OpenClawbot → Ollama → Qwen 3.5' 链路打通
到这里,一个本地终端版的 Qwen 3.5 OpenClawbot 已经部署完成。
八、可选:接入 Telegram,做'聊天软件版机器人' 很多教程会在这一步把 OpenClawbot 接入 Telegram,形成一个真正的'聊天机器人'。这里只简单带一下部署关键点。
1. 在 Telegram 里创建 Bot
搜索 @BotFather
发送 /newbot 按提示创建机器人
获得一个形如 123456789:ABC-... 的 Bot Token
2. 在 OpenClaw 里配置 Telegram 通道
选择要配置的 section:channels
添加新的 channel:选择 telegram
粘贴 Bot Token
保存退出
channels:
terminal:
enabled: true
type: terminal
telegram:
enabled: true
type: telegram
bot_token: YOUR_TELEGRAM_BOT_TOKEN
此时在 Telegram 中给你的 Bot 发消息,应该就能看到由 Qwen 3.5 驱动的回复了(消息也会在 TUI 里同步显示)。
九、常见问题与排错
1. OpenClaw 报 'model not found' 或调用失败 providers:
ollama:
model: qwen3.5-0.8b
与 ollama list 里的 tag 完全一致(包括点、横线、大小写)。
2. CPU 占用高 / 非常慢
尝试先用 qwen3.5-0.8b,避免一上来就拉大模型
问题尽量短一点,减少生成 token 数
如果是服务器,可以考虑用 screen 或 tmux 把进程常驻后台
3. 报 'unauthorized token' 类错误 说明 OpenClaw 的网关启用了一些 token 校验:
openclaw token create
openclaw gateway restart
十、一键启动脚本示例(方便日常使用) 例如 start_openclaw_qwen.sh:
#!/bin/bash
openclaw gateway restart
openclaw tui
chmod +x start_openclaw_qwen.sh
十一、总结:这一篇你已经完成了什么?
在本地安装并启动 Ollama ;
拉取并验证可以运行的 Qwen 3.5 0.8B 模型 ;
安装 OpenClaw / OpenClawbot ;
写好 config.yaml,让 OpenClaw 通过 Ollama 调 Qwen 3.5 ;
启动网关和 TUI,确认可以在终端完成整链路对话;
初步了解了如何把机器人接入 Telegram。
相关免费在线工具 RSA密钥对生成器 生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
Mermaid 预览与可视化编辑 基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
随机西班牙地址生成器 随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online
Base64 字符串编码/解码 将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
Base64 文件转换器 将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
Markdown转HTML 将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online