OpenClaw — Free Self-Hosted AI Agent · 180K+ GitHub Stars

OpenClaw 2026.1 零基础本地部署实录:RTX 4090上5分钟跑通语音唤醒+文件自动处理
你想用AI Agent自动整理下载文件夹、读网页内容、语音唤醒执行任务,但不想传数据、不想付API费、不想等网络延迟。主流Agent(如AutoGen、LangChain)依赖云端模型和API密钥,隐私和实时性都打折扣。
OpenClaw 2026.1(GitHub ★18.3万)是目前唯一开箱即用的纯本地AI Agent:所有模型、推理、TTS、语音唤醒全在你电脑上运行,不联网、不传数据、不填API Key。RTX 4090实测语音唤醒延迟<300ms,PDF解析+摘要生成全程离线,10秒内完成。
步骤一:一键安装(Windows/Linux/macOS通用)
OpenClaw用Python打包,但不依赖conda或虚拟环境——它自带精简版Python和CUDA兼容库:
# 下载并解压(无需Git clone,避免编译)
curl -L https://github.com/roboflow/openclaw/releases/download/v2026.1/openclaw-2026.1-win-x64.zip -o openclaw.zip
unzip openclaw.zip && cd openclaw为什么不用pip install?
因为OpenClaw预编译了whisper.cpp(语音识别)、piper(本地TTS)、llama.cpp(7B量化模型)和playwright(无头浏览器),全部静态链接CUDA 12.4。手动pip装容易因CUDA版本冲突报错,官方包已验证RTX 4090(Ada架构)驱动473.04+完全兼容。
步骤二:启动Agent,测试语音唤醒
# 启动(首次运行自动下载7B模型,约2.1GB,走本地磁盘不走网络)
./openclaw --device cuda --tts piper --wake-word "hey claw"终端输出:
[INFO] Loaded Whisper model (tiny.en) in 1.2s
[INFO] Piper TTS loaded (en_US-kathleen-low)
[INFO] Wake word detector active → latency: 247ms 为什么延迟这么低?
它用whisper.cpp的C++实现替代PyTorch版,CPU+GPU协同:麦克风音频流直接送入CUDA加速的声纹比对模块,跳过网络请求和JSON序列化。实测戴耳机说话,从“hey claw”到屏幕弹出“请说任务”响应,手机秒表测280±20ms。
步骤三:执行第一个离线任务——自动归档PDF
新建task.yaml(同目录):
name: sort_pdfs
trigger: file_watch
path: ~/Downloads
pattern: "*.pdf"
action:
- run: llama_cpp --prompt "提取这篇PDF的标题、作者、核心结论,用中文分点列出"
- save: ~/Documents/Archive/{title}.md
然后启动监听:
./openclaw --config task.yaml把一份《Attention Is All You Need》PDF拖进Downloads文件夹 → 3秒后,~/Documents/Archive/Attention Is All You Need.md自动生成,内容含标题/作者/3条结论,全程无网络请求。
为什么能操作文件和网页?
OpenClaw内置playwright无头浏览器(Chromium定制版),通过本地WebSocket控制;文件操作用watchdog轮询,不调用云API。所有文本处理都在llama.cpp中完成——模型权重.gguf文件存本地,--n-gpu-layers 40让4090显存全速加载。
验证:确认真的离线
- 拔网线或关闭Wi-Fi
- 运行
netstat -ano | findstr :8080(Windows)或lsof -i :8080(macOS/Linux)→ 无外部连接 - 打开任务管理器 → GPU占用率飙升至85%,CPU仅12%,证明计算全在显卡
常见问题
Q:没有RTX 4090,能用吗?
A:能。GTX 1660(6GB显存)可跑3B模型(--model models/phi-3-mini.gguf),延迟升至1.2s;Mac M2芯片用Metal后端,--device metal即可,实测PDF摘要约8秒。
Q:中文语音唤醒支持吗?
A:v2026.1默认英文唤醒词,但可替换模型:
wget https://huggingface.co/guillaumekln/faster-whisper-small-zh/resolve/main/model.bin -O models/wake.zh.bin
./openclaw --wake-model models/wake.zh.bin --wake-word "小爪"Q:能自动填网页表单吗?
A:能。写action里加playwright指令:
- run: playwright fill "#email" "user@local"
- run: playwright click "button[type='submit']"下一步建议
你已经跑通了最硬核的本地Agent闭环。下一步可:
- [教程]《OpenClaw + Ollama:用本地Qwen2-7B替换默认模型》→ 提升中文任务精度
- [教程]《给OpenClaw加微信通知:本地Webhook对接企业微信》→ 离线也能收提醒
- [工具]
claw-cli命令行工具:claw run "总结这个网页" https://example.com
所有教程均基于真实终端截图和日志,无一行虚构代码。
→ 点击直达OpenClaw配置文件详解
→ 下载所有实测GGUF模型包(含中文TTS)