第一部分:认知篇 —— 什么是 OpenClaw?
1.1 定义与定位
OpenClaw(原名 Clawdbot / Moltbot)是一个本地优先、隐私至上、多渠道集成的自托管 AI 助手平台。它标志着人工智能从'对话式交互'迈入'自主行动'的第三阶段。
通俗理解:
传统 AI(如网页版 ChatGPT):你问一句,它答一句,像个顾问。
OpenClaw:你给它一个目标(如'帮我整理本月财报并发送给团队'),它能自己规划步骤、搜索数据、处理文件、发送邮件,像个员工。
1.2 核心架构:App、Gateway 与 CLI
要玩转 OpenClaw,必须理解它的三个核心组件:
Gateway(网关):真正的中枢。负责承接模型调用、工具连接、会话状态和本地配置。它是大脑与手脚的连接点。
App(桌面应用):稳定入口。主要用于申请系统权限、查看运行状态和线程交互。
CLI(命令行):操作界面。用于初始化配置、健康检查、安装技能和调试。
1.3 为什么是'空壳框架'?
OpenClaw 本身只提供执行逻辑,不具备具体的功能。它的强大完全依赖于 Skills(技能插件)。没有技能的 OpenClaw 只是一个'智障聊天机器人',装对技能才是'AI 员工'。
第二部分:准备篇 —— 环境与选型
2.1 硬件与系统要求
操作系统:Windows 11、macOS 12+、Linux(Ubuntu 22.04+ 推荐)。
内存:最低 2GB,强烈推荐 4GB 以上(尤其是在运行浏览器自动化技能时)。
核心依赖:Node.js 22.x 或更高版本(必须,低于此版本会安装失败)。
2.2 部署方案选型
根据你的使用场景选择方案:
| 部署方案 | 核心优势 | 适用场景 | 维护成本 |
|---|---|---|---|
| 本地部署 | 零费用、数据私有、响应快 | 个人办公、短期任务、功能测试 | 中(需保持电脑开机) |
| 云服务器部署 | 7x24 小时运行、多设备访问、公网接入 | 店铺托管、批量任务、团队协作 | 低(云厂商运维) |
新手建议:先在本地(Win/Mac)用 QuickStart 模式跑通,熟悉后再迁至云端。
第三部分:部署篇 —— 多平台实战
3.1 本地部署(Windows / macOS / Linux)
方法一:一键安装脚本(推荐新手)
这是官方最推荐的方式,自动检测并安装 Node.js 环境。
macOS / Linux:
curl -fsSL https://openclaw.ai/install.sh | bash
Windows(管理员模式 PowerShell):
iwr -useb https://openclaw.ai/install.ps1 | iex
方法二:手动安装(适合有 Node.js 环境的用户)
配置国内镜像(加速下载):
npm config set registry https://registry.npmmirror.com
全局安装 OpenClaw:
npm install -g openclaw@latest
初始化配置:
openclaw onboard --install-daemon
这一步会进入交互式配置,关键选择如下:
模式:选择 QuickStart。
模型:推荐选择 Moonshot AI (Kimi) 或 Qwen(国内用户友好)。
API Key:输入从 Kimi 或阿里云百炼平台获取的 Key。
聊天载体:新手先选 Skip,使用内置的 TUI 测试。
网络搜索:选择对应的搜索 API(如 Kimi 搜索或 Tavily)。


