资讯动态

Windows 11 上跑通 OpenClaw、Hermes、Codex 与 Claude Code 全记录

发布时间:2026/9/16 7:28:59 来源:尧图企业网站定制
前阵子有位同事跑来问我Windows 上到底能不能把 OpenClaw、Hermes、Codex 和 Claude 这四样都跑起来他说网上搜到的教程不是 Mac 就是 Linux自己对着敲了两行命令就开始报错心态直接崩了。我仔细想了想这几个名字确实容易让人混淆——它们天天在技术群刷屏但分别解决什么问题、该先装哪个、装完怎么组合很少有人一次讲清楚。这篇文章是我最近在 Windows 11 上把这四个工具从零到一跑通的完整记录。简单说OpenClaw 负责把 AI 能力编排成自动化任务Hermes 是社区里热度很高的开源模型方向Codex 和 Claude Code 则是两类主流的终端编程助手。如果你也想在 Windows 上体验它们甚至把它们放进日常开发流程这篇应该能帮你省掉不少折腾时间。1. 先把四个工具的角色分清楚不是同一个东西别装混了很多人一上来就四个一起装装到一半开始困惑为什么 OpenClaw 装完没有聊天窗口为什么 Hermes 跑起来那么吃内存其实这几个工具定位完全不同先花两分钟搞懂彼此关系后面会顺很多。OpenClaw是一个开源的 Agent 编排框架社区里也常喊它“龙虾”。它的核心思路是把 Claude、DeepSeek 这类模型的能力包装成可编排的自动化任务让模型根据你的指令去调用工具、执行流程。它本身不是一个聊天框更像一个“任务调度中心”。Hermes严格来说是开源模型系列的名字但社区里提到“Hermes 智能体”时往往又指基于该模型搭建的 Agent 工具链。目前最热门的分支是把 Hermes 的训练思路应用到 DeepSeek 基座上的版本中文场景表现不错很多人用来跑本地智能体。它跟 OpenClaw 的关系是Hermes 可以当作 OpenClaw 的“大脑”也可以独立跑。Codex是 OpenAI 官方的终端编程助手装好之后你在命令行里用自然语言描述需求它会直接读写文件、执行命令、改代码。它跟 Copilot 那种编辑器内补全不一样定位更接近“一个懂编程的同事坐在终端里听你指挥”。Claude Code则是 Anthropic 官方的终端编程助手能力和 Codex 类似但底层模型不一样。它除了命令行模式还能接入 VS Code同时 OpenClaw 的一个常见用法就是把它后端的模型指向 Claude两者可以搭配使用。把这四个定位理清之后安装顺序也基本确定了先装基础环境再装 Codex 和 Claude Code 这两个拿来就能用的终端助手然后装 OpenClaw 做编排最后按需选择 Hermes 本地模型或者走 API。2. 开工前的基础环境Git、Node、Python 和 WSL 到底哪些是刚需我在 Windows 上跑这四个工具实际用到的基础依赖并没有想象中多。如果你只打算体验 Codex 和 Claude Code那只需要装 Node.js 和 Git如果想完整玩转 OpenClaw 和 Hermes建议再补上 Python 和 WSL。下面这份清单是我实测下来最省事的组合。Git装 Git for Windows装完命令行里执行git --version能出版本号就行。OpenClaw 从源码安装和后续更新都离不开它。Node.js建议装 LTS 版本Codex 和 Claude Code 都是 npm 全局包Node 太旧会直接装不上。装完确认node -v和npm -v都正常。Python版本建议 3.10 或更高。Hermes 相关脚本、部分本地模型工具链会用到。Windows 上可以通过py -3 --version验证。Windows Terminal强烈建议装一个。这四个工具都是命令行工具Windows Terminal 的标签页和渲染比老版控制台舒服太多多开几个会话也不会乱。WSL不是必须但如果你后续想让 OpenClaw 跑一些 Linux 生态脚本或者想用 Linux 原生的模型推理框架提前装一个 Ubuntu WSL 能省掉很多 Windows 兼容性问题。我这里指的 WSL 是把它当作可选加分项看待不是前置条件。环境变量这块容易被忽略。npm 全局安装目录如果不在 PATH 里你会遇到“装了却提示命令找不到”的诡异情况。我在 Windows 上习惯装完 Node 之后手动检查一下 PATH把%APPDATA%\npm加进去然后所有终端窗口都关掉重开再验证命令。PowerShell 执行策略也是一个绕不开的坑。Windows 默认会拦截脚本运行我遇到过几次 OpenClaw 安装脚本直接闪退的情况。解决办法是在 PowerShell 里执行下面这条命令然后允许当前用户运行本地脚本Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser这条命令的作用是本地创建的脚本可以跑从网上下载的脚本必须有签名。它不会削弱系统整体安全性只是给当前用户打开一个可控的口子。等这些基础环境全部就位后面安装四个工具基本就是一路顺畅。别小看这一步我见过很多人折腾半天不是因为工具本身难装而是 Git 没装或者 Node 版本太旧卡在第一步反复报错。3. OpenClaw 上手实测安装脚本与 Git 源码两条路都走一遍OpenClaw 现在的安装方式主要有两种官方安装脚本和从 GitHub main 分支检出源码。热词里提到“可通过安装脚本指定 git 安装方式从 github 的 main 分支检出源码进行”这句话实际上是 OpenClaw 安装文档里很关键的一段描述。我个人的建议是第一次尝试用官方安装脚本跑通了再考虑用源码方式做二次开发。安装脚本的好处是它会自动帮你检查依赖、拉取代码、安装依赖包你不用手动处理太多细节。实际执行的时候在 PowerShell 里运行官方文档给出的安装命令等待脚本跑完。脚本会做几件事检查 Node 和 Git 是否存在、把 OpenClaw 源码克隆到本地目录、执行依赖安装、然后提示你进行模型配置。如果你是想改源码或者长期跟进更新推荐用 git clone 方式。我当时的做法是git clone https://github.com/openclaw/openclaw.git cd openclaw npm install这里需要注意一点OpenClaw 的项目结构里包含多个子模块直接 clone 可能拉不全。稳妥的做法是用--recurse-submodules参数一起初始化子模块。我在第一次 clone 时没注意这个细节结果启动时一直提示找不到某个核心模块花了半小时排查才反应过来是子模块缺失。安装完成之后第一次启动前需要配置模型后端。OpenClaw 支持通过配置文件对接 Claude、DeepSeek、OpenAI 兼容接口等。配置文件一般在用户目录下的.openclaw文件夹里格式是 TOML类似这样[model] provider claude api_key sk-... model_name claude-sonnet-4-5如果是用 DeepSeek 或者 OpenAI 兼容接口provider 换成对应的名称API 地址和密钥跟着改就行。配置完成后执行openclaw启动交互界面或者通过openclaw run 你的任务描述直接让它干活。我在 Windows 上跑的时候踩了几个坑这里集中说一下路径带空格OpenClaw 的源码目录如果放在C:\Program Files这类带空格的路径下部分子进程会解析出错。建议把项目放在D:\dev\openclaw这种纯英文且无空格的路径。PowerShell 脚本拦截安装脚本如果闪退八成是执行策略问题用前面提到的Set-ExecutionPolicy解决。npm 依赖安装缓慢这个跟你当前的网络环境直接相关如果一直卡住或者报超时建议先确认 npm registry 的连通性再检查是否有其他进程占用了 npm 的缓存目录。OpenClaw 跑起来之后它能做的事情非常多。我给同事们演示过几个场景让它定时抓取某个网页内容然后生成摘要文档、让它读取指定文件夹里的图片并生成说明文字、把它接入企业微信群机器人实现自动回复。本质上只要你想清楚“输入是什么、处理逻辑是什么、输出到哪里”OpenClaw 就能帮你把这条链路自动化。社区里还有大量现成的 Skill 可以装有点类似插件市场。装好一个 Skill 之后OpenClaw 就多了一项专项能力。我在 Windows 上实测下来只要模型 API 连通Skill 的调度和文件操作都很稳定。唯一要注意的是 Skill 的配置项偶尔会依赖 Linux 命令比如rm、grep、sed这些在 Windows 原生终端里会有些兼容问题最简单的处理方式是所有跟文件处理相关的任务都放到 WSL 里跑或者干脆在 OpenClaw 配置里指定 shell 为 WSL 的 bash。4. Hermes 与 DeepSeek-Hermes本地跑模型前必须想清楚的三件事Hermes 这个方向最近讨论度很高尤其 DeepSeek-Hermes 出现之后很多人想在自己的 Windows 机器上直接跑。但本地模型和前面几个工具不一样它最考验的不是安装技巧而是硬件资源。动手之前先想清楚三件事。第一件事是你到底要模型做什么如果只是想把 Hermes 当作 OpenClaw 的本地模型后端那建议别自己硬扛推理直接走 API 方式接入 DeepSeek 官方接口就行。本地跑模型需要显卡显存足够大否则速度会慢到让你怀疑人生。如果你是想完全离线运行、不想把数据送出去那才需要考虑本地部署。第二件事是内存和显存预算。以 DeepSeek-Hermes 系列里偏小尺寸的 7B 模型为例用 GGUF 量化格式跑至少需要 8GB 以上内存理想情况是 16GB。显存方面如果你用显卡推理6GB 显存只能勉强跑量化程度比较高的版本如果只用 CPU 推理速度会慢一些但胜在门槛低。Windows 上最省事的本地模型工具是 Ollama装好后一行命令就能把模型拉下来ollama run deepseek-hermes:7b如果 Ollama 的模型仓库里没有对应的 Hermes 版本也可以去 Hugging Face 找 GGUF 文件然后用 llama.cpp 的llama-cli加载。Windows 编译好的 llama.cpp 可执行文件可以直接从 release 页面下载不需要自己编译。第三件事是中文表现和幻觉控制。DeepSeek-Hermes 的中文能力整体不错但毕竟是社区微调版本回答中偶尔会出现一本正经的胡编。我实测下来给它设定明确的角色和输出格式能显著降低幻觉概率。比如你让它总结文档一定要在提示词里写清楚“只基于输入内容回答不知道就说不确定”。我自己的选择是日常开发相关的任务全部走 Claude 或 Codex 这类云端模型Hermes 本地模型只在断网演练、隐私数据清洗、临时草稿生成这类场景使用。这样的组合能兼顾速度、质量和数据安全。另外提醒一句如果你的机器只有 8GB 内存建议直接用 API 方式体验 Hermes 的能力而不是硬上本地推理。我见过不少人在本地跑了半小时都没跑出一个完整回答最后把责任归到工具头上其实只是硬件不匹配。5. Codex CLI 安装与登录Windows 下最常见的几个报错我一次说完Codex 是这四个工具里安装最直接的因为 npm 包一行命令就搞定npm install -g openai/codex装完之后执行codex --version验证是否成功。接下来是登录运行codex login会弹出浏览器授权页面登录你的 OpenAI 账号授权完会在本地用户目录下生成一份凭据文件之后调用就靠它来识别身份。Codex 在 Windows 上最常见的报错热词里已经给出了不少线索我按出现频率排个序逐个说原因和处理办法。第一个是“Codex Windows 安装未完成”。这种情况通常发生在 npm 全局安装时终端窗口权限不足或者杀毒软件拦截了 npm 写入系统目录的操作。处理办法是用管理员身份打开 PowerShell清理 npm 缓存后重新装npm cache clean --force npm install -g openai/codex如果还是失败检查一下 npm 的 prefix 配置是否指向了一个需要管理员权限的目录常用解决方式是把全局安装目录改到当前用户目录下。第二个报错是运行任务过程中出现“Codex ran out of room in the model’s context”之类的提示。这个不是安装问题而是上下文窗口被填满了。Codex 执行任务时会把相关代码、命令行输出都塞进上下文任务越复杂上下文消耗越快。解决办法是把大任务拆成几个小任务分步执行同时尽量避免让它一次查看太多文件。我在实际使用中深有体会让它改一个模块时非常高效让它“看看整个项目然后重构”时基本一定会撑爆上下文。第三个是在终端里输中文描述时偶尔出现乱码或者编码错误。这是 Windows 默认代码页导致的建议把终端切换到 UTF-8 编码或者直接在 Windows Terminal 的设置里把默认编码改成 UTF-8问题就消失了。Codex 的好处是它不挑项目类型你可以在任何文件夹里运行它。我常用的方式是先用codex交互模式讨论方案确认思路之后再用codex exec 具体任务让它直接执行。执行过程中它会先展示准备运行的命令等你确认之后再跑这给了你一个安全阀不会一上来就乱改文件。热词里还提到“Codex 接入 DeepSeek”这个也是真实存在的玩法。Codex 的配置文件支持自定义模型供应商你可以把后端从 OpenAI 默认模型切换到 DeepSeek 的 API这样能省不少费用。配置文件一般位于~/.codex/config.toml在里面增加一个 provider 配置指向 DeepSeek 的 API 地址和模型名称就行。切换之后基础功能都能用但在工具调用稳定性和某些边界行为上还是原配的模型更省心。如果你只想快速体验不追求定制化那保持默认配置即可。我个人的建议是先原配跑两周熟悉它的行为模式之后再决定要不要折腾自定义模型。6. Claude Code 的安装、认证与 VS Code 集成从命令行到编辑器Claude Code 的安装和 Codex 非常像同样是 npm 全局包npm install -g anthropic-ai/claude-code装完执行claude就能进入交互模式。第一次运行会让你登录 Claude 账号或者设置ANTHROPIC_API_KEY环境变量。如果你同时使用 OpenClaw 并且后端配置的是 Claude那这两个工具可以共用同一个 API Key不用单独再申请一个。Windows 上 Claude Code 有一个特别容易踩的坑热词里也提到了“Claude’s workspace requires the Virtual Machine Platform on Windows”。这主要是因为 Claude Code 的某些工作区功能依赖 Windows 的虚拟机平台功能而这个功能默认是关闭的。解决办法是去控制面板的“启用或关闭 Windows 功能”里勾选“虚拟机平台”然后重启电脑。注意这只是“虚拟机平台”功能不是完整的 Hyper-V开启之后对日常使用没有明显影响。如果你打算在 VS Code 里用 Claude Code有两种方式。一种是在 VS Code 的终端里直接运行claude这样它能感知当前打开的项目结构另一种是安装官方推荐的 Claude Code 扩展通过快捷键唤起侧边栏对话。我实测下来直接在集成终端里跑体验更流畅因为文件修改、diff 查看、错误跳转都能复用 VS Code 自身的交互逻辑。Claude Code 在 Windows 上的稳定性整体不错但我遇到过两个值得注意的问题。第一个是中文路径下的项目偶尔会出现文件识别异常。如果你的项目目录带中文名或者项目里有中文文件名Claude Code 有概率读不到完整路径。这不是它故意不支持中文而是底层文件解析对字符编码的处理在 Windows 上不够统一。遇到这种情况最简单的办法是把项目路径统一改成英文。第二个是权限确认非常频繁。Claude Code 执行某些有副作用的操作比如删除文件、批量替换、执行脚本时会要求你确认这个确认过程在命令行里看起来像“卡住不动”其实是在等你输入 y 或 n。很多新手第一次用的时候以为它死机了直接 CtrlC 中断结果把任务搞到一半。遇到界面没反应先看是不是在等确认再决定下一步操作。另外Claude Code 的上下文配额是按时间和工作量动态计算的如果你在短时间内让它处理大量文件可能会遇到配额限制提示。这时候你别硬顶等一会儿再继续或者把任务拆小。我因为没注意这点曾经让它一口气重构三个模块结果干到一半就停了白等了好几分钟。如你在 Windows 上安装了多个终端工具建议给 Claude Code 单独建一个终端配置设置好启动命令和配色这样不会跟其他工具混淆。我自己的终端布局是Tab 1 跑 Claude CodeTab 2 跑 CodexTab 3 跑 OpenClawTab 4 留给 Git 命令。四个工具各占一个 Tab切换起来非常清晰。7. 四件套配合使用的工作流参考与排错清单光把工具装完不算真正体验我把它们组合进日常工作流之后才感受到这四个工具各自的不可替代性。下面这套组合方式是我目前在用的不一定适合所有人但可以给你一个参考。代码编写主力用 Claude Code。它的理解能力在复杂项目重构、跨文件修改这些场景下最稳。我会先跟它聊清楚需求边界然后让它直接改代码改完我自己 review diff。代码审查和快速补丁用 Codex。Codex 的执行风格更“莽”你给它一个明确的小任务它执行得干脆利落。比如修一个测试用例、补一个参数校验、跑一遍 lint这类任务它完成得很好。让我印象很深的是Codex 在按 Git 提交记录生成变更说明时非常高效生成的文本几乎不需要改。定时任务和自动化编排交给 OpenClaw。OpenClaw 最擅长的是把跨系统的操作串起来。我目前用它做三件事每天上午定时汇总前一晚的项目动态并生成日报监控某个数据文件夹的大小并在超过阈值时发出提醒以及把产品同学丢来的 Excel 自动转成 Markdown 表格。这些任务一旦跑顺基本就不需要我再手动操作。Hermes 本地模型作为隐私数据处理的兜底方案。涉及内部敏感数据的文本分类、脱敏、关键词提取我都会走本地模型避免数据经过外部接口。再分享一份排错清单把前面分散提到的坑汇总成一张表格方便你遇到问题的时候快速定位症状常见原因处理办法npm 安装命令找不到全局目录不在 PATH 里检查%APPDATA%\npm是否在 PATH重开终端安装脚本闪退PowerShell 执行策略限制Set-ExecutionPolicy RemoteSigned -Scope CurrentUserOpenClaw 启动缺模块子模块未拉取clone 时加--recurse-submodules或进目录执行子模块更新命令本地模型反应很慢硬件资源不足切换 GGUF 量化版本或改用 API 方式Codex 执行到一半报上下文不足单次任务包含内容太多拆任务、减少文件查看范围Claude Code 提示需要虚拟机平台Windows 功能未开启控制面板启用“虚拟机平台”后重启终端中文乱码代码页编码问题终端切换到 UTF-8 编码四个工具命令互相抢占快捷键终端多开后混淆Windows Terminal 分 Tab 管理最后再分享一个小技巧在 PowerShell 的 profile 文件里给常用工具设置别名可以省掉大量重复输入。我的 profile 里加了这几个function oc { openclaw args } function cx { codex args } function cc { claude args }保存之后重开终端以后只需要输入oc、cx、cc就能快速唤起对应工具。这个习惯帮我节省了不少时间尤其是四个工具来回切换的时候少打几个字母的体验是完全不一样的。我在 Windows 上把这些工具全部跑通之后最大的感受是环境问题永远是第一道坎但只要把基础依赖梳理清楚后面的路其实很顺畅。希望这篇记录能让你少走一些我走过的弯路把更多精力放在真正有价值的事情上。

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价