OpenClaw 保姆级手册：本地 AI 智能体，从入门到真正能用

用户30560129882
0 阅读7分钟

​

 

一、OpenClaw 全面介绍：给 AI 装上 “手脚” 的执行框架

1.1 项目起源与定位

OpenClaw（江湖人称 “小龙虾 AI”，曾用名 Clawdbot、Moltbot）是由奥地利开发者 Peter Steinberger 于 2025 年 11 月发起的开源 AI 智能体执行框架，采用 MIT 开源协议，核心口号是 “the AI that actually does things”（真正能执行任务的 AI） 。它不是大语言模型本身，而是AI 的 “执行网关” —— 负责把自然语言指令转化为系统操作、工具调用、流程自动化，让 AI 从 “只会说” 的顾问，变成 “真会做” 的数字员工。2026 年初因商标问题更名后，GitHub 星标迅速突破 28 万，成为全球顶流开源 AI Agent 项目。

1.2 核心优势（为什么选 OpenClaw）

  • 完全开源 + 本地优先：100% 开源可审计，支持本地私有化部署，数据不离开设备，隐私安全拉满。
  • 模型无关：兼容所有主流大模型（GPT-4、通义千问、Llama 3、Ollama 本地模型等），可自由切换云端 API / 本地模型。
  • 跨平台全兼容：支持 Windows、macOS、Linux（含 WSL2）、服务器，甚至嵌入式设备，一套配置多端通用。
  • 主动执行 + 持久记忆：具备任务规划、工具调用、长期记忆能力，无需反复提示，可自动完成复杂流程。
  • 生态丰富：内置 50 + 工具集成（浏览器、文件、代码、办公软件、消息平台等），支持自定义开发 “技能（Skills）”。

1.3 核心工作原理

OpenClaw 遵循 “意图解析→任务拆解→工具调用→结果反馈→记忆存储” 的闭环逻辑：

  1. 接收自然语言指令（如 “整理桌面所有 PDF 文件并按日期分类”）；
  2. 解析意图、拆解为可执行步骤（如 “扫描桌面→筛选 PDF→读取创建时间→新建文件夹→移动文件”）；
  3. 调用系统 / 工具接口执行操作；
  4. 反馈执行结果，并将过程存入记忆，支持后续追溯与优化。

1.4 适用场景

  • 个人：文件自动化整理、浏览器操作、代码编写、日程管理、消息收发；
  • 办公：Excel/Word 批量处理、报表自动生成、邮件自动化、数据爬取整理；
  • 开发：项目部署、代码调试、接口测试、日志分析；
  • 企业：私有化 AI 助手、流程自动化、数据安全管控。

二、部署前准备：硬件 + 软件 + 环境检查

2.1 硬件要求（2026 最新版）

表格

配置等级CPU内存显卡（可选）磁盘
最低Intel i5/Ryzen 58GB无（CPU 推理）20GB SSD
推荐Intel i7/Ryzen 716GB+NVIDIA GTX 1660Ti/RTX 3060（8GB + 显存）50GB+ NVMe SSD
高性能i9/Ryzen 932GB+RTX 4080/4090（16GB + 显存）100GB+ NVMe

备注：苹果 M 系列芯片（M2/M3 16GB + 统一内存）可流畅运行，无需独立显卡。

2.2 软件基础要求

  • 操作系统：Windows 10 2004+/Windows 11、macOS 12+、Ubuntu 20.04+/Debian 11+；
  • 核心依赖：Node.js 22.x+ （必须，OpenClaw 基于 TypeScript 开发）、Git（可选，用于源码部署）；
  • 模型对接：云端 API Key（GPT-4 / 通义千问 / DeepSeek 等）或本地模型（Ollama、LlamaCpp）。

2.3 环境预检查

  • Windows：以管理员身份运行 PowerShell，执行 node -v，无输出则需安装 Node.js；
  • macOS/Linux：终端执行 node -v，版本 < 22 则需升级。

三、全平台本地部署：保姆级步骤（新手零失败）

3.1 Windows 部署（2 种方案，新手首选一键脚本）

方案 1：PowerShell 一键脚本（⭐ 推荐，3 分钟完成）

 获取官方部署包：OpenClaw Windows一键部署包2.6.2

  1. 右键开始菜单 → 打开 管理员：Windows PowerShell / 终端（必须管理员，否则权限报错）；

  2. （可选）解除脚本执行限制（国内网络必做）：

    powershell

    Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

    输入 Y 回车确认。

  3. 执行官方一键安装命令（国内镜像加速，避免超时）：

    powershell

    # 官方原版
