openclaw 官方标准安装教程:2026 最新版全系统可复现部署指南

简介: 国内用户强烈推荐搭配 Kimi 大模型 使用,长文本处理和工具调用能力拉满;海外用户直接用 OpenAI 即可获得原生体验。现在就动手,打造你的专属 24 小时在线 AI 数字员工,所有数据都留在自己设备上,隐私安全有保障,让 AI 真正为你干活!

2026 年现象级 AI 智能体 OpenClaw 部署教程来啦!不用再到处找零散资料,这一篇就够了!

  • 全平台支持:Windows、macOS、Linux 一键部署
  • 全环境适配:国内海外网络都能流畅运行
  • 全流程覆盖:网关→认证→模型对接一站式搞定
  • 零门槛上手:小白也能跟着一步步完成

划重点:国内用户强烈推荐搭配 Kimi 大模型 使用,长文本处理和工具调用能力拉满;海外用户直接用 OpenAI 即可获得原生体验。现在就动手,打造你的专属 24 小时在线 AI 数字员工,所有数据都留在自己设备上,隐私安全有保障,让 AI 真正为你干活!

一、关于什么是OpenClaw(龙虾)?

2026 年,大模型技术演进的重心已从模型参数规模的军备竞赛,全面转向智能体端到端执行能力的构建。行业终于突破了 "能说不能做" 的长期瓶颈,从纯对话交互阶段迈入了任务自动化执行的新阶段。在开源智能体领域,有着 "龙虾" 昵称的 OpenClaw,凭借其扎实的工程实现,成功打通了从自然语言理解到实际动作执行的完整闭环。

OpenClaw 的核心技术特性:

  • 端到端任务执行引擎:内置完整的任务生命周期管理能力,实现意图理解、分层任务拆解、动态路径规划、多工具链式调用、执行结果校验与反馈的全流程自动化,零人工干预完成复杂工作流。
  • 原生系统级集成:深度适配主流操作系统,获得安全可控的系统级操作权限,支持文件系统操作、Shell 命令执行、浏览器自动化、代码编写与 CI/CD 部署、邮件与日程 API 集成等全场景系统操作。
  • 标准化多端接入协议:提供统一的交互网关,原生支持 50 + 主流即时通讯与协作平台,用户可通过现有工具链直接与智能体交互,无需改变工作习惯。
  • 分布式智能体框架:支持基于角色的多智能体协同架构,可快速构建包含不同专业能力的 AI 团队,实现复杂任务的并行处理与流水线作业。

二、安装前准备

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

三、安装OpenClaw

1、官方一键脚本安装(推荐新手,全平台)

这是最简单、最不易出错的安装方式,脚本会自动检测并安装缺失依赖。

1.1 Windows 系统

  1. 右键开始菜单,选择终端 (管理员)Windows PowerShell (管理员),在 UAC 弹窗点击 “是”。
  2. 执行官方一键安装命令:
iwr -useb https://openclaw.ai/install.ps1 | iex
  1. 国内用户若下载缓慢,可使用国内镜像加速脚本:
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
  1. 等待安装完成,全程无需手动操作,脚本会自动完成 Node.js 检测、核心程序安装、环境变量配置。

1.2 macOS / Linux / WSL2 系统

  1. 打开系统终端,直接执行官方一键安装命令:
curl -fsSL https://openclaw.ai/install.sh | bash
  1. 国内加速镜像命令:
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
  1. 等待脚本执行完成,全程自动完成环境配置。

2、包管理器安装(npm/pnpm,适合开发者)

适合已安装 Node.js 环境,想要精准控制版本的用户。

2.1 先确认 Node.js 版本,终端输入以下命令验证,需输出 >=22.0.0:

node -v

2.2 全局安装 OpenClaw(二选一即可)

  • npm 安装:
npm install -g openclaw@latest
  • pnpm 安装(速度更快,依赖更稳定):
pnpm add -g openclaw@latest

2.3 国内用户可添加镜像源加速,示例:

npm install -g openclaw@latest --registry=https://registry.npmmirror.com

