1. 先说清楚OpenClaw到底是什么为什么2026年大家都在装它如果你最近刷技术社区应该已经感受到OpenClaw也叫Clawdbot的热度了。简单说它是一个把AI智能体能力落到本地、落到命令行、落到自动化流程里的开源项目。和那种只能在一个网页对话框里聊天的模型不同OpenClaw的思路是给你一个能调用工具、能读写文件、能执行命令、能对接各种服务和API的Agent运行环境装好之后相当于在你电脑里养了一个能真正帮你干活的数字员工。我最初接触这个项目是因为团队里要做大量重复性的信息整理和跨平台任务调度。传统写法是写一堆脚本每个脚本只管一件事运维和编排成本非常高。OpenClaw把“任务理解—拆解—调用工具—执行—返回结果”这一整套流程收口到一个统一框架里让我能像配置服务一样配置Agent而不是每次从零硬编码。项目本身的名字也很有意思Clawdbot这个名字指向的是“爪子”寓意就是Agent得能伸手够到各种工具而不只是动嘴皮子。这篇教程主要面向几类人一是想在Windows 11或Ubuntu上把OpenClaw真正跑起来、而不是停留在跑通Demo阶段的人二是想用OpenClaw对接本地大模型比如Ollama、NVIDIA NIM或者ClawHub生态的人三是那些在安装过程中已经碰了壁、搜索过“PowerShell安装openclaw能指定目录吗”“openclaw无法识别命令”“exec-approvals.json报错”这些问题的人。我会把从环境准备、一键部署、目录规划、验证配置、Skill扩展到问题排查、卸载重装的完整链路都拆开讲尽量做到看完就能照做。需要提前说明的是OpenClaw迭代速度极快2026年的版本在安装机制上已经比早期版本顺滑很多但正因为更新频繁网上很多教程的截图和路径早就不适用了。这篇文章基于当前主流稳定版的实际表现来写同时会把“如何自己判断版本差异”的方法也教给你授人以渔。2. 安装前的底层逻辑为什么这次部署比之前稳以及你真正需要准备什么很多人装OpenClaw失败不是软件本身的问题而是没有理解它的运行机制。OpenClaw虽然提供了一键部署脚本但它本质上不是一个单文件绿色工具而是一套会与操作系统深度交互的Agent运行环境。它需要创建配置目录、写入执行审批规则、调用系统Shell、与模型API通信这些都决定了它对环境有硬性要求。2.1 2026版OpenClaw的部署形态解释清楚“一键部署”背后的三件事所谓一键部署其实帮我们完成了三件事第一步拉取当前平台的OpenClaw二进制或安装包第二步在用户主目录下初始化.openclaw配置目录包括存放配置、暂存数据、运行日志、工作区文件的目录结构第三步注册命令行入口让你在PowerShell或Bash里能直接调用openclaw命令。理解这三件事之后很多报错就变得非常好排查了——比如“命令无法识别”基本就是第三步没成功比如某些配置不生效很可能是第二步的配置目录和实际启动的目录不一致。具体到2026年的版本安装脚本还增加了一项重要的自检机制在安装完成后自动检查运行环境是否满足依赖包括网络连通性、是否安装了Git、PowerShell执行策略等。这也是一键安装成功率大幅提升的原因之一——脚本会在早期阶段就告诉你哪里有问题而不是等启动时才报一堆晦涩错误。2.2 硬性依赖清单Windows和Linux各自要准备什么这里我直接给清单都是实测有价值的。Windows端系统建议Windows 10 22H2或Windows 11需要确保PowerShell 5.1以上建议直接用PowerShell 7因为很多新特性和脚本语法在5.1上表现不佳。还要装好Git for Windows安装时记得选择“在命令行中使用原生Git”的选项。另外网络方面因为需要拉取GitHub上面的发布包和依赖你需要一个稳定的网络通道这一点对国内用户尤其重要很多安装失败案例最后都卡在下载中断。Linux端建议Ubuntu 22.04或24.04。需要确保curl、wget、git和build-essential已安装。如果打算用CUDA加速那就还要预先装好与系统匹配的NVIDIA驱动和CUDA工具包。OpenClaw本身不强制要求GPU但如果你要运行本地大模型GPU是体验的分水岭。内存方面纯Agent框架跑起来占用不大512MB都够但如果你要同时跑7B或13B的本地模型那是另一回事至少16GB内存起步。2.3 提前规划目录结构Windows用户最容易忽略的一步我在实际帮人排查时发现Windows用户最容易遇到的问题之一是OpenClaw默认把配置目录放在C:\Users\用户名\.openclaw。如果你C盘空间紧张或者你希望把整个Agent环境放在另一块硬盘上那么就要在安装前想好Plan B。目前OpenClaw支持通过环境变量指定目录Windows下可以设置用户环境变量OPENCLAW_HOME指向你希望的位置然后命令行安装前先$env:OPENCLAW_HOMED:\OpenClawHome。这样配置目录、工作区、日志就都会迁移到D盘避免C盘被塞满。不过说实话如果你只是探索性使用我更建议先用默认目录跑通。等确认要长期使用、大量安装Skill和扩展之后再考虑迁移。因为迁移过程中需要同步调整环境变量、计划任务等新手容易漏掉某一处导致启动异常。3. 从零到一的完整安装实操Windows和Ubuntu两条路线照着敲就行正式动手之前再次强调OpenClaw的新版本安装脚本会做很多自动检查但脚本不是万能的。安装中遇到问题最重要的是保留完整的终端输出日志而不是截图一部分报错就到处问。完整日志能省掉大量的来回沟通成本。3.1 Windows 11上的PowerShell安装全流程以Windows 11为例我会给出最稳的安装路径。第一步打开PowerShell建议以管理员身份运行首先确认执行策略Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser这一步是为了允许本地脚本运行同时阻止未签名的远程脚本。很多新手卡在这一步因为默认策略是Restricted脚本根本没权限执行。第二步确认网络和基础工具git --version winget --version如果提示找不到git就先装Git for Windows。装完Git之后新开的终端窗口里才识别得到git命令。第三步执行官方推荐的一键安装命令。目前OpenClaw推荐通过脚本方式安装命令大致如下irm https://openclaw.org/install.ps1 | iex这里我用的是官方占位地址实际安装时以官网文档为准。这个命令和很多Go工具链项目的安装方式一致从远程拉取安装脚本然后在当前Shell中执行。irm是Invoke-RestMethod的别名iex是Invoke-Expression的别名合起来就是“下载并运行”。安装脚本跑完后建议重启一次PowerShell然后运行openclaw --version如果输出了版本号恭喜基础安装已经成功。如果提示“无法将openclaw项识别为cmdlet、函数、脚本文件或可运行程序的名称”通常说明当前终端的环境变量没有刷新重启终端即可如果重启后依然如此那就检查安装脚本是否真正把可执行文件路径写入了用户PATH。3.2 Ubuntu 22.04/24.04上的命令行安装全流程Linux下安装要清爽很多。先用一条命令把基础依赖补齐sudo apt update sudo apt install -y curl wget git build-essential然后执行官方安装脚本curl -fsSL https://openclaw.org/install.sh | bash安装脚本一般会在/usr/local/bin或~/.local/bin下生成可执行文件。如果脚本结束之后提示openclaw: command not found多半是~/.local/bin不在PATH里。可以临时执行export PATH$HOME/.local/bin:$PATH再写入~/.bashrc永久生效echo export PATH$HOME/.local/bin:$PATH ~/.bashrc source ~/.bashrc3.3 自定义安装目录和“便携包”思路热词里有人搜索“openclaw便携包”我觉得值得聊一下。OpenClaw在Windows下是以单个可执行文件为核心分发的所以天然具备便携化潜质。你可以把安装目录下的整个OpenClaw文件夹拷贝到U盘或另一台电脑上前提是把OPENCLAW_HOME环境变量指向这个目录下的数据区否则到新机器上它还是会回落到默认用户目录。具体操作是在OpenClaw的安装目录下建home子目录然后设置用户环境变量OPENCLAW_HOME安装目录\home。这样配置和工作区都跟随可执行文件走换电脑只需要重装依赖Git、基础运行库然后把目录拷过去就能用。这个方案很适合需要在多台机器间切换、又不想每次同步配置的人。但要注意便携化之后第一次启动可能还需要重新授权一些外部服务因为配置里的认证令牌是机器相关的。3.4 安装完成后的五分钟首启检查装完先别急着配模型先把五分钟首启检查做掉。直接运行openclawWindows下是openclawLinux同样观察终端输出。正常情况下它会创建一个Agent实例并打印出当前的工作目录、配置文件路径和交互方式。如果没有报错说明核心链路是通的。接着强制中断CtrlC然后检查配置目录结构ls -la ~/.openclaw/Windows下对应C:\Users\用户名\.openclaw\。你会看到一个workspace目录、一个exec-approvals.json文件如果还没有等首次执行需要权限的命令就会生成、以及日志文件。这个结构很重要后面所有排错都围绕它展开。4. 安装之后的第一件正事配置模型、验证Agent闭环、理解NVIDIA NIM和Ollama两种接法OpenClaw本身不包含对话模型它是一个空壳框架你必须给它接上推理后端它才具备思考和行动能力。这也是很多第一次接触的人搞混的地方以为装完OpenClaw就能像ChatGPT一样直接聊天结果装完发现界面是黑底白字的命令行一时不知道下一步该干嘛。4.1 最省事的接入方案Ollama本地模型如果你手头没有API Key又不想花钱Ollama是目前最顺滑的本地模型运行方案。先去Ollama官网下载安装包装好后在终端拉一个模型比如ollama pull qwen2.5:7b然后回到OpenClaw的配置文件Windows下路径类似C:\Users\用户名\.openclaw\config.tomlLinux下是~/.openclaw/config.toml把模型提供商设为OllamaBase URL指向http://localhost:11434模型名填qwen2.5:7b。配置完成后重新启动OpenClaw在交互界面输入一句“请帮我查看当前目录的文件列表”如果Agent返回了正确结果说明端到端链路已经打通OpenClaw理解任务、调用工具、执行命令、返回结果。4.2 追求更强推理NVIDIA NIM接入热词里出现“openclaw配置nvidia nim”不是偶然。NVIDIA NIM是NVIDIA推出的推理微服务可以在本地或云端以标准化接口提供模型服务最大的优势是延迟低、吞吐高、对主流模型的支持经过NVIDIA优化。适合那些不满足于小参数模型、想要跑更强模型的人。接入方式和Ollama类似核心还是填对Base URL和模型名。NIM服务启动后一般会暴露一个兼容OpenAI的接口端点比如http://localhost:8000/v1。在OpenClaw配置里把模型提供商设为openai-compatible或NIM专用选项Base URL填这个地址模型名填你在NIM里部署的模型名例如meta/llama-3.1-8b-instruct视具体NIM版本而定。另外NIM通常需要API Key在配置里加上即可。4.3 为什么我建议你先跑通一个“最小闭环”再扩展我踩过一次最大的坑就是安装完OpenClaw后急着接一堆服务飞书、微信、项目管理、数据库……结果模型接口还没验证所有工具调用全部失败我一度以为OpenClaw本身有问题。后来静下心把配置回退到“只接Ollama本地模型”的极简状态一条一条调用指令测整个排查过程不到十分钟就定位到问题——原来是环境变量里的API地址写错了。所以真的建议第一次用OpenClaw先别急着接任何外部系统。就让它通过自带Shell工具执行几条命令、读写几个文件把这个最小闭环验证扎实。这个闭环跑通之后再去配置飞书、微信、项目管理那些Skill你排查问题时就有一个可靠的对照基准一旦扩展后出了问题先回滚到最小闭环确认基础链路没问题再逐层往上加。5. Skill与执行审批OpenClaw的灵魂功能和最容易被忽略的权限机制OpenClaw之所以能够“干活”核心在于Skill机制。你可以把Skill理解成给Agent安装的外挂能力包既有官方维护的通用技能也有社区分享的自定义技能。ClawHub就是这样一个技能市场类似VS Code的扩展市场只是它装的是Agent技能不是编辑器插件。5.1 基本Skill安装流程Ollama下装技能、ClawHub与自定义Skill的区别在OpenClaw里安装Skill的命令非常直观。比如你想安装一个负责时间管理的Skill大致格式是openclaw skills install skill-name然后重启OpenClaw新的技能就会被加载。重点说一下ClawHub和自定义Skill的区别ClawHub提供的是经过基本审核的社区技能包你安装的是一个完整的功能模块通常包含预设的提示词、工具调用逻辑和示例配置而自定义Skill则是你自己在~/.openclaw/skills/目录下创建的一套指令模板更像是在给Agent写“岗位说明书”。两者不冲突先用ClawHub上的现成技能把流程跑熟再针对自己的实际工作流写自定义Skill是最高效的路线。这里给一个判断标准凡是“通用型、别人也会需要”的能力优先去ClawHub搜凡是“你自己的工作流特有、涉及特定表格、特定脚本”的能力适合写成自定义Skill。我在实际使用中遇到最多的是项目管理场景比如自动读取某个目录下的会议纪要并整理成周报这种ClawHub不一定有正好匹配的技能自定义反而更灵活。5.2 exec-approvals.json是什么为什么总报这个文件的错热词里有一条很典型的报错信息“legacy exec approvals exist at /root/.openclaw/exec-approvals.json”很多人在Linux服务器上部署时会看到这句话。这里需要解释一下OpenClaw的权限模型Agent在执行一条有潜在风险的Shell命令之前需要经过审批。审批结果存放在exec-approvals.json这个文件里里面记录的是你曾经批准或拒绝过的命令。新版OpenClaw出于兼容性考虑会提示旧的审批文件和新的审批机制并存有时会建议你迁移或确认处理方式。看到这条提示不要慌通常直接在交互界面确认迁移或者手动删除旧文件让它重建即可。但这个文件也提醒了我们一个安全原则OpenClaw是一个有命令执行能力的Agent你对它的授权越宽松风险就越高。尤其是部署在公网服务器上、目录权限没设好的人如果exec-approvals.json里默认批准了大量高危险命令那基本等于给攻击者留了后门。我的习惯是在配置里把执行审批设为“每次询问”重要目录的读写也需要明确授权。刚开始会嫌烦但这种摩擦是安全性的体现。等完全信任某个场景后再针对特定命令和目录做白名单。5.3 给Skill目录做“减法”安装前先看配置、安装后注意隔离Skill装得越多Agent的决策空间越复杂很多时候你以为它变笨了其实是太多技能互相干扰。我自己维护过一台机器装了二十多个Skill之后Agent面对简单任务时反而频繁调用无关的工具。后来我花了一晚上把所有暂时不用的Skill禁用掉只保留与当前项目相关的四五个效果立竿见影。所以建议在你规划Skill体系时遵循“一项目一栈”的原则每个项目单独用一个配置目录或工作区只挂载该项目需要的Skill。比起把所有东西都塞进全局的~/.openclaw/workspace里这个习惯能让Agent的表现稳定非常多。6. 实战排错我把新手安装高频问题按“从网络到权限”的排查链路重新捋了一遍这一章我打算换一个写法直接按真实排查链路来。很多人的安装失败其实是多层因素叠加的所以排查顺序非常重要。我按“从网络到权限、从安装到运行时”的顺序把高频问题重新整理了一遍你可以顺着链路一条条走。6.1 第一层网络下载问题与“安装日志中断”如何判断是脚本问题还是网络问题安装脚本中断十次里有八次是网络问题。一个很典型的信号是PowerShell或Shell窗口里长时间没有输出然后突然报错提示连接超时或者远程服务器返回错误。这种时候先去测目标站点的连通性确认能稳定访问GitHub和OpenClaw官方域名再重试安装。Linux下可以临时设置代理环境变量再跑安装脚本Windows下可以调整PowerShell的代理配置。另外一个判断技巧安装脚本的设计者一般都会在每一步打点日志中断前最后输出的那一步往往就是失败点。比如最后一步是注册PATH那说明前面所有文件下载都已经完成了你只需手动把可执行文件路径加入PATH就好。反之如果日志停在“下载主程序”那就不必纠结PATH的问题先解决网络。6.2 第二层PowerShell策略、PATH和“无法识别openclaw命令”“openclaw : 无法将“openclaw”项识别为 cmdlet、函数、脚本文件或可运行程序的名称”是Windows用户最常见的报错没有之一。这个问题95%出在PATH上但我见过不少人是因为PowerShell执行策略太严格导致安装脚本只下载了文件、没来得及写环境变量。所以排查顺序应该是第一步检查执行策略第二步检查安装目录里是否真的存在可执行文件第三步检查PATH里是否包含该目录第四步重启终端。只要按这个顺序走基本都能解决。另外提醒一下很多人在PATH变量里看到OpenClaw路径后觉得万事大吉但其实不同终端窗口的PATH快照是启动时读取的已经打开的窗口必须关了重开才能生效。6.3 第三层Ubuntu服务器上的目录权限问题“root”与普通用户配置不一致在Ubuntu服务器上部署时我最常见到的坑是用户身份混乱。比如安装时用root执行了脚本但日常用普通用户运行OpenClaw导致它找不到/root/.openclaw下的配置或者反过来普通用户安装的东西root访问不到。最稳妥的做法是全程固定用一个账号。我习惯用普通账号安装和运行只有安装系统依赖包时才用sudo。这样配置都在~/.openclaw下不会出现跨用户权限错乱。如果你已经用root装了一遍现在想切到普通用户直接把整个/root/.openclaw目录复制到普通用户的home目录下然后chown -R 用户名:用户组 ~/.openclaw大部分配置可以无缝迁移。6.4 第四层运行时异常查看日志定位问题的正确姿势OpenClaw运行时报错最忌直接猜。所有运行日志都在配置目录下Windows在C:\Users\用户名\.openclaw\logs\Linux在~/.openclaw/logs/。命令执行失败、模型接口连接不上、Skill加载失败都会记录在这里。看日志有一个技巧先搜ERROR级别别急着刷整个文件。大多数情况下一条ERROR信息含有的上下文就足够定位问题。比如日志里连续出现连接不到localhost:11434的记录那几乎可以断定是Ollama服务没启动或者端口被占用。如果日志里显示某个Skill目录解析失败那就去看看sklls目录里的子文件夹是否完整。把“看日志”养成习惯之后你会发现自己问陌生人的频率大幅降低。7. 卸载、重装与版本升级从“怎么关掉”到“怎么换新版本”的完整姿势很多人只关注安装忽略了卸载和升级结果新版发布后不敢动旧版越用越难受。实际上OpenClaw的卸载和升级都非常干脆但有几个注意点。7.1 完全卸载删除文件、清除环境变量、确认残留Windows下先终止所有OpenClaw相关进程Get-Process | Where-Object {$_.ProcessName -like *openclaw*} | Stop-Process然后卸载已安装的OpenClaw组件。如果安装脚本写过专门的卸载命令优先用它的卸载方式否则手动删除安装目录再删除PATH里的条目。最后考虑是否删除C:\Users\用户名\.openclaw这个配置目录。注意这一步是不可逆的所有Skill、配置、权限审批历史都会消失。如果你只是暂时不用建议把这个目录改成.openclaw_backup留档而不是直接删除。Linux下类似rm -f /usr/local/bin/openclaw 或 rm -rf ~/.local/bin/openclaw rm -rf ~/.openclaw7.2 升级前必做备份清单配置、Skills、exec-approvals.json每次升级前我至少备份三样东西配置文件、skills目录、exec审批文件。通常一条压缩命令就能搞定tar -czf openclaw-backup-$(date %Y%m%d).tar.gz ~/.openclawWindows下就复制整个.openclaw文件夹到备份位置。OpenClaw的升级一般是覆盖安装新版本配置目录通常保持兼容但版本跨度较大时旧配置文件可能有字段废弃。备份的意义就在于万一升级后启动失败你能快速回滚。7.3 正确理解“关闭openclaw”是停止进程、还是暂停Agent最后说一下“关闭openclaw”这个概念。有人以为退出终端窗口就等于关闭了Agent其实很多OpenClaw服务模式下核心进程可能还在后台跑着。正确做法是在OpenClaw交互界面里用退出命令或快捷键或者直接终止对应进程。Linux下可以ps aux | grep -i openclaw查看所有相关进程然后针对PID逐个停止。如果打算长期停止建议同时移除或禁用开机自启项否则有时候你以为关了重启后它又自己跑起来了。我在实际使用中的体会是OpenClaw这类Agent框架的部署难度不在安装本身而在于你是否理解它的运行机制和权限模型。把exec-approvals.json这个文件研究透了把Skill加载机制弄明白了把最小闭环验证扎实了后面所有花活都只是配置项的排列组合。哪怕你完全照着这篇教程走我也建议你花十分钟去看一下自己版本的官方文档因为这类项目更新太快了命令行参数和配置字段都可能在短时间内变化。保持“敢于折腾、善于留日志”的心态比记住任何一条具体命令都重要。