在这个 AI 技术飞速发展的时代，我们不再满足于仅仅能聊天的机器人。我们渴望一个能听懂指令、能执行任务、真正帮我们处理琐事的“数字同事”。OpenClaw 正是这样一款强大的开源 AI 智能体（Agent）系统。它不仅仅是一本会说话的百科全书，更像一个拥有“手”和“脚”的超级实习生，能够操作你的电脑、管理文件、自动完成复杂的业务流程。

对于许多零基础的用户来说，本地部署听起来可能有些高深莫测，仿佛必须面对复杂的代码和晦涩的命令行。但请放心，本教程将手把手带你从零开始，一步步完成 OpenClaw 在 Windows 系统上的搭建。无论你是想用它来自动整理文件，还是构建专属的自动化工作流，这篇指南都将为你铺平道路。

准备工作：磨刀不误砍柴工

在正式安装之前，我们需要先准备好必要的“工具”。请确保你的 Windows 电脑（Win10 或 Win11）满足以下基本条件，这能避免后续出现不必要的麻烦。

• 系统环境：64位操作系统是必须的。32位系统将无法运行。

• 硬件配置：建议电脑内存至少 8GB，硬盘预留 10GB 以上的可用空间。虽然 OpenClaw 本身很轻量，但运行 AI 模型和相关依赖需要一定的资源缓冲。

• 核心依赖：你需要安装 Node.js 22.x 或更高版本的长期支持版（LTS）。这是 OpenClaw 运行的基石。

• 网络连接：稳定的互联网连接至关重要，因为我们需要下载安装包以及连接云端的 AI 大脑。

特别提示：虽然 OpenClaw 支持原生 Windows 部署，但为了获得最稳定、最完整的体验（例如更好的系统集成和文件操作权限），强烈建议 Windows 用户安装 WSL2（Windows Subsystem for Linux），并在其中安装 Ubuntu 环境来部署 OpenClaw。这听起来有点进阶，但能为你省去很多后续的排错时间。当然，如果你希望直接在 Windows 原生环境下体验，本教程也将优先介绍原生安装法。

方案一：新手首选，一键式傻瓜安装

对于不想接触任何命令行、希望最快上手的用户，官方提供了一键安装脚本。这种方式会自动检测环境并完成所有配置，就像安装普通软件一样简单。

1.  以管理员身份运行 PowerShell：点击屏幕左下角的搜索框，输入“PowerShell”。在搜索结果中的“Windows PowerShell”上右键单击，务必选择“以管理员身份运行”。这一步是为了赋予安装脚本修改系统环境的权限。

2.  调整执行策略：在弹出的黑色窗口中，粘贴并执行以下命令，然后按回车键：

    powershell

    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    系统会提示你确认更改，输入“Y”并回车。

3.  下载并执行安装脚本：回到 PowerShell 窗口，执行以下命令。这个脚本会自动下载并安装 OpenClaw 及其所有依赖（包括 Node.js）。

    powershell

    iwr -useb https://openclaw.ai/install.ps1 | iex

    如果你在国内，官方也提供了国内镜像地址，下载速度会更快：

    powershell

    iwr -useb https://clawd.org.cn/install.ps1 | iex

4.  耐心等待：安装过程通常需要 3-5 分钟。请不要关闭窗口，脚本会自动完成所有工作。

5.  验证安装：安装完成后，你可以输入 openclaw --version 来查看版本号，如果显示了具体的版本数字，恭喜你，安装成功了！

方案二：进阶手动安装（适合熟悉 Node.js 的用户）

如果你已经是一名前端开发者，或者电脑里已经配置好了 Node.js 环境，你可以选择手动安装，这样你对版本控制有更高的自由度。

1.  全局安装 OpenClaw：打开你的终端（PowerShell 或 CMD），执行以下命令：

    bash

    npm install -g openclaw

    如果你想安装中文社区维护的版本（可能包含针对国内环境的优化），可以使用：

    bash

    npm install -g openclaw-cn

