back
loading skill details...
Ollama Updater installs or updates Ollama with curl-based breakpoint resume, auto-retry, progress display, old version cleanup, and GPU driver detection.
# ollama-updater
带断点续传功能的 Ollama 安装/更新工具,解决网络不稳定导致的下载中断问题。
## 功能
- ✅ **断点续传**: 使用 `curl -C -` 实现下载中断后继续下载
- ✅ **自动重试**: 下载失败自动重试 3 次
- ✅ **进度显示**: 实时显示下载进度
- ✅ **智能清理**: 自动清理旧版本
- ✅ **GPU 支持**: 自动检测并安装 NVIDIA/AMD GPU 驱动
## 安装
```bash
# 使用 OpenClaw
openclaw skills install ollama-updater
# 或使用 ClawHub
clawhub install ollama-updater
```
## 使用方法
### 基本用法
```bash
ollama-updater
```
### 指定版本
```bash
OLLAMA_VERSION=0.5.7 ollama-updater
```
### 手动运行
```bash
# 直接运行脚本
bash /path/to/ollama-updater/main.py
# 或使用 sudo
sudo bash /path/to/ollama-updater/main.py
```
## 断点续传原理
使用 curl 的 `-C -` 参数实现断点续传:
```bash
# 普通下载(中断后需要从头开始)
curl -O https://example.com/file.tar.gz
# 断点续传(中断后可以继续)
curl -C - -O https://example.com/file.tar.gz
```
如果下载中断,只需重新运行命令,curl 会自动从断点处继续下载。
## 故障排查
### 下载总是中断
**原因**: 网络不稳定或服务器限速
**解决**:
1. 多次运行脚本,会自动从断点续传
2. 使用国内镜像(如有)
3. 检查网络连接
### 提示 zstd 错误
**原因**: 需要 zstd 解压工具
**解决**:
```bash
# Debian/Ubuntu
sudo apt-get install zstd
# RHEL/CentOS/Fedora
sudo dnf install zstd
# Arch
sudo pacman -S zstd
```
### 权限错误
**原因**: 需要 sudo 权限
**解决**:
```bash
sudo ollama-updater
```
## 与官方脚本的区别
| 功能 | 官方脚本 | ollama-updater |
|------|---------|----------------|
| 断点续传 | ❌ | ✅ |
| 自动重试 | ❌ | ✅ (3 次) |
| 进度显示 | ✅ | ✅ |
| GPU 检测 | ✅ | ✅ |
| systemd 配置 | ✅ | ✅ |
## 技术细节
### 断点续传实现
```bash
download_file() {
local url="$1"
local output="$2"
local max_retries=3
local retry_count=0
while [ $retry_count -lt $max_retries ]; do
retry_count=$((retry_count + 1))
# 使用 -C - 实现断点续传
if curl --fail --show-error --location --progress-bar -C - -o "$output" "$url"; then
return 0
fi
if [ $retry_count -lt $max_retries ]; then
sleep 5
fi
done
error "Download failed after $max_retries attempts"
}
```
### 下载流程
1. 检查是否需要断点续传(已有部分文件)
2. 使用 `curl -C -` 继续下载
3. 下载失败自动重试(最多 3 次)
4. 下载成功后验证并解压
## 系统要求
- Linux (x86_64, aarch64)
- macOS (x86_64, aarch64)
- curl (必需)
- zstd (新版 Ollama 需要)
- sudo (系统级安装需要)
## 文件结构
```
ollama-updater/
├── main.py # 主程序(包装官方脚本)
├── ollama-install.sh # 改进的安装脚本
├── SKILL.md # 技能说明
├── README.md # 使用指南
└── package.json # 包信息
```
## 版本历史
### v1.0.0 (2026-02-20)
- 初始版本
- 添加断点续传功能
- 添加自动重试机制
- 保留官方脚本所有功能
## 许可证
MIT License
## 支持
如有问题,请提交到:https://github.com/openclaw/skills/issues
don't have the plugin yet? install it then click "run inline in claude" again.