1. What‘s OpenClaw ?

原名 Clawdbot / Moltbot · 2026 年 GitHub 增速最快的开源项目之一

🦞 开源 · 本地优先 · 隐私可控 · 支持 20+ 聊天平台 · 兼容所有主流大模型

---

1.1 简介

OpenClaw是一款由 Peter Steinberger（PSPDFKit 创始人）开发的开源、本地优先的个人 AI 代理平台，是真正能做事的 AI 智能体，可以运行在自己的设备上。可以与大部分已知的通讯渠道（飞书、微信、钉钉、WhatsApp、Telegram等）实现对话接入。

与 ChatGPT、Claude 等依赖云端托管的 SaaS 服务不同，OpenClaw 直接运行在用户自有的硬件上——Mac Mini、个人电脑、Linux 服务器，乃至 VPS 均可。它的核心定位不是"聊天机器人"，而是一个能够主动执行任务的 AI 代理（Agent）：读写本地文件、执行 Shell 命令、操控浏览器、收发邮件、管理日历……AI 的角色从"回答建议"升级为"直接完成"。

OpenClaw 支持接入 20+ 聊天平台（微信、飞书、钉钉、Telegram、Discord 等），兼容几乎所有主流大模型 API（Claude、GPT、DeepSeek、Qwen、Ollama 本地模型等），并拥有超过 5,700 个社区技能（Skills）插件生态。

1.2 本质

如果用一句话概括 OpenClaw 的技术本质：它是一个自托管的本地 AI 代理网关（Local AI Agent Gateway）。

OpenClaw 本身不包含任何 AI 模型——它是一个用 TypeScript 编写的 CLI 进程，持续运行在你的本地设备上，充当"中枢调度器"的角色：接收来自各聊天平台的指令，通过 API 将推理任务外包给大语言模型，再将模型输出转化为对本地系统的实际操作并回传结果。

这种设计让 AI 的"大脑"（模型）与"身体"（执行能力）分离：模型在云端或本地推理，但所有数据、记忆与操作都发生在你自己的机器上，隐私完全可控。

1.3 系统架构

2. 安装OpenClaw

根据您手头的硬件条件，可自行选择云端部署或本地部署

• 云端部署（腾讯云、阿里云）

• 本地部署（macOS、Linux、WIndows）

2.1 本地部署系统要求

• Node.js （>= 22）

• 包管理器：npm、pnpm 或 bun（pnpm仅在从源代码构建时需要）

• 系统：macOS 12+、Linux（Ubuntu20.04+、Debian11+）、WIndows（WSL2）

• GIt

2.2 本地部署安装（macOS / Linux）

OpenClaw官方提供两种安装方式，虽然都是“装上就能用”，但底层逻辑完全不同

2.2.1 curl安装

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

curl安装的本质是：从服务器下载一个预编译好的二进制可执行文件，直接放到你的系统路径下。

• 整个过程类似于从网上下载一个 .exe 然后安装，你的电脑上不需要任何额外的运行环境。OpenClaw 的所有代码已经被编译、打包成了一个独立的可执行程序，你只管运行。

• 适合人群： 普通用户、只想快速上手、不关心底层实现。

• 缺点： 无法查看或修改源码，升级需要重新执行安装命令。

2.2.2 npm安装

npm 安装的本质是：通过 Node.js 的包管理器，把 OpenClaw 的完整程序包下载到本地，由 Node.js 运行时来执行它。

• 电脑上需要预先安装 Node.js（版本 ≥ 22），因为 OpenClaw 本身是用 TypeScript 写的，运行时依赖 Node.js 提供的底层能力。

• 适合人群： 开发者、想二次开发或调试、希望管理多个版本。

• 缺点： 安装步骤相对多一些。

---

要理解npm安装方式，需要先搞清楚两个概念：Node.js和npm

Node.js 是什么？

JavaScript 最初是一门只能在浏览器里运行的语言——打开网页、点击按钮、提交表单，这些是它的"主场"。Node.js 的出现改变了这一点。 它把浏览器里的 JavaScript 引擎单独拿出来，让 JavaScript 也能像 Python、Java 一样直接运行在操作系统上，读写文件、监听端口、执行系统命令……

简单说：Node.js 是 JavaScript 的"服务器端运行时"，让 JS 代码能跑在你的电脑上，而不只是浏览器里。

OpenClaw 就是用 TypeScript（JavaScript 的超集）写的，所以它天然需要 Node.js 作为运行环境。

---

npm 是什么？

npm 全称 Node Package Manager，是 Node.js 自带的包管理工具，随 Node.js 一起安装，不需要单独安装。

它的作用类似于：

• macOS 的 Homebrew

• Python 的 pip

• Ubuntu 的 apt

开发者把写好的程序或库发布到 npm 的公共仓库（npmjs.com），任何人都可以通过 npm install 包名 一行命令下载安装。目前 npm 仓库里有超过 200 万个开源包。

# 安装 Node.js    https://nodejs.org/en/download

# Download and install nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

# in lieu of restarting the shell
\. "$HOME/.nvm/nvm.sh"

# Download and install Node.js:
nvm install 24

# Verify the Node.js version:
node -v # Should print "v24.14.0".

# Verify npm version:
npm -v # Should print "11.9.0".

# --------------------------------------------------------

# 安装 openclaw
# 使用 npm
npm install -g openclaw@latest

# 或使用 pnpm
pnpm add -g openclaw@latest

2.3 配置引导

# 运行安装向导

# 完整安装向导 & 系统服务配置（添加守护进程，会在电脑开机后自动在后台运行并保持活跃）
openclaw onboard --install-daemon

# 仅运行安装向导
openclaw onboard

• 询问是否是个人账户

• 选择快速开始

• 选择模型并配置api key

• 配置消息终端（选择你使用的消息终端，以飞书为例）

• 默认联网搜索先跳过

• skills等可以先暂时跳过，后面根据需求在后台再配置

• 外部hook（通过外部事件触发openclaw执行，比如邮箱收到邮件、商城收到订单等），同样暂时跳过，后面根据需求配置

• 对话方式（终端 / web界面 / 不对话），随意选择，例如选择 web能够打开openclaw的前端界面即安装成功

2.4 检查安装

# 查看网关状态
openclaw gateway status

# 打开前端界面
openclaw dashboard

3. 卸载OpenClaw

注意：openclaw卸载时，不要使用npm卸载，这样卸载不干净，需要手动删除一系列文件及服务

使用openclaw cli可以一键卸载

openclaw uninstall