养虾指南
OpenClaw System Guide
10 分钟极速落地

OpenClaw 小龙虾
安装部署指南

OpenClaw(小龙虾)是 2026 年最火的开源 AI Agent 框架,GitHub 238K+ Stars。本指南将带你从零开始,通过 4 个简单步骤完成 OpenClaw 的安装、模型配置和聊天平台接入,支持 macOS、Linux 和 Windows 系统。无论你是零基础新手还是资深开发者,都能在 10 分钟内养好你的第一只虾。

2 核 CPU / 4 GB 内存Node.js ≥ 22macOS / Linux / WSL2

本地部署 OpenClaw 完整教程

如果你希望完全掌控自己的 AI Agent,本地部署 OpenClaw 是最佳选择。与云厂商一键部署不同,本地安装让你在自己的电脑或私有服务器上运行 OpenClaw,所有对话数据和配置信息都不会离开你的设备,非常适合对数据隐私有要求的个人用户和企业。

整个安装过程分为 4 步:首先安装 OpenClaw 主程序,然后配置一个大语言模型。当前这页推荐首选 GLM-5 和 MiniMax 2.5,次选 Qwen、GPT、Claude;接着选择一个聊天界面(Web UI 开箱即用,也可以接入 QQ、微信、Telegram 等即时通讯平台),最后安装几个实用的 Skills 扩展虾的能力。跟着下面的步骤,你很快就能养好自己的第一只虾。

第一步:安装 OpenClaw

提供三种安装方式,推荐零基础用户使用一键脚本,开发者可以选择 npm 或 Docker。

A

一键安装脚本(推荐新手)

最简单

这是最推荐的安装方式,尤其适合第一次接触 OpenClaw 的用户。脚本会自动检测你的操作系统,如果没有 Node.js 22 会自动安装,然后安装 OpenClaw 最新版本。整个过程通常只需要 30 秒。支持 macOS、所有主流 Linux 发行版和 Windows WSL2。

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

安装完成后,运行以下命令进入初始化向导。--install-daemon 参数会将 OpenClaw Gateway 注册为后台服务(macOS 使用 launchd,Linux 使用 systemd),这样你的虾即使在你关闭终端后也能持续运行。

openclaw onboard --install-daemon
B

npm 全局安装(开发者)

如果你的机器上已经有 Node.js 22 或更高版本,可以直接通过 npm 或 pnpm 全局安装 OpenClaw。这种方式更适合熟悉 Node.js 生态的开发者。

npm
npm install -g openclaw@latest
pnpm
pnpm add -g openclaw@latest
C

Docker

Docker 部署适合在服务器环境运行 OpenClaw,或者不想在本机安装 Node.js 的用户。OpenClaw 提供了官方的 Docker Compose 配置,一条命令即可启动所有服务。

Docker Compose
git clone https://github.com/openclaw/openclaw
cd openclaw
docker compose up -d
Port 18789 — Gateway (Web UI + API) Port 18790 — Bridge Port 18793 — Canvas

Windows 用户必读

OpenClaw 不支持原生 Windows 环境,需要先安装 WSL2(Windows Subsystem for Linux)。以管理员身份打开 PowerShell,运行下方命令安装 Ubuntu 24.04。安装完成后重启电脑,然后在 WSL 终端内按上面的方法安装 OpenClaw。

wsl --install

性能提示:项目文件必须存放在 WSL 内部的 /home/ 路径下。如果放在 /mnt/c/ 等 Windows 挂载目录,文件读写性能会下降 10-20 倍,严重影响 OpenClaw 运行速度。

验证安装是否成功

运行以下命令查看版本号,如果正确输出版本信息,说明 OpenClaw 已安装成功。

openclaw --version

常见问题

关于 OpenClaw 安装部署最常被问到的问题

🦞 准备好养虾了吗?

安装完成后,去案例区看看别人都在怎么养虾,找找灵感。或者逛逛技能商店,给你的虾装备更多超能力。