iwr -useb https://openclaw.ai/install.ps1 | iex
# 国内镜像（网络差优先）
iwr -useb https://gitee.com/openclaw/install/raw/main/install.ps1 | iex

  4. 等待脚本自动安装 Node.js+OpenClaw，出现 installation successful 即成功。

方案 2：WSL2 部署（官方推荐，稳定性最佳）

  1. 安装 WSL2：管理员 PowerShell 执行：

    powershell

    wsl --install -d Ubuntu

    重启电脑，设置 Ubuntu 用户名密码。

  2. 进入 Ubuntu 终端，执行一键脚本：

    bash

    运行

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

3.2 macOS 部署

  1. 打开终端，安装 Homebrew（无则先装）：

    bash

    运行

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

  2. 安装 Node.js 22+：

    bash

    运行

    brew install node@22

  3. 一键安装 OpenClaw：

    bash

    运行

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

    权限不足加 sudo。

3.3 Linux（Ubuntu/Debian）部署

  1. 更新系统并安装依赖：

    bash

    运行

    sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git

  2. 一键安装：

    bash

    运行

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

3.4 初始化配置（全平台通用，关键步骤）

安装完成后，执行初始化命令：

bash

运行

openclaw onboard

按提示操作（新手选 Quick Start 快速配置）：

  1. 风险告知：输入 yes 回车；

  2. 模型配置：

    • 云端 API：填入大模型 API Key（如通义千问、GPT-4）；
    • 本地模型：选 Ollama，确保已启动 Ollama 并拉取模型（如 ollama run llama3）；

  3. 通信平台：选 skip for now（暂时跳过，后续可配置）；

  4. 技能开启：选 no（默认关闭，避免资源占用）；

  5. 完成后，自动启动服务，浏览器访问 http://localhost:18789 进入 Web UI。

3.5 验证部署成功

  1. 终端执行 openclaw --version，输出版本号（如 2026.4.9）即成功；
  2. 打开 Web UI，发送指令：你好，测试一下，AI 正常回复则部署完成。

四、避坑指南：常见问题 + 解决方案

  1. Windows 安装报错：权限不足解决：必须用管理员身份打开 PowerShell，重新执行安装命令。

  2. Node.js 版本过低解决：卸载旧版，安装 Node.js 22.x LTS（官网 /brew/apt 安装）。

  3. 国内网络下载失败解决：使用国内 Gitee 镜像脚本，或开启代理后再安装。

  4. 模型对接失败

    • 云端 API：检查 API Key 是否正确、余额是否充足；
    • 本地 Ollama：确认 Ollama 已启动，执行 ollama list 查看模型是否拉取成功。

  5. Web UI 无法访问解决：检查 18789 端口是否被占用，执行 openclaw start 重启服务。

五、落地使用：基础操作 + 进阶玩法

5.1 基础操作（Web UI）

  • 对话交互：直接输入自然语言指令（如 “打开百度搜索 AI 智能体”）；
  • 任务查看：左侧「任务」面板查看执行历史、进度、结果；
  • 模型切换：「设置」→「模型」，自由切换云端 / 本地模型；
  • 技能开启：「技能」面板启用文件、浏览器、代码等工具。

5.2 进阶玩法

  • 自定义技能：开发专属自动化脚本，扩展 OpenClaw 能力；
  • 多平台联动：配置 Telegram/Discord/ 微信，远程控制本地 AI；
  • 本地模型优化：使用 Ollama 运行 Llama 3、Qwen 等 7B-14B 模型，实现完全离线使用；
  • 企业部署：Docker 容器化部署，搭配 Nginx 反向代理，实现团队共享。

六、总结与下一步

OpenClaw 彻底打破了 AI “只说不做” 的局限，凭借开源、本地、强执行的核心优势，成为个人与企业私有化 AI 部署的首选。本教程覆盖从入门到落地全流程，新手按步骤操作即可 100% 部署成功。

下一步：

  1. 熟悉 Web UI 基础操作，测试文件整理、浏览器自动化等场景；
  2. 尝试对接本地 Ollama 模型，实现完全离线隐私 AI；
  3. 开发自定义技能，打造专属个人数字助手。
  4. 获取官方部署包：OpenClaw Windows一键部署包2.6.2

​

avatar
文章
阅读
粉丝