最近OpenClaw社区也叫它Clawdbot因为图标长得像只龙虾AI龙虾这外号就是这么来的在AI Agent圈子里热度确实高。光看热搜词就能感受到从“OpenClaw部署”到“openclaw obsidian”再到“windows companion怎么配置”提问的人一波接一波。我花了两个晚上把Windows、Ubuntu两条安装路径都跑了一遍踩了不少坑这篇就把整条流程掰开揉碎讲清楚争取让你看完之后最快能在十分钟内跑起来而不是标题党说的“1分钟”。先说说这篇文章适合谁刚接触AI Agent、想在本地跑一个能接模型、能调工具、能读本地笔记和个人文档的数字助手的新手以及那些被安装脚本报错劝退、搜了一堆帖子还是不知道怎么下手的半新手。我会把安装流程拆成原理、准备、实操、排错四块每一块都告诉你为什么这么做、卡住了怎么定位、哪些坑值得提前避开。1. 安装前先搞清楚OpenClaw到底装的是什么1.1 新手最容易懵的Clawdbot、OpenClaw、模型这三者的区别很多新手一上来就搜“OpenClaw怎么安装”但连自己要装的东西是什么都说不清楚。简单拆一下整个系统其实是三层结构模型层负责理解你的话、生成回答。本地跑的一般是Ollama拉下来的Qwen、Llama这类开源模型你也可以接云端API。Agent框架层OpenClaw本身。模型只负责“说话”框架负责“干活”——把模型的回答拆成具体动作比如读取某个文件、调用某个接口、写一条笔记。交互层Clawdbot。这是你直接面对的前端可以是终端界面、网页聊天窗口你觉得它像“AI龙虾”本质上是这一层的样子长得比较可爱。打个比方OpenClaw是中控台Clawdbot是前台接待模型是后台专家。前台把你的问题递给中控台中控台决定找哪位专家专家给答案中控台再调用工具把事办了。三者的分工很明确安装的时候也是分块装的。理解了这层关系你就明白为什么安装流程里既要装Node.js又要装Ollama还要单独启动Clawdbot了——它们压根是不同环节的东西。1.2 为什么“1分钟安装”能实现但现实里经常不止1分钟OpenClaw官方主推的安装方式是一条脚本走天下克隆代码仓库、装npm依赖、生成默认配置、拉起Clawdbot全给你自动化了。理论上只要你环境干净1分钟不是什么夸张说法。但现实是绝大多数人的电脑环境不像官方文档那么干净。我实测下来最常见的三个“隐藏时间黑洞”WSL2没装或者没初始化脚本直接卡在环境检测环节报一堆看不懂的英文。Node.js版本不对启动Clawdbot的时候报“fetch is not defined”又得回头升级。模型权重没下载Clawdbot起来了但一问话就转圈因为底下的Qwen模型还没拉回来。这篇文章的核心目标就是帮你把这几个隐藏时间黑洞提前填平。等你把这些前置条件都准备好再跑官方脚本是真的能体验到那种“一行命令装完”的顺滑感。2. 环境准备先把地基打稳再谈1分钟2.1 Windows用户第一关WSL2环境的检查与修复OpenClaw的设计目标是在类Linux环境里跑所以Windows用户第一步是装WSL2。官方脚本检测不到可用的WSL2环境时会给出类似“无法安全验证环境”的提示。这里要解释清楚这不是安全告警不是说你的电脑有毒而是脚本发现自己找不到一个能执行Linux命令的环境担心装到一半出问题所以主动罢工。处理方法很简单用管理员身份打开PowerShell依次执行两条命令wsl --status wsl --update第一条看看当前WSL状态第二条把内核更新到最新。如果提示你还没有安装任何Linux分发版就再补一条wsl --install -d Ubuntu-22.04装完之后重启终端输入wsl进入Linux子系统确认能正常执行ls命令WSL2这一关就算过了。注意不要在还没有装WSL2的情况下直接在Windows的CMD里跑OpenClaw安装脚本。脚本用的是bash语法CMD跑不了报错报得毫无头绪浪费时间。2.2 Node.js、Git、Ollama依赖清单一次列全OpenClaw的安装脚本虽然会帮你在项目目录里装npm依赖但前提是你系统里先有Node.js和Git。这里给出我实测比较稳的版本要求和检查命令。组件版本要求作用检查命令Node.js20 LTS或更高运行Clawdbot主程序node -vGit2.30以上拉取OpenClaw仓库代码git --versionOllama最新版本地跑Qwen等开源模型ollama --versionWSL2Windows内核最新提供Linux运行环境wsl --status为什么Node.js一定要20以上因为OpenClaw的代码里用到了较新的JavaScript语法和标准库能力Node 18在很多系统上会出现Global fetch不可用的情况Clawdbot启动时直接报错。我一开始没注意版本卡了二十分钟升到Node 20之后就一路畅通了。Ollama这块多说一句它其实是独立的模型运行时拉模型、常驻本地服务都是它在管。你不需要懂它的内部实现只需要知道OpenClaw是通过http://localhost:11434这个地址跟Ollama通信的即可后面配置模型的时候要用到。2.3 网络与下载加速尽量减少等待时间OpenClaw安装过程中最耗时的往往是两件事npm依赖下载和大模型文件下载。如果你所在网络环境访问外网比较慢我建议提前做两个动作第一把npm registry切换成国内镜像源这样装依赖的速度会提升好几个量级npm config set registry https://registry.npmmirror.com第二Ollama拉模型的时候如果速度很慢可以先拉小参数模型试水。比如qwen2.5:3b这个尺寸压缩完大概2GB上下比动辄几十GB的大模型友好太多。想体验完整功能qwen2.5:7b是性能和资源比较平衡的选择。3. 核心安装流程实录主流程加配置一步步来3.1 克隆仓库与运行安装脚本最关键的一分钟环境准备好之后进入WSL2或Ubuntu终端把OpenClaw仓库拉到本地git clone https://github.com/openclaw/openclaw.git cd openclaw这里解释下OpenClaw仓库的最近更新很频繁主分支就是稳定版策略直接克隆主分支即可不用特意切分支。克隆完成后运行安装脚本./install.sh脚本会自动做这几件事检测系统环境、安装npm依赖、生成默认配置文件、检查模型运行时的连通性。如果一切顺利你会看到类似OpenClaw installed successfully的输出到这一步主流程就结束了时间确实只要一两分钟。如果你的环境跟我一样是Windows请注意脚本要在WSL2的终端里跑不是在PowerShell里直接跑。跨平台混用是新手最容易犯的错PowerShell执行bash脚本会直接提示“无法识别”。3.2 模型关联让Clawdbot背后真正有“脑子”主程序装好只是第一步你得让Clawdbot连上一个模型它才会说话。先启动Ollama服务然后把模型拉下来ollama pull qwen2.5:3b拉完之后编辑OpenClaw的配置文件路径一般在~/.openclaw/config.ini核心配置长这样[model] provider ollama name qwen2.5:3b base_url http://localhost:11434然后启动Clawdbot./clawdbot第一次启动会初始化一些运行数据稍等几秒出现对话提示符就说明已经通了。你随便问一句“你好介绍一下你自己”如果它正常回答链路就打通了。提示配置完模型之后最好先重启一次Clawdbot让配置加载干净再正式使用。我实测过热加载在某些版本里不稳定可能出现“模型切换了但对话还是旧模型”的情况重启解决一切。3.3 Windows Companion与Obsidian把Windows桌面和AI助手连起来如果你是Windows用户会发现WSL2里的OpenClaw默认只能操作Linux子系统内的文件访问Windows桌面的文件比较麻烦。这时候需要用到Windows Companion组件。Companion的定位是Windows端的桥接服务它跑在Windows侧通过本地REST接口跟WSL2里的OpenClaw通信。配置步骤不复杂在Windows侧下载并安装Companion。启动后确认它监听的端口一般是http://localhost:8765。在OpenClaw的配置文件里加一段[companion] enabled true endpoint http://localhost:8765重启Clawdbot你就能在对话里直接让它读写Windows磁盘上的文件了。Obsidian的联动是目前社区问得最多的玩法之一。很多人用Obsidian记笔记但笔记一多就搜不过来想让AI直接基于笔记内容回答。做法是在Obsidian社区插件市场安装Local REST API插件。插件设置里开启服务生成一个API Key。在OpenClaw配置里填入Obsidian的笔记库路径和API Key。完成之后你可以直接问Clawdbot“上周写的关于项目架构的笔记里核心结论是什么”它会自动检索笔记库、定位相关文件、整理回答。这个场景对知识管理特别实用等于给自己的笔记库加了一层自然语言搜索引擎。3.4 Ubuntu环境的安装差异比Windows少两步Ubuntu上装OpenClaw比Windows简单很多因为没有WSL2这一层。只要确认系统是20.04或22.04装好Node.js 20、Git、Ollama然后直接克隆仓库运行./install.sh即可。有一点需要提醒Ubuntu上如果直接用apt安装Node.js装到的可能还是老版本建议通过NodeSource或nvm方式安装20版本。我后来统一用nvm管理Node版本切换起来非常方便后面升级OpenClaw的时候也不用担心环境冲突。4. 常见问题排查与避坑手册4.1 安装脚本报“无法安全验证环境”的完整处理链这个问题我在前文提过但因为问的人实在太多这里单独展开。报错全称接近“unable to safely verify the environment”典型的出现场景是Windows用户在一个没有安装WSL2的PowerShell窗口里强行运行安装脚本或者在CMD里运行。处理步骤按顺序来管理员PowerShell执行wsl --status看看有没有WSL。提示没装的执行wsl --install -d Ubuntu-22.04。重启电脑再次进入终端输入wsl确认能进Ubuntu。在Ubuntu终端里重新克隆OpenClaw仓库再跑./install.sh。如果wsl --install执行后卡在下载或提示“无法完成安装”通常是内核组件或虚拟化功能没开到“控制面板—启用或关闭Windows功能”里勾选“适用于Linux的Windows子系统”和“虚拟机平台”再重试。4.2 启动Clawdbot报错常见原因速查表我在实际安装过程中整理了这张问题速查表覆盖了新手安装遇到的大多数问题先看表再动手查效率高很多。问题现象大概率原因解决方案启动报fetch is not definedNode.js版本过低升级到Node 20以上Clawdbot启动后对话一直转圈Ollama服务没启动或模型没拉完ollama list确认模型存在curl http://localhost:11434/api/tags确认服务活着安装脚本在npm install阶段退出网络问题或镜像源太慢配置npmmirror镜像重新跑Companion连不上防火墙拦截或端口被占用放行Windows防火墙用netstat看端口是否被其他进程占用Obsidian检索不到笔记插件没开启或API Key填错确认Local REST API插件已启用检查密钥和笔记库路径模型回答速度很慢模型参数过大机器跑不动降到qwen2.5:3b关闭其他大内存程序4.3 我踩过的一个坑模型和Clawdbot在同一台机器上抢资源最后分享一个很多人容易忽略的问题如果你用Ollama本地跑模型同时开着Clawdbot再同时开着Obsidian同步内存占用会非常吓人。3B参数模型虽然不大但推理时要吃好几个GB内存Clawdbot基于Node.js也不省心两个加起来可能把8GB内存的机器拖到卡顿。我的建议是入门阶段先用3B模型跑通全流程确认功能都正常再考虑换大模型。另外不要在Clawdbot对话窗口还挂着进程的时候就急着拉取7B以上模型我试过一次机器直接卡到鼠标都不动。5. 装完之后怎么玩让它真正变成生产力工具安装只是起点装完之后的配置和玩法才是OpenClaw真正值钱的地方。我个人用了一周之后觉得下面这几个方向最值得折腾。第一是把OpenClaw接成“多AI协作”模式。OpenClaw支持配置多个模型并分流简单的任务比如“帮我整理这段文本的标题”丢给快速的小模型复杂的任务比如“根据笔记库写一篇项目复盘”交给更强的模型。这种配置下响应速度和回答质量能做到比较好的平衡。第二是利用工具调用能力把Clawdbot变成自动化助手。比如设定定时任务让AI定期扫描某个文件夹整理新加入的文档生成摘要并写入Obsidian。OpenClaw的插件机制允许你自定义这类流程本质上你把一个能推理的大模型、一个能执行命令的框架和一个本地知识库缝在了一起。第三是如果你有开发能力可以研究一下Clawdbot对外暴露的接口。它的设计里服务层和交互层是解耦的你完全可以把Clawdbot当成一个本地API服务自己的程序通过HTTP请求调用它。等于给现有应用加了一个自然语言入口。最后再说一个实际体会装完OpenClaw之后别急着给它布置复杂任务先花十分钟把“读笔记、查文件、调用Ollama模型”这条最小链路反复跑熟。等你熟悉了它的工作方式和日志输出后面任何报错都能很快定位。我试过直接把Obsidian里两千多条笔记全交给它做索引结果卡了半天后来改成按文件夹分批次处理效果立刻不一样——AI工具都这样功能强大不代表能一次性吞下所有任务合理的任务切分是使用这类工具的基本功。