一、OpenClaw简介与部署前准备
OpenClaw是一款功能强大的AI本地助手,它能够在您需要的时候接管电脑控制权,帮您读取、总结、整理文档,自动打开浏览器搜索资讯要点,还支持Telegram、WhatsApp、飞书等聊天软件下达任务,具备持久化记忆能力,能像亲人朋友一样了解您及您的偏好,拥有极强的“上下文”能力,同时还支持通过插件不断扩展功能。
在开始部署OpenClaw之前,我们需要确保本地环境符合要求,为后续的安装工作打下坚实基础。
(一)系统要求
操作系统需为Windows 10 64位版本^。硬件方面,CPU至少为i5及以上,内存推荐8GB以上,若使用本地大模型则需要16GB内存,硬盘剩余空间至少20GB^。这样的配置能够保证OpenClaw在运行过程中流畅稳定,避免因硬件性能不足导致的卡顿或报错。
(二)软件环境准备
Python环境(可选):虽然部分部署方式可能不需要Python,但推荐安装Python 3.10以上版本,并确保pip为最新版本。Python环境可以为一些扩展功能提供支持,同时也方便后续可能的自定义开发。
Node.js:OpenClaw是基于Node.js的CLI工具,因此需要安装Node.js,版本要求≥22.x。在安装Node.js时,务必勾选“Add to PATH”选项,这样可以在任意终端窗口中直接使用Node.js和npm命令。安装完成后,打开PowerShell,输入
node -v和npm -v,若能正常输出版本号,则说明安装成功。Git:Git用于克隆项目代码,从Git官网下载Windows版本安装包,运行安装程序并保持默认选项即可。安装完成后,在PowerShell中输入
git --version,若显示版本号(如git version 2.x.x),则表示安装成功。PowerShell:确保PowerShell版本为5.1或更高版本,Windows 10系统一般已内置符合要求的PowerShell^。
(三)网络环境
需要保证网络环境可访问GitHub及PyPI仓库,以便下载安装所需的依赖包和模型文件。若网络受限,可提前下载好相关依赖包,在安装时手动导入。
(四)辅助工具(可选)
推荐使用DS本地部署大师,它可以自动处理依赖环境、虚拟环境和权限问题,省去手动配置的繁琐步骤,特别适合新手用户。
二、多种部署方式详解
根据用户的技术水平和需求,我们提供以下几种不同的部署方式,您可以根据自身情况选择最适合的一种。
(一)DS本地部署大师一键部署(推荐新手)
这种方式无需手动配置环境或数据库,操作简单快速,是新手用户的首选。
点击相关按钮,下载DS本地部署大师安装包并完成安装。
进入主界面后,您会看到多个可选模型,每个模型都有详细的配置要求(显存、CPU、内存、显卡等)。根据自己的电脑性能,选择最适合的版本即可。
选好模型后,选择文件存放路径,然后点击“立即安装”。软件会自动下载模型文件并配置运行环境,完全不需要手动寻找安装包或处理依赖冲突。
安装完成后,点击“立即启动”,即可进入OpenClaw操作界面。整个过程无需编写代码,小白也能轻松上手。
(二)使用Codex插件自动部署
如果您熟悉VS Code和ChatGPT,这种方式也能让您快速完成部署。
安装VS Code(或者其他IDE、CLI工具),您可以通过百度搜索VS Code官网进行下载安装^。
打开VS Code,点击商店,搜索“codex”并安装该插件^。
点击右侧栏的Codex对话窗口,登录ChatGPT(需要科学上网,具体方式请自行解决)。GPT Codex 5.3有免费额度,实测额度足够安装完OpenClaw,还有富余^。
给Codex完全访问权限,然后输入“我给你最高权限,请自动帮我部署吧”,它会自己完成部署、启动和验证工作^。
部署完成后,您需要自己去申请一个大模型的API key,国内的大模型厂商有DeepSeek、阿里、GLM、MINIMAX、字节等^。申请完成后,将API key配置到OpenClaw中即可。
您可以通过以下命令来查看OpenClaw是否启动成功:
openclaw --version
openclaw gateway health
openclaw dashboard
看到 Gateway Health OK 即表示成功^。
(三)手动部署(适合进阶用户)
手动部署需要您具备一定的技术基础,但能让您更好地掌握OpenClaw的安装和配置过程。
下载软件:打开OpenClaw的GitHub网站,下载最新版本的压缩包并解压到您想存放的文件夹。
创建运行环境:进入解压后的文件夹,双击“创建环境”或按提示操作,即可生成独立的运行空间(虚拟环境),这样可以保证OpenClaw的运行不会影响电脑上的其他程序。
安装依赖工具:OpenClaw需要一些额外工具才能运行,点击“安装依赖”,系统会自动下载和安装这些工具。如果网络较慢,也可以提前下载好工具,再放进虚拟环境进行安装。
准备数据库:默认使用SQLite,可直接初始化。如果您想使用MySQL或PostgreSQL,需要先在电脑上创建数据库,并在OpenClaw中填写数据库信息。
启动OpenClaw:点击“启动”按钮,然后打开浏览器访问指定地址即可进入OpenClaw操作界面。
(四)使用官方安装脚本一键安装
这种方式操作简单,适合大多数用户。
以管理员身份打开PowerShell,在开始菜单里搜索PowerShell,右键点击并选择“以管理员身份运行”。
在PowerShell中输入以下命令(请以官网最新指令为准):
iwr -useb https://openclaw.ai/install.ps1 | iex
脚本会自动运行,若您的电脑上未安装Node.js或版本过低,脚本会自动下载安装或升级Node.js。
接下来会出现一些选项,您可以根据自己的需求进行选择,例如选择大模型、配置通讯通道等。选择完成后,脚本会自动完成后续的安装和配置工作。
安装成功后,会自动跳出一个日志界面,并自动打开浏览器,您就可以在浏览器页面中与OpenClaw进行交互了。
三、部署后的验证与初步配置
(一)验证安装成功
无论采用哪种部署方式,都需要验证OpenClaw是否安装成功。除了前面提到的使用命令查看版本和网关健康状态外,您还可以尝试在浏览器中访问OpenClaw的操作界面,若能正常打开并进行简单的交互操作,如发送指令让OpenClaw完成某个小任务(如总结一段文本),则说明安装成功。
(二)初步配置
Token配置:您可以生成一个随机Token,并将其写入OpenClaw的配置文件中,以提高系统的安全性。在PowerShell中输入以下命令:
$token = "openclaw-gateway-$(Get-Random -Minimum 100000 -Maximum 999999)"
openclaw config set gateway.auth.token $token
openclaw config set gateway.port 18789
配置文件会生成到C:\Users\<你的用户名>\.openclaw\openclaw.json下。 2. 启动测试:设置环境变量OPENCLAW_GATEWAY_TOKEN为前面生成的Token,然后启动OpenClaw网关:
$env:OPENCLAW_GATEWAY_TOKEN="前一个步骤生成的TOKEN"
openclaw gateway --port 18789 --verbose --allow-unconfigured
在浏览器中输入http://127.0.0.1:18789/#token=openclaw-gateway-504467(请将token替换为您实际生成的Token),即可访问OpenClaw的操作界面。 3. 通讯通道配置(可选):如果您想通过飞书、钉钉等聊天软件下达任务,可以进行相应的通讯通道配置。以飞书为例,您可以使用以下命令安装飞书插件:
openclaw plugins install @m1heng-clawd/feishu
如果安装过程中出现错误,可以尝试手动安装,具体步骤可参考相关文档。 </doc_start> 以上教程详细介绍了在Windows 10系统上本地部署OpenClaw的多种方式,从部署前的准备工作到具体的安装步骤,再到部署后的验证与初步配置,每一个环节都有清晰的说明。无论您是新手用户还是进阶用户,都能从中找到适合自己的部署方法。希望这份教程能帮助您顺利完成OpenClaw的部署,开启高效的AI办公之旅。