官方标准流程版 OpenClaw 安装教程：安装与跨平台私有化部署全指南

聚焦观点集合
0 阅读4分钟

2026 年，AI 行业的核心竞争赛道，已从纯对话大模型的参数内卷，转向了智能体的落地执行能力比拼，彻底告别了仅能实现对话交互的 “嘴强王者” 时代。在全球开源智能体赛道中，被开发者们称为 “龙虾” 的 OpenClaw，凭借两大核心优势脱颖而出：

  • 一是 100% 支持私有化部署，从根源上保障用户数据隐私与安全；
  • 二是原生深度兼容官方推荐的 OpenAI、Anthropic、Kimi 等主流顶尖大语言模型，可最大化释放大模型的推理与执行能力。

本文为开发者带来覆盖 Windows、macOS、Linux 全平台的标准化部署全流程教程，全程操作零门槛、步骤可复现，手把手带你完成网关服务搭建、安全认证体系配置与官方推荐大模型的无缝对接，帮助你快速落地专属私有化 AI 智能体助理，既实现隐私数据的完全自主掌控，也能充分发挥 OpenClaw 的全场景高效执行能力。

安装前准备

  • 系统要求：Windows 10+/macOS 12+/主流 Linux 发行版（Ubuntu 22.04+ 推荐）
  • 依赖条件：Node.js ≥ v22（一键脚本会自动安装）、npm/pnpm、Git（源码安装需要）
  • 内存要求：≥ 2GB（推荐 4GB+）
  • 网络环境：需联网下载安装包和依赖
  • 权限要求：Windows 需 PowerShell 管理员权限，Linux/macOS 需 sudo 权限

第一步：安装 OpenClaw（新手入门首选，3 分钟完成）

这是官方最推荐的方式，自动检测并安装 Node.js 和所有依赖，无需手动配置环境

  • macOS / Linux

需要打开电脑终端软件，输入下面命令等待依赖和 openclaw 安装，主要依赖为 Node JS

curl -fsSL openclaw.ai/install.sh | bash

  • Windows（PowerShell 管理员模式）
  1. 以管理员身份打开 PowerShell（开始菜单搜索 PowerShell，右键选择"以管理员身份运行"）
  2. 执行以下命令：

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

  1. 等待脚本自动完成 Node.js 检测、安装和 OpenClaw 配置

第二步：入门新手引导（配置模型）

入门向导会引导你完成以下核心设置:

  1. 第一步安装成功后显示下面画面，我们选择 Yes 并回车，表示知道风险。可以用键盘方向键左右切换 Yes 或 No

  1. 选择快速安装模式 QuickStart 并敲击回车确认

  1. 选择 Model，这里我们按需选择 OpenClaw 创始人推荐的 Moonshot AI（Kimi K2.5）/ Open AI/ Anthropic 作为基础模型。（本次选择的是 Kimi K2.5 进行演示）

Moonshot AI（Kimi K2.5）配置步骤

  1. 中国用户，选择 Moonshot AI .cn 接入点

  1. 登录 Kimi 网站获取 API Key，访问 platform.moonshot.cn/console 点击登录

  1. 点击左侧的 API Key 管理，创建 API Key，复制弹出的密钥字符

  1. 回到 OpenClaw 继续配置

将复制的 API Key 贴入终端并敲击回车，然后选择 Moonshot/Kimi-K2.5 模型并敲击回车确认。

  1. 选择与 OpenClaw 聊天的载体，我们可以先跳过，使用 tui 进行体验。

  1. 选择网络搜索提供商，选择 Kimi

  1. 然后回到 Kimi 工作台，创建一个搜索专用的 API Key

  1. 复制 Key 并粘贴到 OpenClaw 配置步骤，敲击回车确认

  1. 选择你 OpenClaw 的技能和一些配置，选择 Yes

  1. 选择你想用的 Skill，按回车确认安装所有勾选的 Skills

  1. Google Places 选择 No 跳过

  1. Notion API 选择 No

  1. Open AI 语言服务选择 No

  1. Sag 服务选择 No

  1. 自动化 Hook 选择跳过

第三步：使用 TUI 快速体验，开始畅聊

选择 TUI 并敲击回车

第四步：查看 OpenClaw 状态

  1. 连续按两次 ctrl + c，先退出 TUI

  1. 输入 openclaw status 可查看当前状态

  1. 输入 openclaw gateway status 可查看 gateway 状态

  1. 输入 openclaw tui 可返回 tui 继续聊天

常见问题及解决方案：未找到 OpenClaw

  • 如果安装成功但在终端中找不到 openclaw：

node -v # Node 是否已安装？

npm prefix -g # 全局包位于何处？

echo “$PATH” # 全局二进制目录是否在 PATH 中？

  • 如果未包含在 PATH 中，请将其添加到 shell 启动文件（或）中：(npmprefix−g)/bin(npm prefix -g)/bin PATH~/.zshrc~/.bashrc

export PATH="(npmprefix−g)/bin:(npm prefix -g)/bin: PATH"

然后打开一个新的终端。

结语

至此，OpenClaw 全链路本地化部署保姆级教程全线收官，从环境配置到服务上线的全流程教学已完整闭环。恭喜你，成功完成了从 0 到 1 的私有化部署，拿下了这款开源社区顶流的智能体执行框架！

你的专属 “小龙虾” 节点已完成全链路校验，服务正式上线运行，全功能模块开放调用，支持无限制自定义二次开发与场景拓展。愿这款原生开源的智能体工具，陪你深挖 AI 落地的无限可能，在私有化智能体的探索之路上玩出更多新花样。

avatar
文章
阅读
粉丝