最近花了点时间把openclaw在本地完整部署了一遍整个过程比我想象中顺利太多。老实说我对这类终端AI agent工具一直带着点警惕潜意识里总觉得能自己执行命令的AI要么配置复杂到劝退要么核心功能藏着掖着收费。但openclaw的一键安装和免费版童叟无欺这两个点确实戳中了我实际跑下来从下载到跑通第一个真实任务大概也就十来分钟而且免费版给我最直观的感受是核心能力没做任何阉割。这篇文章就把我从零部署的过程、卡过的坑、以及第一周高强度使用的真实体验完整理一遍给正在犹豫要不要本地部署openclaw的朋友一个参考。1. 先搞清楚openclaw是什么以及本地部署意味着什么1.1 一个跑在终端里的AI代理而不是又一个聊天框openclaw本质上是一个终端原生的AI代理框架。这句话听起来有点抽象我换个说法你给它一个目标它会自己拆解步骤、读写文件、执行命令、调用工具直到把事办完。拿我自己最常用的场景举例我需要批量把一个目录下几百个命名混乱的日志文件整理成按日期归档的结构传统做法是自己写个Python脚本琢磨半天路径和异常情况openclaw的做法是直接告诉它把xxx目录下的日志按日期归档重名文件加序号它会自己写脚本、运行、检查结果遇到解析不了的文件名还会停下来问我怎么处理。它和普通聊天AI最大的区别在于它不止说还会做。它会真的在你的工作目录里创建文件、执行shell命令、安装依赖、跑测试。换句话说它更像一个远程实习生坐在你的电脑前操作而不是一个只输出文字的问答机器人。这也是很多人第一次用的时候既兴奋又紧张的原因——权限控制做得好不好直接决定这个工具是得力帮手还是安全隐患。1.2 本地部署的意义数据、成本和可控性很多人听到本地部署四个字第一反应是会不会很折腾。但放在openclaw这个场景里本地部署解决的是三个很实际的问题。第一是数据隐私。如果使用云端版本你的代码、文档、对话内容都要经过别人的服务器。本地部署之后分析动作都发生在自己的机器上项目文件本身不用上传只有你想让模型处理的指令会经过API。对写私有代码、处理客户文档的用户来说这一点几乎是刚需。第二是成本。openclaw框架本身免费你只需要为背后的大模型付费。如果配合本地模型比如用Ollama跑qwen系列连模型费用都省了日常小任务基本零成本。这和那些按agent调用次数收费的商业产品比差的不是一点半点。第三是可控性。你能看到每个配置文件的每一行能自由切换模型、调整工具权限、修改工作目录。那种把命运握在自己手里的感觉是云端版本给不了的。1.3 免费版到底童叟无欺在哪里我这人比较谨慎看到免费版三个字第一反应是去找有没有隐藏限制。实测下来openclaw的免费版在核心功能上没有故意阉割终端交互、workspace文件读写、命令执行、skills扩展这些能力全都在也没有强制联网、强制注册账号那套东西真正做到了开箱即用。安装过程中如果弹出类似add ai later的提示直接跳过也不影响使用后面在配置文件里随时可以补上模型连接。唯一需要说清楚的是免费版送的是openclaw这个框架本身你调用云端大模型API产生的费用是单独的这部分跟框架的免费与否没关系。2. 部署前的准备环境依赖与容易忽视的细节2.1 硬件与系统要求openclaw本身是个轻量级程序跑起来占用的系统资源很少真正的资源大头是背后的大模型。如果使用云端APIDeepSeek、OpenAI兼容接口这类一台8GB内存的普通电脑就够CPU也不用太好因为推理都在服务端完成。如果要跑本地模型建议16GB内存起步有NVIDIA显卡且显存8GB以上体验会好很多。没有显卡也能跑但只能选小尺寸模型速度看你接受底线在哪。系统层面Windows 10/11、主流Linux发行版、macOS都有对应的安装方式。我这次验证了两台机器一台Windows 11一台Ubuntu 22.04下面的步骤两边都会覆盖到。2.2 前置依赖git、Node还有Windows用户绕不开的PowerShell一键安装脚本并不是完全零依赖。为了避免装到一半卡住建议提前把下面几样准备好git很多操作和后续拉取skills会用到。Node.jsopenclaw的一些内置工具和skills依赖Node运行时。Python如果你打算让agent写Python脚本大部分文件处理、数据分析任务会涉及提前装好并加入PATH。Windows用户最容易在这里踩的坑是PowerShell执行策略。安装脚本本质是一个PowerShell脚本如果系统默认的ExecutionPolicy是Restricted脚本会被直接拦下来报错类似于无法加载文件因为在此系统上禁止运行脚本。解决办法不是关掉安全策略而是先打开PowerShell执行一次Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserRemoteSigned的意思很明确本地脚本可以运行从网络下载的脚本必须经过签名或确认。这是微软官方推荐的安全级别比直接设为Unrestricted稳妥得多。2.3 模型接入想清楚云端API还是本地模型这是部署前我纠结最久的问题。我的建议是第一次部署先用云端API把整体流程跑通再考虑本地模型。原因很简单如果第一次就接本地模型任务执行报错时你很难判断到底是openclaw配置问题还是模型能力不足、上下文长度不够、推理速度太慢。云端大模型能力稳定先跑通之后出问题时可以把变量从模型缩小到框架排查难度直接降一个数量级。我初次配置选的是DeepSeek的APIOpenAI兼容格式成本低国内网络环境下调用也稳定。跑通之后才切换到Ollama跑本地qwen2.5体验从能用到完全免费这条升级路径。openclaw对模型的核心要求是支持OpenAI兼容接口这一条几乎覆盖了市面上所有主流方案后面配置时你会有直观感受。3. 一键安装Windows与Linux的完整实操3.1 Linux/macOS下的安装Linux下的安装是标准的curl管道bash模式。官方README会给你一条命令结构基本长这样curl -fsSL 官方安装脚本地址 | bash这里多提醒一句别直接复制别人博客里的命令去官方仓库拿最新版。这类项目迭代速度很快老版本脚本在新系统上可能出现兼容问题用官方文档里的准没错。脚本执行过程中会依次做几件事下载openclaw主程序到当前用户目录、初始化~/.openclaw配置目录、创建workspace工作目录、检测git和Node环境是否就绪。网速正常的情况下整个过程大约两三分钟。3.2 Windows下的PowerShell安装Windows下流程类似打开PowerShell执行官方文档里的安装命令irm 官方安装脚本地址 | iex这里有两个被反复问到的问题我实测后的结果如下。第一能不能指定安装目录可以。安装前先设置环境变量把OPENCLAW_HOME指向你想要的路径再执行安装脚本程序就会装到对应目录。不想设置环境变量的话装完也可以把整个openclaw目录挪走但需要同步更新系统PATH和配置文件里的绝对路径否则会有奇怪的找不到文件的问题。个人建议还是提前设置OPENCLAW_HOME省事。第二安装到一半提示add ai later是什么意思这是安装程序在询问要不要顺便配置模型连接。选稍后配置完全不影响使用我第一次就是选跳过后面改配置文件几分钟搞定。Windows安装结束后你会在用户目录下看到.openclaw文件夹这个路径要记一下后面所有配置都在里面。3.3 安装目录与workspace结构装完之后~/.openclawWindows下是C:\Users\你的用户名.openclaw目录里主要有这样几个东西config文件全局配置模型、API key、默认行为都在这里改。workspace目录AI代理的工作沙盒默认在这个目录里操作文件。exec-approvals.json命令审批记录后面详细说。skills目录存放扩展技能。这里有个很多人不理解的设置默认workspace在.openclaw目录内部但你完全可以在配置里指向任意目录。比如我就把项目目录单独划给openclaw用这样它操作文件时不会波及系统重要区域出问题也好收拾。4. 核心配置模型接入、workspace与审批机制4.1 配置文件里到底要改什么第一次打开配置文件内容可能比你想象中少甚至会有种这就完了的感觉。核心要改的其实就三处model provider模型供应商填openai兼容的服务商或者本地Ollama都行。api_key调用API所需的密钥本地模型可以留空。model name要用的模型名比如deepseek-chat或者qwen2.5:7b。改配置之前记得先备份。我见过有人手滑把默认配置删了程序启动后又重新生成了一份默认的之前调好的参数全没了。4.2 从DeepSeek API到Ollama本地模型接入DeepSeek的配置逻辑和OpenAI完全一致因为都走OpenAI兼容协议。把base_url指到DeepSeek的API地址api_key填你申请的key模型处填deepseek-chat保存重启即可。切到本地模型需要先装Ollama然后拉一个模型下来ollama pull qwen2.5:7b再把openclaw的base_url改成http://localhost:11434/v1模型名改成qwen2.5:7bapi_key留空。这样一来推理全走本机算力日常简单任务不花钱数据也完全不出机器。不过必须提醒一句本地小模型的能力上限和云端大模型有明显差距复杂多步推理任务7B本地模型很容易想不明白。我的用法是日常琐事挂本地模型重要任务临时切回云端API两边切换就是改几个字段的事。4.3 exec-approvals.json权限审批机制这是整个openclaw安全设计里我最喜欢的一环也是新手最容易忽略的配置。默认情况下openclaw执行系统命令之前会先征求你的同意属于先问再做模式。当你确认某个命令可以执行它会把这个命令记录到exec-approvals.json里下次遇到同样的命令就直接放行不再询问。这个机制很像手机上的应用权限弹窗第一次App要访问相册会弹窗询问允许之后后续就不再打扰。它的价值在于AI agent是一个会自主行动的程序如果给了它完全自由的命令执行权限一旦模型被诱导或者判断失误可能在系统里执行危险操作逐条审批是个有效缓冲。实际用了一段时间后有一个经验与其每次都手动点同意不如花五分钟手动编辑这个文件把确实安全、高频使用的命令预先写入白名单比如文件列表、git status、普通文件读写操作。日常使用会顺畅很多而rm、格式化这类危险命令继续保持逐条审批。把安全策略前置比事后再追责靠谱得多。5. 跑通第一个真实任务从安装完成到真正干活5.1 初始化项目与workspace配置好模型之后先别急着接自己的业务在workspace里开一个测试目录让openclaw在里面自由发挥。启动openclaw后会进入一个交互式的命令行界面。和常见的AI聊天界面不同这里更像一个终端你可以直接输入自然语言指令它会边思考边执行把中间步骤打印出来。我第一次测试时让它做了一件看起来很简单的事在workspace下创建一个Python脚本生成1到100的质数列表运行并输出结果。这个任务的目的不是看AI会不会写代码而是验证它能不能完成创建文件、写代码、运行命令、读取输出的完整闭环。配置正确的话你会看到它自己新建文件自己执行python命令然后把质数列表打印出来。5.2 权限审批的完整流程体验这个过程中你会遇到一个很有意思的时刻——当agent第一次要执行python命令时它会停下来询问你是否允许。你输入确认它继续。前面提到的exec-approvals.json就在这个环节起效。这里容易误解的点是openclaw的审批不是每一条命令都会问。workspace内的文件读写、目录操作通常是直接允许的审批主要针对系统级命令。所以授权时要有意识地区分哪些命令可以放心给比如ls、cat、git status哪些命令会引入风险比如curl执行远程脚本、rm -rf。拿不准的先拒绝手动检查命令内容再做决定。5.3 第一个实用小任务批量归档日志文件跑通质数脚本后我做的第一个真实有用的任务就是开篇说的日志归档。场景是这样的一个目录里有几百个日志文件名带日期但不规则有.log后缀、.txt后缀还有完全没后缀的需要按日期归到年/月/日文件夹里。我给openclaw的指令足够自然扫描D:\logs目录下的所有日志文件根据文件名中的日期信息重命名并按日期归档到D:\logs_archive\YYYY\MM\DD目录重名文件加序号完成后给我统计报告。它先列出文件清单分析命名规则然后写了一个Python脚本跑了一次结果有若干文件解析日期失败它停下来把问题反馈给我我确认后它调整脚本继续跑。全过程不到10分钟手工处理的话半小时起步。这个任务让我真正理解了openclaw的定位它不是一个Ask me anything的搜索引擎而是一个帮我搞定这件事的执行引擎。6. 实战进阶skills扩展与生态联动6.1 skill机制让openclaw学会调工具openclaw的skills有点像ChatGPT的插件或者Claude的skills本质上是一组预定义的提示词加工具脚本让agent面对特定任务时自动调用最合适的方法。我举一个自创的例子。我需要定期把项目里的变更整理成周报。传统做法是手动看git log、整理commit信息、写周报文档。我写了一个skill里面定义了完整的流程从git log提取本周提交按模块分类生成Markdown周报保存到指定目录。之后我只需要在openclaw里说生成本周周报它就会自动加载这个skill执行整套流程。skill的编写难度不算高但对第一次接触的人来说建议先从社区拿现成的跑通了再自己改。我踩过的一个坑是skill脚本里的路径写的是绝对路径换了一台机器就崩了后来统一改成读环境变量才解决。6.2 与本地模型生态联动Ollama、NVIDIA NIM、Difyopenclaw能直接使用的模型来源不止一个Ollama最轻量适合个人电脑装好即用。NVIDIA NIM如果机器上有N卡可以部署NIM微服务openclaw通过OpenAI兼容接口调用延迟和并发能力比Ollama好不少。Dify如果已经在用Dify搭建工作流可以把它当模型网关openclaw接Dify的API等于把Dify里调试好的工作流能力开放给openclaw。这三条路径的选择逻辑其实很清晰个人笔记本用Ollama就够有几张N卡、追求推理性能和并发上NIM已经有一套Dify工作流、不想重复造轮子就直接对接Dify。它们和openclaw对接的方式基本一致都是改配置里的base_url和模型名。6.3 Obsidian openclaw 做项目管理另一个强烈推荐玩的是Obsidian和openclaw联动。Obsidian本身是一个本地Markdown笔记库文件结构清晰非常适合作为agent的操作对象。我的用法是把项目笔记全部放在Obsidian库里的一个专门目录然后让openclaw定期扫描目录找出状态为进行中的任务结合日期判断是否延期自动生成当日待办清单和昨日总结。因为Obsidian的文件全是本地Markdownopenclaw读写起来毫无障碍两个工具配合得像是原生一体的。这个过程让我体会到openclaw最擅长的事情之一就是充当本地文件和外部API之间的胶水。它能读笔记、调模型、执行脚本把你手里的零散工具串成一条自动化流水线。7. 常见问题与排错经验7.1 安装脚本执行失败的第一现场无论Linux还是Windows安装失败最常见的原因就是网络。curl或者irm下载脚本时超时甚至直接返回空内容。遇到这种情况先别怀疑脚本有问题检查网络连接、确认能正常访问官方域名然后重试。另一个高频原因是环境变量缺失。比如git、node没装或者没加PATH安装脚本调用它们时会失败报错通常是command not found。提前装好前置依赖能规避90%的问题。7.2 模型连接失败怎么判断问题出在哪我见过最多的情况是配置文件字段写错。模型名填错很典型比如填成deepseek-v3实际服务商提供的是deepseek-chat差一个字符就会报模型不存在。还有base_url漏了末尾的/v1或者https写成了http。排查顺序我推荐从后往前先确认模型名正确再看base_url是否完整最后确认api_key是否有权限。用curl直接打一下API接口绕过openclaw——如果curl通而openclaw不行说明配置文件有问题如果curl也报错那就是API侧的问题。7.3 权限相关报错如果你在Linux上用root跑过openclaw然后在普通用户下去读root用户的~/.openclaw/exec-approvals.json大概率会看到permission denied。这种情况把文件权限改一下就行或者用普通用户重新初始化一份配置。实测最省心的办法是安装时就想好用哪个系统账号固定下来不要来回切。Windows下类似的坑是杀毒软件拦截。openclaw要执行命令、写文件行为模式和某些恶意软件相似可能触发Windows Defender误报。如果安装或运行过程中文件被杀掉去保护历史记录里手动恢复并添加信任目录。这算是这类终端agent工具在Windows上的常见麻烦不算openclaw独有的问题。7.4 卸载与重装卸载比想象中简单毕竟它没有往系统目录里塞东西。直接删除openclaw主程序目录和~/.openclaw配置目录即可。唯一要留意的是如果配置过PATH环境变量需要把对应条目清掉。重装直接重新执行安装脚本它会重新生成配置目录。不过记得先把旧配置文件备份出来尤其是exec-approvals.json里的审批白名单否则重装后又要重新逐个信任命令挺烦的。总的来说openclaw本地部署的整个链路已经相当成熟免费版也确实没有藏着掖着。如果你手头正好有大量文件处理、代码整理、项目管理类的琐碎任务花一个晚上部署好后面省下来的时间绝对值回票价。最后再分享一个小习惯每周花几分钟备份一下~/.openclaw目录重点备份exec-approvals.json和skills目录——这些是你和这个agent协同工作的记忆丢了再重新养要花不少时间。