01｜OpenClaw 概述与环境安装：从零认识 AI Agent 框架

萤火阳光2026-04-01 9:20

01｜OpenClaw 概述与环境安装：从零认识 AI Agent 框架

专栏定位 ：OpenClaw 从入门到精通（第 01 章）
适读人群 ：开发者、技术爱好者、AI应用创业者
前置知识：基本的命令行操作，理解 AI/LLM 概念

文章目录

  • [01｜OpenClaw 概述与环境安装：从零认识 AI Agent 框架](#01｜OpenClaw 概述与环境安装：从零认识 AI Agent 框架)
    • 摘要
    • [SEO 摘要](#SEO 摘要)
    • 目录
    • 开篇
    • 核心知识点
      • [1. 什么是 OpenClaw](#1. 什么是 OpenClaw)
        • [1.1 定位与愿景](#1.1 定位与愿景)
        • [1.2 架构概览](#1.2 架构概览)
        • [1.3 与同类产品的对比](#1.3 与同类产品的对比)
      • [2. OpenClaw 能做什么](#2. OpenClaw 能做什么)
        • [2.1 个人效率助手](#2.1 个人效率助手)
        • [2.2 自动化工作流](#2.2 自动化工作流)
        • [2.3 编程助手](#2.3 编程助手)
        • [2.4 多模态能力](#2.4 多模态能力)
      • [3. 系统要求与安装前准备](#3. 系统要求与安装前准备)
        • [3.1 硬件要求](#3.1 硬件要求)
        • [3.2 软件要求](#3.2 软件要求)
        • [3.3 环境检查脚本](#3.3 环境检查脚本)
        • [3.4 账号与 API Key 准备](#3.4 账号与 API Key 准备)
      • [4. 各系统安装步骤](#4. 各系统安装步骤)
        • [4.1 Windows 安装](#4.1 Windows 安装)
          • [方法一：通过 npm 全局安装（推荐）](#方法一：通过 npm 全局安装（推荐）)
          • [方法二：通过 GitHub 源码安装](#方法二：通过 GitHub 源码安装)
        • [4.2 Linux 安装](#4.2 Linux 安装)
        • [4.3 macOS 安装](#4.3 macOS 安装)
        • [4.4 安装后配置](#4.4 安装后配置)
        • [4.5 更新 OpenClaw](#4.5 更新 OpenClaw)
      • [5. 验证安装](#5. 验证安装)
        • [5.1 基本状态检查](#5.1 基本状态检查)
        • [5.2 检查 Gateway 状态](#5.2 检查 Gateway 状态)
        • [5.3 查看已安装的 Skills](#5.3 查看已安装的 Skills)
      • [6. 第一个 Hello World 对话](#6. 第一个 Hello World 对话)
        • [6.1 启动 Gateway](#6.1 启动 Gateway)
        • [6.2 启动对话](#6.2 启动对话)

摘要

想象一下，你有一个永不疲倦的助手，它 24 小时在线，理解你的指令，主动帮你完成繁琐的工作，甚至能代替你在网上浏览信息、操作网页、发送消息。这就是 OpenClaw------一个让你用自然语言驱动一切的开源 AI Agent 框架。本章将从零开始，带你认识 OpenClaw 的核心定位与架构，并通过完整的安装实测，让你快速跑通第一个 Hello World 对话。无论你是想打造个人效率助手，还是为企业构建自动化工作流，OpenClaw 都是一个值得深入学习的强力工具。

SEO 摘要

OpenClaw 是一个开源的 AI Agent 框架，支持自然语言驱动的自动化任务执行、网页浏览、消息发送、代码编写等能力。本文详细介绍 OpenClaw 的功能定位、系统要求、Windows/Linux/macOS 多平台安装步骤，并提供第一个对话示例，帮助开发者快速上手 AI Agent 开发。

目录

开篇

凌晨两点，你突然想起明天要给客户发送一份项目进展报告，但手头的周报数据还散落在 Confluence、Jira 和邮件里。换作以前，你可能需要熬着困意一个个打开工具、复制粘贴数据。而今天，你只需要对电脑说一句话："帮我整理本周项目进展，发到飞书群里。"你的 AI 助手就开始自动工作------它读取 Jira 的任务列表，提取邮件中的关键反馈，生成一份结构化的周报，最后发送到飞书群。全程你只需要下一道指令，然后安心睡觉。

这不是科幻，这是 OpenClaw 每天在真实用户环境中做的事。

OpenClaw 是什么？它是一个运行在本地或服务器上的 AI Agent 运行时环境。你可以用自然语言向它下达指令，它会调用各种工具（浏览网页、执行代码、操作文件、发送消息）来完成任务。它既可以作为你的私人助手，也可以集成到企业工作流中，实现复杂的自动化场景。

本章我们将完成最重要的一步：从零认识 OpenClaw，完成环境安装，并运行你的第一个对话。

核心知识点

1. 什么是 OpenClaw

1.1 定位与愿景

OpenClaw 是一个开源的 AI Agent 运行时框架 ，由 OpenClaw 团队开发并维护。它的核心设计理念是：让 AI 不只是聊天，而是真正替你去行动（From Chat to Act）。

传统的 AI 对话系统（如 ChatGPT）只能生成文字，你仍然需要自己把建议复制到其他地方执行。而 OpenClaw 赋予 AI 工具调用能力------它可以执行 Shell 命令、操作浏览器、读写文件、发送消息、管理定时任务，甚至调用外部 API。这意味着你可以把一个具体的工作流"教给"OpenClaw，之后它就能自主完成整个流程。

1.2 架构概览

OpenClaw 的核心架构包含以下几个关键组件：

Gateway（网关） ：整个系统的中枢，负责管理 Agent 的生命周期、消息路由和模型调用。它既可以在本地运行（openclaw gateway），也可以通过配置文件连接远程服务。Gateway 支持两种模式：

  • 本地模式：直接在本地启动 AI 服务，适合开发调试
  • 远程模式：连接云端 API，适合生产环境

Agent（智能体）：运行在 Gateway 之上的 AI 实例。每个 Agent 有自己的身份（SOUL.md）、工作流程（AGENTS.md）、记忆系统（MEMORY.md）和技能（Skills）。你可以同时运行多个 Agent，分别负责不同任务。

Skills（技能系统） ：可插拔的能力扩展模块。每个 Skill 实际上是一个包含 SKILL.md 配置文件的目录，定义了 Agent 如何调用特定工具或执行特定任务。通过 ClawHub（OpenClaw 的技能市场），你可以下载社区贡献的 Skills，也可以发布自己的作品。

Memory（记忆系统）：三层记忆架构，保证 Agent 在不同时间尺度上都有上下文：

  • 短期记忆：当前对话窗口内的上下文
  • 中期记忆 ：每天的日志（memory/YYYY-MM-DD.md）
  • 长期记忆 ：MEMORY.md 文件中的精华沉淀

Tools（工具集）：Agent 与外界交互的接口。包括：

  • exec：执行 Shell 命令
  • browser：控制浏览器自动化
  • message：发送消息（支持飞书、微信、Telegram 等平台）
  • read/write/edit：文件系统操作
  • feishu_*：飞书文档、知识库、多维表格操作

运行时模型：OpenClaw 默认支持多种模型接入，包括 OpenAI GPT 系列、Claude、MiniMax 等。你可以在配置文件中自由切换，也可以为不同任务指定不同的模型（多模型路由）。

1.3 与同类产品的对比
特性 OpenClaw LangChain AutoGPT Coze
部署方式 本地优先 偏云端 偏本地 纯云端
工具调用 内置+Skill扩展 DIY 基础 插件丰富
多模态支持 有 有限 有限 有
多 Agent 协作 支持 支持 弱 支持
飞书等国内集成 原生支持 需自行开发 无 有限
开源免费 完全开源 开源 开源 部分开源

OpenClaw 的最大特点是本地化 + 飞书等国内平台原生集成，这让它在国内企业场景中具有独特优势。

2. OpenClaw 能做什么

2.1 个人效率助手

OpenClaw 可以成为你的数字第二大脑。你可以：

  • 信息聚合：让它每天自动抓取你关注的 AI 新闻、技术博客，整理成简报
  • 日程管理：通过自然语言创建、查询、修改日历事件
  • 邮件处理：自动分类邮件、提取关键信息、起草回复
  • 文档整理：帮你读写文档、表格，格式化内容
  • 飞书知识库：自动整理和更新飞书文档
2.2 自动化工作流

在企业场景中，OpenClaw 可以串联多个系统和工具：

  • 项目管理自动化：从 Jira 拉取任务状态，汇总到飞书群
  • 客服预处理：自动读取客户工单，分类并生成初步回复建议
  • 数据报表：定时从数据库或 API 拉取数据，生成报表发送到指定渠道
  • 审批流程：自动追踪审批状态，在关键节点发送提醒
2.3 编程助手

OpenClaw 内置了强大的编程相关 Skills：

  • 代码审查：分析代码库，提出改进建议
  • 代码生成：根据自然语言描述生成代码
  • 调试辅助：分析错误日志，提供修复建议
  • 文档生成：自动为代码生成或更新文档
  • Claude Code / Codex 集成 ：通过 coding-agent Skill，可以直接调用 Claude Code 或 Codex 执行复杂编程任务
2.4 多模态能力

OpenClaw 不仅处理文本，还能处理图像和音视频：

  • 图像分析 ：使用 image 工具分析图片内容
  • 图像生成 ：通过 image_generate 工具生成 AI 图片
  • 视频处理 ：结合 ffmpeg Skill 进行视频编辑和格式转换
  • PDF 处理：读取和分析 PDF 文档内容
  • 语音合成：使用 TTS 将文字转为语音

3. 系统要求与安装前准备

3.1 硬件要求
组件 最低要求 推荐配置
CPU 双核 四核或以上
内存 4 GB 8 GB 或以上
存储 2 GB 可用空间 SSD，10 GB 以上
网络 需要网络连接（调用 AI 模型 API） 稳定宽带
3.2 软件要求

Node.js：OpenClaw 基于 Node.js 开发，必须安装。版本要求：

  • 最低版本：Node.js 18.x
  • 推荐版本：Node.js 20.x LTS 或 21.x

你可以从 https://nodejs.org 下载安装包。安装完成后，验证：

bash 复制代码 
node --version
# 应输出 v18.x.x 或更高版本

npm --version
# 应输出 9.x.x 或更高版本

npm：随 Node.js 一起安装，用于安装 OpenClaw 本身和 Skills。

3.3 环境检查脚本

在安装之前，建议运行以下检查：

Windows (PowerShell)：

powershell 复制代码 
# 检查 Node.js 和 npm
node --version
npm --version

# 检查是否安装 Git（可选，用于从源码安装）
git --version

# 检查网络连通性（确保能访问 AI 模型 API）
curl -I https://api.openai.com/v1/models 2>$null

Linux / macOS (Terminal)：

bash 复制代码 
# 检查 Node.js 和 npm
node --version
npm --version

# 检查 Git（可选）
git --version

# 检查网络连通性
curl -I https://api.openai.com/v1/models
3.4 账号与 API Key 准备

使用 OpenClaw 需要一个 AI 模型的 API Key。你可以选择：

OpenAI（需要海外网络）：

MiniMax（国内可用，推荐）：

硅基流动（国内可用）：

4. 各系统安装步骤

4.1 Windows 安装
方法一：通过 npm 全局安装（推荐）

步骤 1：安装 Node.js

如果你还没有安装 Node.js，请从 https://nodejs.org 下载 Windows 安装包（.msi），选择 LTS 版本（推荐 20.x），安装过程中勾选"Add to PATH"。

步骤 2：安装 OpenClaw

以管理员身份打开 PowerShell（或 Windows Terminal），执行：

powershell 复制代码 
npm install -g openclaw

如果遇到权限问题（EACCES 错误），需要配置 npm 的全局目录：

powershell 复制代码 
# 创建 npm 全局目录
mkdir $HOME/npm-global

# 配置 npm
npm config set prefix $HOME/npm-global

# 添加到 PATH（PowerShell）
$env:PATH = "$HOME/npm-global;$env:PATH"

# 重新安装
npm install -g openclaw

步骤 3：验证安装

powershell 复制代码 
openclaw --version
# 应输出类似 openclaw/1.x.x 的版本号
方法二：通过 GitHub 源码安装

如果你想体验最新功能（可能不稳定）：

powershell 复制代码 
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git

# 进入目录
cd openclaw

# 安装依赖
npm install

# 链接到全局
npm link
4.2 Linux 安装

步骤 1：安装 Node.js

Ubuntu / Debian：

bash 复制代码 
# 使用 NodeSource 安装指定版本
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证
node --version
npm --version

CentOS / RHEL / Fedora：

bash 复制代码 
# 安装 EPEL 并使用 yum
sudo yum install -y nodejs npm

# 或使用 fnm（推荐，更方便管理多版本）
curl -fsSL https://fnm.vercel.app/install | bash
source ~/.bashrc
fnm install 20
fnm use 20

Arch Linux：

bash 复制代码 
sudo pacman -S nodejs npm

步骤 2：安装 OpenClaw

bash 复制代码 
# 使用 npm 全局安装
sudo npm install -g openclaw

# 验证
openclaw --version

如果遇到 EACCES 错误（权限拒绝），参考 npm 官方文档 修复目录权限。

4.3 macOS 安装

方法一：通过 Homebrew（推荐）

bash 复制代码 
# 如果没有安装 Homebrew，先安装
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node@20

# 验证
node --version
npm --version

# 安装 OpenClaw
npm install -g openclaw

方法二：通过 nvm

bash 复制代码 
# 安装 nvm（如果没有）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.zshrc  # 或 source ~/.bash_profile

# 安装并使用 Node.js 20
nvm install 20
nvm use 20

# 安装 OpenClaw
npm install -g openclaw

方法三：直接下载安装包

从 https://nodejs.org 下载 macOS 安装包（.pkg），按向导完成安装，然后：

bash 复制代码 
npm install -g openclaw
4.4 安装后配置

安装完成后，首次运行需要初始化配置：

bash 复制代码 
openclaw init

这个命令会在 ~/.openclaw/（用户主目录下的隐藏文件夹）创建必要的配置文件：

复制代码 
~/.openclaw/
├── AGENTS.md          # Agent 工作流程配置
├── SOUL.md            # Agent 身份/人格配置
├── USER.md            # 用户信息
├── MEMORY.md          # 长期记忆
├── memory/            # 每日记忆目录
├── skills/           # 本地 Skills 目录
├── config.yaml       # 主配置文件
└── .env              # API Key 等敏感配置

配置 API Key：

在 ~/.openclaw/.env 文件中添加：

bash 复制代码 
# OpenAI（如果使用）
OPENAI_API_KEY=sk-your-key-here

# MiniMax（推荐国内用户）
MINIMAX_API_KEY=your-minimax-key

# 或使用硅基流动
SILICONFLOW_API_KEY=your-key
4.5 更新 OpenClaw
bash 复制代码 
# 检查当前版本
openclaw --version

# 更新到最新版本
npm update -g openclaw

# 或指定版本
npm install -g openclaw@latest

5. 验证安装

安装完成后，通过以下命令验证 OpenClaw 是否正常工作：

5.1 基本状态检查
bash 复制代码 
openclaw status

正常输出应该类似：

复制代码 
┌─────────────────────────────────────┐
│          OpenClaw Status           │
├─────────────────────────────────────┤
│  Version:     1.2.3                 │
│  Node.js:     v20.11.0              │
│  Platform:    win32 (Windows)       │
│  Gateway:     running (localhost:18789) │
│  Model:       minimax/MiniMax-M2.7  │
│  Memory:      3 files loaded        │
│  Skills:      12 installed          │
└─────────────────────────────────────┘

如果看到 Gateway: stopped，需要先启动 Gateway：

bash 复制代码 
openclaw gateway start
5.2 检查 Gateway 状态
bash 复制代码 
openclaw gateway status

输出示例：

复制代码 
Gateway is running on http://localhost:18789
WebSocket: ws://localhost:18789
5.3 查看已安装的 Skills
bash 复制代码 
openclaw skills list

应该看到类似：

复制代码 
Installed Skills:
✓ weather          - 获取天气预报
✓ feishu-doc       - 飞书文档操作
✓ feishu-bitable   - 飞书多维表格
✓ feishu-wiki      - 飞书知识库
✓ coding-agent     - 编程助手
✓ pdf              - PDF 处理
✓ xlsx             - Excel 处理
...

6. 第一个 Hello World 对话

6.1 启动 Gateway

如果 Gateway 还没有运行，先启动它：

bash 复制代码 
openclaw gateway start

后台运行模式：

bash 复制代码 
openclaw gateway start --background
6.2 启动对话

方式一：交互式对话（推荐新手）

ba 复制代码
相关推荐
首席数智官2 小时前
AI CRM 2.0时代：SaaS厂商的生死局
大数据·人工智能·物联网
茴香豆的茴12 小时前
手撕 Transformer (1)：Transformer 的结构拆解
人工智能·深度学习·transformer
Yao.Li2 小时前
PVN3D 训练与评估代码流程详解
人工智能·3d
前端大波2 小时前
Vue 项目中让 AI 更稳：AGENTS.md + Prompt 模板实践
vue.js·人工智能·prompt
珠海西格电力2 小时前
零碳园区能源互联技术路径适配方案的成本效益分析
大数据·人工智能·架构·智慧城市·能源
Daydream.V2 小时前
OpenCV——DNN模块实现风格迁移
人工智能·opencv·dnn
jinglong.zha2 小时前
OpenClaw核心概念速览
人工智能·ai·大模型·openclaw·养龙虾
摄影图2 小时前
AI神经网络数据可视化图片素材 多格式多场景助力设计高效开展
人工智能·aigc·插画
IT大师兄吖2 小时前
MatAnyone2 视频去除背景 懒人整合包
人工智能·音视频
热门推荐
012026年3月AI领域大事件：DeepSeek引领开源风暴02GitHub 镜像站点03围棋-html版本04纯 HTML/CSS/JS 实现的高颜值登录页，还会眨眼睛！少女心爆棚！05Mac 本地部署 OMLX + 通义千问 Qwen3.5-27B 保姆级教程06UV安装并设置国内源07“wsl --install -d Ubuntu-22.04”下载慢，中国地区离线安装 Ubuntu 22.04 WSL方法（亲测2025年5月6日）08Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services09OpenClaw 使用和管理 MCP 完全指南10安娜的档案(Anna’s Archive) 镜像网站/国内最新可访问入口（持续更新）