OpenClaw Windows本地部署实战：零基础完成智能Agent环境配置

1. 项目概述OpenClaw 是什么为什么值得在 Windows 上本地部署OpenClaw 不是一个“又一个大模型前端界面”它本质上是一套面向中文工作流深度优化的智能代理Agent运行时框架。我第一次在 GitHub 上看到它的 README 时第一反应是“这东西终于把‘让 AI 真正干活’这件事从概念拉到了可执行层面。” 它不像传统 LLM 应用那样只负责“回答问题”而是内置了任务分解、工具调用编排、多步记忆回溯、结构化输出约束等核心能力特别适合处理“写周报查数据库生成PPT初稿邮件草拟”这类跨系统、多步骤、强格式的办公自动化场景。关键词里反复出现的openclaw, windows, 本地部署, 环境配置恰恰说明了它的核心价值取向——不依赖云端 API所有逻辑、数据、敏感业务规则都跑在你自己的电脑上。这直接解决了三类人的痛点一是企业内网环境无法外连的IT管理员二是对文档隐私有硬性要求的法务/财务人员三是想在离线状态下训练自己专属工作流的个体开发者。很多人看到“Windows 本地部署”就下意识觉得“肯定比 Linux 难”其实恰恰相反。OpenClaw 的设计哲学是“降低启动门槛”它对 Windows 的适配不是“勉强支持”而是做了大量针对性优化。比如它默认使用 Windows 原生的 PowerShell 而非 bash工具链封装成 .exe 可执行文件而非 shell 脚本日志路径自动适配 %LOCALAPPDATA%甚至对中文路径、空格路径、长文件名都有专门的容错处理。我在测试机上对比过同样一套配置在 Ubuntu WSL2 里要手动 patch 三个 Python 包的路径解析逻辑而在原生 Windows 11 23H2 上只要按顺序执行四条命令就能看到openclaw serve成功启动并监听 localhost:8000。这不是“能跑”而是“跑得稳、看得懂、改得顺”。所以如果你搜索的是openclaw安装教程、openclaw本地部署、openclaw命令这些词你真正需要的不是一份“能凑合用”的指南而是一份能让你在部署完成后立刻理解每个环节“为什么这样配”、“改哪里能适配我的旧笔记本”、“出错了看哪行日志最有效”的实操手册。接下来的内容就是基于我过去三个月在 6 台不同配置 Windows 设备从 i5-8250U 8GB 内存的商务本到 Ryzen 9 7950X 64GB 内存的工作站上反复验证、踩坑、重装、调参后沉淀下来的完整记录。没有“理论上可行”只有“我亲手敲过、截图过、压测过”的细节。2. 整体设计思路与方案选型逻辑2.1 为什么放弃 Docker 方案坚持纯原生部署网络上很多教程一上来就推荐docker-compose up -d这在 Linux/macOS 上确实省事但放到 Windows 环境尤其是面向普通用户时会引入一层不可控的复杂度。我做过一组对照实验在一台刚重装系统的 Windows 10 专业版无 Hyper-V、无 WSL2上安装 Docker Desktop 需要先启用 Windows 功能、下载 WSL2 内核更新包、配置镜像源、处理wsl --update失败、再解决docker build时的权限错误……整个过程平均耗时 47 分钟且有 3 次因网络波动导致失败。而纯原生部署核心依赖只有 Python 和 Node.js这两者在 Windows 上的安装包.exe早已成熟稳定双击下一步即可完成全程离线可操作。更重要的是OpenClaw 的核心模块openclaw-core是用 Rust 编写的它编译后的二进制文件天然具备“开箱即用”特性——不需要虚拟环境隔离不依赖系统级动态库直接扔进 PATH 就能执行。这意味着当你在 CMD 里输入openclaw --version时返回的不是一堆 Python 导入错误而是一个干净的v0.8.3字符串。这种确定性对于需要快速验证想法、或在客户现场做演示的场景价值远超“看起来更现代”的 Docker 标签。2.2 Python 版本锁定为 3.11.x 的深层原因OpenClaw 的官方文档写着“支持 Python 3.9”但我在实际部署中发现3.12 的新特性如TaskGroup的行为变更与它底层依赖的asyncio工具链存在隐式冲突会导致openclaw skill list命令卡死在Loading skills...状态。而 3.10 及以下版本则因为typing模块的泛型语法不兼容会在pip install openclaw阶段报SyntaxError: invalid syntax。最终锁定 3.11.x是经过三轮pyenv-win切换测试后得出的结论3.11.0 到 3.11.9 之间所有版本都能完美通过openclaw test --all的全部 137 个单元测试。这里有个关键细节必须使用官方 CPython 构建版本不能用 Miniconda 或 Anaconda 的 Python。因为 Conda 的 Python 在 Windows 上会修改sys.path的初始化顺序导致 OpenClaw 的插件加载器openclaw.plugin.loaders无法正确识别~/.openclaw/skills/目录下的.py文件。我曾在一个客户的机器上花了两天排查这个问题最后发现罪魁祸首是他们 IT 部门统一推送的 Anaconda3-2023.07换成 python.org 下载的python-3.11.8-amd64.exe后问题瞬间消失。所以教程里强调“去 python.org 下载”不是为了形式主义而是基于血泪教训的硬性要求。2.3 Node.js 的角色定位不止是前端构建更是后端胶水很多人误以为 Node.js 在 OpenClaw 里只负责 Web UI 的打包这是个巨大误区。实际上OpenClaw 的openclaw-cli工具链中有 4 个核心子命令openclaw serve,openclaw skill create,openclaw config init,openclaw log tail的底层实现全部是用 TypeScript 编写的并通过esbuild打包成单文件可执行程序。这些程序在 Windows 上运行时会动态调用node.exe来执行嵌入的 JS 逻辑。这意味着Node.js 不是“可选依赖”而是和 Python 一样是运行时的一级公民。我们测试过如果只装 Python 不装 Node.jsopenclaw serve会直接报错Error: node is not installed而不是优雅降级。更关键的是Node.js 的版本选择直接影响 Web UI 的渲染性能。OpenClaw 的前端基于 React 18 Vite它对fetchAPI 的 AbortSignal 支持要求 Node.js 18.17.0。我们在一台老款 Surface Pro 4i5-6300U上测试发现用 Node.js 16.20.2 启动服务后UI 加载时间长达 12 秒且频繁出现Failed to load resource: net::ERR_CONNECTION_REFUSED换成 Node.js 18.18.2 后首屏时间降至 1.8 秒错误率归零。因此教程里明确要求“Node.js 18.17.0 或更高”这个数字不是拍脑袋定的而是 Vite 官方文档和 Chrome DevTools Network 面板共同验证过的临界点。2.4 Redis 的取舍何时必须装何时可以跳过Redis 在 OpenClaw 架构中扮演“状态中心”的角色主要服务于两个功能一是openclaw memory模块的长期记忆存储比如记住用户上周五提过的“季度预算表模板”二是openclaw queue模块的任务队列比如批量处理 100 份合同 PDF 的 OCR 请求。但如果你的使用场景是“单人、轻量、离线办公”比如只是用它来自动整理微信聊天记录、生成会议纪要那么 Redis 就是可选组件。我们做过压力测试在关闭 Redis 的情况下OpenClaw 默认会退化到使用 SQLite 作为内存后端所有功能照常运行唯一区别是“长期记忆”在重启服务后会丢失且并发任务数被限制在 3 个以内。这对个人用户完全够用。但如果你要部署在团队共享的 Windows Server 上或者需要处理每小时上千次的 API 调用那么 Redis 就成了必选项。这里有个 Windows 用户友好的细节不要去 redis.io 下载原始 tar.gz 包而应该直接使用 Microsoft 官方维护的redis-windows项目GitHub 地址microsoftarchive/redis。它提供了预编译的redis-server.exe和redis-cli.exe解压即用无需编译且对 Windows 服务注册有完善支持。我在教程里给出的sc create Redis binPath C:\redis\redis-server.exe --service-run命令就是基于这个版本实测有效的。3. 核心环境配置与实操要点详解3.1 Python 3.11.8 安装避开 Windows 的“PATH 陷阱”Windows 的 PATH 环境变量管理是本地部署中最容易翻车的第一道坎。很多用户安装完 PythonCMD 里输入python --version显示正常但一执行pip install openclaw就报ModuleNotFoundError: No module named setuptools。问题根源在于Python 官方安装包在 Windows 上默认勾选了“Add Python to environment variables”但这个选项只修改当前用户的 PATH不修改系统 PATH。而当你以管理员身份运行 CMD右键→“以管理员身份运行”时CMD 读取的是系统 PATH里面没有 Python 路径于是它会 fallback 到 Windows 自带的python.exe位于C:\Windows\py.exe这个是 Python Launcher它不认识openclaw这个包。解决方案非常简单但必须手动操作下载python-3.11.8-amd64.exe注意一定要选amd64不是 x86即使你的 CPU 是 IntelWindows 10/11 默认也是 64 位系统x86 版本在 64 位系统上会触发 WOW64 兼容层导致后续 Rust 编译的openclaw-core二进制文件无法加载。运行安装程序在第一个界面取消勾选 “Add Python to environment variables”。别担心这是为了让我们手动控制避免混乱。记住安装路径比如C:\Users\YourName\AppData\Local\Programs\Python\Python311。按WinR输入sysdm.cpl→ “高级”选项卡 → “环境变量” → 在“系统变量”区域找到Path→ 点击“编辑” → 点击“新建” → 粘贴刚才记下的完整路径 → 再新建一行粘贴C:\Users\YourName\AppData\Local\Programs\Python\Python311\Scripts这是 pip 的位置。最关键的一步点击“确定”保存后必须关闭所有已打开的 CMD/PowerShell 窗口重新打开一个新的。Windows 的环境变量是进程级继承的旧窗口不会自动刷新。提示验证是否成功打开新 CMD依次执行where python where pip python -c import sys; print(sys.version)三行命令的输出路径必须一致且版本号显示为3.11.8。如果where python返回两行说明你之前装过其他 Python必须手动删掉 PATH 里旧的路径。3.2 Node.js 18.18.2 安装如何让 Vite 前端不报错Node.js 的安装看似简单但有两个 Windows 特有的坑。第一个是 npm 的镜像源。国内用户如果直接用npm install -g openclaw-cli大概率会卡在fetchMetadata阶段因为 npm 默认源 registry.npmjs.org 在国内访问极不稳定。解决方案不是换淘宝镜像npm config set registry https://registry.npmmirror.com而是用 OpenClaw 官方推荐的cnpm阿里系它对 Windows 的符号链接symlink处理更健壮。第二个坑是corepack的启用。Node.js 16.13 内置了corepack它是用来管理pnpm/yarn等包管理器的但 OpenClaw 的前端构建脚本package.json中的build命令明确指定了pnpm而 Windows 默认不启用corepack。如果不启用执行pnpm build时会报command not found。所以安装完 Node.js 后必须立即执行# 以管理员身份运行 PowerShell Set-ExecutionPolicy RemoteSigned -Scope CurrentUser npm install -g corepack corepack enable然后验证pnpm --version是否返回8.15.4OpenClaw v0.8.3 锁定的版本。这里有个经验不要用npm install -g pnpm因为 npm 安装的 pnpm 在 Windows 上有时会丢失pnpx命令而corepack启用的 pnpm 是全功能的。我在三台不同品牌的笔记本上都复现过这个问题最终确认corepack是唯一可靠的方案。3.3 OpenClaw 主体安装pip与npm的协同作战OpenClaw 的安装不是单一命令能搞定的它是一个“Python 后端 Node.js 前端”的混合体必须分步、按序执行。很多教程把pip install openclaw和npm install -g openclaw-cli写在一起这是误导。正确的顺序是先装 Python 后端pip install openclaw0.8.3。注意必须指定0.8.3不能用。因为 0.8.4 版本引入了一个新的openclaw-webui子包它依赖uvicorn[standard]而uvicorn[standard]在 Windows 上会尝试编译cryptography包这需要 Visual Studio Build Tools普通用户根本装不上。0.8.3 是最后一个“纯 wheel 包”版本所有依赖都是预编译好的pip install10 秒内完成。再装 Node.js CLI 工具pnpm add -g openclaw-cli0.8.3。这里用pnpm而不是npm是因为pnpm的硬链接机制能节省磁盘空间且对 Windows 的长路径260 字符支持更好。openclaw-cli是命令行入口它本身不包含业务逻辑只是一个“路由器”负责把openclaw serve这样的命令转发给 Python 后端执行。最后初始化配置openclaw config init。这一步会创建~/.openclaw/config.yaml文件并询问你是否启用 Redis。如果你前面没装 Redis它会自动切换到 SQLite 模式并告诉你Using SQLite for memory storage。注意openclaw config init必须在安装完openclaw和openclaw-cli之后执行。如果先执行它会报错openclaw command not found因为此时openclaw-cli还没装系统找不到这个命令。3.4 Redis 安装与服务化让状态持久化真正落地对于需要长期记忆的用户Redis 是必选项。在 Windows 上最稳妥的方式是把它注册为 Windows 服务这样开机就能自启不用每次手动开 CMD。步骤如下去 GitHub Releases 页面下载redis-windows的最新版 ZIP比如redis-windows-7.2.5.zip解压到C:\redis。用管理员权限打开 PowerShell执行# 创建服务 sc create Redis binPath C:\redis\redis-server.exe --service-run start auto # 启动服务 sc start Redis # 设置服务描述可选但方便识别 sc description Redis OpenClaw Memory Queue Service验证服务是否运行打开“服务”管理器services.msc找到名为Redis的服务状态应为“正在运行”。如果启动失败最常见的原因是端口 6379 被占用。可以用netstat -ano | findstr :6379查看 PID再用tasklist | findstr PID找到进程名并结束它。关键配置默认的redis.windows.conf文件里bind参数是127.0.0.1这没问题但protected-mode默认是yes这会导致 OpenClaw 连接时被拒绝。必须手动编辑C:\redis\redis.windows.conf将protected-mode yes改为protected-mode no然后重启 Redis 服务sc stop Redis sc start Redis。实操心得我曾经在一个客户现场因为没关protected-mode折腾了 3 个小时。OpenClaw 的错误日志只显示Connection refused根本没提示是 Redis 的保护模式问题。后来用redis-cli -h 127.0.0.1 -p 6379 ping测试返回NOAUTH Authentication required才意识到是配置问题。所以教程里把这个步骤单独列出来并加粗强调就是为了帮你省下这 3 小时。4. 完整实操流程与核心环节实现4.1 从零开始一次成功的本地部署全流程记录现在我们把前面所有知识点串联起来走一遍完整的、可复制的部署流程。我会以一台全新的 Windows 11 专业版22H2虚拟机为蓝本记录每一步的命令、预期输出和可能的变数。这不是理想化的“教科书流程”而是包含了真实世界里你会遇到的所有分支。第一步准备阶段下载python-3.11.8-amd64.exe官网、node-v18.18.2-x64.msi官网、redis-windows-7.2.5.zipGitHub。关闭所有杀毒软件特别是 360、腾讯电脑管家它们会拦截openclaw-core的 Rust 二进制文件误报为“可疑程序”。第二步安装 Python运行python-3.11.8-amd64.exe取消勾选 “Add Python to environment variables”自定义安装路径为C:\Python311。手动添加C:\Python311和C:\Python311\Scripts到系统 PATH。新开 CMD执行python --version确认输出3.11.8。第三步安装 Node.js运行node-v18.18.2-x64.msi一路下一步。以管理员身份打开 PowerShell执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser npm install -g corepack corepack enable pnpm --version预期输出8.15.4。第四步安装 OpenClaw在 CMD 中执行pip install openclaw0.8.3 pnpm add -g openclaw-cli0.8.3 openclaw --version预期输出0.8.3。如果报错openclaw is not recognized说明openclaw-cli的 bin 目录没进 PATH检查pnpm的全局安装路径通常是%LOCALAPPDATA%\pnpm\store\...将其加入 PATH。第五步初始化与启动执行openclaw config init按提示操作当问到Use Redis for memory?时根据你是否安装了 Redis 选择y或n。执行openclaw serve。首次运行会自动下载默认技能集约 12MB需要几分钟。你会看到类似这样的输出INFO Starting OpenClaw server on http://localhost:8000 INFO Using SQLite for memory storage INFO Loaded 12 skills from ~/.openclaw/skills INFO Server started successfully!打开浏览器访问http://localhost:8000你应该能看到 OpenClaw 的 Web UI顶部显示Status: Online。第六步验证核心功能在 UI 的输入框里输入“请帮我把桌面上的Q3_Sales_Report.xlsx文件按Region列分组计算每组的Revenue总和并生成一个柱状图。”点击发送。OpenClaw 会自动调用pandas读取 Excel用matplotlib生成图表并把结果以 Markdown 表格和 PNG 图片形式返回。整个过程在 8 秒内完成证明 Python 后端、Node.js 前端、文件系统访问全部打通。4.2 技能Skill开发入门五分钟写一个“微信消息整理器”OpenClaw 的灵魂在于“技能”它把复杂的自动化逻辑封装成一个个可复用、可组合的模块。下面教你写一个最实用的技能自动整理微信导出的文本聊天记录。创建技能目录openclaw skill create wechat-cleaner这会在~/.openclaw/skills/wechat-cleaner/下生成一个标准模板包含skill.yaml、main.py、README.md。编辑skill.yamlname: 微信消息整理器 description: 将微信导出的纯文本聊天记录按日期和联系人分组提取关键信息 triggers: - 整理微信聊天 - 分析微信对话 input_schema: type: object properties: file_path: type: string description: 微信导出的 .txt 文件的绝对路径编写main.py核心逻辑简化版import re from pathlib import Path def run(skill_input): # 读取文件 text Path(skill_input[file_path]).read_text(encodingutf-8) # 正则匹配微信消息格式[2023-10-01 14:22:33] 张三你好 pattern r\[(\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2})\] ([^])(.) messages [] for match in re.finditer(pattern, text): messages.append({ time: match.group(1), sender: match.group(2), content: match.group(3) }) # 按日期分组 from collections import defaultdict grouped defaultdict(list) for msg in messages: date msg[time].split()[0] grouped[date].append(msg) # 返回结构化结果 return { summary: f共 {len(messages)} 条消息覆盖 {len(grouped)} 天, by_date: dict(grouped) }激活技能openclaw skill enable wechat-cleaner测试在 Web UI 输入“整理微信聊天文件路径是C:\Users\YourName\Desktop\wechat_export.txt”即可看到结构化输出。这个例子展示了 OpenClaw 的核心优势你不需要懂前端只需要用 Python 写业务逻辑UI 和交互由框架自动处理。skill.yaml里的triggers字段就是让 OpenClaw 的 NLU 模块能听懂你的自然语言指令。4.3 配置文件深度解析config.yaml的每一个字段都意味着什么~/.openclaw/config.yaml是 OpenClaw 的“大脑”它的每一行配置都直接影响运行行为。我们逐行解读# 服务监听地址localhost 是最安全的禁止设为 0.0.0.0 server: host: localhost port: 8000 # 如果你用 nginx 做反向代理需要设置这个前缀 base_url: / # 内存后端决定你的“记忆”存在哪 memory: backend: sqlite # 可选 redis 或 sqlite # sqlite 的路径可以指向 D 盘避免 C 盘爆满 sqlite_path: D:/openclaw/memory.db # redis 配置只有 backendredis 时生效 redis: host: 127.0.0.1 port: 6379 db: 0 # 日志级别debug 会输出所有请求详情生产环境建议 info logging: level: info # 日志文件路径便于排查问题 file: C:/Users/YourName/AppData/Local/openclaw/logs/openclaw.log # 技能市场配置决定从哪下载官方技能 skills: # 官方仓库地址可以 fork 后改成你自己的私有 Git 仓库 default_repo: https://github.com/openclaw/skills.git # 本地技能目录所有你手动创建的技能都在这里 local_path: ~/.openclaw/skills # 大模型配置OpenClaw 本身不提供模型需要你填自己的 API Key llm: provider: openai # 可选 ollama, deepseek, qwen # 这里填你的 API KeyOpenClaw 会自动加密存储 api_key: sk-... # 模型名称Ollama 用户填 llama3:8bDeepSeek 用户填 deepseek-chat model: gpt-3.5-turbo注意api_key字段的值OpenClaw 会用 Windows DPAPIData Protection API进行加密密钥绑定到你的 Windows 用户账户。这意味着即使别人拿到你的config.yaml文件也无法解密出你的 API Key。这是 OpenClaw 在 Windows 平台上做的一个非常务实的安全增强。5. 常见问题与排查技巧实录5.1 经典报错“openclaw : 无法将‘openclaw’项识别为 cmdlet、函数、脚本文件或可运行程序的名称”这是 Windows 用户遇到的最高频报错90% 的原因都出在 PATH 上。但具体原因有三种需要分层排查排查层级检查方法解决方案层级一命令是否存在在 CMD 中执行where openclaw如果返回空说明openclaw-cli没装成功重装pnpm add -g openclaw-cli层级二PATH 是否生效执行echo %PATH%看输出里是否有pnpm的 global bin 路径通常形如C:\Users\YourName\AppData\Local\pnpm\global\bin如果没有手动添加该路径到系统 PATH然后重启 CMD层级三权限冲突以管理员身份运行 CMD再执行where openclaw如果管理员 CMD 里能找到普通 CMD 里找不到说明 PATH 只加到了“系统变量”没加到“用户变量”。需要同时在两个地方添加我总结了一个“三分钟速查表”贴在工位上每次遇到这个问题就按顺序执行# 1. 确认 pnpm 全局 bin 路径 pnpm prefix -g # 2. 确认该路径是否在 PATH 中 echo %PATH% | findstr /i pnpm # 3. 如果没找到手动添加替换为你自己的路径 setx PATH %PATH%;C:\Users\YourName\AppData\Local\pnpm\global\bin /M # 4. 关闭所有 CMD重新打开再试 openclaw --version5.2 Web UI 打不开或显示空白页这通常不是 OpenClaw 的问题而是前端资源加载失败。打开浏览器的开发者工具F12切换到 Console 和 Network 标签页Console 报错Failed to load module script说明openclaw-cli没有正确构建前端资源。执行openclaw-cli build这个命令会调用 pnpm 运行 Vite 构建然后重启openclaw serve。Network 标签页里/static/开头的请求全是 404说明openclaw serve启动时没找到前端构建产物。检查~/.openclaw/webui/目录是否存在里面是否有index.html和assets/文件夹。如果没有执行openclaw-cli build。Network 标签页里/api/health返回 502说明 Python 后端没起来。回到 CMD看openclaw serve的输出是否有ERROR字样。最常见的原因是openclaw-core的 Rust 二进制文件被杀毒软件拦截临时关闭杀软或把C:\Python311\site-packages\openclaw_core目录加入白名单。5.3 技能运行超时或返回NoneOpenClaw 对每个技能的执行时间有硬性限制默认是 30 秒。如果你的技能里有time.sleep(40)或者在处理一个 2GB 的 CSV 文件就会超时。解决方案有两个临时提高超时在config.yaml的skills下添加timeout: 120 # 单位秒永久优化技能把耗时操作拆分成异步任务。OpenClaw 提供了openclaw.queue模块你可以这样写from openclaw.queue import enqueue_task def run(skill_input): # 立即返回一个任务 ID告诉用户“已提交稍后通知” task_id enqueue_task(process_large_file, skill_input) return {status: submitted, task_id: task_id}然后在后台用openclaw queue worker启动一个独立的 Worker 进程来处理这些长任务。这需要 Redis但能彻底解决超时问题。5.4 如何卸载 OpenClaw清理所有痕迹网络上搜openclaw卸载很多教程只说删掉pip uninstall openclaw这是不完整的。OpenClaw 的数据分散在多个地方Python 包pip uninstall openclaw openclaw-cli全局 Node.js 包pnpm remove -g openclaw-cli用户数据目录删除~/.openclaw/这是所有配置、技能、日志、SQLite 数据库的根目录Redis 数据如果装了停止 Redis 服务删除C:\redis\dump.rdb文件环境变量从系统 PATH 中删除C:\Python311\Scripts、C:\Python311、以及pnpm的 global bin 路径执行完以上五步你的 Windows 就恢复到了“从未安装过 OpenClaw”的状态。我之所以把卸载步骤写得这么细是因为在帮客户做技术支持时经常遇到“重装后还是老配置”的问题根源就是~/.openclaw/没删干净。6. 进阶技巧与个性化定制6.1 用 VS Code 配置 OpenClaw 开发环境调试技能就像调试普通 Python 脚本VS Code 是 Windows 上最适合 OpenClaw 开发的 IDE。配置的关键在于两点一是 Python 解释器的正确选择二是调试配置的编写。选择解释器按CtrlShiftP输入Python: Select Interpreter然后选择C:\Python311\python.exe。这确保了 VS Code 的终端和调试器都用同一个 Python 环境。创建调试配置在项目根目录~/.openclaw/skills/wechat-cleaner/下创建.vscode/launch.json{ version: 0.2.0, configurations: [ { name: Debug Skill, type: python, request: launch, module: openclaw.skill.runner, args: [--skill-path, ., --input, {\file_path\: \C:/test.txt\}], console: integratedTerminal, justMyCode: true } ] }这个配置的意思是用openclaw.skill.runner模块来运行当前目录.下的技能并传入一个模拟的输入 JSON。按 F5你就可以像调试任何 Python 脚本一样在main.py里打断点、看变量、单步执行了。6.2 将