2.  配置环境变量（如遇权限问题）：如果在安装过程中提示权限错误，说明 npm 的默认目录权限受限。你需要通过以下命令修改 npm 的全局安装路径，或者参考相关文档将该路径添加到系统环境变量中。

首次启动与核心配置：赋予 AI 大脑

安装仅仅是第一步，为了让 OpenClaw 能够“思考”，你必须为它配置一个云端的 AI 模型作为大脑。这一步需要你拥有一个 API Key。

1.  启动初始化向导：在终端中输入以下命令，启动配置向导：

    bash

    openclaw onboard --flow quickstart

2.  选择模型提供商：系统会列出支持的 AI 平台，例如 Kimi（月之暗面）、通义千问（阿里）、DeepSeek、智谱（GLM）或 豆包（字节）。

3.  获取 API Key：

    - 以通义千问为例：你需要访问“阿里云百炼平台”，登录后进入“密钥管理”页面，创建一个新的 API Key，并将其复制下来。

    - 以智谱为例：访问“智谱AI开放平台”，点击右上角的“API Key”，创建并复制密钥。

4.  填入密钥：回到终端的向导界面，将复制的 API Key 粘贴进去。系统会自动验证密钥的有效性。

5.  验证成功：如果显示“验证成功”，说明你的 OpenClaw 已经成功连接到了 AI 大脑。

启动服务与 Web 界面访问

配置好大脑后，我们就可以启动 OpenClaw 的核心服务了。

1.  启动网关：在终端输入以下命令：

    bash

    openclaw start

    或者指定端口：

    bash

    openclaw gateway --port 18789

2.  访问控制台：打开浏览器（推荐 Chrome 或 Edge），访问地址：http://localhost:18789。

3.  进入工作台：你会看到 OpenClaw 的 Web UI 界面。在这里，你可以看到“聊天”、“概览”、“通道”等选项。点击“聊天”，你现在就可以像和普通 AI 聊天一样，开始向它下达指令了。

进阶：绑定消息渠道（让 AI 无处不在）

OpenClaw 最强大的地方在于它可以接入你常用的通讯软件。你不需要每次都打开浏览器，直接在微信、飞书或 Telegram 里就能指挥它。

1.  选择通道：在 Web UI 的左侧菜单栏点击“通道”。

2.  添加应用：以国内用户最常用的“飞书”为例，点击“飞书”图标。

3.  创建飞书机器人：你需要前往飞书开放平台，创建一个企业自建应用，获取 App ID 和 App Secret。

4.  填入凭据：将飞书后台的 App ID 和 App Secret 填入 OpenClaw 的配置界面。

5.  启用：保存后，你的飞书好友列表中会出现一个机器人。在飞书里 @它，它就能收到你的指令并执行任务。

常见问题与排坑指南

• 问题：安装过程中提示 "Sharp" 模块加载失败。
    解决：这通常是 Node.js 版本不兼容导致的。请确保你使用的是 Node.js 22.x 版本，或者尝试删除 node_modules 文件夹后重新安装。

• 问题：启动时报错 "端口被占用"。
    解决：说明 18789 端口已经被其他程序占用。你可以通过命令 openclaw gateway --port 18888 换一个端口号启动。

• 问题：API Key 验证失败。
    解决：请检查密钥是否复制完整，或者前往对应平台确认该密钥是否已过期或被删除。

结语：你的 AI 助手已就位

恭喜你！经过以上步骤，你已经成功搭建了一个属于你自己的 OpenClaw AI 智能体。它不再是云端一个遥远的模型，而是你本地电脑上一个可以信赖的伙伴。

你可以试着给它下第一个指令：“帮我把 D 盘的‘下载’文件夹里，上周修改过的所有 PDF 文件，移动到‘文档’文件夹下的‘上周文件’目录中。” 看着它自动执行任务，你会真切地感受到 AI 自动化的魅力。

技术的世界浩瀚无垠，OpenClaw 只是你探索 AI 自动化旅程的一艘小船。希望这篇教程能帮你顺利扬帆起航。如果你在使用过程中遇到任何问题，可以查阅官方文档或加入社区寻求帮助。祝你在 AI 的世界里玩得开心！