跳到主要内容
极客日志极客日志
首页博客AI提示词GitHub精选代理工具
搜索
|注册
博客列表
JavaScriptNode.jsAI

Windows 部署 OpenClaw:本地 AI 助手搭建与公网访问指南

介绍如何在 Windows 系统上部署 OpenClaw 开源 AI 网关,集成多模型与通讯平台。通过 Node.js 环境配置、一键脚本安装及自定义 API 接入,实现本地 AI 助手构建。结合内网穿透工具实现公网访问,支持文件检索、代码生成等自动化任务。注意权限管理与 Token 安全保护。

虚拟内存发布于 2026/4/7更新于 2026/5/16 浏览
Windows 部署 OpenClaw:本地 AI 助手搭建与公网访问指南

Windows 部署 OpenClaw:本地 AI 助手搭建与公网访问指南

你是否遇到过这样的场景:想让 AI 帮忙写工作汇报,却要在 ChatGPT、飞书、钉钉之间反复切换;出门在外想调取家里电脑资料,却被局域网限制束手无策;尝试接入不同的大模型,却被复杂的 API 配置劝退……

OpenClaw 是一个开源的个人 AI 助手网关,旨在解决上述痛点。它运行在你的 Windows 电脑上,既是 AI 能力的中转站,能对接 Claude、千问、硅基流动等主流大模型;也是通讯平台的连接器,可同时接入飞书、钉钉、Telegram 等常用工具。通过这份教程,我们将从环境搭建到公网访问,带你完成从零到一的部署。

1. 什么是 OpenClaw?

OpenClaw 就像一个长在你电脑里的数字员工。你通过微信、飞书、钉钉或 Telegram 发消息,它在后台操控电脑帮你干活——发文件、查资料、写代码、控制智能家居,无所不能。自 2025 年 11 月开源以来,该项目在 GitHub 上获得了大量关注,成为增长较快的 AI 项目之一。

2. 环境准备与依赖安装

本教程基于 Windows 操作系统。在运行 OpenClaw 前,必须安装 Node.js 和 Git。虽然官方提供一键脚本,但为了确保稳定性,建议手动安装基础环境。

2.1 安装 Node.js 环境

推荐使用 nvm(Node Version Manager)进行版本管理,方便后续切换。首先访问 nvm-windows 的发布页面下载最新版本。

下载安装程序后,一路点击 Next 即可。安装完成后,打开安装目录下的 settings.txt 文件,添加国内镜像源以加速下载:

node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/

保存后,打开 CMD 窗口验证安装:

nvm -v

接着安装并启用 Node.js 22 版本及以上:

nvm install 22
nvm use 22.20.0
node -v
npm -v

2.2 安装 Git 环境

Git 是代码管理工具,部署时需要从 GitHub 拉取源码。访问 Git 官网下载 Windows 安装包,默认配置一路 Next 安装即可。

安装完成后,在终端输入以下命令验证:

git --version

3. 一键部署 OpenClaw

环境就绪后,使用官方提供的一键部署脚本最为便捷。这里以 PowerShell 为例。

3.1 解决 PowerShell 执行策略问题

首次运行脚本可能会提示禁止运行脚本,这是因为 PowerShell 默认安全策略限制。我们需要修改当前用户的执行策略:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

确认后重新打开 PowerShell 即可正常执行。

3.2 执行部署脚本

在 PowerShell 终端输入以下命令开始安装:

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

脚本会自动检测环境并开始安装 OpenClaw。等待初始化完成后,按键盘左右键选择【YES】同意风险协议,然后回车进入快速开始模式。

接下来需要配置 AI 大脑供应商。推荐选择 MiniMax、Qwen 或硅基流动等平台。以硅基流动为例,你需要先注册账号并获取 API Key。

  1. 访问硅基流动控制台,领取新用户额度。
  2. 在侧边栏创建 API 密钥并复制。
  3. 回到 PowerShell 配置界面,选择【Custom Provider】。
  4. 填入 Base URL:https://api.siliconflow.cn/v1
  5. 粘贴刚才复制的 API Key。
  6. 接口类型保持默认的 OpenAI-compatible。
  7. 输入模型 Code,例如 Pro/MiniMaxAI/MiniMax-M2.5。
  8. 验证成功后设置模型别名。
  9. 通道(Channel)配置可暂时跳过,技能配置选 No,Hooks 建议全部启用。

最后启动 Gateway 服务,Web UI 会自动跳转浏览器打开。

3.3 常见问题修复

初次对话时,如果发现回答不完整或报错,通常是因为自定义模型的上下文窗口配置过小。配置文件位于用户目录下,路径类似:

C:\Users\<你的用户名>\.openclaw\openclaw.json

用记事本打开该文件,找到模型配置部分,修改以下参数:

"contextWindow": 200000,
"maxTokens": 8192

保存后重启网关服务,再次测试对话即可恢复正常。

4. 实战场景:让 AI 接管电脑

OpenClaw 的强大之处在于它能直接读取和操控你的电脑。以下是几个真实可用的场景:

场景一:远程找回遗忘的文件

人在公司,文件忘在家里电脑桌面上。只需给家里的 OpenClaw 发送指令:

我昨天在桌面上放了一个带'元旦'两个字的 docx 方案文件,你帮我找一下,找到后直接发送给我。

它会模拟人工操作,定位文件并通过微信文件传输助手发送给你。这种自动化能力比单纯的聊天机器人实用得多。

场景二:生成网页并部署

想要一个个人简历网页?你可以这样指挥:

帮我写一个个人简历的 HTML 页面,样式要现代好看。具体信息如下:姓名苏苏,求职新媒体运营... 写完后放在 D 盘 resume 文件夹,并在本地运行起来,给我一个预览链接。

它能完成代码编写、文件保存和本地服务器启动。不过此时生成的通常是局域网地址,外网无法访问。

5. 内网穿透实现公网访问

为了让 OpenClaw 随时随地可用,我们需要将其映射到公网。传统的云服务器配置复杂且昂贵,借助 cpolar 内网穿透工具可以零成本快速实现。

5.1 安装与登录

下载 cpolar 客户端并安装,CMD 输入 cpolar version 确认。注册账号后,访问本地 Web UI 管理界面:

http://127.0.0.1:9200

使用注册的账号登录。

5.2 配置隧道

随机域名方式(免费)

适合预算有限的用户。在隧道管理中新建隧道,协议选 HTTP,本地地址填 OpenClaw 端口(默认 18789),地区选择 China Top。更新后,状态页会显示生成的公网地址。

访问该地址时,如果遇到 origin not allowed 错误,说明需要允许公网域名访问。此时可直接在本地 OpenClaw 界面询问它修改配置:

我将 openclaw 的 webui 界面 18789 端口通过 cpolar 穿透至公网了,域名地址是:https://xxxx.r1.cpolar.top,但是访问页面提示 origin not allowed,请你帮我修改一下 openclaw 的配置文件允许它,改完后并且重启 openclaw 网关

修改完成后,网关会自动重启。再次访问公网地址,粘贴网关令牌进行设备配对授权,即可正常使用。

固定域名方式

如果需要长期稳定的访问地址,可以在 cpolar 官网预留二级子域名。在隧道编辑页面将域名类型改为二级子域名,填入预留的名称。后续配置与随机域名类似,只需更新允许的域名列表即可。

6. 安全警告

由于 OpenClaw 拥有直接读取文件和操控鼠标键盘的最高系统执行权限,安全性至关重要。当你将其穿透映射到公网后,请务必保护好你的网关令牌(Token)和相关访问密码,切勿将其发在公开群组或分享给不信任的人,以免造成数据泄露或被恶意篡改。


通过本教程,我们成功搭建了基于 OpenClaw 的全能个人 AI 助手。它不仅实现了跨平台的消息互通,还能在公网环境下自动执行复杂任务。30 分钟的部署成本,换来的是效率的翻倍和生活的便捷。记住,智能生活的边界已被打破,但安全始终是前提。

目录

  1. Windows 部署 OpenClaw:本地 AI 助手搭建与公网访问指南
  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 常见问题修复
  10. 4. 实战场景:让 AI 接管电脑
  11. 场景一:远程找回遗忘的文件
  12. 场景二:生成网页并部署
  13. 5. 内网穿透实现公网访问
  14. 5.1 安装与登录
  15. 5.2 配置隧道
  16. 随机域名方式(免费)
  17. 固定域名方式
  18. 6. 安全警告
  • 💰 8折买阿里云服务器限时8折了解详情
  • 💰 8折买阿里云服务器限时8折购买
  • 🦞 5分钟部署阿里云小龙虾了解详情
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 仓储AGV视觉导航:Java+YOLOv10+Spring Boot对接PLC
  • C++ 进阶核心知识点整理
  • Python 使用 FPDF 和 OpenPyXL 自动化生成 PDF 文档
  • 从 GAN 到 ChatGPT:AIGC 技术演进与实战应用指南
  • Naiz AI:从语义到像素,全链路重构视频数字孪生
  • Unity 接入 DeepSeek 实现 AI 对话的完整步骤
  • CCF-GESP 一级 C++ 真题解析:手机电量显示
  • 2025 大模型学习路线与核心资源指南
  • 多模态处理技术与大模型架构下的AI解决方案落地实践
  • 基于 Django 的教育机构师资资源管理系统设计与实现
  • JiuwenClaw AI 智能体实战:任务规划与上下文管理
  • Qwen-Image-Edit-2511 与 Stable Diffusion 图像编辑能力实测对比
  • AI 绘画 Face Fusion 人脸融合技巧与云端部署
  • ClawdBot 环境部署:vLLM 后端、Web 控制台与设备授权解析
  • 前端面试指南:技术、项目与职业规划的真心建议
  • Qt Creator 配置 GitHub Copilot AI 编程插件
  • Stable Diffusion WebUI Rembg 扩展:AI 智能背景移除工具
  • Llama-3.2-3B 部署指南:Ollama 启用 GPU 加速(CUDA/cuDNN)
  • 小米推出手机端智能体应用 MiClaw,重构智能家居底层逻辑
  • Raphael AI:全球首个无限制免费 AI 图片生成器

相关免费在线工具

  • RSA密钥对生成器

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

  • Mermaid 预览与可视化编辑

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

  • 随机西班牙地址生成器

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

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online