跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PowerShellNode.jsAI

Windows 部署 OpenClaw 构建本地 AI 助手教程

在 Windows 系统上部署 OpenClaw 开源 AI 网关工具的全过程。首先安装 Node.js 和 Git 环境,使用 PowerShell 脚本一键部署 OpenClaw。接着配置硅基流动等大模型 API 密钥,修改配置文件以支持长上下文。最后通过 cpolar 内网穿透实现公网访问,使 AI 助手能跨设备控制电脑、处理文件及生成代码。教程涵盖环境搭建、模型接入及网络配置,帮助用户打造本地化全能 AI 助理。

忘忧发布于 2026/4/6更新于 2026/9/1185 浏览
Windows 部署 OpenClaw 构建本地 AI 助手教程

前言

OpenClaw 是一个开源的个人 AI 助手网关,旨在实现跨场景、跨设备的智能交互。它运行在本地电脑上,对接主流大模型(如 Claude、千问、硅基流动等),并连接通讯平台(飞书、钉钉、Telegram 等)。通过一次部署,即可实现多平台通联。

本教程将手把手带你完成 OpenClaw 在 Windows 系统上的部署,包括环境搭建、模型接入及公网访问配置。

1 什么是 OpenClaw?

OpenClaw 是一个开源的个人 AI 助手网关,2025 年 11 月正式开源。它可以运行在你的电脑或服务器上,把各种 AI 能力接入到日常使用的通讯工具中,实现一个 AI 助手,多个平台同时在线。

简单来说,OpenClaw 就像一个长在你电脑里的数字员工:你通过微信、飞书、钉钉、Telegram 发消息,它在后台操控电脑,帮你干活,发文件、查资料、写代码、控制智能家居等。

2 环境准备与依赖安装

本教程演示在 Windows 操作系统上进行部署。在运行 OpenClaw 前,必须安装 Node.js 和 Git。

2.1 安装 Node.js 环境

推荐使用 nvm 进行安装,方便切换不同版本的 Node.js。

  1. 打开 nvm-windows GitHub 仓库发布页面下载最新版本。
  2. 双击执行启动安装程序,选择同意协议,点击下一步。
  3. 选择安装目录(例如 D:\nvm),继续点击下一步。
  4. 设置 nodejs 的下载位置,建议也在 nvm 文件夹中。
  5. 一路点击下一步,直到最后点击 install。
  6. 安装完成后,打开 settings.txt 文件,添加国内镜像源:
    node_mirror: https://npmmirror.com/mirrors/node/ 
    npm_mirror: https://npmmirror.com/mirrors/npm/
    
  7. 打开 cmd 窗口,输入 nvm -v 验证版本。
  8. 依次输入以下命令,安装并启用 Node.js 22 版本及以上:
    nvm install 22
    nvm use 22.20.0
    node -v
    npm -v
    
2.2 安装 Git 环境

Git 是代码管理工具,部署时需要从 GitHub 下载源码。

  1. 打开 Git 下载页面下载安装包。
  2. 双击启动安装程序,一直点击 Next,最后点击 Install。
  3. 安装完成后,进入 cmd 窗口,输入 git --version 验证。

3 一键部署 OpenClaw

推荐使用官方提供的一键部署脚本,以 PowerShell 为例。

3.1 解决 PowerShell 执行脚本问题

打开 PowerShell,若提示禁止运行脚本,输入以下命令允许执行:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
3.2 执行一键部署脚本

在 PowerShell 终端输入如下命令:

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

等待安装完成,按键盘左右键切换到 YES,回车同意风险后选择 QuickStart。

3.3 配置 AI 模型
  1. 选择 AI 大脑供应商,推荐 MiniMax、Qwen 或硅基流动。
  2. 注册硅基流动账号,领取体验额度。
  3. 在侧边栏创建 API 密钥并复制。
  4. 回到 PowerShell 界面,选择 Custom Provider。
  5. 填写硅基流动的 Base URL:https://api.siliconflow.cn/v1
  6. 粘贴 API Key。
  7. 选择 Endpoint ID 兼容 OpenAI-compatible。
  8. 输入模型 Code(例如 Pro/MiniMaxAI/MiniMax-M2.5)。
  9. 设置模型别名,跳过 Channel 配置,选择 No 跳过技能配置。
  10. 启用 Hooks(包含命令历史、记忆功能等)。
  11. 安装 Gateway 并启动服务。
3.4 修改配置文件

如果对话出现上下文限制问题,需修改 openclaw.json 配置文件。

  1. 找到配置文件路径(例如 C:\Users\admin\.openclaw\openclaw.json)。
  2. 用记事本打开,修改 contextWindow 和 maxTokens 参数:
    "contextWindow": 200000,
    "maxTokens": 8192
    
  3. 保存并重启服务。

4 硬核实测:一句话让 AI 接管电脑替你干活

OpenClaw 能直接读取和操控你的电脑。

4.1 场景一:找回遗忘在家里的重要文件

发送消息:"我昨天在桌面上放了一个带元旦两个字的 docx 方案文件,你帮我找一下,找到后直接发送给我。" AI 会通过模拟人工操作,定位文件并通过微信发送。

