OpenClaw 从新手到中级完整教程

什么是 OpenClaw

2026年，开源AI Agent圈子里最火的名字，非OpenClaw莫属。这个项目在GitHub上拿下了超过68,000颗星标，势头相当猛。它跟那些只会陪你聊天的机器人完全不是一回事——OpenClaw是那种真正能替你干活的个人AI助理。

简单梳理一下它到底强在哪：

：所有数据都存在你的设备上，不用上传到云端，隐私安全这块拿捏得死死的。

：不只是动动嘴皮子，它能实际操作你的电脑，自动处理邮件、日历管理、文件整理——实打实地干活。

：WhatsApp、Telegram、Discord、Slack……超过10个平台都能接，一个入口管所有通讯。

：跨会话保存上下文和你的偏好，用得越久它越懂你，效率也越来越高。

：代码完全开放，你只需要自备一个API Key就能用，属于完全自主控制的那种免费。

那么，OpenClaw和传统AI助手的区别到底在哪？举个例子你就明白了。

传统AI（比如ChatGPT）是这样的：

• 你：“帮我整理桌面文件”
• AI：“我建议你可以这样做：1. 创建文件夹…… 2. 按类型分类……”

OpenClaw呢？

• 你：“帮我整理桌面文件”
• OpenClaw：直接重命名、分类、移动文件，然后告诉你“完成了！我把47个文件按类型整理到5个文件夹里了。”

这就是“聊天机器人”和“AI Agent”之间那道实实在在的分界线。

新手阶段：基础入门

第一步：环境准备

开始之前，先检查一下你的电脑能不能跑。硬性要求不算高：

• 操作系统
  ：macOS、Linux或者Windows（需要用WSL）。新手推荐用Mac Mini，大概3800块的成本——不过因为OpenClaw太火，这台机器价格已经飙上去了，以前2500到2700就能搞定。

• Node.js
  ：v22或更高版本

• AI模型API Key
  ：Anthropic Claude或者OpenAI GPT的API密钥

实践任务1：检查环境

# 检查 Node.js 版本
node --version
# 如果版本低于 v22，需要升级
# macOS/Linux 使用 nvm
nvm install 22
nvm use 22

# Windows 访问 nodejs.org 下载安装

✅ 完成标准：终端显示 Node.js 版本 >= v18.0.0

第二步：安装 OpenClaw

安装方式有三条路可选，按你的水平挑就行。

# 全局安装 OpenClaw
npm install -g openclaw

# 验证安装
openclaw --version

# 拉取镜像
docker pull openclaw/openclaw:latest

# 运行容器
docker run -d --name openclaw 
  -v ~/.openclaw:/root/.openclaw 
  openclaw/openclaw:latest

# 克隆项目
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖
npm install

# 启动
npm run start

实践任务2：完成安装

选择一种方式，把OpenClaw装好就行。

✅ 完成标准：运行 openclaw --version 或 openclaw --help 能正常显示信息

第三步：初始化配置

运行下面这行代码，敲个回车，向导就启动了：

# 启动初始化向导
openclaw onboard

向导会一步步带你把这几件事搞定：

• 选择AI模型供应商（Anthropic Claude / OpenAI GPT / 本地模型）
• 输入API Key
• 选择消息平台（Telegram / Discord / WhatsApp 等）
• 配置系统权限（建议先选沙盒模式）

配置API Key

如果你手上还没有API Key，可以从官方渠道拿，或者找一些API聚合服务——通常支持多个模型，新用户还有免费额度可以用。

实践任务3：完成初始化

运行 openclaw onboard，老老实实走完所有配置步骤。

✅ 完成标准：

• 成功配置API Key
• 选好至少一个消息平台
• 完成权限设置（建议先选沙盒模式）

第四步：第一次对话

启动OpenClaw也不复杂：

# 启动 OpenClaw
openclaw

# 或者启动 Dashboard（Web 界面）
openclaw dashboard

连接消息平台，以Telegram为例：

在Telegram里找到 @BotFather，发送 /newbot 创建新机器人，拿到Bot Token，然后配置到OpenClaw里：

openclaw config set channels.telegram.botToken "YOUR_BOT_TOKEN"
openclaw config set channels.telegram.enabled true

之后在Telegram里搜到你的机器人，直接开聊。

实践任务4：第一次对话

跟你的OpenClaw助手来场简单的对话，试试这些：

你好，介绍一下你自己
你能帮我做什么？
现在几点了？

✅ 完成标准：机器人能正常回复你的消息

第五步：理解核心概念

Gateway（网关）

Gateway是OpenClaw跟外界打交道的通道：

• 消息网关
  ：Telegram、Discord、WhatsApp

• API网关
  ：HTTP API接口

• CLI网关
  ：命令行交互

Skills（技能）

Skills是OpenClaw的能力扩展包，说白了就是“插件”或者“应用”：

• 每个Skill管一组特定任务
• 可以从Clawhub安装第三方写好的Skills
• 当然也能自己动手写自定义Skill

