从零开始OpenClaw(一)：OpenClaw简介及快速安装

1. What‘s OpenClaw ?原名 Clawdbot / Moltbot · 2026 年 GitHub 增速最快的开源项目之一 开源 · 本地优先 · 隐私可控 · 支持 20 聊天平台 · 兼容所有主流大模型1.1 简介OpenClaw是一款由 Peter SteinbergerPSPDFKit 创始人开发的开源、本地优先的个人 AI 代理平台是真正能做事的 AI 智能体可以运行在自己的设备上。可以与大部分已知的通讯渠道飞书、微信、钉钉、WhatsApp、Telegram等实现对话接入。与 ChatGPT、Claude 等依赖云端托管的 SaaS 服务不同OpenClaw 直接运行在用户自有的硬件上——Mac Mini、个人电脑、Linux 服务器乃至 VPS 均可。它的核心定位不是聊天机器人而是一个能够主动执行任务的 AI 代理Agent读写本地文件、执行 Shell 命令、操控浏览器、收发邮件、管理日历……AI 的角色从回答建议升级为直接完成。OpenClaw 支持接入 20 聊天平台微信、飞书、钉钉、Telegram、Discord 等兼容几乎所有主流大模型 APIClaude、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、WIndows2.1 本地部署系统要求Node.js 22包管理器npm、pnpm 或 bunpnpm仅在从源代码构建时需要系统macOS 12、LinuxUbuntu20.04、Debian11、WIndowsWSL2GIt2.2 本地部署安装macOS / LinuxOpenClaw官方提供两种安装方式虽然都是“装上就能用”但底层逻辑完全不同2.2.1 curl安装curl -fsSL https://openclaw.ai/install.sh | bashcurl安装的本质是从服务器下载一个预编译好的二进制可执行文件直接放到你的系统路径下。整个过程类似于从网上下载一个.exe然后安装你的电脑上不需要任何额外的运行环境。OpenClaw 的所有代码已经被编译、打包成了一个独立的可执行程序你只管运行。适合人群普通用户、只想快速上手、不关心底层实现。缺点无法查看或修改源码升级需要重新执行安装命令。2.2.2 npm安装npm 安装的本质是通过 Node.js 的包管理器把 OpenClaw 的完整程序包下载到本地由 Node.js 运行时来执行它。电脑上需要预先安装 Node.js版本 ≥ 22因为 OpenClaw 本身是用 TypeScript 写的运行时依赖 Node.js 提供的底层能力。适合人群开发者、想二次开发或调试、希望管理多个版本。缺点安装步骤相对多一些。要理解npm安装方式需要先搞清楚两个概念Node.js和npmNode.js 是什么JavaScript 最初是一门只能在浏览器里运行的语言——打开网页、点击按钮、提交表单这些是它的主场。Node.js 的出现改变了这一点。 它把浏览器里的 JavaScript 引擎单独拿出来让 JavaScript 也能像 Python、Java 一样直接运行在操作系统上读写文件、监听端口、执行系统命令……简单说Node.js 是 JavaScript 的服务器端运行时让 JS 代码能跑在你的电脑上而不只是浏览器里。OpenClaw 就是用 TypeScriptJavaScript 的超集写的所以它天然需要 Node.js 作为运行环境。npm 是什么npm 全称Node Package Manager是 Node.js 自带的包管理工具随 Node.js 一起安装不需要单独安装。它的作用类似于macOS 的HomebrewPython 的pipUbuntu 的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 openclawlatest # 或使用 pnpm pnpm add -g openclawlatest2.3 配置引导# 运行安装向导 # 完整安装向导 系统服务配置添加守护进程会在电脑开机后自动在后台运行并保持活跃 openclaw onboard --install-daemon # 仅运行安装向导 openclaw onboard询问是否是个人账户选择快速开始选择模型并配置api key配置消息终端选择你使用的消息终端以飞书为例默认联网搜索先跳过skills等可以先暂时跳过后面根据需求在后台再配置外部hook通过外部事件触发openclaw执行比如邮箱收到邮件、商城收到订单等同样暂时跳过后面根据需求配置对话方式终端 / web界面 / 不对话随意选择例如选择 web能够打开openclaw的前端界面即安装成功2.4 检查安装# 查看网关状态 openclaw gateway status # 打开前端界面 openclaw dashboard3. 卸载OpenClaw注意openclaw卸载时不要使用npm卸载这样卸载不干净需要手动删除一系列文件及服务使用openclaw cli可以一键卸载openclaw uninstall