一、什么是 OpenClaw1.1 项目起源与发展历程OpenClaw 由奥地利资深开发者、PSPDFKit 创始人 Peter Steinberger 于 2025 年 11 月发起最初以Clawdbot为名发布核心初衷是打造一个能真正落地执行任务的本地 AI 助手而非单纯的对话机器人。项目发展经历了关键迭代2025 年 11 月初代版本 Clawdbot 发布快速在极客圈走红2026 年 1 月因商标问题短暂更名为 Moltbot寓意龙虾 “蜕壳” 重生2026 年 1 月 30 日正式定名为OpenClaw明确开源中立定位2026 年 2 月转向独立基金会运营GitHub Star 突破 20 万成为全球顶流 AI Agent 项目1.2 核心定位与核心优势OpenClaw 是一款完全开源、模型无关、本地优先的 AI 智能体执行网关。它的核心定位一句话概括用自然语言指挥设备让 AI 替你完成真实操作。和传统聊天 AI 的本质区别传统对话 AIChatGPT/Claude 等OpenClaw云端对话仅输出文本与建议本地运行拥有系统级执行权限直接完成操作局限在浏览器 / APP 内无法跨应用协同打通 50 通讯、办公、开发工具全场景联动数据上传云端隐私不可控所有数据、配置、执行全在本地隐私完全可控它的核心优势模型无关兼容 Claude、GPT、Gemini、通义千问、DeepSeek、Kimi 等国内外主流大模型也支持 Ollama 本地模型可自由切换甚至混搭使用零门槛上手无需编程基础一键脚本部署自然语言即可定义自动化任务极致扩展官方 ClawHub 技能市场拥有超 1.3 万社区贡献的技能包覆盖办公、开发、生活等几乎所有场景可按需安装也可自定义开发全平台适配支持 Windows、macOS、Linux 全系统可在本地电脑、轻量服务器、嵌入式设备上运行多通道统一支持微信、Telegram、WhatsApp、飞书、Slack 等 50 平台收发指令跨设备跨会话任务不中断1.3 核心架构与工作原理OpenClaw 本身不做大模型训练它的核心是连接大模型推理能力、用户聊天入口、本地系统执行能力的中枢桥梁核心由四大模块构成Gateway 网关系统的神经中枢负责消息路由、模型调度、工具调用的统一管理同时对接各类通讯与办公平台单端口复用 WebSocketHTTP 协议Agent 智能体系统的决策核心接入大语言模型负责理解用户意图、拆解任务步骤、规划执行路径、处理复杂上下文支持多智能体并行协作Skills 技能AI 执行任务的 “抓手”模块化的能力扩展单元通过标准化的自然语言文档即可定义无需复杂代码开发Memory 记忆持久化上下文存储系统采用向量索引 全文检索 Markdown 文件的组合方案能记住用户偏好、任务历史跨会话保持上下文连贯1.4 典型使用场景办公自动化自动汇总邮件、整理会议纪要、批量处理 Excel 数据、生成周报、定时发送通知开发提效自动拉取代码、执行构建部署、监控服务器状态、处理日志告警、编写并调试代码片段生活效率自动整理下载文件夹、定时备份文件、追踪快递物流、生成旅行攻略并预订行程内容创作自动追踪全网热点、生成选题方案、多平台内容分发、数据复盘分析二、部署前准备工作2.1 系统与硬件要求官方最低配置要求如下个人使用推荐配置高于最低标准运行更流畅配置项最低要求推荐配置操作系统Windows 10、macOS 12、LinuxUbuntu 20.04/Debian 11Windows 11、macOS 14、Ubuntu 22.04运行内存2GB4GB 及以上使用本地大模型建议 16GB存储空间500MB 可用空间2GB 及以上可用空间网络可联网调用云端大模型需要本地模型可离线使用稳定网络环境2.2 核心依赖准备OpenClaw 的核心运行依赖是Node.js 22 及以上 LTS 版本部分技能需要 Python 3.10源码编译需要 Git。新手建议无需提前手动安装 Node.js官方一键脚本会自动检测并安装匹配的 Node.js 版本避免版本冲突。2.3 提前准备内容大模型 API KeyOpenClaw 本身不含大模型需要对接第三方模型才能运行提前注册对应平台并生成 API Key推荐选择国内用户阿里云百炼、DeepSeek、Kimi、通义千问新用户均有免费额度海外用户Anthropic Claude、OpenAI GPT、Google Gemini管理员权限Windows 系统需要以管理员身份运行 PowerShellmacOS/Linux 需要 sudo 权限确保脚本可正常安装依赖路径要求所有安装路径、工作区路径必须为全英文避免中文、空格、特殊字符导致安装或运行失败三、全平台本地部署详细步骤本文提供 4 种部署方式新手优先选择官方一键脚本部署进阶用户可根据需求选择包管理器、源码编译或 Docker 部署。方式一官方一键脚本部署新手首选全平台通用这是官方推荐的极简部署方式脚本会自动检测系统环境、安装对应依赖、完成核心程序部署全程无需手动配置复制一行命令即可完成。1. Windows 系统部署步骤右键点击开始菜单选择Windows PowerShell (管理员)或终端 (管理员)打开管理员权限的命令行窗口可选解锁脚本执行权限避免系统拦截Set-ExecutionPolicy RemoteSigned -Scope CurrentUser3. 复制官方一键安装命令粘贴到终端回车执行iwr -useb https://openclaw.ai/install.ps1 | iex4. 等待脚本执行完成出现installation successful提示即为安装成功补充Windows 系统官方更推荐使用 WSL2 环境运行性能和兼容性更好先执行wsl --install安装 WSL2再在 Linux 子系统中执行 macOS/Linux 的安装命令2. macOS/Linux 系统部署步骤打开系统终端macOS 可通过 Launchpad 搜索 “终端”Linux 可使用 CtrlAltT 快捷键复制官方一键安装命令粘贴到终端回车执行curl -fsSL https://openclaw.ai/install.sh | bash3. 若提示权限不足在命令前添加 sudo 执行curl -fsSL https://openclaw.ai/install.sh | sudo bash4. 等待脚本执行完成出现成功提示即为安装完成方式二包管理器安装进阶用户npm/pnpm适合熟悉 Node.js 生态的用户方便版本管理和更新需提前安装 Node.js 22。npm 安装# 全局安装OpenClaw npm i -g openclawbeta # 启动初始化配置向导 openclaw onboardpnpm 安装推荐速度更快占用空间更小# 全局安装OpenClaw pnpm add -g openclawbeta # 启动初始化配置向导 openclaw onboard方式三源码编译安装开发者自定义修改适合想要修改源码、二次开发的用户需提前安装 Git、pnpm 9、Node.js 22。克隆官方源码仓库git clone https://github.com/openclaw/openclaw.git2.进入项目目录安装依赖cd openclaw pnpm install3.编译构建项目pnpm run build4. 启动初始化配置向导pnpm run openclaw onboard方式四Docker 部署服务器 / 隔离环境适合服务器部署、想要隔离运行的场景需提前安装 Docker Engine 20 或 Docker Desktop。拉取官方最新镜像docker pull openclaw/openclaw:latest2.后台启动容器映射端口并持久化配置docker run -d \ --name openclaw \ -p 3000:3000 \ -v ~/.openclaw:/root/.openclaw \ --env-file ~/.openclaw/.env \ --restart unless-stopped \ openclaw/openclaw:latest3.也可使用 Docker Compose 实现持久化部署创建docker-compose.yml文件version: 3.8 services: openclaw: image: openclaw/openclaw:latest ports: - 3000:3000 volumes: - ~/.openclaw:/root/.openclaw env_file: - ~/.openclaw/.env restart: unless-stopped4.启动容器docker compose up -d四、初始化配置与功能验证安装完成后需要通过交互式配置向导完成核心设置才能正常使用 OpenClaw。4.1 交互式配置向导1.若安装完成后未自动启动向导手动执行以下命令启动openclaw onboard --install-daemon2.按照向导提示完成核心配置新手全程可选择默认选项第一步确认风险告知输入yes同意用户协议第二步启动模式选择新手选QuickStart快速开始模式第三步选择 AI 模型供应商粘贴提前准备好的 API Key向导会自动测试模型连接第四步设置工作区路径保持默认即可确保路径为全英文第五步安装 daemon 后台服务输入yes实现开机自启、后台常驻运行第六步连接聊天平台、安装技能包新手可先选skip跳过后续在可视化界面配置4.2 安装有效性验证执行以下命令验证 OpenClaw 是否安装成功查看版本号输出版本信息即为安装有效openclaw --version2.环境诊断自动检查 Node.js 版本、依赖、配置、网络连接全部通过即为环境正常openclaw doctor3.服务健康检查验证核心服务是否正常运行openclaw health4.3 启动可视化控制台与功能测试执行以下命令自动打开浏览器进入 OpenClaw 可视化 Web 控制台openclaw dashboard2.控制台默认地址为http://127.0.0.1:3000若端口被占用可在配置文件中修改端口号3. 在控制台的聊天框中输入测试指令例如你能做什么AI 正常回复即为部署成功4.进阶测试输入简单的执行指令例如帮我查看当前目录下的所有文件验证 AI 的执行能力五、总结与进阶玩法通过本文的步骤你已经完成了 OpenClaw 的本地部署拥有了一个专属的、可自主执行任务的 AI 数字助手。它的核心价值不在于对话能力而在于把自然语言转化为真实的执行动作帮你从重复繁琐的工作中解放出来。进阶玩法推荐安装社区技能在官方 ClawHub 技能市场按需安装办公自动化、开发运维、生活服务等各类技能包快速扩展能力自定义技能开发通过标准化的 Markdown 文档用自然语言定义自己的专属自动化任务无需复杂代码多模型混搭使用不同任务分配给不同的模型例如用 Claude 做任务规划、DeepSeek 写代码、本地模型做总结兼顾成本与效果远程访问控制将 OpenClaw 部署在云服务器上通过手机端的 Telegram、微信等平台远程下达指令实现 24 小时无人值守执行多智能体协作创建多个专属智能体分别负责内容创作、数据处理、运维监控等不同工作协同完成复杂任务