Codex 第 33 课：被虚拟化劝退？一条指令让你在 Windows 11 原生跑通 OpenClaw

从零开始掌握 OpenAI Codex——AI 编程工程 Agent。14 章覆盖认识 Codex、四种入口安装、核心功能（自动化/插件/Skill/MCP/Git/记忆）、标准工作流、实战案例和第三方模型接入。

前天，腾讯大楼底下出现了一个关于 AI 圈的奇景：为了推动这场前沿的工具革命，腾讯竟然派出了官方的工程师团队，在总部大楼广场直接“摆摊”，手把手免费为每一个路过的路人安装部署 OpenClaw。

这也难怪，最近眼馋 OpenClaw 的人实在太多了。起初我也想老老实实按照官方推荐走 WSL2 虚拟化路线，结果因为系统环境的各种虚拟化限制被按在地上摩擦。痛定思痛后，我决定转换思路：直接在 Windows 11 原生环境中硬刚。

经过一轮踩坑，我跑通了一条不需要虚拟机的原生极简安装路径。这篇文章是对这次成功安装并接入 Telegram 机器人的核心复盘，希望能帮大家少走弯路。

避坑核心心法（写在开头）

在正式动手前，请牢记以下三点“血泪教训”：

抛弃 PowerShell ：在之后的 npm 命令执行中，PowerShell 的脚本执行策略极易引发玄学拦截报错。全程请使用具有管理员权限的经典 cmd 窗口。
提前备好 Git ：很多人以为直接用 npm 就能拉取所有库，但 OpenClaw 的安装包强依赖 Git 客户端。不提前装好 Git，安装过程必然见红。
网络畅通 ：确保你的环境能无障碍访问 GitHub、npm 镜像、OpenAI API 以及 Telegram 服务器。

第一步，建立干净的运行底层。打开 cmd 执行微软官方的包管理命令：

1. 安装 Node.js

winget install OpenJS.NodeJS

（安装完成后，必须关闭当前窗口并新开一个 cmd ，输入 node -v 和 npm -v 验证是否成功读到环境变量）

2. 安装 Git

winget install —id Git.Git -e

（同样，重启 cmd 并在新窗口验证 git —version）

至此，原生的底子铺好了。

如果你直接使用常规的 npm install -g openclaw@latest，在 Windows 下十有八九会因为库依赖树的冲突报错。

在这里，原生环境能够强制安装成功的“护身符”是追加 —legacy-peer-deps 参数：

npm install -g openclaw@latest —legacy-peer-deps

这条指令能让 npm 在解析依赖时忽略那些会导致冲突的对等依赖树，强行把 OpenClaw 的核心模块塞进你的系统里。跑完后，新开一个 cmd 执行 openclaw —version，只要不报错，最难的一关就过了。

在 cmd 中输入指令启动配置向导：

openclaw onboard

接下来的交互中，我摸索出了一套最稳的“极简起步配置”：

安全确认 : 毫不犹豫选 Yes
模式 : 选 QuickStart（新手起步不建议选繁冗的进阶模式）
模型渠道 : OpenAI
认证方式 : 选择 OpenAI Codex (ChatGPT OAuth)，此时会弹出一个浏览器网页让你完成授权。完成后，默认模型保留推荐的 openai-codex/gpt-5.3-codex。
通信渠道 (Channel) : 选择 Telegram (Bot API)。随后按提示填入你从 @BotFather 那里申请来的 Bot Token。