2026年OpenClaw 安装教程

科技前沿 • 2026-04-08 10:10 • 阅读 0

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

本文介绍如何在 macOS、Linux 和 Windows 上安装 OpenClaw 并启动你的第一个本地 AI Agent。提供一键安装脚本和源码构建两种方式，适合不同使用场景。

macOS：如果你计划构建应用，需要安装 Xcode 或 Command Line Tools。仅使用 CLI + Gateway 网关的话，Node.js 即可。

Windows：推荐使用 WSL2（Ubuntu）。WSL2 环境更接近 Linux，兼容性更好；原生 Windows 可以运行但工具链兼容性较差，遇到问题可参考 Windows 原生源码安装实战。

使用官方安装脚本，自动完成 CLI 安装和初始化引导。

curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

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

# 以管理员身份运行PowerShell，执行以下命令 iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

# 以管理员身份运行PowerShell，执行以下命令 iwr -useb https://openclaw.ai/install.ps1 | iex

如果你希望参与开发或需要定制构建，可以从源码安装。OpenClaw CN 引入了最新的底层安全机制与构建工具，请确保环境满足以下要求：

npm install -g pnpm

为了确保国内访问速度，请从 Gitee 镜像仓库下载。为了获得最稳定的体验，推荐切换到最新的稳定版分支：

git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git cd openclaw-cn

git clone https://github.com/openclaw/openclaw.git cd openclaw

在安装依赖前，务必设置 pnpm 镜像源，否则下载速度会很慢：

pnpm config set registry https://registry.npmmirror.com/

OpenClaw 是一个现代化的全栈应用，首次运行需要编译前端 UI 和后端核心：

# 安装依赖 (飞快 🚀) pnpm install  # 构建前端界面，首次运行时自动安装 UI 依赖 pnpm ui:build  # 构建核心服务 pnpm build

由于不是全局安装，所以请通过 pnpm openclaw … 运行仓库命令。

运行交互式初始化工具，完成 AI 模型配置（支持 DeepSeek、火山引擎等国产大模型）：

pnpm openclaw onboard –install-daemon

在向导的 Select Provider 步骤中，可以直接选择 DeepSeek，系统会自动完成配置。如需接入火山引擎方舟等其他平台，请参考火山引擎大模型接入指南。

初始化完成后，可以通过以下命令启动 Gateway 网关服务：

# 启动网关 (Gateway) pnpm openclaw gateway

如果你关闭了管理页面，可以通过以下命令再次打开：

# 打开仪表板 (Dashboard) pnpm openclaw dashboard

安装完成后，建议执行以下命令确认 OpenClaw 运行状态：

启动成功后，进入管理面板或交互式命令行，给 Agent 下达第一个指令：

"请帮我在桌面上创建一个名为 hello_openclaw.txt 的文件，并在里面写入：大道至简，实战落地。"

OpenClaw Agent 会自动规划任务、调用文件系统工具并完成操作。