4.2 场景二:写全套代码并部署跑起来

发送指令要求生成个人简历网页,并指定保存到 D 盘 resume 文件夹,然后本地运行。AI 会完成编码、部署,并提供局域网访问链接。

5 下载安装 cpolar

为了让 OpenClaw 支持公网访问,需要内网穿透工具 cpolar。

5.1 什么是 cpolar?

cpolar 是一款内网穿透工具,可以将局域网内的服务映射至公网。

5.2 下载安装 cpolar
  1. 访问 cpolar 官网下载页面,下载 64-bit 安装包。
  2. 解压后执行应用程序,一路默认安装。
  3. 打开 cmd 输入 cpolar version 确认安装成功。
5.3 注册及登录 cpolar web ui 管理界面
  1. 访问官网注册账号。
  2. 浏览器输入 http://127.0.0.1:9200 访问 Web UI。
  3. 输入账号密码登录。

6 穿透 OpenClaw 以实现公网访问

将本地 OpenClaw 服务(默认端口 18789)通过 cpolar 映射出去。

6.1 随机域名方式 (免费方案)
  1. 点击隧道管理,编辑 website 隧道。
  2. 协议选择 http,本地地址填写 18789,地区选择 China Top。
  3. 更新后查看在线隧道列表,获取公网地址。
  4. 访问时若提示 origin not allowed,需在 OpenClaw 聊天界面请求修改配置文件,允许该域名访问。
  5. 复制网关令牌,在公网界面授权设备配对。
6.2 固定域名方式
  1. 进入官网预留页面,保留二级子域名。
  2. 在隧道管理中修改域名类型为二级子域名,填写已保留的名称。
  3. 同样需要修改 OpenClaw 配置文件中的 allowedOrigins 项,允许新域名访问。
  4. 授权设备后即可使用固定域名访问。

总结

本教程介绍了基于 OpenClaw 的全能个人 AI 助手搭建过程,实现了大模型接管电脑自动执行任务,并通过 cpolar 内网穿透支持公网访问。

  • 极简部署:通过一键脚本快速安装 OpenClaw。
  • 自定义模型:零成本接入强悍的 AI 模型。
  • 全网畅联:借助 cpolar 内网穿透,打破空间限制。

安全警告: 由于 OpenClaw 拥有直接读取文件和控制鼠标键盘的最高系统执行权限,请务必保护好网关令牌和相关访问密码,切勿将其发在公开群组或分享给不信任的人,以免造成数据泄露。

目录

  1. 前言
  2. 1 什么是 OpenClaw?
  3. 2 环境准备与依赖安装
  4. 2.1 安装 Node.js 环境
  5. 2.2 安装 Git 环境
  6. 3 一键部署 OpenClaw
  7. 3.1 解决 PowerShell 执行脚本问题
  8. 3.2 执行一键部署脚本
  9. 3.3 配置 AI 模型
  10. 3.4 修改配置文件
  11. 4 硬核实测:一句话让 AI 接管电脑替你干活
  12. 4.1 场景一:找回遗忘在家里的重要文件
  13. 4.2 场景二:写全套代码并部署跑起来
  14. 5 下载安装 cpolar
  15. 5.1 什么是 cpolar?
  16. 5.2 下载安装 cpolar
  17. 5.3 注册及登录 cpolar web ui 管理界面
  18. 6 穿透 OpenClaw 以实现公网访问
  19. 6.1 随机域名方式 (免费方案)
  20. 6.2 固定域名方式
  21. 总结

更多推荐文章

查看全部
  • EgoPoseFormer v2:AR/VR 第一视角人体动捕技术方案
  • KaiwuDB 3.1.0 在 Ubuntu 22.04 部署实战:TLS 配置与性能基线
  • HTML5 页面 AI 识别与安全防御技术
  • AI 变现真相:为何学百种工具仍难盈利
  • 基于 Python 的毕业设计管理系统架构与 AI 辅助开发实践
  • OpenClaw Agent Skills 核心技能推荐及安装指南
  • Python 极简教程:Java 开发者视角入门实战
  • 阿里推出 AI 编程插件 Qoder,JetBrains 集成体验一周评测
  • 环形链表检测:哈希表与快慢指针实战
  • 大模型的终局是通用还是专用?
  • 基于 LangChain 从零搭建 AI Agent 实战指南
  • R 语言零截断数据建模实战:复杂数据结构下的统计建模技术
  • 华为 OD 机试:小朋友分组最少调整次数 (Java)
  • PicView 跨平台开源图像浏览器
  • ShellCrash Web面板部署与自定义配置指南
  • 大厂 AI 产品经理招聘数据分析:薪资、门槛与核心技能要求
  • Stable Diffusion WebUI 无障碍改造:键盘导航与屏幕阅读器适配
  • LLama-Factory 结合 HuggingFace 镜像加速模型下载与微调
  • 平台、记忆、评测——AI 竞赛正在换挡
  • Hugging Face 技术主管详解 Llama 3 微调方案

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online