Memory（记忆）

OpenClaw会记住这些东西：

• 你的偏好和习惯
• 之前的对话上下文
• 重要的信息和任务

Sandbox（沙盒）

沙盒模式会限制OpenClaw对系统的访问范围，保护你的电脑不遭殃：

• 沙盒模式
  ：限制文件系统、网络、Shell访问

• 完全访问模式
  ：给足所有权限（慎用）

实践任务5：探索工作空间

# 查看 OpenClaw 的工作目录
ls ~/.openclaw

# 查看配置文件
openclaw config list

# 查看已安装的 Skills
openclaw skills list

# 运行安全审计
openclaw security audit

✅ 完成标准：搞清楚OpenClaw的文件结构和基本配置

进阶阶段：实用技能

第六步：安装和使用 Skills

浏览Skills市场很方便。去Clawhub逛一圈，或者直接在终端里操作：

# 搜索 Skills
openclaw skills search email

# 查看 Skill 详情
openclaw skills info @author/skill-name

安装几个常用的Skills：

# 安装邮件管理 Skill
openclaw skills install @openclaw/email-manager

# 安装日历管理 Skill
openclaw skills install @openclaw/calendar

# 安装文件整理 Skill
openclaw skills install @openclaw/file-organizer

# 安装网页搜索 Skill（用 Ta vily 替代 Bra ve）
openclaw skills install @openclaw/ta vily-search

实践任务6：安装并测试 Skills

• 至少装3个Skills
• 每个都测试一遍功能
• 记一下哪些对你最有用

✅ 完成标准：成功安装并使用至少3个Skills

第七步：Google Workspace 集成

OpenClaw可以接手管理你的Gmail、Google Calendar、Google Docs等。

配置步骤

1. 创建 Google Cloud 项目
   ：去 console.cloud.google.com 新建一个项目，然后启用Gmail API、Google Calendar API、Google Drive API。

2. 创建服务账号
   ：在“IAM & Admin → Service Accounts”里创建服务账号，下载JSON密钥文件。

3. 配置 OpenClaw
   ：

openclaw config set integrations.google.enabled true
openclaw config set integrations.google.credentialsPath "/path/to/credentials.json"

1. 授权访问
   ：

openclaw integrations google authorize

实践任务7：Google 集成实践

试着完成以下任务：

1. 日历管理
   ：让OpenClaw帮你创建一个会议邀请

帮我在明天下午3点创建一个1小时的会议，主题是"项目评审"

1. 邮件处理
   ：让OpenClaw检查未读邮件

检查我的未读邮件，总结最重要的3封

1. 文档编辑
   ：创建一个Google Doc

创建一个新的 Google Doc，标题是"周报模板"，包含本周工作总结的框架

✅ 完成标准：成功完成至少2个Google Workspace任务

第八步：设置定时任务（Cron Jobs）

OpenClaw可以按照你的要求定期自动执行任务。

我想让你每天早上 8 点给我发送一份简报，包含：
1. 今天的天气
2. 我的日历安排
3. 未读邮件数量
4. 一句励志的话

它收到指令后会自动创建一个cron job。管理这些任务也不难：

# 列出所有定时任务
openclaw cron list

# 查看任务详情
openclaw cron show 

# 禁用任务
openclaw cron disable 

# 删除任务
openclaw cron delete 

实践任务8：创建定时任务

• 每日简报：每天早上发送天气和日程
• 每周总结：每周五下午发送本周统计
• 定时提醒：每天下午6点提醒你该结束工作了

✅ 完成标准：至少创建2个定时任务，并验证它们能跑起来

第九步：配置持久记忆

OpenClaw的记忆系统可以让它记住你的各种偏好。训练方法很简单——直接告诉它：

记住以下关于我的信息：
- 我的名字是 [你的名字]
- 我的工作是 [你的职业]
- 我的工作时间是周一到周五 9:00-18:00
- 我喜欢简洁的回复，不要太啰嗦
- 我使用中文交流
- 我的时区是 GMT+8

查看记忆也很方便：

# 查看记忆文件
cat ~/.openclaw/memory/long-term.json

# 或在对话中询问
你记得我的哪些信息？

实践任务9：个性化你的助手

• 给你的助手起个名字
• 告诉它你的基本信息和偏好
• 设置你的工作习惯和时间安排
• 最后测试一下它有没有记住

✅ 完成标准：OpenClaw在对话中能体现出对你的了解

中级阶段：高级应用

第十步：编写自定义 Skill

自定义Skill用YAML或Markdown格式定义，结构挺清晰的。

比如创建一个文件 ~/.openclaw/skills/my-first-skill.yaml：

name: "每日新闻摘要"
description: "获取并总结今日科技新闻"
version: "1.0.0"

triggers:
  - "今日新闻"
  - "科技新闻"

steps:
  - action: web_search
    query: "latest tech news today"
    max_results: 5
    
  - action: summarize
    content: "{{search_results}}"
    style: "bullet_points"
    
  - action: respond
    message: "