1. 为什么要本地部署?先搞懂这三点
在动手之前,我们先花 3 分钟搞清楚一个问题:为什么要把 OpenClaw 装在本地,而不是直接用云端版?
1. 数据隐私可控
你的聊天记录、文件内容、API 密钥全都留在自己电脑里,不用上传任何第三方服务器。这对处理敏感数据的人来说,是刚需。
2. 长期零成本
云端部署虽然方便,但 Token 消耗起来成本高——重度用户一天烧掉上百万 Token,长期下来不是小数目。本地部署搭配 Ollama 本地模型,等于一次性投入,终身免费。
3. 断网也能用
哪怕家里断网、出差飞机上,只要你电脑有电,OpenClaw 就能干活。
2. 部署前的'全家桶'准备
不管你是哪个系统,下面这几样东西必须先准备好:
核心凭证:
- 阿里云百炼 API-Key(用于调用大模型能力,新用户有免费额度)
- 获取路径:登录阿里云百炼大模型服务平台 → 密钥管理 → 创建 API-Key,生成后立即复制保存(关掉页面就看不到了)
辅助工具:
- 浏览器(Chrome/Edge 都行)
- 文本编辑器(VS Code 或记事本都够用)
- 一个加密记事本(专门存 API-Key 和 Token)
网络要求: 确保网络通畅,能正常下载依赖包(建议提前配好国内镜像,后面有命令)
3. Windows 11 本地部署(最全版本)
第一步:以管理员身份打开 PowerShell
右键点击开始菜单 → 选择'Windows PowerShell(管理员)',这一步很重要,否则后面会权限报错。
第二步:解锁执行策略
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force
输入这行命令,回车,看到没有任何报错就行。
第三步:一键安装核心依赖
# 安装 Node.js 22+(OpenClaw 运行必须)
winget install OpenJS.NodeJS.LTS --version 22.2.0
# 安装 Python 3.9(部分 Skill 依赖)
winget install Python.Python.3.9
# 安装 Git(拉取代码用)
winget install Git.Git
如果 winget 命令报错,可以去官网手动下载安装: Node.js 官网:https://nodejs.org(选 LTS 版,安装时勾选'Add to PATH') Python 官网:https://python.org(选 3.9+,安装时勾选'Add Python.exe to PATH')
第四步:验证安装
node --version # 应显示 v22.x.x
npm --version # 应显示 10.x.x
python --version # 应显示 Python 3.9.x
如果版本都对,继续下一步。
第五步:配置国内镜像(加速下载)
npm config set registry https://registry.npmmirror.com
这步能让你后面安装快 3 倍以上。
第六步:全局安装 OpenClaw
npm install -g openclaw@latest