四、初始化配置

  1. 安装后初始化向导

安装完成后,配置以下代码执行初始化向导

openclaw onboard --install-daemon
  1. 入门向导新手引导

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

下载 (1).png

  1. 完成引导过程中配置大模型

OpenClaw需要连接大模型才可以使用,以下是国内(海外)的常用配置:

  • Kimi API配置(国内用户优选方案)
{
  env: { KIMI_API_KEY: "sk-..." },
  agents: {
    defaults: { model: { primary: "kimi-coding/k2p5" } },
  },
}
  • OpenAI API配置(海外用户选择方案)
{
  agents: { defaults: { model: { primary: "openai/gpt-5.4" } } },
}

五、使用TUI快速体验,开始畅聊

选择TUI并敲击回车

image.png

六、配置完成后查看OpenClaw状态:

完成网关、模型通道、管理员配置(推荐添加 --install-daemon 安装后台守护进程):

  1. 执行环境诊断命令,检查安装是否完整、环境是否正常:
openclaw doctor
  1. 查看网关运行状态:
openclaw status
  1. 打开本地可视化控制台:
openclaw dashboard

七、常见问题及解决方案:未找到OpenClaw

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

node -v           # Node 是否已安装?

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

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

  • 如果未包含在 PATH 中,请将其添加到 shell 启动文件(或)中:$(npm prefix -g)/bin$PATH~/.zshrc~/.bashrc

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

然后打开一个新的终端。

八、结语

到这里,我们的 OpenClaw 全链路本地化部署之旅就圆满结束了。从最初的环境准备,到一步步解决各种问题,再到现在服务成功启动,你真的很棒!

现在,这只专属于你的 "小龙虾" 已经整装待发,它拥有完整的执行能力,并且完全由你掌控。你可以用它来自动化繁琐的工作,搭建专属的 AI 助手,甚至组建自己的 AI 团队。希望它能成为你工作和学习中的得力伙伴,陪你一起探索 AI 智能体的无限可能。

相关文章
|
6天前
|
人工智能 数据可视化 安全
王炸组合!阿里云 OpenClaw X 飞书 CLI,开启 Agent 基建狂潮!(附带免费使用6个月服务器)
本文详解如何用阿里云Lighthouse一键部署OpenClaw,结合飞书CLI等工具,让AI真正“动手”——自动群发、生成科研日报、整理知识库。核心理念:未来软件应为AI而生,CLI即AI的“手脚”,实现高效、安全、可控的智能自动化。
16517 10
王炸组合!阿里云 OpenClaw X 飞书 CLI,开启 Agent 基建狂潮!(附带免费使用6个月服务器)
|
17天前
|
人工智能 JSON 机器人
让龙虾成为你的“公众号分身” | 阿里云服务器玩Openclaw
本文带你零成本玩转OpenClaw:学生认证白嫖6个月阿里云服务器,手把手配置飞书机器人、接入免费/高性价比AI模型(NVIDIA/通义),并打造微信公众号“全自动分身”——实时抓热榜、AI选题拆解、一键发布草稿,5分钟完成热点→文章全流程!
28083 140
让龙虾成为你的“公众号分身” | 阿里云服务器玩Openclaw
|
7天前
|
人工智能 JSON 监控
Claude Code 源码泄露:一份价值亿元的 AI 工程公开课
我以为顶级 AI 产品的护城河是模型。读完这 51.2 万行泄露的源码,我发现自己错了。
4573 20
|
5天前
|
人工智能 API 开发者
阿里云百炼 Coding Plan 售罄、Lite 停售、Pro 抢不到?最新解决方案
阿里云百炼Coding Plan Lite已停售,Pro版每日9:30限量抢购难度大。本文解析原因,并提供两大方案:①掌握技巧抢购Pro版;②直接使用百炼平台按量付费——新用户赠100万Tokens,支持Qwen3.5-Max等满血模型,灵活低成本。
1412 3
阿里云百炼 Coding Plan 售罄、Lite 停售、Pro 抢不到?最新解决方案