OpenClaw这个名字,最近一个月在AI自动化圈子里出现的频率高得吓人。它是Cognition在Clawdbot基础上延续下来的一个开源AI Agent执行框架,核心做一件事:让大模型像人一样操作电脑,开浏览器查资料、整理文件、填表单、批量处理数据,把“请你帮我做”从一句提示词变成一系列真实执行的鼠标键盘动作。很多人把它和Manus、ChatGPT Operator、Anthropic Computer Use放在一起比较,但我的结论很直接:在本地部署、多端控制、MCP生态这三件事上,OpenClaw目前的完成度是最高的。这篇文章就围绕四个维度——定位、架构、扩展性、部署成本——把它和同类框架摆在同一张桌上拆开看,顺便把Windows和Ubuntu上跑通的步骤也写出来,想折腾的朋友直接照抄。
1. 先看清楚坐标系:OpenClaw和同类框架各自站哪一排
1.1 它到底是什么
OpenClaw是一个开源、可本地部署的AI Agent执行框架,采用控制平面(Control Plane)+被控端(Companion)两层架构。控制平面负责跟大模型通信、做任务规划、管理执行状态;Companion则安装在你希望被控制的电脑上,提供截图、键盘输入、鼠标操作、文件读写、剪贴板等底层能力。理解了这个架构,你就能明白它和那些“云端跑一个机器人帮你干活”的产品有本质区别——OpenClaw的“手”长在你自己的电脑上,而不是别人的服务器里。
它最初的形态是一个叫Clawdbot的内部项目,开源后改名OpenClaw,社区迭代很快。当前版本支持Windows、macOS、Linux,提供Web控制台、CLI命令行和HTTP API三种接入方式,并且原生支持MCP(Model Context Protocol)协议。这意味着你不仅能让它操作桌面,还能通过MCP把各种外部工具接进来。Obsidian笔记库、数据库客户端、浏览器插件,本质上都是一条配置的事。
1.2 同类框架的四个派系
把这段时间市面上常见的AI Agent工具归类,大致是四个派系。
第一个是云端Agent平台,典型代表是Manus。任务在云端沙箱里执行,用户看到的是最终结果,过程基本黑盒。第二个是模型API层的Computer Use能力,典型代表是Anthropic Computer Use和后来的OpenAI Operator API。模型给出一系列“截屏、点击、输入”的指令,但执行管线要自己搭,没有现成的“手脚”。第三个是浏览器脚本框架,典型代表是Browser Use和Skyvern。它们聚焦网页自动化,能高效做数据采集、表单填写,但手脚被限制在浏览器标签页里。第四个是本地执行框架,典型代表就是OpenClaw和OpenInterpreter。它们控制的是整台电脑,可以跨应用完成任务,属于桌面级Agent。
这四个派系没有谁完全替代谁的关系,更多是适用场景不同。但如果你想要一个能稳定控制桌面应用、数据又留在本地的通用执行框架,OpenClaw在这个位置几乎没有直接对手。
1.3 一张表看懂四类框架差别
| 维度 | OpenClaw | 云端Agent(Manus类) | API型Computer Use | 浏览器脚本框架(Browser Use类) |
|---|---|---|---|---|
| 部署方式 | 本地/WSL/Docker | 云端沙箱 | 自建脚本调用API | 本地脚本进程 |
| 控制范围 | 整台电脑,多端可管 | 云端浏览器/云主机 | 只有模型指令,无执行器 | 浏览器标签页内 |
| 数据流向 | 数据不出本机 | 经过第三方服务器 | 依赖API调用链路 | 本地+模型API |
| 模型选择 | 可换任意OpenAI/Anthropic/OpenRouter/本地Ollama | 固定云端模型 | 绑定单一供应商 | 模型可换但范围受限 |
| 开源与扩展 | 开源,MCP生态 | 不开源,插件受平台限制 | 需自行组装工具链 | 开源,但无设备管理架构 |
这个对照表对选型很有用,后面所有结论都围绕这四列的差异展开。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 为什么我先把云端Agent排除掉:数据流向是硬伤
2.1 云端“黑盒”的代价
Manus刚火的时候我也用过几天,确实惊艳。你说一句话,它在云端自己查资料、写代码、操作网页,最后给你一份报告。但冷静下来有个绕不开的问题:整个执行过程发生在服务商的云端环境里,你的任务描述、中间产物、访问过的页面、下载过的文件,全部经过别人的服务器。
如果有业务数据、客户信息、财务表格,我会非常犹豫。云端Agent适合尝鲜和个人轻度使用,做正经工作的自动化其实是拿数据安全冒险。这是OpenClaw这类本地框架最核心的竞争力:除了模型API调用之外,所有操作都在你眼皮底下执行,日志、截图、重放记录都留在本机。单凭这一点,在企业内部场景里就足以让云端Agent出局。
2.2 可观测性:出了问题你看得见
实际使用中,可观测性比很多人想象的重要得多。云端Agent报错你只能看到一段抽象信息,不知道是模型理解错了,还是操作步骤错了。OpenClaw每一步都有轨迹记录,你可以暂停、接管鼠标自己操作、然后再让Agent继续。这种“人机协作的接管能力”在复杂的真实任务里几乎是刚需。
我举个例子。让Agent把几十个PDF按标题重命名并归档到对应目录。云端Agent很可能中途乱掉,你只能在最后发现“怎么全跑到一个文件夹了”。而OpenClaw这边,我能实时看到它在遍历哪个目录、改了哪个文件,一旦发现命名规则不对,立刻打断纠正,重来成本很低。这种控制感和安全感,用过一次就回不去。
2.3 控制范围:局域网内任意机器
云端Agent只能操作它自己的云环境,OpenClaw因为Companion可以部署在任意机器上,控制范围天然扩展到局域网和办公网络。只要目标机器能连接控制平面的地址,配好Key,你就能在一台中控机上调度多台电脑完成各自任务。
这对工作室、实验室、办公室场景特别有用。比如一台机器专门跑数据抓取,一台机器整理工程文件,控制平面统一派发任务,互不干扰。这种集中管理多台设备的能力,在同类开源框架里是少有的。
3. 跟Anthropic Computer Use比:OpenClaw赢在“框架完整度”
3.1 Computer Use只是“大脑”,不是“手脚”
Anthropic Computer Use推出的时候也很轰动,因为Claude可以直接“看屏幕、点按钮”了。但用起来你会发现,它本质上是大模型的一种能力输出:模型根据截图返回一串操作指令,页面滚动、坐标点击、字符输入,需要你用脚本解释并逐条执行。模型没有内置“怎么递归重试、怎么做多步规划、怎么管理多端会话”的执行框架,这些都是工程活。
OpenClaw把这些工程活一次性做好了。它内置了任务规划器,把一个大目标拆成子步骤,每步调用模型决策、执行动作、观察结果,失败自动重试,超过阈值再尝试换方案。这种“执行闭环”是Computer Use模型本身不会为你做的。加上它支持多种模型provider,你甚至可以把同一个任务分别用Anthropic和OpenRouter跑一遍做效果对比,这在模型选型阶段非常有用。
3.2 多被控端管理是实用价值
OpenClaw的控制平面天然支持多个Companion同时在线。你在Web控制台里可以看到每台被控机器的状态,向不同机器派发不同任务。这种C/S架构带来的集中管理能力,在开源Agent里很少见。同类项目要么只支持本机,要么还需要自己搭消息队列。
实际操作中这个能力很值钱。我手上有一台Windows工作机和一台Ubuntu服务器,OpenClaw控制平面装在Mac上,两边各跑一个Companion,同一套任务模板分发下去,一台整理本地工程文件,一台跑定时数据抓取。这个调度体验,市面上几乎没有平替。尤其在一个团队共用一套控制平面的情况下,每个人都能看到任务执行情况,协作起来非常直观。
3.3 MCP生态:给Agent接上“USB”
MCP是Anthropic推的模型上下文协议,本质上是一个标准化的工具接口。OpenClaw直接把它作为一等公民支持,意味着社区里几千个现成的MCP服务器都能拿来用,不用自己写适配层。
举一个最常见的组合:Obsidian。先在Obsidian里装好Local REST API插件,再通过MCP服务器把笔记库暴露给OpenClaw,Agent就能完成“检索旧笔记、整理思路、写入新笔记”这种闭环。我实际用它做了一个每日工作日志自动归档:下班前一句话“把今天处理的问题按日期归档到Obsidian”,它会自己打开笔记库、检索今天相关的文件、生成结构化记录。整个过程没有写一行插件代码,靠MCP就把两个生态打通了。这种扩展性是同类框架里最舒服的,没有之一。
4. 和浏览器脚本框架比:OpenClaw补的是“最后一公里”
4.1 Browser Use这派擅长什么
Browser Use、Skyvern这类开源项目在网页自动化场景里表现非常好,定位很清晰:数据采集、批量登录、表单填写、对单页应用做流程测试。它们基于浏览器自动化协议,速度比“屏幕截图+坐标点击”的Computer Use方案快很多,而且对DOM结构的理解更稳定。
如果你只需要一个高效的网页爬虫或自动填表器,直接用Browser Use就够了,没必要上OpenClaw。选型不是越重越好,工具匹配场景才是核心。这点一定要想清楚,别为了“什么都干”的框架背上不必要的复杂度。
4.2 跨应用流程只有桌面级框架能扛
但真实办公任务往往是“网页+桌面软件+文件系统”的组合。比如:从数据后台导出Excel,再打开企业办公软件上传,再给相关人员发邮件。Browser Use只能在浏览器里做前半段,后面几步无能为力。OpenClaw这类桌面级Agent可以连续跨越多个应用,因为Companion层能控制全局鼠标键盘和文件操作,并且每一步都观察屏幕反馈来调整。
我实测过一个混合任务:打开浏览器下载一份月度报表,用本地的表格软件做汇总计算,最后把汇总结果写进Obsidian并发送通知。OpenClaw完整跑下来了,Browser Use做不到这种场景。这也是我判断“二选一”时最关键的考量——你是要网页流程自动化,还是要整机操作自动化。两者的边界,比很多人想的要明显得多。
4.3 开源协议与社区迭代
OpenClaw在GitHub上的仓库社区活跃度很高,提交节奏非常快,近期几乎每周都有更新。开源许可也比较宽松,可以拿来做内部工具二次开发。而Browser Use这类项目同样开源,但定位不同,它们没有“控制平面+Companion”这套设备管理架构。
如果你未来想把控制范围扩展到手机、平板、多台办公电脑,OpenClaw的架构扩展性明显更从容。这一点在选型时容易被忽略,但等需求真的来了,你会发现从浏览器脚本切换成桌面级框架的成本,比一开始就选对高得多。
5. 实操:Windows+WSL2跑通OpenClaw,接Ollama本地模型和Obsidian
5.1 环境准备
Windows上跑OpenClaw,最省心的方式是控制平面装在WSL2的Ubuntu里,Windows本机跑Companion去控制桌面。原因很简单:控制平面依赖的Node生态和一些脚本工具在Linux里更顺,Windows原生跑会遇到各类权限和路径兼容问题。
第一步装Node.js LTS,直接去Node官网下载安装包,装完在PowerShell里验证:
powershell复制node -v
npm -v
第二步确认WSL2。很多人遇到的“sl2环境”问题,多半是把WSL2这个缩写抄错了。在PowerShell里运行:
powershell复制wsl --status
正常会显示默认版本是2。如果提示没有安装发行版,运行wsl --install,装完重启电脑,然后装Ubuntu。如果默认版本是1,用以下命令升级:
powershell复制wsl --set-version <发行版名> 2
第三步装Ollama并拉取Qwen2.5-3B:
bash复制curl -fsSL https://ollama.com/install.sh | sh
ollama pull qwen2.5:3b
选择Qwen2.5-3B的原因是它足够轻,CPU推理也能跑,对没有独显的机器很友好。处理文件整理、笔记归档这类简单任务,效果完全够用,也是目前OpenClaw本地模型方案里验证最多的一条路径。
5.2 安装OpenClaw控制平面
进入WSL的Ubuntu终端:
bash复制cd ~
git clone https://github.com/cognition-ai/openclaw.git
cd openclaw
npm install
npm run build
如果你不打算二次开发,也可以直接用官方的一键安装脚本。但我更推荐源码方式,因为出问题可以直接看日志和断点。安装完成后,初始化配置:
bash复制npx openclaw init
按提示填写模型provider和API Key。这里注意:刚装好的OpenClaw默认配置指向Anthropic,如果你要用Ollama本地模型,需要手动修改配置文件。Ubuntu上整个过程只要网络稳定,十分钟就能跑通,比Windows原生环境少踩很多坑。
5.3 配置本地模型与API
OpenClaw的配置文件通常是openclaw.config.jsonc,也就是允许注释的JSON。把模型指向本地Ollama:
jsonc复制{
"model": {
"provider": "ollama",
"name": "qwen2.5:3b",
"baseUrl": "http://localhost:11434"
}
}
注意,在WSL里访问Windows宿主机的Ollama时,localhost不一定通,要确认Ollama是装在WSL内还是Windows里。如果Ollama在Windows,WSL里得用宿主机IP。我踩过这个坑,最后干脆把Ollama装在WSL里,彻底避免跨系统网络问题。如果你要用商业模型,也可以配置OpenRouter或Anthropic API,填上provider和apiKey即可。
OpenClaw支持多provider,你可以把任务规划用强模型、简单动作用本地模型,这种混合配置在实际任务里性价比很高。能力强的模型负责“想”,本地轻模型负责“干”,成本直接降一个量级。
5.4 配置Obsidian MCP
先确保Obsidian里安装了Local REST API社区插件并在设置里开启。然后在OpenClaw配置文件的mcpServers里加一条:
jsonc复制{
"mcpServers": {
"obsidian": {
"command": "npx",
"args": ["-y", "obsidian-mcp-server"],
"env": {
"OBSIDIAN_API_KEY": "你的API密钥",
"OBSIDIAN_HOST": "127.0.0.1",
"OBSIDIAN_PORT": "27124"
}
}
}
}
配置好后重启OpenClaw,执行npx openclaw mcp list应该能看到obsidian在线。Obsidian这边弹出的“是否允许本地REST API”请求要点允许。这一步是OpenClaw和知识库打通的关键,很多人卡在MCP离线,九成是插件没开或者端口填错。
5.5 Windows Companion怎么配
Windows上控制桌面要装Companion。打开PowerShell,在OpenClaw项目目录执行:
powershell复制npx openclaw companion install
安装完成后启动Companion,它会提示输入控制平面的地址和认证Key,把WSL里控制平面的地址和你初始化时生成的Key填进去。这里有个关键点:Windows Companion的控制端地址不要填localhost,要填WSL的IP,否则连不上。最简单的做法是在控制平面里查看网络信息,拿到WSL的IPv4地址,再填到Companion里。
配对成功后,Control Plane的Web控制台里会看到这台Windows机器在线,可以给它派发任务。macOS端类似,但首次控制需要到“系统设置、隐私与安全性、辅助功能”里勾选终端授权。这一步漏了,表现就是“看得见屏幕但点不动”,排查起来很隐蔽。
5.6 跑一个完整任务验收
配置完成后,我建议先跑一个低风险验收任务,别一上来就动重要文件。我当时的验收任务是:让OpenClaw浏览本地~/Downloads目录中的PDF文件,按文件名里的日期信息排序,生成一份清单并写入Obsidian笔记。
在Web控制台输入任务,能观察到它先调用Qwen模型做规划,拆出“读取目录、过滤PDF、提取日期、生成markdown、调用obsidian MCP写入”几个步骤,然后逐步执行。第一次跑可能在中文文件名解码上出问题,那是WSL和Windows文件系统编码差异导致的,把文件名改成英文或调整locale即可。跑通之后,你基本就掌握OpenClaw的日常使用节奏了。
6. 高频问题快查:安装和运行OpenClaw遇到的坑
6.1 “无法安全验证”和WSL命令写错
下载安装包时看到的“无法安全验证”,基本是Windows SmartScreen对未签名程序的常规拦截,不是病毒。浏览器里选“保留”或“仍然下载”,公司电脑如果强策略锁死,就用winget装Node或者直接走命令行方案,绕开图形下载窗口。
wsl -- status这个写法几乎每天都在各种报错现场出现,正确命令是wsl --status,中间有空格。如果提示“适用于Linux的Windows子系统未安装”,就先wsl --install,重启后再检查。我见过最离谱的报错是冒号输成了中文全角,命令直接报“不是内部或外部命令”。这类问题排查时先照抄官方命令,别自己改格式,能省很多时间。
6.2 Node.js版本不对
OpenClaw要求Node 18以上。装完记得关掉PowerShell重开再验证版本,环境变量没刷新会让你误判安装失败。如果电脑上已经装了旧版Node,推荐用nvm管理多版本,别硬升级到全局,会影响其他老项目。
npm install卡住也是高频问题,通常是网络原因,切到npm国内镜像后再执行。跑源码方式安装时,npm run build如果报某个依赖包拉不下来,先清缓存再重试,基本能解决。
6.3 Ollama和MCP的连通性
本地模型不响应时,先确认Ollama进程活着:ollama list能看到模型说明服务正常。再用curl http://localhost:11434/api/tags测API,返回JSON就说明接口可用。如果这个地址在WSL里不通,按我之前说的,检查Ollama装在哪个系统里,跨系统访问要用宿主IP。
MCP服务器列表里obsidian显示离线,基本是API Key没配对或者Obsidian插件没开启。按配置反复核对三项:插件开关、端口、密钥。别小看这三项,我见过有人把端口号27124打成27142,排查了一下午才找到问题。
6.4 关于“workbuddy是不是参考了OpenClaw”
这个问题最近看得多,网上议论的人也很多。从时间线上看,OpenClaw开源的时间确实早于很多“work buddy”类产品的发布,说这类本地Agent框架的流行很大程度上是OpenClaw推动的,并不夸张。但要说具体产品是不是“参考”了它,这个很难实锤,也不重要。
做选型时我更建议大家看架构不看噱头。一个框架值不值得用,取决于它给不给你数据自主权、能不能接你想接的模型和工具、出问题时你能不能接管,而不是它名字里带不带“buddy”。同类产品扎堆出现,说明这个方向被验证了,但真正能长期留住的,还是底层架构足够扎实的那一个。
6.5 安全使用的基本原则
OpenClaw这类能操作电脑的框架,权限很大,使用时我给自己定了三条底线。
- 重要目录先做备份,别让Agent直接操作生产库。
- API Key别写死在代码仓库里,用环境变量或密钥管理工具。
- 首次使用新插件或新MCP服务器时,先在虚拟机或测试目录里跑一遍,确认行为符合预期再上真实环境。
这几条不是OpenClaw特有的,而是所有自动化工具的共同原则。权限越大,越要控制好边界。尤其当你把Companion装到办公电脑上时,一定要先想清楚它能访问哪些目录、能执行哪些命令,别让它裸奔。
最后说点个人体会。我折腾OpenClaw前后大概两周,最大的感受是:它不是一个“开箱即用就能替代你上班”的玩具,而是一个把“让AI操作电脑”这件事真正做到可控、可看、可扩展的工程框架。如果你手里的任务恰好是跨应用、涉及敏感数据、又需要随时人工接管,它几乎是目前唯一能打齐这三点的开源方案。我的建议是先别追新模型,用Ollama上的Qwen2.5-3B跑通简单流程,把Obsidian和MCP接好,再慢慢加复杂任务。这套组合我跑了两周,一天下来很稳。OpenClaw的社区更新很快,过两个月再回来看,应该又会多出不少值得玩的东西。趁框架还热、坑还少,早点上手,总不吃亏。
