openclaw 详细的新手部署教程 window11 详细教程
来源：互联网 2026-03-15 08:37:03一、安装 Node.js 1 打开 Node 官网下载 访问 https://nodejs.org 下载 Node.js LTS版本（建议22以上） https://download.csdn.net/download/qq_38735017/92719228 直接下载这个 2 安装 一路 Next → Next → Install。 3 检查安装 打开 CMD 或 PowerShell 输入： node -v 如果出现类似： v22.
一、安装 Node.js
首先，你需要在电脑上安装 Node.js 运行环境。很简单，分三步完成。
第一步：下载安装包。 直接访问 Node.js 官网（nodejs.org），找到并下载 LTS（长期支持）版本。当前比较推荐 v22 及以上版本，稳定性更好。
长期稳定更新的攒劲资源： >>>点此立即查看<<<
第二步：执行安装。 下载完成后，打开安装程序。安装过程无需特殊配置，一路“Next”（下一步）就好，最后点击“Install”等待安装完成。
第三步：验证安装。 安装完毕后，打开你的命令提示符（CMD）或者 PowerShell，输入以下命令并按回车：
node -v
如果屏幕上显示出版本号，比如“v22.x.x”，恭喜你，Node.js 已经成功就位了。
二、安装 OpenClaw
接下来，我们通过 Node.js 自带的包管理工具 npm 来安装 OpenClaw 核心工具。
在刚才的命令行窗口里，输入下面这条安装命令：
npm install -g openclaw
稍等片刻，等待其下载和安装完成。之后，可以通过以下命令检查是否安装成功：
openclaw --version
能看到对应的版本号输出，就说明工具已经妥妥地装好了。
三、初始化 OpenClaw
安装好后，还需要进行一次简单的初始化配置。在命令行输入：
openclaw onboard
然后跟着提示一步步操作：
1. 创建配置目录： 这一步通常直接按回车，使用默认路径即可。
2. 选择模型提供商： 系统会列出支持的 AI 模型供应商。一般情况下，输入数字“1”选择 OpenAI 就行，这是最常用且稳定的选项。
3. 输入 API KEY： 这里需要填入你从 OpenAI 获取的 API 密钥，格式类似于“sk-xxxxxxxxxxxxxxxx”。这是让 AI“活”起来的关键。
4. 为你的 AI 起个名字： 比如可以叫它 “claw-agent” 或者其他你喜欢的名字。
当看到“OpenClaw configured successfully”的提示时，就意味着初始化配置大功告成了。
四、启动 OpenClaw
现在，启动 OpenClaw 的网关服务。在命令行输入：
openclaw gateway
启动成功后，你会看到一行提示：“Gateway running on http://127.0.0.1:18789”。这说明服务已经在本地 18789 端口上运行起来了。
五、打开控制台
打开你常用的浏览器，在地址栏输入上一步看到的地址：
http://127.0.0.1:18789
回车之后，OpenClaw 的 Web 管理界面就会呈现在你面前。在这里，你可以进行各种管理操作，例如管理已配置的 AI 助手、查看运行日志、添加新的聊天机器人，甚至将其连接到 Telegram 或 WhatsApp 等社交平台。
六、测试 AI
为了确保一切工作正常，我们来做个快速测试。回到命令行，输入：
openclaw agent --message “你好”
如果部署成功，你会很快收到 AI 的回复，比如：“你好！有什么可以帮助你？” 看到这个，就说明你的 OpenClaw 环境已经完全准备就绪了。
七、常用命令
记住这几个命令，日常使用会非常方便：
启动网关服务： openclaw gateway
检查运行状态： openclaw doctor
更新 OpenClaw 版本： openclaw update
八、配置文件位置
在 Windows 系统上，OpenClaw 的所有配置文件和日志都存放在这个目录：
C:\Users\你的用户名\.openclaw
其中，“config.json”是核心配置文件，“logs”文件夹存放运行日志，“agents”文件夹则与你的 AI 助手相关。
九、常见问题
npm安装失败
如果在安装时遇到网络问题导致速度慢或失败，可以尝试切换到国内的npm镜像源。先执行：
npm config set registry https://registry.npmmirror.com
之后，再重新运行安装命令：
npm install -g openclaw
端口打不开
如果在浏览器中无法访问 18789 端口，请首先确认网关服务是否正在运行。检查一下命令行窗口，确保“openclaw gateway”命令正在执行且没有报错退出。
十、最简单总结（3条）
其实整个过程可以浓缩成三条核心指令：
1. 安装： npm install -g openclaw
2. 初始化： openclaw onboard
3. 启动： openclaw gateway
最后，用浏览器访问 127.0.0.1:18789，一切尽在掌控。
掌握了基础部署后，还可以探索更多实用玩法。比如：
1. OpenClaw Windows 一键安装脚本： 可以让你在30秒内完成所有部署，省时省力。
2. OpenClaw 搭配本地大模型（Ollama）部署教程： 完全在本地运行，无需担心网络和API费用。
3. OpenClaw 连接 Telegram 机器人搭建教程： 将你的 AI 助手变成真正的社交聊天机器人。
当然，也可以直接获取已经配置好的完整项目包，解压后即可直接使用，适合想要快速上手体验的朋友。
侠游戏发布此文仅为了传递信息，不代表侠游戏网站认同其观点或证实其描述
