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

OpenClaw 跨平台安装指南:Windows 与 Ubuntu

OpenClaw 是一款基于 Node.js 的本地 AI 代理工具,支持在 Windows 和 Ubuntu 系统上部署。详细记录了从环境准备到交互式配置的全流程,包括 Node.js 版本选择、全局包安装、API Key 绑定及网关服务启动。通过图文步骤演示了如何快速完成初始化向导并访问 Web 控制台,适合开发者快速搭建私有化 AI 助手环境。

NodeJser发布于 2026/3/29更新于 2026/10/2582 浏览
OpenClaw 跨平台安装指南:Windows 与 Ubuntu

OpenClaw 跨平台安装指南:Windows 与 Ubuntu

本文介绍如何在 Windows 和 Ubuntu 系统上部署 OpenClaw,从 Node.js 环境准备到完整配置。无论是 Linux 服务器还是本地开发机,都能按照本指南快速完成安装并运行。

Ubuntu 环境安装教程

在 Linux 环境下,命令行操作是主流。如果你尚未安装 Ubuntu 或对 Linux 环境不熟悉,建议先搭建好基础操作系统环境后再继续。

部署 Node.js 基础运行环境

OpenClaw 依赖 Node.js,为了保证最佳兼容性,推荐使用 Node.js 22.x 版本。

首先,下载并执行 NodeSource 提供的官方安装配置脚本,它会自动配置软件源:

curl -fsSL https://deb.nodesource.com/setup_22.x | bash -

等待脚本执行完毕并看到成功提示后,使用 apt 包管理器安装 Node.js:

apt-get install -y nodejs

安装时间视网络情况而定。完成后,验证环境是否就绪:

node -v

如果输出类似 v22.22.1 的版本号,说明环境已就绪。

全局安装 OpenClaw

将 OpenClaw 安装到全局环境中,以便在任何目录下调用。

npm install -g openclaw@latest

当终端提示 added xxx packages 时,表示依赖包已下载解压。检查版本确认程序可用:

openclaw --version

初始化向导与大模型配置

安装完成后需连接大模型。官方提供交互式配置向导。

启动初始化向导并安装守护进程:

openclaw onboard --install-daemon

此时会显示 OPENCLAW 图标及安全警告。由于 OpenClaw 拥有读取文件和执行命令的权限,系统会询问你是否了解这是一款默认面向个人的高权限工具。如果在私人机器或虚拟机中运行,选择 Yes 继续。

接着选择向导模式,为避免复杂配置项干扰,直接选择绿色的 QuickStart 模式。

进入核心步骤:选择大模型供应商。针对国内网络环境和性价比,以 Kimi 为例。使用方向键选中 Moonshot AI (Kimi K2.5) 并回车。

认证方式选择第一项,即标准的 Kimi API key (.ai)。

系统询问如何提供秘钥,选择 Paste API key now,直接在终端里粘贴。

在提示行 Enter Moonshot API key 后,右键或按快捷键粘贴之前申请好的 API Key,然后回车确认。

默认模型保持选中的 Keep current (moonshot/kimi-k2.5) 不动即可。

后续扩展功能配置,为尽快完成基础搭建,可暂时略过:

  • 在选择 Select channel 时,移动到最下方选择 Skip for now。
  • 在选择 Search provider 时,可选择 Kimi (Moonshot) 赋予联网搜索能力。
  • 询问是否现在配置 Configure skills now?,选择绿色的 No。
  • 询问是否启用 Enable hooks?,依然选择 Skip for now。

配置完成后,终端会打印出 Control UI 的控制台网址及生成的安全访问 Token。

启动网关服务并进入可视化界面

配置完成后,手动启动网关服务,指定监听端口为 18789:

openclaw gateway --port 18789

终端会刷新日志,表明网关已成功绑定端口。在浏览器地址栏输入 http://127.0.0.1:18789/(若为服务器请替换为公网 IP),回车后即可进入聊天页面。

Windows 系统环境安装

Windows 安装过程结合图形化安装包和命令行,更符合普通用户习惯。

下载并安装 Node.js 运行库

打好 Node.js 地基永远是第一步。

打开浏览器访问 Node.js 官网主页,点击绿色大按钮 Get Node.js。跳转后,Windows 用户点击左侧 Windows Installer (.msi) 按钮下载安装包。

双击 .msi 文件启动安装。欢迎界面右下角点击 Next。

阅读许可协议,勾选左下角 I accept the terms in the License Agreement,点击 Next。

