OpenClaw零基础实操教程:3分钟跑通本地AI助手实现文件读写与自动关机

OpenClaw 零基础实操:3分钟跑通你的第一个本地AI助手(文件读写+自动关机)
想让AI自动整理下载文件夹、定时备份文档,甚至半夜帮你关机?
怕云端模型泄露隐私,又卡在 LangChain + Ollama + MCP 的嵌套配置里?
90% 的新手其实就卡在一件事上:装完模型,调不动系统权限。
OpenClaw(龙虾AI)是 2026 年国内首个真正打通 OS 底层的开源 Agent 框架。
它不依赖 App 安装,Web 页面点开就能用,命令行输入就能执行,桌面端双击即运行。
更重要的是,它默认启用沙箱内安全的系统调用权限——读文件、改配置、启/停进程,全在本地完成。模型权重和操作日志零上传。
我们用一个真实场景演示:让 AI 每天早上 8 点自动读取 ~/Downloads 里的所有 PDF,提取标题,重命名后移入 ~/Documents/日报存档,最后发条系统通知。
步骤一:环境准备(仅需 2 条命令)
# 1. 安装OpenClaw(Mac/Linux一键安装,Windows用PowerShell)
curl -fsSL https://get.openclaw.dev | bash
# 2. 启动服务(自动下载轻量版龙虾-7B模型,约1.2GB,首次运行需5分钟)
openclaw serve --model yitb/lc-7b-q4_k_mcurl | bash 是 OpenClaw 官方签名安装脚本,会校验二进制完整性。 --model 参数指定龙虾 AI 官方微调的 7B 量化模型,专为本地 OS 操作优化:比通用模型快 3 倍、内存占用少 60%,且内置文件系统工具链。
步骤二:加载模型并配置 Agent
打开浏览器访问 http://localhost:3000 → 点击「新建Agent」→ 填写:
name: 晨间整理员
description: 自动归档PDF并通知
tools:
- file_read
- file_list
- file_move
- os_notify
- shell_exec
schedule: "0 0 8 * * ?" # cron格式:每天8:00执行
prompt: |
你是一个严谨的文件管理员。请:
1. 列出 ~/Downloads 下所有 .pdf 文件
2. 对每个PDF,用pdfinfo命令读取Title元数据(若无,则用文件名前10字)
3. 将文件重命名为「[标题]_YYYYMMDD.pdf」,移入 ~/Documents/日报存档
4. 最后执行 os_notify "已归档X份PDF"OpenClaw 把常用 OS 能力封装成 tool,不是让你写 Python 脚本。 file_move 自动处理路径冲突、权限不足等异常; os_notify 在 macOS 弹窗、Linux 走 D-Bus、Windows 用 Toast,无需跨平台适配。
👉 Binance · OKX · Gate.io · HTX · Bitget
步骤三:验证效果
等待到明天早上 8 点,或手动触发测试:
# 立即运行一次(跳过定时器)
openclaw run --agent "晨间整理员"✅ 成功时你会看到终端输出:
[INFO] 找到3个PDF:report_v2.pdf, data_summary.pdf, meeting_notes.pdf
[INFO] 已重命名并移动:「Q3销售报告_20260805.pdf」→ ~/Documents/日报存档/
[NOTIFY] 已归档3份PDF同时桌面右下角弹出通知(非浏览器弹窗,是系统级通知)。
常见问题
Q:提示“Permission denied”无法读取 Downloads?
A:OpenClaw 默认只访问用户主目录。首次运行时,macOS 会弹出「允许访问下载文件夹」系统授权框——必须点击「好」。Linux 需确保 ~/Downloads 属主是当前用户:chown $USER:$USER ~/Downloads。
Q:模型启动失败,报错“CUDA out of memory”?
A:这是显存不足。改用 CPU 模式:openclaw serve --model yitb/lc-7b-q4_k_m --device cpu(速度略慢但稳定,日常整理任务无感知)。
Q:想让 AI 自动关机?
A:在 prompt 里加一行:5. 执行 shell_exec "shutdown -h now",然后在 Agent 设置中开启「高危指令白名单」(Web 界面右上角 ⚙️ → Security → Allow shell_exec)。
OpenClaw 的价值不在“能做什么”,而在“不用妥协什么”:
不传数据上云、不学 React 写前端、不配 Docker 网络——你写的每行指令,都在自己电脑上实时执行。
下一步建议:
→ 《用OpenClaw+Ollama部署13B本地模型》
→ 《给Agent添加微信通知:3步接入企业微信机器人》
→ 或直接试用预置模板:openclaw template list 查看「自动清理临时文件」「Git提交摘要生成」「截图OCR转文字」等现成 Agent。