OpenClaw安装与使用教程

本文将详细介绍如何安装和使用开源 AI Agent 项目 ​OpenClaw​。
从环境准备、安装部署，到基本使用与进阶功能，帮助你快速上手这个目前非常火的 AI Agent 框架。

一、项目介绍

OpenClaw 是一个开源的 ​自主 AI Agent 框架​，可以将大模型（如 GPT、Claude、DeepSeek 等）变成可以 ​执行真实任务的智能助手​。(OpenClaw)

与普通聊天机器人不同，OpenClaw 可以：

  • 控制浏览器
  • 执行系统命令
  • 自动完成任务
  • 调用插件（skills）
  • 与 Telegram / Discord 等平台集成

其特点：

  • 本地运行（隐私更安全）
  • 支持多种大模型
  • 插件化扩展能力
  • 开源可定制

该项目由开发者 Peter Steinberger 于 2025 年发布，并迅速成为 GitHub 上增长最快的开源 AI 项目之一。(维基百科)

项目地址：

1
https://github.com/openclaw/openclaw

二、OpenClaw架构概览

OpenClaw 的整体架构大致如下：

1
2
3
4
5
6
7
8
9
10
11
用户
   │
聊天平台 / CLI
   │
OpenClaw Agent
   │
技能系统 (Skills)
   │
工具系统 (Tools)
   │
大模型 (LLM API)

组件说明：

组件 作用
Agent 核心控制逻辑
Skills 插件扩展功能
Tools 执行具体操作
LLM API AI模型能力
Gateway 系统入口

工作流程：

1
2
3
4
5
6
7
8
9
用户请求
   ↓
OpenClaw解析任务
   ↓
调用LLM规划步骤
   ↓
调用Tools执行
   ↓
返回结果

三、环境准备

安装 OpenClaw 之前需要准备以下环境：

1 Node.js

建议版本：

1
Node.js >= 18

检查版本：

1
node -v

安装方式：

Linux / Mac

1
https://nodejs.org

Windows 建议：

1
nvm-windows

2 Python（可选）

部分插件需要 Python：

1
Python >= 3.10

3 API Key

OpenClaw 支持多种模型：

模型 是否推荐
OpenAI GPT 推荐
Claude 推荐
DeepSeek 推荐
本地 Ollama 可选

因为 OpenClaw 本身是免费的，费用主要来自模型 API。(OpenClaws.io)

四、安装 OpenClaw

方法一：npm 安装（推荐）

直接全局安装：

1
npm install -g openclaw

安装完成后检查：

1
openclaw --version

如果成功会看到版本号。

方法二：源码安装

克隆项目：

1
git clone https://github.com/openclaw/openclaw.git

进入项目：

1
cd openclaw

安装依赖：

1
npm install

运行：

1
npm run dev

五、初始化配置

首次运行：

1
openclaw init

系统会启动一个 ​初始化向导​。

配置内容包括：

  • LLM API Key
  • 默认模型
  • 本地工作目录
  • 插件安装

配置 API Key

例如 OpenAI：

1
OPENAI_API_KEY=sk-xxxx

Linux / macOS：

1
export OPENAI_API_KEY=sk-xxxx

Windows：

1
setx OPENAI_API_KEY "sk-xxxx"

六、运行 OpenClaw Agent

运行 agent：

1
openclaw start

启动后会看到：

1
2
OpenClaw Gateway running
http://localhost:3000

打开浏览器：

1
http://localhost:3000

即可进入 Web UI。

七、基础使用示例

示例1：总结新闻

1
openclaw run "summarize today's top tech news"

Agent 执行流程：

1
2
3
4
5
6
7
任务理解
↓
调用搜索工具
↓
整理信息
↓
生成总结

示例2：自动发送邮件

1
openclaw run "send daily report to my team"

Agent 会：

1
2
3
4
5
6
7
读取文件
↓
总结内容
↓
调用邮件工具
↓
发送邮件

示例3：自动化任务

例如：

1
openclaw run "check my calendar and schedule focus time"

八、技能（Skills）系统

OpenClaw 支持插件系统：

1
skills

安装插件：

1
openclaw install news-aggregator

运行：

1
openclaw run "summarize today's hacker news"

常见技能：

技能 功能
browser 浏览网页
filesystem 文件管理
email 邮件发送
calendar 日程管理
search 搜索引擎

九、自定义 Agent 人格

OpenClaw 有一个非常有趣的配置：

1
soul.md

路径：

1
~/.openclaw/soul.md

示例：

1
2
3
4
You are a concise technical assistant.
Always respond in Chinese.
Avoid emojis.
Be precise and structured.

系统启动时会加载该文件。

它相当于：

1
Agent System Prompt

十、进阶使用

1 定时任务

可以创建自动任务：

1
every day at 8:00 summarize news

2 多 Agent

可以创建多个 Agent：

1
2
3
research-agent
coding-agent
finance-agent

3 本地模型

如果不想使用 API，可以用：

1
Ollama

安装：

1
https://ollama.com

运行：

1
ollama run llama3

然后在 OpenClaw 配置：

1
model: ollama/llama3

十一、安全注意事项

由于 OpenClaw 可以 ​执行系统命令和读取文件​，需要注意安全问题。

例如：

  • 不要安装未知插件
  • 不要运行来源不明的 skill
  • 使用最新版本

研究人员发现 AI agent 在插件系统中存在安全风险，因此需要谨慎配置权限。(arXiv)

十二、常见问题

Q1 OpenClaw 免费吗？

软件本身 ​完全开源免费​。
费用主要来自 LLM API 调用。(OpenClaws.io)

Q2 OpenClaw 和 ChatGPT 有什么区别？

ChatGPT OpenClaw
云端服务 本地运行
只聊天 可执行任务
封闭系统 开源系统

Q3 适合哪些人？

  • AI开发者
  • 自动化工程师
  • AI Agent研究者
  • 想搭建私人AI助手的人

十三、总结

OpenClaw 是目前最受关注的 ​开源 AI Agent 框架之一​，它让 AI 从“聊天工具”升级为 ​真正可以执行任务的智能助手​。

优点：

  • 开源免费
  • 本地运行
  • 可扩展
  • 支持多模型

缺点：

  • 配置较复杂
  • 插件生态仍在发展
  • 安全需要注意

如果你想体验 ​AI Agent 自动化工作流​，OpenClaw 是非常值得尝试的项目。