openclaw 详细的新手部署教程 window11 详细教程

一、安装 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 助手变成真正的社交聊天机器人。

当然，也可以直接获取已经配置好的完整项目包，解压后即可直接使用，适合想要快速上手体验的朋友。