选择安装路径,可点击 Change 修改到 D 盘或 E 盘,然后点击 Next。

在 Custom Setup 界面,保持默认勾选的所有组件,直接点击 Next。

看到名为 Tools for Native Modules 的界面时,务必勾选屏幕中间的框:'Automatically install the necessary tools…'。若不勾选,后续安装某些开源库时容易报错,这能省去很多麻烦。勾选完毕后点击 Next。

一切就绪,点击 Install 按钮,等待进度条跑完。

看到 Completed 界面后,点击 Finish 结束安装。

按下 Win + R 调出命令行窗口,输入:

node -v

若能打印出版本号,说明环境变量配置成功。

在 Windows 终端全局安装 OpenClaw

打开 PowerShell 或 CMD 终端(建议鼠标右键选择'以管理员身份运行')。输入以下命令:

npm install -g openclaw

等待出现 added xxx packages 字样,安装完成。

启动交互式配置向导

流程与 Ubuntu 类似,需配置连接的大模型。

在终端中输入初始化命令:

openclaw onboard

阅读安全风险提示,选择绿色的 Yes 继续。

配置模式选择第一项 QuickStart 快速模式。

更换模型供应商演示,使用方向键选中 MiniMax,该模型在处理长文本和逻辑推理方面表现不错。

进入认证方式选择,为保证稳定性,请选择带有国内节点标识的 MiniMax M2.5 (CN) 选项。

系统询问如何输入 API 秘钥,选择 Paste API key now。

将 MiniMax 开放平台申请的秘钥复制过来,在终端里右键点击即可粘贴,然后回车。

默认模型设置保持高亮的 Keep current (minimax-cn/MiniMax-M2.5) 选项并回车。

高级配置选项,新手可全部跳过:

  • 接入渠道选择 Skip for now。
  • 搜索引擎服务选择 Skip for now。
  • 是否配置技能选择 No。
  • 是否启用自动化钩子选择 Skip for now。

等待片刻,你会看到 Gateway 网关服务已安装成功,并列出了本地存储路径。

一键孵化并访问 Web 控制台

向导最后询问如何孵化机器人,选择中间那一项 Open the Web UI。

选择后,终端开始吐出后台运行日志,表明私有大模型网关正在运转。同时,Windows 默认浏览器会自动弹出新标签页,指向 http://127.0.0.1:18789。这就是本地 AI 聊天控制台,可以直接开始对话。

目录

  1. OpenClaw 跨平台安装指南:Windows 与 Ubuntu
  2. Ubuntu 环境安装教程
  3. 部署 Node.js 基础运行环境
  4. 全局安装 OpenClaw
  5. 初始化向导与大模型配置
  6. 启动网关服务并进入可视化界面
  7. Windows 系统环境安装
  8. 下载并安装 Node.js 运行库
  9. 在 Windows 终端全局安装 OpenClaw
  10. 启动交互式配置向导
  11. 一键孵化并访问 Web 控制台

更多推荐文章

查看全部
  • OpenClaw 本地 AI 智能体:从部署到实战指南
  • Java 并发编程基石:深入理解 synchronized 与 volatile 关键字
  • Trae AI IDEA 插件实战指南:Java 开发效率提升
  • C/C++ 全局变量跨文件机制与底层原理
  • JavaScript 完整语法指南
  • Windows 系统彻底卸载 OpenClaw、ClawHub 及清理飞书机器人配置指南
  • MCP 协议详解:与 Function Call 的区别及实践指南
  • 2026 年全球 AI 全景分析:中美对标与算力模型应用数据
  • AI 驱动的前端开发新范式:从工具辅助到智能重构
  • Visual Studio 2026 GitHub Copilot Agent 模式深度解析
  • 多模态模型开发与应用:文本、图像与语音融合实践
  • JavaScript 数组方法:find 与 findIndex 用法详解
  • Mac 专属大模型框架 Chat with MLX:两行代码部署支持中文与本地数据
  • Kubernetes: 使用 kubectl 插件 ketall 查看所有 API 对象资源
  • 基于 SpringBoot 的超市会员积分管理系统
  • Dubbo 服务降级 Mock 机制详解
  • OFDM 完整通信链路项目 FPGA 开发:开发板硬件片内测试
  • AI 安全:Stable Diffusion 视觉提示词注入攻击原理与实现
  • Open Notebook:开源隐私优先的 AI 笔记替代方案
  • Flutter 组件 genkit 在鸿蒙平台的适配与 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