OpenClaw怎么在本地安装Ollama?
OpenClaw 应用依赖本地 Ollama 服务,用户需先独立部署 Ollama 并确保其在 http://localhost:11434 正常运行,再启动 OpenClaw;否则初始化时会因连接失败而报错退出。

确认系统环境与权限
检查当前用户是否具备 systemd 管理权限(Ubuntu/Debian/CentOS Stream 等主流发行版默认支持)。若使用 WSL2 或无 systemd 的精简系统(如 Alpine 容器),需改用前台启动模式,否则
ollama serve 命令将无法后台驻留,OpenClaw 启动后立即断连
运行 uname -m 验证架构:x86_64 或 aarch64 均受支持;RISC-V 或旧版 i386 不兼容。
下载并执行 Ollama 安装脚本
在终端中逐行执行以下命令:
curl -fsSL https://ollama.com/install.sh | sh
该脚本自动完成:检测系统类型→下载对应架构二进制→写入 /usr/bin/ollama→注册 systemd 服务→启动 ollama.service。安装过程无需 sudo,但最终服务注册需要 root 权限,脚本内已内置 su 提权逻辑。
安装完成后,ollama 命令全局可用,且服务默认开机自启。
验证 Ollama 是否正常运行
方法一:检查服务状态
systemctl is-active ollama
返回 active 表示服务已就绪;若返回 inactive 或 unknown,请先运行 sudo systemctl start ollama。
方法二:发起一次 API 请求
curl http://localhost:11434/api/tags 2>/dev/null | jq -r '.models[].name' | head -n1
能输出类似 llama3:8b 或 deepseek-r1:14b 即说明服务响应正常。如果报 curl: (7) Failed to connect,则证明 Ollama 未运行或端口被占用——此时不要继续配置 OpenClaw。
加载 OpenClaw 所需的基础模型
OpenClaw 默认调用 ollama run 时指定的模型名通常为 llama3、phi3 或 qwen2:0.5b,需提前拉取:
ollama run llama3
首次运行会自动下载约 4.7GB 模型文件到 ~/.ollama/models/blobs/,耗时取决于网络。下载中途断开不会损坏已有分片,再次运行 ollama run llama3 会续传。
注意:若服务器无外网访问能力,必须提前在有网环境执行 ollama pull llama3 → tar -cf ollama-llama3.tar ~/.ollama/models/ → 拷贝至目标机器 → tar -xf ollama-llama3.tar -C /,否则 OpenClaw 启动时会卡在模型拉取阶段超时失败。