OpenClaw Windows 启动与关闭完全指南前阵子项目里需要搭一套自动化Agent试了一圈开源方案最后落在了OpenClaw上。这东西在国内技术社区讨论不算多但在Windows上的部署体验和Linux差距比较大尤其是启动和关闭这两个看似基础的操作里面藏了不少坑。我踩了一遍把完整过程记录下来从装依赖到各种方式启动、优雅关闭再到进程清理给准备在Windows上折腾OpenClaw的朋友一条能直接走通的路线。这篇指南适合三类人第一次接触OpenClaw、想在Windows上跑通实验环境的新手已经跑起来但总是关不干净、端口被占用的普通用户以及想把启动关闭流程做成脚本、纳入自动化运维的开发者。我尽量把原理也讲清楚不只是给命令起码你遇到问题的时候知道自己大概卡在哪一环。1. 先搞清楚OpenClaw在Windows上的运行逻辑1.1 OpenClaw到底是什么为什么选WindowsOpenClaw本质上是一个面向大模型应用的自动化代理框架核心思路是让语言模型通过一组预定义的技能Skill去调用外部工具、读写文件、操作API从而完成较复杂的任务流程。你可以简单把它当成一个带工具的AI执行层上层接模型本地Ollama或云端API都行下层接各种可操作的能力模块。在电商自动化、信息整理、轻量运维脚本这类场景下非常实用相当于给你一个能稳定反复执行工作流的Agent底座。很多教程默认在Linux上跑但实际工作中大量用户主力机就是Windows。Windows上有更熟悉的IDE、更顺手的调试工具而且对于很多轻量任务来说没必要专门装一套Linux虚拟机。OpenClaw的官方文档虽然提供了跨平台支持但Windows上的细节处理往往藏在Issue里需要自己摸索。我这套环境是Windows 11 专业版Python 3.11Node.js 20 LTSOpenClaw本体用Git克隆的源码运行。后面所有操作都基于这个组合。1.2 Windows和Linux在启动关闭上的核心差异在Linux上OpenClaw通常用systemd服务托管启动、停止、开机自启都有成熟方案。Windows上没有systemd但替代方案并不少只不过很多新手不知道。常见的思路有三个用任务计划程序Task Scheduler托管这是微软官方的后台运行方案用NSSMNon-Sucking Service Manager把任意exe注册为Windows服务直接写批处理脚本配合start命令在后台跑。三者各有优缺点。任务计划程序最稳但配置界面有点繁琐NSSM功能强大适合需要服务级管理的场景批处理最轻量适合快速测试。我个人在开发阶段直接开命令行窗口跑有日志输出方便排查确认稳定之后再用NSSM封装成服务这样不用一直挂着一个控制台窗口。另外一个关键差异是Windows的进程模型。Linux下CtrlC通常能干净地终止进程但在Windows的cmd或PowerShell里如果你直接关掉控制台窗口子进程未必跟着退出经常出现端口还占着、进程还在后台跑的情况。这也是为什么关闭操作需要专门写一节来讲。提示Windows上跑OpenClaw之前先确认你的Python和Node版本符合要求。实测Python 3.8以下会直接报语法错误Node 18以下的某些依赖会编译失败。建议用Python 3.10Node 18。2. 部署前的环境准备与配置细节2.1 基础依赖安装清单OpenClaw在Windows上需要以下基础环境建议按顺序装省得后面排查交叉依赖的问题组件版本要求用途安装方式Python3.10OpenClaw核心运行环境python.org下载或wingetNode.js18 LTS部分技能模块与Web UInodejs.org下载或wingetGit任意较新版本拉取OpenClaw源码git-scm.comOllama可选最新版本地模型推理ollama.comVisual C Redistributable2015-2022某些依赖库的编译运行微软官网这里特别提醒一下Visual C Redistributable很多人漏了它。OpenClaw的部分依赖在Windows上需要编译本地扩展比如某些AI相关的Python包如果没有对应的VC运行时pip install的时候会报一些莫名其妙的错误类似Microsoft Visual C 14.0 or greater is required。这种错误跟OpenClaw本身没关系纯粹是环境缺东西补上就能过。安装Python的时候记得在安装向导里勾选Add Python to PATH。这是最容易被忽略的一步如果没勾选后面命令行里python命令会直接提示找不到。如果你已经装好了但没勾选可以手动去系统环境变量里把Python安装目录和Scripts目录加进去。2.2 拉取代码与虚拟环境创建我个人习惯用虚拟环境来隔离OpenClaw的依赖避免污染系统的Python环境。如果你之前被Python依赖冲突折磨过这步一定别省。# 克隆OpenClaw源码 git clone https://github.com/openclaw/openclaw.git cd openclaw # 创建并激活虚拟环境Windows下 python -m venv venv venv\Scripts\activate # 安装核心依赖 pip install -r requirements.txt这一步有几个细节需要说明。第一虚拟环境一定要创建在OpenClaw的根目录内部或者你能轻易找到的地方因为后续每次启动都要先激活这个环境。第二requirements.txt里有的包体积比较大比如涉及嵌入模型的包下载时间视网络情况而定耐心等。第三如果你打算让OpenClaw调用Ollama的本地模型建议提前把Ollama装好并启动服务第一次使用的时候OpenClaw会检测本地API是否可用。2.3 配置文件准备OpenClaw运行需要一个配置文件用来指定模型来源、密钥、启用的技能模块等。在源码根目录下通常会有一个.env.example或者config.example.yaml模板复制一份改成自己的名字copy .env.example .env打开.env文件你需要根据自己的情况修改几个关键项模型接口地址如果你用Ollama本地模型填http://localhost:11434如果用云端API填对应服务的地址。API密钥云端API需要填密钥本地Ollama可以留空或者填任意值。技能目录指定想要的技能在哪里加载默认是skills/文件夹。日志级别建议调试阶段设成debug稳定后改回info。这里有一个经验之谈调试阶段日志级别一定要开debug。启动失败的时候OpenClaw的debug日志会把你引导到一个明确的错误原因比如端口冲突、模型服务未启动、配置文件字段错误。如果设成info很多信息被吞掉了排查难度直接翻倍。3. 启动OpenClaw三种常用方式与适用场景3.1 前台启动最快、最直观、最适合调试打开命令行工具cmd或PowerShell都行先激活虚拟环境再回到OpenClaw根目录直接运行venv\Scripts\activate python main.py或者有些版本用python run.py取决于你拉取的代码版本。如果不确定看根目录下的README.md里面会写明启动入口。前台启动时OpenClaw的所有日志都会直接输出到当前终端窗口包括模型加载记录、技能注册信息、任务执行的中间日志。这个方式最大的优点是你能实时看到发生什么遇到问题了直接看日志就能定位。缺点是终端窗口一关进程就没了而且CtrlC的退出响应取决于程序对信号的处理方式有时会卡在等待某个子线程退出。我建议新手前三次运行都用这个方式先把环境跑通再说。如果你想在当前这个终端窗口之外干别的可以另外开一个window互不干扰。提示如果你的OpenClaw配置了要连接Ollama或其他本地模型服务启动前先确认那个服务已经起来了。判断方法很简单浏览器打开地址如http://localhost:11434如果能看到Ollama的响应信息说明服务正常。否则OpenClaw起来后会反复重试连接模型日志里全是连接失败的报错。3.2 后台启动不挂终端把进程放后台如果你不想一直挂着一个命令行窗口可以用PowerShell的Start-Process来把OpenClaw放到后台运行Start-Process -FilePath venv\Scripts\python.exe -ArgumentList main.py -WorkingDirectory D:\openclaw -WindowStyle Hidden这样OpenClaw就在后台跑起来了没有控制台窗口。日志会写到哪去呢默认情况下可能写到当前目录的日志文件也可能什么都没写取决于你的日志配置。这里有个坑如果你用的是-WindowStyle Hidden日志不会自动保存到文件出问题的时候无从查起。更稳的做法是后台启动的同时把标准输出和错误输出重定向到文件Start-Process -FilePath venv\Scripts\python.exe -ArgumentList main.py -WorkingDirectory D:\openclaw -RedirectStandardOutput D:\openclaw\logs\stdout.log -RedirectStandardError D:\openclaw\logs\stderr.log -NoNewWindow这样即使进程在后台日志也完整地写进文件排查问题的时候直接打开log看就行。Windows后台进程有一个要注意的点如果你是在PowerShell窗口里启动的后台进程当这个PowerShell窗口被关闭时后台进程不一定跟着退。所以关窗口之前建议你用下面的方式确认一下进程状态。3.3 开机自启动让OpenClaw随系统启动自动运行如果你打算把OpenClaw当作一个长期运行的服务开机自启几乎是必须的。Windows上有两种常见做法任务计划程序和NSSM。我重点推荐NSSM因为它把OpenClaw封装成了标准的Windows服务你可以像操作其他服务一样用net start、net stop来控制还能设置失败后自动重启。首先用管理员权限的PowerShell安装NSSM并把OpenClaw注册成服务nssm install OpenClawService D:\openclaw\venv\Scripts\python.exe D:\openclaw\main.py nssm set OpenClawService AppDirectory D:\openclaw nssm set OpenClawService AppStdout D:\openclaw\logs\service_stdout.log nssm set OpenClawService AppStderr D:\openclaw\logs\service_stderr.log nssm set OpenClawService Start SERVICE_AUTO_START nssm start OpenClawService这几条命令的含义第一条把Python解释器和OpenClaw启动脚本注册为名为OpenClawService的服务第二条设置服务的工作目录第三、四条指定日志输出文件第五条设置开机自启第六条立即启动服务。注册完成之后在Windows服务管理器里就能看到OpenClawService的状态还能配置如果服务意外停止尝试重新启动的恢复策略。如果你不用NSSM也可以用任务计划程序。创建任务时触发器选计算机启动时操作选启动程序程序填D:\openclaw\venv\Scripts\pythonw.exe注意用pythonw.exe而不是python.exe这样不会弹出黑色控制台窗口参数填main.py起始于填D:\openclaw。任务计划程序的方案好处是纯系统原生不需要额外装工具缺点是故障恢复策略不如NSSM灵活服务崩溃后不会自动重启。对于要求可用性的场景我还是推荐NSSM。4. 关闭OpenClaw比启动更容易踩坑的环节4.1 标准关闭流程让程序自己善后如果是前台运行的OpenClaw直接在终端里按CtrlC正常情况下OpenClaw会捕获中断信号执行清理逻辑比如保存当前的会话状态、释放占用的端口、停止后台线程。等命令行提示符重新出现说明已经干净退出了。如果你是通过NSSM注册的服务用管理员权限的PowerShell执行nssm stop OpenClawService或者更传统的net stop OpenClawService这两个命令都会向服务发送停止信号。NSSM默认会有个等待超时默认30秒如果OpenClaw在30秒内没有正常退出NSSM会强制终止进程。这个特性可以在服务卡死的时候救急但也意味着你可能丢失一部分未保存的任务中间状态。所以如果OpenClaw正在执行一个重要的长任务建议先观察日志等它完成再手动停止服务。4.2 强制关闭进程残留与端口占用一网打尽强烈不建议一上来就强制杀进程但总会有服务卡死、响应超时的情况。这时候你需要找到OpenClaw的实际进程并结束它。常见的做法是按Win X打开Windows Terminal管理员用下面的命令找到占用端口8080或你在配置里指定的端口的进程netstat -ano | findstr :8080输出里有一列是PID比如输出显示TCP 0.0.0.0:8080 0.0.0.0:0 LISTENING 22132说明PID为22132的进程在监听8080端口。确认这个是OpenClaw的进程之后taskkill /PID 22132 /F/F表示强制终止。如果这样还杀不掉偶尔会遇到进程处于不可中断的I/O等待状态可以用taskkill /PID 22132 /F /T/T表示连同该进程的子进程一起终止。这个参数很有用因为OpenClaw经常派生多个子进程你杀掉了主进程子进程还在后台占着资源。用/T可以斩草除根。还有一种常见情况你也不知道OpenClaw的进程PID是多少但你知道端口被占了。上面的netstat方法先找端口再杀进程但对一个系统性强迫症来说还是写个一键清理脚本更舒服。下面这个脚本做得事情很简单检查8080端口是否被占用如果被占用就关掉对应进程。$port 8080 $connections netstat -ano | Select-String :$port\s.*LISTENING foreach ($conn in $connections) { $tokens $conn.ToString().Trim().Split( ) $pidVal $tokens[-1] Write-Host Killing process $pidVal on port $port taskkill /PID $pidVal /F /T }这个脚本在反复调试OpenClaw配置的时候非常实用——改完配置重新跑之前先执行一遍保证端口是干净的否则新起的服务会一直绑定失败。提示杀进程之前一定确认PID对应的进程确实是OpenClaw而不是别的程序。判断方法是在PowerShell里执行Get-Process -Id 22132查看进程名和路径。经验不足的人误杀系统进程造成蓝屏或服务崩溃的例子不在少数请务必确认。4.3 关闭之后的清理缓存、临时文件与端口状态确认OpenClaw跑久了会在本地留下一些缓存和临时文件比如会话历史、临时下载的工具输出等。定期清理可以让下一次启动更快也能减少磁盘占用。需要关注的位置通常包括OpenClaw根目录下的cache/文件夹系统临时目录%TEMP%里以openclaw开头的文件或文件夹日志文件夹里的历史日志文件建议按日期归档不要直接全删。清理之前先确认OpenClaw已经完全停止否则文件可能正在被占用清理失败。还有一个细节OpenClaw如果配置了调用Ollama的本地模型关闭OpenClaw并不会自动关闭Ollama。如果你希望彻底释放资源需要单独停止Ollama服务。Windows下安装Ollama之后它默认会在后台运行托盘图标里有退出选项命令行的方式也可以找到它的进程并关闭。如果你开启了开机自启的Ollama服务关闭OpenClaw后它还会继续占着显存和CPU。5. 常见问题排查与避坑技巧5.1 启动时报端口已被占用怎么办这个问题在调试阶段出现频率最高。原因很简单上一次OpenClaw没有干净退出进程残留占住了端口这次启动时新的实例无法绑定同一个端口。解决办法就是上面提到的三步走先netstat -ano | findstr :端口号找到PID然后taskkill /PID 进程号 /F /T强制终止最后再启动OpenClaw。如果你想省事把这几条命令写成脚本每次启动前执行一次。还有一种情况端口其实没有被占用但报错显示绑定失败。这时候要检查是不是配置里写了两个不同端口比如主服务端口和Web UI端口发生了冲突或者某个端口被防火墙策略阻止了。Windows防火墙在某些情况下会拦截非本地回环地址的监听尤其是你配置了0.0.0.0作为监听地址时。解决方法是给防火墙添加放行规则或者把监听地址改成127.0.0.1。5.2 启动后立刻退出窗口一闪而过如果你双击启动脚本发现窗口一闪而过说明程序启动就报错了并直接退出。这时候最有效的办法是不双击改成在命令行里手动运行这样错误信息就不会被吞掉。cd /d D:\openclaw venv\Scripts\activate python main.py运行后你会看到具体的错误信息最常见的几种ModuleNotFoundError: No module named xxx缺少依赖执行pip install -r requirements.txt或者单独安装缺失的包。Port 8080 already in use端口冲突按上一节方法处理。Failed to connect to Ollama at http://localhost:11434模型服务没启动先启动Ollama再启动OpenClaw。Invalid API key云端API密钥配错了检查.env文件。还有一种隐蔽问题OpenClaw启动过程中需要读写配置文件或创建工作目录如果程序所在路径没有写入权限比如放在C:\Program Files目录下会报权限错误。解决办法是把OpenClaw放在用户级目录下比如D:\openclaw或C:\Users\你的用户名\openclaw避开UAC权限限制。5.3 关闭后进程仍然存活、反复重启这个问题的根源通常是NSSM服务配置了服务停止后自动重新启动的恢复策略或者任务计划程序设置了如果任务失败则重新启动。当服务管理器认为一次意外终止发生了就会按照恢复策略重新拉起来。解决办法有两个方向。如果你想彻底关掉OpenClaw直接停掉服务或任务计划就行如果你想保留开机自启但需要临时停止它一定要用停用而非结束任务否则任务计划程序可能因为任务异常退出而自动重试。对于NSSM服务关闭前先确认系统日志里没有PID冲突。只要nssm stop返回成功状态变成已停止通常就没问题了。5.4 关闭后端口释放慢的排查思路在Windows上执行关闭后端口偶尔不会立刻释放原因是TCP连接进入TIME_WAIT状态。这个状态是TCP协议的正常行为通常持续几十秒到几分钟。如果你急着要重启OpenClaw可以通过调整注册表缩短TIME_WAIT时间HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters 新建 DWORD 值 TcpTimedWaitDelay设为 30十进制这个操作需要重启Windows才能生效。或者干脆在开发测试阶段每次关闭后等一会儿再启动顺手把日志看一下心态反而更稳。注意修改TCP参数会影响所有使用TCP的网络连接不只是OpenClaw。如果没有把握不建议乱调注册表。端口释放慢的问题在大多数情况下等几十秒就自然解决了没必要为此折腾系统设置。5.5 容易忽略的Windows路径与编码问题Windows和Linux最大的隐性问题之一就是路径分隔符和文件编码。OpenClaw配置里如果写了路径建议统一用正斜杠/或者双反斜杠\\不要在单个反斜杠上翻车。还有一个Windows独有的大坑如果你的用户名或路径包含非ASCII字符比如中文用户名张三OpenClaw的某些日志和临时文件在处理时可能遇到编码错误。最省心的方案是把OpenClaw放在一个纯英文路径下比如D:\OpenClawService\openclaw既方便命令行定位也避免编码问题。另外Windows默认的终端编码是GBK而OpenClaw日志输出通常是UTF-8。你可能会看到日志里中文变成乱码。解决方案是在启动前执行chcp 65001把代码页切换成UTF-8然后再启动OpenClaw日志显示就正常了。这个操作只对当前终端窗口生效不影响系统设置。6. 从手动到自动化启动关闭脚本的经验补充在NSSM或者任务计划程序的方案之上我强烈建议你再配一个通用的控制脚本把启动、停止、重启、状态检查封装成一条命令。这不仅仅是省事更是防止自己在手忙脚乱中操作失误。下面这个批处理脚本是我实际用的放在OpenClaw根目录下echo off setlocal set SERVICE_NAMEOpenClawService if %1start ( echo Starting OpenClaw service... nssm start %SERVICE_NAME% goto :eof ) if %1stop ( echo Stopping OpenClaw service... nssm stop %SERVICE_NAME% goto :eof ) if %1restart ( echo Restarting OpenClaw service... nssm restart %SERVICE_NAME% goto :eof ) if %1status ( sc query %SERVICE_NAME% goto :eof ) echo Usage: openclaw.bat [start^|stop^|restart^|status] endlocal有了这个脚本日常操作只需要openclaw.bat start、openclaw.bat stop这样的单条命令不用每次敲一长串NSSM参数。对于团队内部共享开发机的人来说这种统一入口能有效减少误操作。再补充一个我觉得很有价值的点无论用哪种方式启动日志一定要落盘。你可以把日志文件路径固定在一个目录里比如D:\openclaw\logs\openclaw.log然后在排查问题时直接用Get-Content -Tail 100查看最后100行。这样你不需要打开终端翻找历史输出效率高很多。我个人在实际操作中的体会是OpenClaw在Windows上的启动关闭问题80%都是进程残留、端口冲突、权限不足、编码问题这四个大类而这些问题在第一次配置环境时多花十分钟做好规范就能避免。比如坚持用虚拟环境、坚持把日志落盘、坚持在启动前检查端口这些小事积累起来能省掉后面大量的排障时间。开源自带的机制其实做得已经很完善了缺的往往是我们使用的方式是否足够克制和规范。 
长河君 · 2026/10/9 5:03:02 · 阅读 1.2k OpenClaw Windows 启动与关闭完全指南
OpenClaw Windows 启动与关闭完全指南前阵子项目里需要搭一套自动化Agent试了一圈开源方案最后落在了OpenClaw上。这东西在国内技术社区讨论不算多但在Windows上的部署体验和Linux差距比较大尤其是启动和关闭这两个看似基础的操作里面藏了不少坑。我踩了一遍把完整过程记录下来从装依赖到各种方式启动、优雅关闭再到进程清理给准备在Windows上折腾OpenClaw的朋友一条能直接走通的路线。这篇指南适合三类人第一次接触OpenClaw、想在Windows上跑通实验环境的新手已经跑起来但总是关不干净、端口被占用的普通用户以及想把启动关闭流程做成脚本、纳入自动化运维的开发者。我尽量把原理也讲清楚不只是给命令起码你遇到问题的时候知道自己大概卡在哪一环。1. 先搞清楚OpenClaw在Windows上的运行逻辑1.1 OpenClaw到底是什么为什么选WindowsOpenClaw本质上是一个面向大模型应用的自动化代理框架核心思路是让语言模型通过一组预定义的技能Skill去调用外部工具、读写文件、操作API从而完成较复杂的任务流程。你可以简单把它当成一个带工具的AI执行层上层接模型本地Ollama或云端API都行下层接各种可操作的能力模块。在电商自动化、信息整理、轻量运维脚本这类场景下非常实用相当于给你一个能稳定反复执行工作流的Agent底座。很多教程默认在Linux上跑但实际工作中大量用户主力机就是Windows。Windows上有更熟悉的IDE、更顺手的调试工具而且对于很多轻量任务来说没必要专门装一套Linux虚拟机。OpenClaw的官方文档虽然提供了跨平台支持但Windows上的细节处理往往藏在Issue里需要自己摸索。我这套环境是Windows 11 专业版Python 3.11Node.js 20 LTSOpenClaw本体用Git克隆的源码运行。后面所有操作都基于这个组合。1.2 Windows和Linux在启动关闭上的核心差异在Linux上OpenClaw通常用systemd服务托管启动、停止、开机自启都有成熟方案。Windows上没有systemd但替代方案并不少只不过很多新手不知道。常见的思路有三个用任务计划程序Task Scheduler托管这是微软官方的后台运行方案用NSSMNon-Sucking Service Manager把任意exe注册为Windows服务直接写批处理脚本配合start命令在后台跑。三者各有优缺点。任务计划程序最稳但配置界面有点繁琐NSSM功能强大适合需要服务级管理的场景批处理最轻量适合快速测试。我个人在开发阶段直接开命令行窗口跑有日志输出方便排查确认稳定之后再用NSSM封装成服务这样不用一直挂着一个控制台窗口。另外一个关键差异是Windows的进程模型。Linux下CtrlC通常能干净地终止进程但在Windows的cmd或PowerShell里如果你直接关掉控制台窗口子进程未必跟着退出经常出现端口还占着、进程还在后台跑的情况。这也是为什么关闭操作需要专门写一节来讲。提示Windows上跑OpenClaw之前先确认你的Python和Node版本符合要求。实测Python 3.8以下会直接报语法错误Node 18以下的某些依赖会编译失败。建议用Python 3.10Node 18。2. 部署前的环境准备与配置细节2.1 基础依赖安装清单OpenClaw在Windows上需要以下基础环境建议按顺序装省得后面排查交叉依赖的问题组件版本要求用途安装方式Python3.10OpenClaw核心运行环境python.org下载或wingetNode.js18 LTS部分技能模块与Web UInodejs.org下载或wingetGit任意较新版本拉取OpenClaw源码git-scm.comOllama可选最新版本地模型推理ollama.comVisual C Redistributable2015-2022某些依赖库的编译运行微软官网这里特别提醒一下Visual C Redistributable很多人漏了它。OpenClaw的部分依赖在Windows上需要编译本地扩展比如某些AI相关的Python包如果没有对应的VC运行时pip install的时候会报一些莫名其妙的错误类似Microsoft Visual C 14.0 or greater is required。这种错误跟OpenClaw本身没关系纯粹是环境缺东西补上就能过。安装Python的时候记得在安装向导里勾选Add Python to PATH。这是最容易被忽略的一步如果没勾选后面命令行里python命令会直接提示找不到。如果你已经装好了但没勾选可以手动去系统环境变量里把Python安装目录和Scripts目录加进去。2.2 拉取代码与虚拟环境创建我个人习惯用虚拟环境来隔离OpenClaw的依赖避免污染系统的Python环境。如果你之前被Python依赖冲突折磨过这步一定别省。# 克隆OpenClaw源码 git clone https://github.com/openclaw/openclaw.git cd openclaw # 创建并激活虚拟环境Windows下 python -m venv venv venv\Scripts\activate # 安装核心依赖 pip install -r requirements.txt这一步有几个细节需要说明。第一虚拟环境一定要创建在OpenClaw的根目录内部或者你能轻易找到的地方因为后续每次启动都要先激活这个环境。第二requirements.txt里有的包体积比较大比如涉及嵌入模型的包下载时间视网络情况而定耐心等。第三如果你打算让OpenClaw调用Ollama的本地模型建议提前把Ollama装好并启动服务第一次使用的时候OpenClaw会检测本地API是否可用。2.3 配置文件准备OpenClaw运行需要一个配置文件用来指定模型来源、密钥、启用的技能模块等。在源码根目录下通常会有一个.env.example或者config.example.yaml模板复制一份改成自己的名字copy .env.example .env打开.env文件你需要根据自己的情况修改几个关键项模型接口地址如果你用Ollama本地模型填http://localhost:11434如果用云端API填对应服务的地址。API密钥云端API需要填密钥本地Ollama可以留空或者填任意值。技能目录指定想要的技能在哪里加载默认是skills/文件夹。日志级别建议调试阶段设成debug稳定后改回info。这里有一个经验之谈调试阶段日志级别一定要开debug。启动失败的时候OpenClaw的debug日志会把你引导到一个明确的错误原因比如端口冲突、模型服务未启动、配置文件字段错误。如果设成info很多信息被吞掉了排查难度直接翻倍。3. 启动OpenClaw三种常用方式与适用场景3.1 前台启动最快、最直观、最适合调试打开命令行工具cmd或PowerShell都行先激活虚拟环境再回到OpenClaw根目录直接运行venv\Scripts\activate python main.py或者有些版本用python run.py取决于你拉取的代码版本。如果不确定看根目录下的README.md里面会写明启动入口。前台启动时OpenClaw的所有日志都会直接输出到当前终端窗口包括模型加载记录、技能注册信息、任务执行的中间日志。这个方式最大的优点是你能实时看到发生什么遇到问题了直接看日志就能定位。缺点是终端窗口一关进程就没了而且CtrlC的退出响应取决于程序对信号的处理方式有时会卡在等待某个子线程退出。我建议新手前三次运行都用这个方式先把环境跑通再说。如果你想在当前这个终端窗口之外干别的可以另外开一个window互不干扰。提示如果你的OpenClaw配置了要连接Ollama或其他本地模型服务启动前先确认那个服务已经起来了。判断方法很简单浏览器打开地址如http://localhost:11434如果能看到Ollama的响应信息说明服务正常。否则OpenClaw起来后会反复重试连接模型日志里全是连接失败的报错。3.2 后台启动不挂终端把进程放后台如果你不想一直挂着一个命令行窗口可以用PowerShell的Start-Process来把OpenClaw放到后台运行Start-Process -FilePath venv\Scripts\python.exe -ArgumentList main.py -WorkingDirectory D:\openclaw -WindowStyle Hidden这样OpenClaw就在后台跑起来了没有控制台窗口。日志会写到哪去呢默认情况下可能写到当前目录的日志文件也可能什么都没写取决于你的日志配置。这里有个坑如果你用的是-WindowStyle Hidden日志不会自动保存到文件出问题的时候无从查起。更稳的做法是后台启动的同时把标准输出和错误输出重定向到文件Start-Process -FilePath venv\Scripts\python.exe -ArgumentList main.py -WorkingDirectory D:\openclaw -RedirectStandardOutput D:\openclaw\logs\stdout.log -RedirectStandardError D:\openclaw\logs\stderr.log -NoNewWindow这样即使进程在后台日志也完整地写进文件排查问题的时候直接打开log看就行。Windows后台进程有一个要注意的点如果你是在PowerShell窗口里启动的后台进程当这个PowerShell窗口被关闭时后台进程不一定跟着退。所以关窗口之前建议你用下面的方式确认一下进程状态。3.3 开机自启动让OpenClaw随系统启动自动运行如果你打算把OpenClaw当作一个长期运行的服务开机自启几乎是必须的。Windows上有两种常见做法任务计划程序和NSSM。我重点推荐NSSM因为它把OpenClaw封装成了标准的Windows服务你可以像操作其他服务一样用net start、net stop来控制还能设置失败后自动重启。首先用管理员权限的PowerShell安装NSSM并把OpenClaw注册成服务nssm install OpenClawService D:\openclaw\venv\Scripts\python.exe D:\openclaw\main.py nssm set OpenClawService AppDirectory D:\openclaw nssm set OpenClawService AppStdout D:\openclaw\logs\service_stdout.log nssm set OpenClawService AppStderr D:\openclaw\logs\service_stderr.log nssm set OpenClawService Start SERVICE_AUTO_START nssm start OpenClawService这几条命令的含义第一条把Python解释器和OpenClaw启动脚本注册为名为OpenClawService的服务第二条设置服务的工作目录第三、四条指定日志输出文件第五条设置开机自启第六条立即启动服务。注册完成之后在Windows服务管理器里就能看到OpenClawService的状态还能配置如果服务意外停止尝试重新启动的恢复策略。如果你不用NSSM也可以用任务计划程序。创建任务时触发器选计算机启动时操作选启动程序程序填D:\openclaw\venv\Scripts\pythonw.exe注意用pythonw.exe而不是python.exe这样不会弹出黑色控制台窗口参数填main.py起始于填D:\openclaw。任务计划程序的方案好处是纯系统原生不需要额外装工具缺点是故障恢复策略不如NSSM灵活服务崩溃后不会自动重启。对于要求可用性的场景我还是推荐NSSM。4. 关闭OpenClaw比启动更容易踩坑的环节4.1 标准关闭流程让程序自己善后如果是前台运行的OpenClaw直接在终端里按CtrlC正常情况下OpenClaw会捕获中断信号执行清理逻辑比如保存当前的会话状态、释放占用的端口、停止后台线程。等命令行提示符重新出现说明已经干净退出了。如果你是通过NSSM注册的服务用管理员权限的PowerShell执行nssm stop OpenClawService或者更传统的net stop OpenClawService这两个命令都会向服务发送停止信号。NSSM默认会有个等待超时默认30秒如果OpenClaw在30秒内没有正常退出NSSM会强制终止进程。这个特性可以在服务卡死的时候救急但也意味着你可能丢失一部分未保存的任务中间状态。所以如果OpenClaw正在执行一个重要的长任务建议先观察日志等它完成再手动停止服务。4.2 强制关闭进程残留与端口占用一网打尽强烈不建议一上来就强制杀进程但总会有服务卡死、响应超时的情况。这时候你需要找到OpenClaw的实际进程并结束它。常见的做法是按Win X打开Windows Terminal管理员用下面的命令找到占用端口8080或你在配置里指定的端口的进程netstat -ano | findstr :8080输出里有一列是PID比如输出显示TCP 0.0.0.0:8080 0.0.0.0:0 LISTENING 22132说明PID为22132的进程在监听8080端口。确认这个是OpenClaw的进程之后taskkill /PID 22132 /F/F表示强制终止。如果这样还杀不掉偶尔会遇到进程处于不可中断的I/O等待状态可以用taskkill /PID 22132 /F /T/T表示连同该进程的子进程一起终止。这个参数很有用因为OpenClaw经常派生多个子进程你杀掉了主进程子进程还在后台占着资源。用/T可以斩草除根。还有一种常见情况你也不知道OpenClaw的进程PID是多少但你知道端口被占了。上面的netstat方法先找端口再杀进程但对一个系统性强迫症来说还是写个一键清理脚本更舒服。下面这个脚本做得事情很简单检查8080端口是否被占用如果被占用就关掉对应进程。$port 8080 $connections netstat -ano | Select-String :$port\s.*LISTENING foreach ($conn in $connections) { $tokens $conn.ToString().Trim().Split( ) $pidVal $tokens[-1] Write-Host Killing process $pidVal on port $port taskkill /PID $pidVal /F /T }这个脚本在反复调试OpenClaw配置的时候非常实用——改完配置重新跑之前先执行一遍保证端口是干净的否则新起的服务会一直绑定失败。提示杀进程之前一定确认PID对应的进程确实是OpenClaw而不是别的程序。判断方法是在PowerShell里执行Get-Process -Id 22132查看进程名和路径。经验不足的人误杀系统进程造成蓝屏或服务崩溃的例子不在少数请务必确认。4.3 关闭之后的清理缓存、临时文件与端口状态确认OpenClaw跑久了会在本地留下一些缓存和临时文件比如会话历史、临时下载的工具输出等。定期清理可以让下一次启动更快也能减少磁盘占用。需要关注的位置通常包括OpenClaw根目录下的cache/文件夹系统临时目录%TEMP%里以openclaw开头的文件或文件夹日志文件夹里的历史日志文件建议按日期归档不要直接全删。清理之前先确认OpenClaw已经完全停止否则文件可能正在被占用清理失败。还有一个细节OpenClaw如果配置了调用Ollama的本地模型关闭OpenClaw并不会自动关闭Ollama。如果你希望彻底释放资源需要单独停止Ollama服务。Windows下安装Ollama之后它默认会在后台运行托盘图标里有退出选项命令行的方式也可以找到它的进程并关闭。如果你开启了开机自启的Ollama服务关闭OpenClaw后它还会继续占着显存和CPU。5. 常见问题排查与避坑技巧5.1 启动时报端口已被占用怎么办这个问题在调试阶段出现频率最高。原因很简单上一次OpenClaw没有干净退出进程残留占住了端口这次启动时新的实例无法绑定同一个端口。解决办法就是上面提到的三步走先netstat -ano | findstr :端口号找到PID然后taskkill /PID 进程号 /F /T强制终止最后再启动OpenClaw。如果你想省事把这几条命令写成脚本每次启动前执行一次。还有一种情况端口其实没有被占用但报错显示绑定失败。这时候要检查是不是配置里写了两个不同端口比如主服务端口和Web UI端口发生了冲突或者某个端口被防火墙策略阻止了。Windows防火墙在某些情况下会拦截非本地回环地址的监听尤其是你配置了0.0.0.0作为监听地址时。解决方法是给防火墙添加放行规则或者把监听地址改成127.0.0.1。5.2 启动后立刻退出窗口一闪而过如果你双击启动脚本发现窗口一闪而过说明程序启动就报错了并直接退出。这时候最有效的办法是不双击改成在命令行里手动运行这样错误信息就不会被吞掉。cd /d D:\openclaw venv\Scripts\activate python main.py运行后你会看到具体的错误信息最常见的几种ModuleNotFoundError: No module named xxx缺少依赖执行pip install -r requirements.txt或者单独安装缺失的包。Port 8080 already in use端口冲突按上一节方法处理。Failed to connect to Ollama at http://localhost:11434模型服务没启动先启动Ollama再启动OpenClaw。Invalid API key云端API密钥配错了检查.env文件。还有一种隐蔽问题OpenClaw启动过程中需要读写配置文件或创建工作目录如果程序所在路径没有写入权限比如放在C:\Program Files目录下会报权限错误。解决办法是把OpenClaw放在用户级目录下比如D:\openclaw或C:\Users\你的用户名\openclaw避开UAC权限限制。5.3 关闭后进程仍然存活、反复重启这个问题的根源通常是NSSM服务配置了服务停止后自动重新启动的恢复策略或者任务计划程序设置了如果任务失败则重新启动。当服务管理器认为一次意外终止发生了就会按照恢复策略重新拉起来。解决办法有两个方向。如果你想彻底关掉OpenClaw直接停掉服务或任务计划就行如果你想保留开机自启但需要临时停止它一定要用停用而非结束任务否则任务计划程序可能因为任务异常退出而自动重试。对于NSSM服务关闭前先确认系统日志里没有PID冲突。只要nssm stop返回成功状态变成已停止通常就没问题了。5.4 关闭后端口释放慢的排查思路在Windows上执行关闭后端口偶尔不会立刻释放原因是TCP连接进入TIME_WAIT状态。这个状态是TCP协议的正常行为通常持续几十秒到几分钟。如果你急着要重启OpenClaw可以通过调整注册表缩短TIME_WAIT时间HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters 新建 DWORD 值 TcpTimedWaitDelay设为 30十进制这个操作需要重启Windows才能生效。或者干脆在开发测试阶段每次关闭后等一会儿再启动顺手把日志看一下心态反而更稳。注意修改TCP参数会影响所有使用TCP的网络连接不只是OpenClaw。如果没有把握不建议乱调注册表。端口释放慢的问题在大多数情况下等几十秒就自然解决了没必要为此折腾系统设置。5.5 容易忽略的Windows路径与编码问题Windows和Linux最大的隐性问题之一就是路径分隔符和文件编码。OpenClaw配置里如果写了路径建议统一用正斜杠/或者双反斜杠\\不要在单个反斜杠上翻车。还有一个Windows独有的大坑如果你的用户名或路径包含非ASCII字符比如中文用户名张三OpenClaw的某些日志和临时文件在处理时可能遇到编码错误。最省心的方案是把OpenClaw放在一个纯英文路径下比如D:\OpenClawService\openclaw既方便命令行定位也避免编码问题。另外Windows默认的终端编码是GBK而OpenClaw日志输出通常是UTF-8。你可能会看到日志里中文变成乱码。解决方案是在启动前执行chcp 65001把代码页切换成UTF-8然后再启动OpenClaw日志显示就正常了。这个操作只对当前终端窗口生效不影响系统设置。6. 从手动到自动化启动关闭脚本的经验补充在NSSM或者任务计划程序的方案之上我强烈建议你再配一个通用的控制脚本把启动、停止、重启、状态检查封装成一条命令。这不仅仅是省事更是防止自己在手忙脚乱中操作失误。下面这个批处理脚本是我实际用的放在OpenClaw根目录下echo off setlocal set SERVICE_NAMEOpenClawService if %1start ( echo Starting OpenClaw service... nssm start %SERVICE_NAME% goto :eof ) if %1stop ( echo Stopping OpenClaw service... nssm stop %SERVICE_NAME% goto :eof ) if %1restart ( echo Restarting OpenClaw service... nssm restart %SERVICE_NAME% goto :eof ) if %1status ( sc query %SERVICE_NAME% goto :eof ) echo Usage: openclaw.bat [start^|stop^|restart^|status] endlocal有了这个脚本日常操作只需要openclaw.bat start、openclaw.bat stop这样的单条命令不用每次敲一长串NSSM参数。对于团队内部共享开发机的人来说这种统一入口能有效减少误操作。再补充一个我觉得很有价值的点无论用哪种方式启动日志一定要落盘。你可以把日志文件路径固定在一个目录里比如D:\openclaw\logs\openclaw.log然后在排查问题时直接用Get-Content -Tail 100查看最后100行。这样你不需要打开终端翻找历史输出效率高很多。我个人在实际操作中的体会是OpenClaw在Windows上的启动关闭问题80%都是进程残留、端口冲突、权限不足、编码问题这四个大类而这些问题在第一次配置环境时多花十分钟做好规范就能避免。比如坚持用虚拟环境、坚持把日志落盘、坚持在启动前检查端口这些小事积累起来能省掉后面大量的排障时间。开源自带的机制其实做得已经很完善了缺的往往是我们使用的方式是否足够克制和规范。