最近OpenClaw这个热度确实上来了。不管你是刷到过“AI代理助手”这个词还是看到谁电脑上跑了个自动写周报的窗口大概率背后都是这类东西。OpenClaw做的事情说白了就是把大模型的能力做成一个“听话的管家”你给它一个任务它会自己规划步骤、调用工具、访问本地文件再把结果给你。而它最让我上头的点是所有能力都打包在一个叫Gateway的入口上可以在Windows、Linux甚至手机上部署一套配置到处跑。这篇指南我按照2026年最新的安装环境重新整理了一遍从零开始讲清楚环境准备、各平台安装流程、本地模型接入、常见报错排查。适合的人群很明确想在Windows或Ubuntu上跑AI助手的新手、想用手机Termux尝鲜的折腾党、想搭本地知识库或任务自动化服务的开发者。看完你至少能获得一份可以直接照着敲命令的安装手册外加一堆文档里不会写的踩坑经验。1. 走近OpenClaw这个AI助手Gateway到底要解决什么问题1.1 “Gateway”翻译成人话是什么我第一次听到“Gateway”这个词第一反应是“网关”然后脑子里全是网络路由、防火墙、端口转发这些破玩意儿。但OpenClaw里的Gateway你可以直接理解成“前台接待处”。它负责一件事把你发的消息、指令统一收进来然后根据规则转发给不同的“办事员”。这些“办事员”就是各种大模型。比如云端API模型适合复杂推理本地Ollama模型适合隐私数据、离线场景。没有Gateway的时候你想换个模型就得改代码、改配置甚至重写一整套调用逻辑。有了Gateway你只需要改一条路由规则说“这种任务走本地那种任务走云端”完事。我个人的理解是OpenClaw真正的价值不在于它“套了哪个模型”而在于它把三件事焊死在了一起模型路由、工具调用、渠道接入。模型路由决定用谁干活工具调用决定它能干什么活渠道接入决定你在哪里指挥它。今天你在电脑前敲键盘能用它出门在外掏出手机也能连上同一个Gateway。1.2 为什么2026年要关注多平台部署多平台这个词听起来有点虚但实际场景非常具体。我自己就有三套使用环境主力办公机是Windows日常跑日报助手、周报整理、会议纪要生成。一台Ubuntu服务器挂在角落上面跑着定时任务和长期服务相当于家庭机房。手机装了Termux通勤路上临时连回家里那台Ubuntu的Gateway处理点小任务。以前这三套环境要分别配三套工具维护成本高到让人想放弃。但OpenClaw这套东西设计上就带着多端思维配置目录一同步三套环境基本可以复用同一套Skill和模型路由。另外我观察到一个很有意思的动向在ROS2、Gazebo这类机器人仿真社区也有不少人开始研究OpenClaw。这在热词里能看到比如“rosclaw openclaw ros2 humble gazebo”。你想机器人开发本身就需要一个大模型大脑来理解任务、调用传感器数据、控制仿真环境。OpenClaw这种带Gateway路由的框架天然适合做机器人任务的“调度中枢”。虽然机器人方向不是这篇重点但它说明OpenClaw已经不只是聊天玩具了横向场景一直在扩展。平台优势劣势适合人群Windows上手快、生态成熟、GUI方便本地服务稳定性一般新手、办公自动化为主Ubuntu/Linux长期运行稳定、资源占用低命令操作门槛较高跑服务器、定时任务、家庭机房安卓Termux随身携带、随时排查性能有限、WiFi断连影响移动办公、远程管理兜底2. 安装前的环境准备先把地基打牢2.1 Python、Git、Node.js三件套一次装明白OpenClaw的安装方式在2026版依然走的是标准开源路线从Git仓库拉代码用Python虚拟环境装依赖部分辅助工具需要Node.js跑前端面板。这套流程最怕的不是装不上而是环境里旧版本互相打架。Python的话官方目前要求3.10或更高版本。这里要单独提醒Windows用户安装勾选那一页非常大但最关键的只有一个——“Add Python to PATH”必须勾上。不然你在CMD里敲python会提示找不到命令后面所有步骤全部卡住。Node.js我倒不推荐装最新大版本选LTS版就够了。原因是OpenClaw的Web管理面板对Node版本比较敏感最新大版本偶尔会有依赖编译报错LTS版反而一直很稳。装完后第一件事不是去clone项目而是先验证这三个东西是否就位。打开终端分别执行python --version git --version node -v看到版本号正常输出再往下一步走。我见过不少卡在“pip install时报错”的朋友追到最后都是Python版本不对或者PATH没配好。2.2 Windows子系统与Docker到底要不要装很多教程会一上来就让你装Docker但我个人建议分情况讨论。如果你只是想在Windows上体验一下OpenClaw不打算把它当常驻服务那完全没必要装Docker直接本机装完跑就行。但如果你打算把它当成一个长期运行的家庭网关那就绕不开Docker了。原因很简单Docker能帮你把Python版本、依赖库、系统环境全部打包隔离换机器迁移配置就是一条命令的事不用再从头配环境。Windows上跑Docker的推荐路线是WSL2。WSL2全称是“适用于Linux的Windows子系统第二代”它跟虚拟机的区别是不是完整模拟一台电脑而是Windows内核和Linux内核之间的轻量协调层。装好WSL2之后再装Docker Desktop设置里勾选“Use the WSL 2 based engine”这样编译运行速度都比传统虚拟机方案快不少。安装WSL2只需要两行命令在管理员权限的PowerShell里执行wsl --install装完重启电脑系统会自动拉取默认的Ubuntu发行版。我这里依然用Python命令来验证Linux环境是否就绪。2.3 版本核对建议用一张清单自查在正式开始安装前我整理了一份我自己用的环境自检清单照着走基本能在五分钟内排除80%的问题检查项WindowsUbuntu安卓TermuxPython3.103.103.11Git最新版apt安装pkg安装Node.jsLTS 201820Docker可选WSL2建议安装不适用Ollama可选可选可选这个表格看着简单但每一条背后都是我踩过的坑。比如Termux的Python版本系统源里的初始版本往往比较旧必须用pkg upgrade先升级再装否则后面拉依赖的时候会报编译错误。3. 多平台安装OpenClaw实操流程3.1 Windows安装不是一股脑敲命令Windows上装OpenClaw我的固定流程是四步拉代码、建虚拟环境、装依赖、初始化配置文件。广义上这也是绝大部分开源Python项目的标准安装路线。第一步打开CMD或者PowerShell选好你想放项目的目录然后执行git clone https://github.com/你的来源/OpenClaw.git cd OpenClaw拉下来之后先别急着操作直接建虚拟环境。虚拟环境这东西通俗点说就像“一个与世隔绝的小房间”你在这个房间里装的任何Python库都不会影响房间外的大环境。我见过很多Windows用户直接pip install装到一半和系统里别的库冲突最后只能重装系统所以我在这里多说一句养成用虚拟环境的习惯能省掉未来十次重装。python -m venv venv venv\Scripts\activate pip install -r requirements.txt依赖装完接着是初始化配置。OpenClaw首次启动会生成一个默认的配置文件目录里面主要包括三个文件主配置、渠道配置、Skill配置。新手阶段不用改太多直接跑一下启动命令让它自动生成openclaw init openclaw startinit的意思是“初始化”作用是把默认配置模板写出来然后再用start启动服务。如果一切正常终端会输出一个本地地址通常是127.0.0.1:8088打开浏览器就能看到管理面板。Windows上比较常见的一个坑是第一次启动后服务只在前台运行窗口一关服务就没了。如果只是临时体验问题不大但想长期挂着建议用任务计划程序建一个“运行此任务时自动启动”的条目或者直接用python方式注册成Windows服务。不过这部分属于进阶玩法新手先用前台跑通再说。3.2 Ubuntu/Linux安装把它做成开机自启的服务Ubuntu上的安装逻辑和Windows一样但有一些系统级的前置依赖需要先装。在开始之前我推荐先更新一下软件源sudo apt update sudo apt upgrade -y sudo apt install python3 python3-venv python3-pip git curl -y然后同样走拉取代码、建虚拟环境的路线命令跟Windows几乎一样唯一区别是激活命令git clone https://github.com/你的来源/OpenClaw.git cd OpenClaw python3 -m venv venv source venv/bin/activate pip install -r requirements.txt openclaw initUbuntu上跑服务和Windows有个很大区别Linux天生就是为常驻服务设计的。配置初始化完成后我建议直接用系统服务管理器托管这样就算终端窗口关掉、服务器重启OpenClaw也能自动恢复运行。在项目根目录下创建一个服务文件写入以下内容[Unit] DescriptionOpenClaw Gateway Service Afternetwork.target [Service] Typesimple User你的用户名 WorkingDirectory/你的路径/OpenClaw ExecStart/你的路径/OpenClaw/venv/bin/openclaw start Restartalways RestartSec10 [Install] WantedBymulti-user.target保存后通过service命令加载并启动sudo service-openclaw enable sudo service-openclaw start用这种方式托管的最大好处是“崩溃自愈”。有一次我升级了系统里某个Python库导致Gateway进程崩了本来以为要折腾半小时结果Restartalways这个参数让它在十秒后自动重启了我的定时任务一个都没漏跑。3.3 安卓Termux安装一台手机就是移动网关手机装OpenClaw我推荐Termux这个安卓终端模拟器。它不需要ROOT权限也没啥复杂的安装流程F-Droid或应用商店直接装就行。装好打开先换个可用的软件源然后升级系统包pkg update pkg upgrade -y接着安装Python、Git等基础环境pkg install python git nodejs -y后续流程还是那老四样拉代码、建虚拟环境、装依赖、初始化。唯一要留意的是手机Termux的环境路径和PC不一样克隆项目时注意路径别写错就行。Termux上跑OpenClaw最大的限制是性能。拉大模型推理不现实但用来管理Gateway、发消息、查任务状态完全够用。我最常用的场景是在地铁上用手机连家里Ubuntu服务器的Gateway让AI助手把今天待办事项整理好再推送到通知栏。如果手机内存比较大也能装Ollama的Android版本跑一些1-3B的小参数本地模型。体验跟电脑比会有差距但胜在完全离线、断电断网也能用。4. 接入Gateway路由本地模型、云端模型一次打通4.1 先装Ollama把本地模型跑起来OpenClaw的好处之一是它对“算力来源”完全无感。你可以全用云端API也可以全用本地模型还可以两者混着来。我个人比较喜欢本地模型为主的方案隐私性好也不依赖外部API。本地模型推荐通过Ollama来装。Ollama是一个免费开源的本地大模型管理器安装后能用一条命令拉取模型、启动服务。Windows和Linux都支持安装方式curl -fsSL https://ollama.com/install.sh | shWindows用户则直接下载安装包装完会自动注册成系统服务基础体验很顺滑。装好后拉一个模型ollama pull qwen2.5:7b这里解释一下拉模型的动作它会把模型文件的权重数据下载到本地然后通过Ollama提供一个本地API接口。默认端口是11434。验证模型是否正常工作可以直接执行ollama run qwen2.5:7b会进入一个交互式对话界面。能聊就说明本地算力这块已经通了OpenClaw的配置文件里只要把模型指向这个端口就行。4.2 配置Gateway模型路由本地优先、云端兜底OpenClaw的核心配置是一个YAML格式文件里面最大的一块就是Gateway的路由规则。所谓路由规则你可以理解成“把什么样的请求交给什么样的模型去处理”。以下是我自己用的一个简化版配置照抄基本能跑通gateway: routes: - name: local_fast type: ollama model: qwen2.5:7b base_url: http://127.0.0.1:11434 timeout: 120 # local_fast的意思是本地快速通道适合日常对话类任务 - name: cloud_power type: anthropic-compatible model: claude-sonnet-latest api_key: ${ANTHROPIC_API_KEY} timeout: 60 # cloud_power适合推理难度较高的任务作为兜底 rules: - pattern: .* prefer: local_fast fallback: cloud_power看到这里你大概能理解为什么开头说Gateway像个“前台接待处长”了。它先把请求抓进来根据你设置的pattern规则判断该交给谁。pattern: .*表示默认全部走本地如果本地超时或失败就自动换到cloud_power兜底。这就回答了一个很常见的问题OpenClaw只能用接入API的方式使用算力吗答案当然不是。本地模型和API可以混跑甚至可以把模型配置在远程服务器上Gateway把你的电脑和那台服务器连接起来。配置好之后重启服务让它生效openclaw restart4.3 打通多平台使用用Skill扩展能力模型路由通了之后OpenClaw才真正开始展现“AI助手”的形态。它的核心武器叫Skill你可以把它理解成手机上的“快捷指令”。比如我配了一个“日报生成”Skill它会在每天18点自动读取当天的Git提交记录调用模型总结成一段工作总结再通过渠道推送到指定群聊。配置Skill不需要写代码只需要在Skill目录下创建一个YAML文件name: daily_report trigger: schedule: 0 18 * * * # cron表达式每天18点触发 steps: - action: shell.exec command: git log --sincemidnight --oneline - action: llm.chat route: local_fast prompt: 把下面的提交记录整理为周报形式{{output}} - action: notify.send route: desktop这里顺便解释Cron表达式它是一个定时任务的语法用来告诉系统在什么样的时间点触发任务。这只是冰山一角。OpenClaw的Skill配置支持很多种能力模块文件读写、代码执行、浏览器操作、消息发送、定时任务等等。配合多平台之后你完全可以把电脑变成一个“自动处理日常事务的机器人”。5. 常见问题与排查技巧实录5.1 高频报错速查表报错信息原因解决办法doesnt look like an anthropic model: expected a gateway model route referenceGateway配置里的模型路由指向了不存在的模型或格式不对检查配置文件中模型名称、路由名称是否一致重启Gateway502 Bad Gateway上游服务没有响应常见于云端或本地模型没有启动先单独验证模型服务是否可用再确认Gateway配置的地址和端口Bad Gateway error EOF网络连接被中断多发生在Termux或服务器回连的场景检查网络连接确认端口未被防火墙拦截必要时增加超时时间ModuleNotFoundError: No module named xxxPython依赖缺失通常是虚拟环境没激活就执行了启动命令重新激活虚拟环境pip install -r requirements.txt这里面最典型的是第一个doesnt look like an anthropic model。这条报错我刚接触OpenClaw时撞见过一次折腾了半小时最后发现是自己把配置文件里的model字段写错了路径指向了一个不存在的别名。记住一个原则每次改动配置后都要先执行openclaw doctor这个内置检查命令它会帮你把配置里明显的格式错误和路径错误扫一遍。5.2 我的踩坑心得能省你不少时间讲几个常规文档不会有的心得。**第一虚拟环境必须养成习惯。**OpenClaw的Python依赖比较多直接安装到系统环境里很容易和已有工具冲突。最典型的表现是今天装好了能跑过几天装了个别的库突然启动就报错怎么排查都找不到原因。这是因为两个库依赖了同一个底层包的不同版本互相覆盖了。用虚拟环境从根上斩断这种可能。**第二Ollama的端口冲突很隐蔽。**Ollama默认监听11434但有次我发现Gateway路由本地模型超时查了半天发现是我之前跑一个测试项目把11434端口占了。排查这种问题优先看端口占用netstat -ano | findstr 11434 lsof -i :11434如果发现被别的进程占用要么停掉那个进程要么给Ollama换个端口。我之前就是因为这个端口冲突浪费了一个下午。**第三Termux的锁屏断网问题。**手机装好OpenClaw后只要息屏一段时间应用就“假死”。这不是配置问题是安卓系统在后台限制了Termux的网络活动。解决办法是到系统设置里给Termux关掉电池优化并在WiFi设置里开启“在休眠状态下保持WiFi连接”。很多手机上跑Termux的教程都不会提这点但你不处理的话手机版体验会非常糟糕。**第四日志是排查的第一现场。**OpenClaw启动失败时终端往往会刷出一大堆报错。很多人看到红字就慌其实真正有用的信息通常不在最下面而要在日志文件里找。日志默认存放在运行目录下的logs文件夹里。建议养成习惯出了任何问题先看日志不要凭感觉乱改配置。tail -f logs/gateway.logtail -f的意思是动态查看文件末尾的输出服务每打印一条新日志就会实时滚动显示。这样你就能实时看到Gateway做了什么操作、在哪个环节失败了。**第五版本升级别偷懒升级前一定备份配置。**更新版本这个操作看着风险不大但经常出现新版本改了旧配置项。我的习惯是升级前把整个配置目录压缩备份升级后如果起不来直接恢复到旧版本。无论多可靠的软件备份都是最后的退路。写在最后我自己的使用心得是OpenClaw这种东西最大的门槛不在安装而在配置思路。很多人照着教程装完之后就不知道该干嘛了然后放在硬盘里吃灰。其实你只要想清楚一个场景——比如“每天早上自动整理发货清单”——然后顺着任务反推需要什么模型、需要什么Skill配置就不会太乱。如果你完全不知道从哪下手我建议从最小组合开始一台Windows本机装上OpenClawOllama拉一个7B模型配一条本地路线。先跑通“在管理面板里跟模型聊天”这一步然后再慢慢加Skill、加渠道、加定时任务。等这套跑稳了再考虑迁移到Ubuntu或Docker做成真正的常驻Gateway。如果你遇到某个具体的报错不知道怎么处理先按速查表对照一遍多半能解决。实在不行的把日志里最后二十行贴出来找社区。这个项目现在的社区交流氛围还不错你要找的是报错信息而不是情绪化描述问题基本能很快定位。