引言

在AI办公自动化普及的今天,OpenClaw(原名ClawdBot/Moltbot)凭借其“自然语言操控、多任务自动化执行”的核心优势,成为了个人用户打造专属AI助理的首选 。它不仅能陪你聊天,更能动手读写本地文件、执行代码,动脚联网搜索,用脑接入Qwen、OpenAI等大模型 。

很多Windows用户担心部署过程复杂,其实不然。本文将提供一份面向小白的零基础教程,手把手带你完成从环境配置到成功运行的每一步。

⚠️ 重要提示:由于OpenClaw涉及自动化操作,如果你的电脑存有重要隐私或商业资料,强烈建议使用一台备用机或虚拟机进行安装,以保障数据安全 。

第一步:安装前的环境准备

OpenClaw基于Node.js运行,且要求版本 ≥ 22 。我们需要先搭建好基础环境。

1. 安装 Node.js (LTS版本)

  1. 下载:访问 Node.js 官网,网站会自动推荐适合你系统的LTS版本(如22.x或24.x),点击下载Windows 64位安装包(.msi文件)。

  2. 安装:双击安装包,除了默认设置外,最关键的一步是务必勾选 “Add to PATH”(添加到环境变量),这样系统才能识别nodenpm命令 。

  3. 验证:安装完成后,重启你的电脑或PowerShell。然后按下 Win + R,输入 powershell 打开终端,输入以下命令:

    powershell

    node -v
    npm -v

    如果显示出版本号(如 v22.12.0),即表示安装成功 。

2. 安装Git(必需)

OpenClaw在安装插件或依赖时需要用到Git。

  1. 下载:访问 Git官网,系统会自动下载64位版本。

  2. 安装:一路默认设置即可,但需确保安装界面中勾选了 “Add Git to PATH” 选项 。

  3. 验证:在PowerShell中输入 git --version,显示版本号即成功 。

3. 安装VC++运行库(Win10 LTSC用户必看)

部分精简版系统(如Win10 LTSC)可能缺失必要的运行库。

4. 配置PowerShell执行策略(关键步骤)

Windows默认禁止运行脚本,如果不解除限制,后续的一键安装命令会报错。

  1. 右键点击开始菜单(或按 Win + X),选择 “Windows PowerShell (管理员)”

  2. 在管理员终端中输入以下命令并回车:

    powershell

    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    此时会提示是否更改执行策略,输入 Y 确认即可 。

5. (可选)配置npm镜像加速

如果你在国内下载依赖速度较慢,可以配置淘宝镜像源,大幅提升安装速度 。

powershell

npm config set registry https://registry.npmmirror.com/

第二步:一键安装OpenClaw

环境准备好后,就可以安装主角了。

  1. 打开普通权限的PowerShell:这一步不需要管理员权限,直接按 Win + S 搜索PowerShell打开即可(避免后续权限冲突)。

  2. 执行一键安装命令

    powershell

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

    *小贴士:该命令会自动下载并安装OpenClaw核心程序,耗时约3-10分钟,取决于网络状况* 。

第三步:初始化配置 (Onboarding)

安装完成后,系统通常会自动进入配置流程。如果关闭了窗口,可以手动输入以下命令启动向导 :

powershell

openclaw onboard --flow quickstart

按照提示进行配置:

  • 风险提示:出现 I understand this is powerful and inherently risky. Continue?,输入 Yes 回车 。

  • AI模型配置 (Provider):这是最关键的一步。你需要选择一个模型提供商并输入API Key。

    • 新手推荐:选择 KimiQwen(通义千问)或 Google Gemini。这些通常支持网页授权登录,无需手动复制繁琐的API Key 。

    • 进阶用户:如果你有自己的API Key(如阿里云百炼、OpenAI),选择对应选项手动填入 。

  • 通讯工具 (Channels):这里我们先选择 “Skip for now”(暂时跳过)。这是为了接入飞书、微信等外部聊天软件,我们等安装成功后再回来配置 。

  • 技能 (Skills):选择 “Yes”。这是OpenClaw的核心能力(如文件操作、代码执行),建议启用 。

配置完成后,系统会自动启动Gateway服务,并弹出一个浏览器窗口,打开OpenClaw的控制台界面 。

第四步:验证安装与常用命令

1. 访问可视化控制台

如果浏览器没有自动打开,可以手动在地址栏输入:http://127.0.0.1:18789/ 。
在这个界面里,你可以直接与AI助理对话,也可以管理插件和技能。

2. 核心服务管理命令

OpenClaw的后台服务叫做“Gateway”,掌握以下命令能帮你轻松管理它 :

  • 查看服务状态openclaw gateway status

  • 启动服务openclaw gateway start

  • 重启服务openclaw gateway restart

  • 停止服务openclaw gateway stop

  • 设为开机自启openclaw onboard --install-daemon 

3. 系统健康检查

如果遇到问题,首先运行诊断命令:

powershell

openclaw doctor

查看实时日志定位错误:

powershell

openclaw logs follow

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