Windows下跑OpenClaw大多数人卡住的第一关不是Docker装不上而是根本不知道这玩意儿到底有哪些操作指令。OpenClaw这个开源AI助手框架管理方式跟普通桌面软件完全不一样——它不是双击图标就能用的而是跑在Docker容器里的服务配置、启动、排障全靠命令行。我把这套指令体系从头到尾摸了一遍从环境准备到日常管理再到常见排障一条条梳理出来写成这篇实操笔记。这篇文章适合正在Windows上搭OpenClaw、或者准备入坑的开发者看完之后你心里就有底了到底哪条命令管什么、什么时候该用哪条指令、出了问题先去查什么。1. 先把OpenClaw的指令体系搞清楚1.1 三层指令别混淆这才是Windows用户最大的坑OpenClaw的操作指令严格来说分成三个层面很多人没搞清楚就在网上搜答案结果越搜越乱。第一层是Docker层面的指令管的是容器本身。启动、停止、查看日志、进入容器这些都是Docker命令跟OpenClaw本身没什么关系。第二层是OpenClaw的CLI指令在容器内部执行主要负责管理配置、诊断健康状态、查看版本、导入导出数据。第三层是交互会话里的斜杠指令在Web聊天界面里敲用来切换模型、管理技能和触发器。这三层指令各管各的事混着用必然出错。我在不少帖子里看到有人直接在Windows的PowerShell里敲openclaw start提示找不到命令然后就开始怀疑安装有问题。其实原因是OpenClaw的二进制在容器内部宿主机上根本没有这个命令。想用CLI指令要么docker exec进容器再敲要么用docker exec openclaw openclaw doctor这种方式直接在宿主机上执行容器内的命令。这也是OpenClaw跟普通Windows软件最大的不同。平时我们用的软件安装完在开始菜单里点一下就行OpenClaw装完入口是命令行和浏览器地址栏。理解了这个分层逻辑后面所有指令操作就都顺了。1.2 Windows环境下的指令执行差异OpenClaw官方文档默认以Linux为主要部署环境Windows下的部署本质上是先虚拟化、再跑容器。Windows上用Docker Desktop底层走的是WSL2或Hyper-V这意味着你执行的每条Docker命令其实都经过了一层虚拟化转换。实测下来性能影响不大但有两个细节必须注意。第一个是路径写法。Windows的路径是C:\Users\xxx这种反斜杠风格但在Docker命令里做目录挂载时需要用正斜杠或转义写法。比如想把本机配置目录挂载进容器在PowerShell里要写成docker run -d --name openclaw -v C:/Users/你的用户名/.openclaw:/root/.openclaw openclaw/openclaw:latest第二个是PowerShell跟CMD的转义规则不同。PowerShell里$符号有特殊含义如果命令里出现$变量前缀不加处理会被PowerShell直接解析掉。比如在CMD里能正常执行的docker exec openclaw echo $HOME在PowerShell里就得改写成docker exec openclaw echo \$HOME或者用单引号包裹。这个坑很隐蔽我见过不少人在PowerShell里跑命令报错换到CMD就好了其实就是转义问题。还有一个Windows特有的注意点Docker Desktop启动后如果用管理员权限打开终端有时候docker命令会连不上守护进程提示error during connect或者error during connect: This error may also indicate that the docker daemon is not running。这是因为Windows的权限隔离机制。解决方式很粗暴——重新以普通用户身份打开终端或者右键Docker Desktop图标选Restart。这不是OpenClaw的问题但会在OpenClaw部署时卡住提前知道能省不少时间。2. Windows部署OpenClaw的前置指令2.1 先把Docker Desktop和WSL2装到位在Windows上部署OpenClaw第一步永远是装Docker Desktop。装完建议顺手确认WSL2已经启用打开PowerShell执行wsl --status能看到默认版本为2就对了。如果显示的是1执行wsl --set-default-version 2装好Docker之后验证一下守护进程是否正常docker info能看到Server Version那一栏有具体版本号就说明环境OK。如果执行docker info卡住不动大概率是Docker Desktop没启动去开始菜单把Docker Desktop打开等右下角鲸鱼图标变稳定再试。版本方面多说一句Docker Desktop建议装最新版老版本在Windows 11新版系统上偶尔会有兼容问题。另外Windows 10的话确保系统版本不低于21H2不然WSL2支持不完整后面跑容器会出现各种莫名其妙的问题。2.2 拉取镜像与首次启动容器的关键指令环境就绪后拉取OpenClaw镜像docker pull openclaw/openclaw镜像大概几百兆视网速而定。拉下来之后第一次启动我建议用这种稳妥的参数组合docker run -d --name openclaw --restart unless-stopped -p 127.0.0.1:18789:18789 -v openclaw_data:/root/.openclaw openclaw/openclaw:latest四个参数逐一解释-d后台运行--name指定容器名--restart让容器异常退出后自动拉起-p把容器的18789端口映射到宿主机-v持久化数据目录。端口映射这里我故意写成127.0.0.1而不是0.0.0.0是为了安全。OpenClaw的Web界面默认不带鉴权如果绑到0.0.0.0局域网内其他设备也能直接访问数据隐私没保障。只绑定本机回环地址外部网络才访问不到。启动完成后浏览器访问http://localhost:18789能看到界面就说明部署成功了。首次打开会让你配置API连接信息这里就涉及另一个热搜问题——OpenClaw是不是只能用接入API的方式使用算力答案是否定的。OpenClaw既可以接云端大模型API也可以通过Ollama这类工具接本地模型。Windows下很多人就是配Ollama把本地跑的模型作为OpenClaw的算力来源完全离线可用。3. OpenClaw核心操作指令全解析3.1 容器生命周期管理指令日常用得最多OpenClaw跑起来之后日常操作最频繁的就是容器管理指令。这几条我每个月都要用很多次docker start openclaw启动已停止的容器。开机后Docker Desktop自动起来容器因为设置了--restart unless-stopped也会跟着起来但偶尔手动停过就需要这条命令。docker stop openclaw优雅停止容器。改配置文件前建议先停容器防止配置被运行时状态覆盖。docker restart openclaw重启容器改完配置后最常用的一条命令。配置文件的修改只有在容器重启后才会完全生效。docker logs --tail 100 -f openclaw查看最近100行日志并持续跟踪输出。排障必备后面专门讲。我在Windows上实测docker stop之后要等几秒因为容器里的OpenClaw要做优雅退出保存会话状态和记忆数据。如果超过30秒还停在Stopping状态说明有进程挂住了这时候直接docker kill openclaw强杀再启动不用担心数据损坏因为配置和数据都写在命名卷openclaw_data里容器本身是无状态的。3.2 进入容器执行CLI指令管理配置的核心手段需要改配置或者跑诊断的时候要进到容器里面操作docker exec -it openclaw bash进容器之后OpenClaw的二进制在~/.openclaw/bin目录下。最常用的几条CLI指令如下。openclaw doctor是我每次改完配置必跑的指令没有之一。它会做一遍系统自检检查API连通性、配置文件合法性、技能加载状态、触发器语法然后输出一份报告。哪个API key失效了、哪个技能包路径找不到、配置文件哪行有YAML语法错误一目了然。排障效率比翻日志高太多。openclaw version查看当前版本号。OpenClaw迭代很快遇到问题先在社区里报版本号别人才能帮你判断是不是已知bug。升级前后也建议各跑一次确认版本变化。openclaw export把当前配置、技能、触发器全部导出成一个zip包。改配置前必做备份这是我最深的教训——有一次手动改配置文件少了个空格导致整个YAML解析失败OpenClaw起不来最后靠之前导出的备份才救回来。openclaw import --file xxx.zip从备份包恢复。注意恢复操作会覆盖当前配置执行前确认清楚最好先把现有配置再导出一份。3.3 交互会话中的斜杠指令RAG知识库场景尤其常用打开Web界面进入对话后斜杠指令是管理OpenClaw最直接的方式。这里要区分一个概念斜杠指令是跟OpenClaw本体交互的你发普通消息是跟AI对话但发斜杠指令就是在调用管理功能。常用斜杠指令如下/model查看当前使用的模型后面跟模型名可以切换。比如从GPT系列切到本地Ollama模型就在对话里敲/model ollama/qwen2.5/skills列出已加载的技能包后面加技能名可以查看详情/triggers列出所有触发器检查哪些自动化规则在生效/memory查看长期记忆内容。OpenClaw会把重要对话摘要存进记忆库这条指令能直接浏览和搜索/export在界面上直接导出配置包跟CLI里的export效果一样/doctor运行诊断跟容器里的CLI命令同样功能使用斜杠指令特别要注意副作用。比如/restart这类指令会重启整个容器正在进行的对话和任务会中断。我在实际使用中踩过这个坑当时让OpenClaw跑一个长任务顺手敲了条/restart想刷新状态结果任务进度全部丢失。后来养成了习惯——执行有副作用的指令前先/export做备份。RAG知识库场景里/skills特别实用。OpenClaw的自定义技能相当于给它装工具你可以在技能里配置连接本地知识库的方式。加载新技能后用/skills list确认有没有加载成功比瞎猜强得多。提示斜杠指令的完整列表可以在Web界面输入单独一个/或者/help查看不同版本支持的指令有差异以你自己部署版本的提示为准。4. 配置技能与触发器Windows下的实操指令汇总4.1 技能管理指令从安装到热加载技能Skills是OpenClaw扩展能力的核心。在Windows下管理技能有两个途径。一个是在Web界面里通过/skills系列指令操作另一个是直接在命名卷对应目录里操作文件。OpenClaw的技能包放在容器内的/root/.openclaw/skills/下每个技能就是一个独立目录里面有SKILL.md描述文件和配套脚本或程序。Windows下很难直接进到Docker命名卷目录里改文件所以我推荐用docker cp指令在宿主机和容器之间拷贝文件。安装新技能最稳妥的流程把技能包目录放在Windows本机某个路径下比如C:\skills\my-skill执行docker cp C:/skills/my-skill openclaw:/root/.openclaw/skills/在Web界面执行/skills reload或者重启容器执行/skills list确认技能加载成功删除技能更简单docker exec openclaw rm -rf /root/.openclaw/skills/技能名然后在界面里/skills reload。注意技能名别拼错rm -rf删错目录的后果不用我多说。技能文件挂载的建议如果你打算频繁调试技能包不建议用docker cp一遍遍拷贝太折腾。更好的方式是在docker run的时候直接把Windows宿主机目录挂载进容器docker run -d --name openclaw -v C:/skills:/root/.openclaw/skills -v openclaw_data:/root/.openclaw openclaw/openclaw:latest这样Windows本机C:\skills下的技能文件直接同步到容器里改完文件在界面里/skills reload就行不用再执行docker cp。但要注意容器内技能的加载路径、宿主机挂载路径、命名卷持久化路径这三者之间的关系要想清楚挂载了专门的skills目录之后原来的命名卷里就不再重复保存技能文件备份策略也要跟着调整。4.2 触发器配置指令自动化规则的生效流程触发器的核心配置都写在主配置文件里。OpenClaw的主配置文件是/root/.openclaw/openclaw.yaml通过命名卷持久化。每次改完配置文件标准生效流程是这样的在容器内执行openclaw doctor先验证配置语法和依赖项执行docker restart openclaw让配置生效在Web界面里执行/triggers检查触发器列表是否正确加载有条件的话试触发一次确认自动化规则真的在执行Windows下编辑配置文件还有个独门技巧——直接在宿主机上用VSCode改然后重启容器。因为配置文件在命名卷里如果你用的是bind mount方式挂载了C:/Users/你的用户名/.openclaw那直接在Windows里用任意编辑器改openclaw.yaml保存后重启容器即可。实测VSCode的YAML插件会实时检验语法错误比在容器里用nano改舒服太多。触发器配置示例比如你想让OpenClaw每天固定时间检查邮件并生成摘要就在openclaw.yaml里写一条触发器定义包括触发时机、调用的技能、参数。改完务必先openclaw doctor因为YAML对缩进极其敏感多一个空格少一个冒号都可能导致整条触发器不生效而且不一定报错——这是最阴间的坑。5. 常见问题与排障指令实录5.1 端口占用问题一条命令定位本地跑OpenClaw端口冲突是最常见的问题之一。启动容器时如果提示端口已被占用先查是谁占了18789端口netstat -ano | findstr 18789会看到占用端口的进程PID然后去任务管理器里找到对应进程。如果确认是无用进程直接结束如果是其他开发服务占用了端口那就改OpenClaw的映射端口启动命令改成docker run -d --name openclaw -p 127.0.0.1:18790:18789 openclaw/openclaw:latest宿主机端口改成18790容器内依然是18789然后浏览器访问http://localhost:18790就行。5.2 Docker Desktop吃内存太狠用.wslconfig限制Docker Desktop在Windows下跑默认会吃掉大量内存尤其是OpenClaw容器加上日志积累16GB内存的机器都可能卡顿。解决办法是限制WSL2资源。在C:\Users\你的用户名下新建或编辑.wslconfig文件[wsl2] memory6GB processors4 swap2GB保存后在PowerShell里执行wsl --shutdown等几秒再重新打开Docker Desktop配置就会生效。我实测限制到6GB之后日常跑OpenClaw加Ollama本地模型完全够用Windows本体也不再卡。注意这个文件会影响所有WSL2发行版别把内存调太小最低建议4GB不然Ollama加载模型会直接OOM。5.3 容器启动后马上退出的排查流程容器启动后几秒就退出多半是配置问题。第一步永远是看日志docker logs openclaw常见错误分几类提示缺少API key通常是没有正确配置模型API需要在容器环境变量里补上提示配置文件解析失败把配置文件导出到Windows本地检查YAML格式提示技能加载异常可能是某个技能包的脚本缺失依赖。还有一种情况容器状态一直显示Restarting过一会儿自动恢复。这通常是因为配置的API服务暂时不可用OpenClaw启动时重试导致的。docker logs里能看到重试日志确认服务恢复后一般会自动拉起。5.4 数据备份与恢复指令比你想的更重要Windows下重装系统或者升级Docker Desktop最怕数据丢失。OpenClaw的配置、技能、记忆全部在/root/.openclaw目录里。备份就一条指令docker exec openclaw openclaw export导出文件会生成在容器内的/root/.openclaw/exports/目录下然后docker cp openclaw:/root/.openclaw/exports/xxx.zip C:/backup/把备份文件拷到Windows本机。恢复的时候反过来操作。我个人的习惯是每周自动导出一份加上改配置前手动导出一份双保险。OpenClaw的对话记忆积累起来之后非常宝贵丢了是真的找不回来。5.5 Web界面登录异常试试这几个技巧浏览器访问localhost:18789打不开或者界面加载异常先确认容器状态docker ps如果容器是Up状态再检查端口映射是否正常docker port openclaw能看到127.0.0.1:18789-18789/tcp就说明映射正常。这时候大概率是浏览器缓存问题换个无痕窗口或者直接CtrlF5强刷。还有个小技巧OpenClaw的Web界面有时会因为WebSocket连接异常导致对话发不出去刷新页面能解决八成问题剩下两成检查日志里有没有WebSocket报错。6. 一些实操体会写给正在踩坑的你我个人实际操作下来的最大体会是OpenClaw在Windows上的稳定性很大程度上取决于你愿不愿意搞清楚命令到底在哪一层执行。Docker命令在宿主机敲CLI命令在容器里敲斜杠命令在Web界面敲——这个最基本的分层搞明白了一半的问题都不是问题。还有一个小技巧值得分享Windows Terminal比老版CMD好用太多可以开多个标签页一个盯着docker logs -f一个编辑配置文件一个执行操作指令排障效率翻倍。刚开始不习惯命令行操作很正常坚持用几天你会发现命令行方式管理OpenClaw其实比图形界面更高效因为一切操作都有迹可循出了问题看一眼历史命令就能定位。希望这份指令梳理能帮你少走一些我走过的弯路。