如果你最近在折腾机器人、智能体或自动化控制大概率已经听过OpenClaw这个名字。简单说OpenClaw是一个把大模型能力接到真实设备和仿真环境里的开源智能体控制框架它支持Windows、安卓、ROS2、Gazebo也能通过Ollama跑本地模型。这篇文章就是我折腾OpenClaw安装的完整总结覆盖Windows端Companion配置、安卓手机Termux部署、ROS2 Humble联动Gazebo仿真、Ollama接入本地算力以及我实际踩过的坑。无论你是想给机器人装“大脑”还是想在手机或电脑上跑一个能调用工具、执行技能的智能体这篇安装总结都可以直接当参考手册用。1. 安装前必读OpenClaw的项目定位与整体思路1.1 它到底解决什么问题先说结论OpenClaw不是传统意义上的“软件”它更像是一个智能体运行骨架。官方把它拆成了几块核心运行时负责调度和状态管理技能skill模块负责具体动作平台适配层负责对接不同设备Windows、安卓、ROS2而算力层可以选云端API或本地Ollama。我在实际安装后发现这套设计的最大好处是把“大脑”模型推理和“手脚”设备控制解耦了所以你既可以在电脑上让它操作文件、调用命令也能在手机上通过Termux跑一个轻量实例还能把它接到Gazebo仿真环境里去控制虚拟机器人。很多人看到“OpenClaw”这个名字时会以为它和某个商业产品有关其实它的核心定位恰好是反过来的面向开发者、极客和机器人爱好者强调可定制、可本地化、可离线运行。我安装它的直接动机是想在ROS2环境里做一个能用自然语言控制机器人移动和抓取的实验实测下来OpenClaw的skill机制非常适合这类场景。1.2 “多端部署”到底是什么意思热门搜索词里有“openclaw安卓部署”、“Windows companion 怎么配置”这正是OpenClaw与普通AI项目最不同的地方。它采用主从式架构主控端负责大脑模型调用、任务规划、技能管理执行端Companion负责手脚设备操作、ROS2通讯、传感器读取、运动控制。Windows上安装的Companion组件本质是让PC成为执行端安卓上通过Termux安装本质是把手机也变成一个可移动执行端而ROS2场景下rosclaw这个适配层负责把智能体指令翻译成ROS2的话题和服务调用。我建议你在动手之前先想清楚自己的目标场景如果是纯软件测试只需要装Windows端和Ollama如果是机器人控制就必须把rosclaw和Gazebo那一套一起装如果想在手机上有便携的测试环境就按Termux路线走。不同路线的依赖差异很大一次性全装反而容易出问题。1.3 算力问题API和本地模型到底怎么选热搜词里有一条“openclaw只能用接入api的方式使用算力吗”这个问题很有代表性。答案是并非如此。OpenClaw的算力层是可插拔设计它给了两种接入路径一种是通过通用模型API比如OpenAI兼容接口、各云厂商接口获得最强推理能力另一种是通过Ollama接入本地模型完全离线运行。我个人的建议是如果侧重机器人控制本地模型首选Ollama如果侧重复杂任务规划和多技能编排API的稳定性和指令遵循能力会明显更好。两种方式可以并存运行OpenClaw时按场景切换即可。2. Windows端安装Companion配置全流程2.1 装之前需要准备什么Windows端是OpenClaw最成熟的运行平台也是我第一个跑通的环境。前置依赖相对简单但建议按顺序装好避免装到一半报缺少组件。首先是Git用于拉取项目仓库然后是Python 3.10以上版本我实测3.11最稳3.12在某些依赖编译上会有小坑Node.js也是需要的Companion的Web配置面板依赖它运行。如果你后面要接ROS2还要预先装好ROS2 Humble或对应版本的桥梁组件。一个容易被忽略的点是Python环境隔离。我建议从一开始就使用虚拟环境而不是把依赖直接装进系统Python。因为OpenClaw的依赖里包含pydantic、numpy、gradio等库版本要求比较严格和系统里其他项目的依赖容易产生冲突。安装前可以先执行python --version确认版本再用venv创建独立环境。2.2 拉取仓库与安装依赖的实操步骤打开CMD或PowerShell进入你准备放项目的目录执行仓库克隆。这里我不写具体仓库地址因为OpenClaw的官方仓库经常更新地址以你获取到的官方仓库为准。克隆完成后进入项目目录创建并激活虚拟环境然后安装Python依赖。如果你的网络环境不理想可以考虑使用国内PyPI镜像速度会快很多。依赖安装完成后先不要急着启动先检查关键依赖是否就位。执行python -c import openclaw确认主包能正常导入再执行openclaw --version看版本号。如果这两步有问题大概率是依赖冲突或者Python版本不对回到上一步排查比盲目往下走更高效。2.3 Windows Companion配置的5个关键参数Companion是Windows端的执行组件负责把OpenClaw的口令变成Windows系统调用。配置它的核心是修改配置文件重点看以下几个参数监听地址默认127.0.0.1表示只允许本机连接如果你要让局域网内的其他设备比如手机连过来需要改成0.0.0.0并注意防火墙放行。通信端口默认端口只要不冲突就不用改但如果你本机有服务占用了可以在配置文件里改掉并同步修改主控端的连接配置。工作目录执行命令和读写文件的根目录建议限定在一个专用文件夹避免智能体误操作其他目录。权限开关是否允许Companion执行管理员级命令为了安全我建议默认关闭需要用的时候再按需打开。日志级别设置为INFO可以看到完整执行记录排查问题时非常有用平时跑稳定了再调回WARNING减少日志量。配置完成后启动Companion服务用浏览器打开本地配置面板能看到运行状态就说明Windows端组件已经通了。3. 安卓部署Termux环境下的手机版安装3.1 为什么要用Termux装OpenClaw手机版OpenClaw的最佳安装方式就是Termux这是一个在安卓上提供Linux终端环境的模拟器。之所以推荐Termux而不是其他容器方案是因为它在不root手机的情况下就能提供接近完整的Linux环境适合直接运行Python项目和智能体运行时。我在一台骁龙处理器的安卓手机上实测过OpenClaw基础运行时能比较流畅地跑起来接Ollama的轻量模型推理会慢一些但做测试和远程控制完全够用。需要注意的是Termux环境下OpenClaw不是运行在手机桌面上而是运行在终端里。也就是说它更适合作为“随身执行端”或“远端控制端”而不是像手机App那样有图形界面。如果你只是想在手机上和OpenClaw聊天那不需要走Termux路线但如果你想体验“手机智能体控制真实设备”Termux就是正确的选择。3.2 一步步从零装到能跑第一步当然是安装Termux。安装完成后在Termux里先做基础更新然后安装必要的系统包git、python、build-essential、openssh等。编译类依赖要提前装全否则后面安装Python包时会卡在编译报错。接着还是要解决Python版本问题。Termux官方源里的Python可能不是OpenClaw要求的版本我建议用pkg install python检查版本如果不满足要求可以用pyenv安装指定版本。这一步比较费时间但值得做因为很多安装失败都源于版本不匹配。然后就是克隆项目仓库、创建虚拟环境、安装依赖流程和Windows端类似。不过Termux环境下部分Python包需要通过Termux源安装系统依赖才能编译成功我遇到比较多的是编译工具链和若干头文件缺失的问题。最后启动OpenClaw服务确认终端能正常响应指令。如果要用手机连接Windows端的Companion执行操作还要在主控端配置里填写电脑的局域网IP和端口。这里有个细节手机和电脑必须在同一局域网防火墙要放行对应端口否则连接会一直超时。3.3 手机版这么配操作效率反而更高在手机上跑OpenClaw最大的优势是便携但终端输入不方便。我的做法是配合Termux的SSH服务用电脑连上手机终端后操作。这样既保留了手机端的独立性又解决了输入效率问题。启动SSH服务后在电脑上用任意SSH客户端连到手机的局域网地址就行之后的安装和配置都能在电脑上完成体验和本地操作几乎一样。还有一个细节我个人比较推荐给Termux配置一个“开机自启”脚本让手机开机后自动启动OpenClaw服务。这样手机就变成了一个常驻的智能体节点你随时可以通过网络连接调用它而不是每次掏出手机打开Termux手动启动。4. ROS联动rosclaw、ROS2 Humble与Gazebo仿真4.1 rosclaw在整套系统里的角色如果你接触过机器人开发会发现OpenClaw生态里有一个高频关键词rosclaw。它实际上是OpenClaw针对ROS2的适配组件负责把OpenClaw生成的技能指令转换成ROS2话题、服务和动作。我在没有rosclaw之前试过用文件接口硬对接ROS2效果极其别扭延迟高且不稳定。用rosclaw之后指令生成、话题发布、反馈接收就是一条完整的链路调试方便多了。rosclaw的安装建议放到ROS2 Humble环境中进行这样能直接复用ROS2的底层通讯机制不需要额外引桥接依赖。安装方式和我前面说的流程类似在ROS2工作空间里克隆相关源码用colcon构建然后source环境变量。4.2 让OpenClaw和ROS2 Humble跑在同一个的“频道”上OpenClaw与ROS2的通讯本质是相互收发消息用户在OpenClaw中输入自然语言指令解析后转换为目标话题或服务调用同时ROS2端的传感器消息、状态反馈也会回传给OpenClaw让它感知机器人的实际状态。这套双向链路中确保OpenClaw主控和rosclaw节点使用相同的通讯配置是最重要的一步包括命名空间、话题名称和服务名称的对应关系。我在配置时先启动rosclaw节点然后用ros2 topic list命令确认话题是否成功注册。如果话题没出现优先检查ROS2的工作空间环境变量是否正确source。这步成功了才算真正打通了OpenClaw在ROS2环境中的“感知-决策-执行”闭环。4.3 Gazebo仿真里跑通第一轮控制Gazebo是ROS2最常用的机器人仿真环境也是验证OpenClaw控制逻辑的最安全场所。在实体机器人上调试很容易损坏硬件但在Gazebo里你可以随便试错。首次运行时需要确认OpenClaw的输出对象是仿真中的机器人模型而不是物理设备。这一步在配置机器人描述和模型名称时尤其要注意。我测试的标准流程是启动Gazebo世界、启动rosclaw节点、在OpenClaw中输入移动指令观察Gazebo中的机器人是否有相应动作。如果机器人没反应不要急着怀疑OpenClaw先用ros2 topic echo手动发布一条同样的指令看仿真机器人能不能动以此快速定位问题出在哪个环节。建议从最简单的运动控制开始跑通。越是简单的闭环越能帮助你快速理解整套系统的数据流方向为后面做抓取、导航等复杂技能打基础。5. 本地算力接入Ollama部署的完整链路5.1 为什么说“只能API”是个误解不少人刚接触OpenClaw时会有“只能用API”的印象这其实是被默认配置误导了。OpenClaw的默认配置里会使用在线模型的接口但运行时层面它设计成了可替换的模型后端。我在安装时直接把模型后端切到Ollama几分钟就完成了本地推理的配置。这个体验和API接入几乎一样唯一的区别是本地模型更自由、零使用成本、完全离线而API通常更聪明、更能理解复杂任务。从架构上说OpenClaw只是按照统一接口向模型后端发请求无论后端是API还是Ollama对它来说都一样。所以“OpenClaw只能用API算力”这说法不正确实际上它能本地接入的模型范围比大多数人想象的大得多。5.2 Ollama安装和模型选择的实操思路Ollama本身就是一个超轻量的本地模型运行工具。你按官方指引安装Ollama之后启动服务拉取一个模型OpenClaw这边就能切过去。模型选择上我实测过几款的感受是如果设备内存小于16G选参数量小一号的量化版本会更流畅如果内存充裕或者对指令理解能力要求高再考虑大尺寸模型。用于OpenClaw这类智能体场景主要看工具的“指令遵循能力”和“上下文长度”不是盲目追求模型参数最多。配置OpenClaw连接Ollama关键就两个参数API地址和模型名称。地址默认指向本机的Ollama服务端口模型名称填你拉取的那个模型标签。改完配置重启OpenClaw确认能正常推理就算接通了。我在实际使用中发现让Ollama保持后台运行、不让它被系统节能策略杀掉对稳定性影响很大。5.3 本地模型也能调用“技能”吗这是我自己也纠结过的问题本地模型那么“小”能不能理解OpenClaw的技能调用协议实测结果是完全可以。OpenClaw对技能调用的约束是用提示词和结构化指令实现的本地模型的指令遵循能力虽然不如大模型那么强但通过把技能指令写清晰大部分场景都能正确触发。我的做法是在系统配置中加上固定的技能说明让每次调用都带上完整的调用示例这样模型误判的概率会明显下降。如果你的任务链路比较复杂、技能步骤很长本地模型的成功率确实会下降。这时候用API会更省心。所以我的经验是不要强迫自己只用一种算力把Ollama作为日常主力、把API作为复杂任务的备用才是最舒服的组合方式。6. 安装与使用常见问题排查实录6.1 我遇到的8个典型问题和解决办法为了让你少走弯路我把实际安装和调试OpenClaw过程中最典型的8个问题整理成了表格每个问题都附带了排查方向和解决方案。常见问题原因解决思路启动时报依赖冲突Python版本不符或库版本冲突创建干净的虚拟环境锁定Python版本重新安装Companion配置面板打不开端口被占用或监听地址设置不对检查监听地址是否设为127.0.0.1换个端口试试局域网内手机连不上电脑防火墙拦截或监听地址是回环地址监听地址改成0.0.0.0放行对应通信端口Termux装依赖时编译失败缺少编译工具链安装build-essential及对应头文件再重新安装依赖ROS2话题创建后找不到工作空间环境变量未source每次终端都source ROS2环境再启动rosclawGazebo中机器人不响应指令模型名称或命名空间不匹配用ros2 topic echo手动发消息定位断点Ollama接入后推理超时Ollama服务未启动或模型未就绪确认Ollama服务进程在跑模型状态为loaded技能调用失败率高指令描述不清晰或模型指令遵循能力弱把技能说明写清楚示例给全或临时切换API测试6.2 安装时最容易踩的坑和绕开方法第一个容易出现的坑是版本“最新癖”。很多人在安装时习惯性装最新Python、最新依赖库反而让OpenClaw跑不起来。我不是说旧版更好而是强调要按项目要求锁定版本。凡是遇到“装完启动报错”的问题先怀疑版本匹配这个思路能解决大部分报错。第二个坑是忽略配置文件里的日志开关。我调试时把日志级别调到INFO很快就看到了错误来源而很多人出了问题只会干瞪眼。日志是排查的第一入口不要嫌它输出多。谁装了OpenClaw都会遇到“看似正常但不动”的情况那时候一条完整的日志胜过十次胡乱猜测。第三个坑是过早接入复杂设备。我建议你先把Windows端或Termux端的基础版跑通再上ROS2和Gazebo。很多朋友一上来就要控制仿真机器人结果基础依赖没调好出问题的时候根本分不清是OpenClaw的问题还是rosclaw的问题。分阶段推进才能精准定位每层的错误。6.3 几个能显著提升成功率的实用技巧前面讲的是避坑这里说几个能让你更顺手的技巧。第一善用别名和快捷方式把启动OpenClaw、启动Companion、启动rosclaw这三条长命令都写成别名日常操作会轻松很多。第二维护一个独立的配置文件版本每次改动前先备份一份可用的配置改坏了就回滚千万不要在同一个配置文件里反复试。第三多平台环境尽量用同步配置管理Windows和Termux两端的核心配置要保持一致否则来回切换很容易混乱。我在最终稳定运行后的体会是OpenClaw这套系统一旦装好之后的使用成本和API接入方案几乎一样低但可玩性高得多。无论是把它作为个人智能体助手还是接上ROS2变成机器人控制中枢都值得投入一个下午来安装调试。最后再分享一个小技巧我习惯在启动OpenClaw的终端里开一个单独的监视窗口实时输出运行日志。这样在做长时间任务时一旦卡住能看到执行到哪一步、卡在哪个技能上不用重新翻日志文件排查效率提高了不少。这套安装流程我已经重复过多次照着走一遍你大概率能在一个晚上就把Windows端或安卓端跑起来后面再慢慢扩展rosclaw和Ollama就会顺畅很多。