OpenClaw（原名 Clawdbot/Moltbot）是开源本地 AI 智能体执行引擎，核心是 “给大模型装双手”—— 能理解自然语言、直接操作电脑 / 文件 / 软件、执行自动化任务，数据本地存储、隐私可控，零代码 / 低代码即可使用。以下从入门→进阶→精通→实战全流程详解。

---

一、入门篇：认识 + 安装 + 基础使用（3 天搞定）

1.1 核心概念与架构

• 定位：AI 执行中枢（非大模型），三层架构：
  • Gateway：网关，多平台接入（飞书 / 企微 / QQ / 终端）、消息路由
  • Agent：大脑，对接 GPT-4o/Claude/ 通义千问 / Ollama 本地模型
  • Skills：手脚，16000 + 插件（文件 / 邮件 / 浏览器 / 代码 / 搜索）
• 核心优势：本地部署、隐私安全、无限扩展、多端适配、免费开源
• 适用场景：个人助理、办公自动化、开发辅助、内容创作、远程控制

1.2 环境准备（全平台通用）

• 必备：Node.js 18+、Python 3.8+、Git
• 可选：Docker（容器化）、Ollama（本地模型）
• 系统：Windows/macOS/Linux 全支持

1.3 三种安装方式（推荐 npm）

方式 1：npm 全局安装（最快）

bash

运行

# 安装
npm install -g openclaw
# 或pnpm（更快）
pnpm add -g openclaw
# 验证
openclaw --version
# 初始化配置（向导式）
openclaw onboard

方式 2：源码安装

bash

运行

git clone https://github.com/astral-sh/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm link --global

方式 3：Docker 部署

bash

运行

docker pull openclaw/openclaw:latest
docker run -d --name openclaw -v openclaw-data:/data -p 3000:3000 openclaw/openclaw:latest

1.4 首次配置（关键）

1. 选择模型：
   • 国内：通义千问 / 豆包（免费 / 低成本）
   • 海外：GPT-4o/Claude 3.5（效果强）
   • 隐私：Ollama 本地模型（数据不外传）
2. 接入渠道：终端（默认）、飞书、企微、QQ、Discordgetopenclaw.ai
3. 测试指令（Hello World）：

bash

运行

# 终端直接输入
帮我创建OpenClawTest文件夹，新建txt写入"Hello OpenClaw"

1.5 必装 5 大基础 Skills（一行命令）

bash

运行

# 1. 邮件管理
openclaw skills install @openclaw/email-manager
# 2. 日历日程
openclaw skills install @openclaw/calendar
# 3. 文件整理
openclaw skills install @openclaw/file-organizer
# 4. 联网搜索（Tavily）
openclaw skills install @openclaw/tavily-search
# 5. 浏览器控制
openclaw skills install @openclaw/browser-control

---

二、进阶篇：熟练使用 + 个性化 + 自动化（7 天精通）

2.1 基础命令速查（日常必备）

bash

运行

# 网关管理
openclaw gateway start  # 启动服务
openclaw gateway stop   # 停止服务
openclaw gateway status # 查看状态

# 技能管理
openclaw skills list    # 查看已装技能
openclaw skills search 关键词 # 搜索技能
openclaw skills reload  # 重载技能

# 任务/定时
openclaw cron list      # 查看定时任务
openclaw cron delete ID # 删除定时任务

# 记忆管理
openclaw memory show    # 查看长期记忆
openclaw memory clear   # 清空记忆

2.2 个性化 AI 助手（贴合你的习惯）

• 设置偏好（永久生效）

plaintext

记住：
- 我用中文，喜欢简洁回复
- 工作时间9:00-18:00
- 优先用通义千问，编程用GPT-4o
- 文件默认保存到D:/OpenClaw

• 多 Agent 分工（不同任务不同 AI）

yaml

# 配置文件：~/.openclaw/config.yaml
agents:
  - name: "办公助手"
    tools: { allow: ["document", "schedule", "email"] }
  - name: "开发助手"
    tools: { allow: ["code", "github", "terminal"] }
  - name: "隐私助手"
    tools: { allow: ["file-local"] }
    model: "ollama:qwen2"

2.3 自动化工作流（Workflows，核心灵魂）

用途：多技能组合、定时 / 触发执行、复杂任务自动化

示例 1：每日早报（自动生成 + 发送）

yaml

# 路径：~/.openclaw/workflows/daily-report.yaml
name: "每日工作早报"
description: "每天8点发送天气+日程+未读邮件"
trigger:
  type: "schedule"
  cron: "0 8 * * *" # 每天8点
steps:
  - name: "获取天气"
    skill: "tavily-search"
    params: { query: "深圳今日天气" }
  - name: "获取日程"
    skill: "calendar"
    params: { action: "list", date: "today" }
  - name: "查未读邮件"
    skill: "email-manager"
    params: { action: "unread" }
  - name: "生成报告"
    skill: "summarize"
    params: { content: "{{天气}}{{日程}}{{邮件}}" }
  - name: "发送到飞书"
    skill: "feishu"
    params: { message: "{{summary}}" }

示例 2：文件自动整理

plaintext

每周日晚10点，把Downloads中超过30天的文件按"图片/文档/视频"分类，移动到D:/整理

2.4 进阶 Skills（效率拉满）

1. LosslessClaw：永久记忆，不丢失历史对话
2. GitHub Manager：代码仓管理、提交、PR、Issues
3. Code Executor：自动写代码 + 运行 + 调试（Python/JS/Java）
4. GOG：全办公打通（Gmail/Outlook/ 日历 / Excel）
5. Browser Auto：网页自动化（填表 / 爬虫 / 发布）

---

三、精通篇：自定义开发 + 高级优化 + 故障排查（10 天大成）

3.1 自定义 Skill（YAML 编写，零代码）

步骤 1：创建 Skill 文件

yaml

# ~/.openclaw/skills/tech-news.yaml
name: "科技新闻汇总"
description: "获取每日科技新闻并总结"
triggers: ["今日科技", "科技新闻"]
steps:
  - action: web_search
    query: "2026科技最新进展"
    max_results: 5
  - action: summarize
    content: "{{search_results}}"
  - action: respond
    message: "今日科技：{{summary}}"

步骤 2：加载使用

bash

运行

openclaw skills reload
# 触发
今日科技

3.2 多模型协同（省钱 + 效果最优）

• 规则配置（自动切换）
  • 办公 / 日常：通义千问（低成本）
  • 编程 / 创作：GPT-4o/Claude（高质量）
  • 隐私数据：Ollama 本地模型（安全）
• 设置路径：设置→模型管理→模型协同→添加规则

3.3 成本优化（Token 省 50%-70%）

1. 上下文瘦身：AGENTS.md≤800token、MEMORY.md≤2000token
2. 定时重置：每天 0 点自动/reset，避免历史累积
3. 任务合并：一次指令多任务（如 "整理文件 + 查邮件 + 生成周报"）
4. 本地优先：常用功能用本地 Skills，减少 API 调用

3.4 私有知识库（企业 / 专业必备）

1. 打开：设置→私有知识库→上传文档（PDF/Word/Excel/Markdown）
2. 自动解析（本地处理，100MB≈1 分钟）
3. 提问示例：

plaintext

整理知识库中2026Q1营销方案要点
根据公司流程写项目立项报告
用行业标准生成产品使用说明

3.5 故障排查（常见问题）

• 安装失败：检查 Node.js 版本、清理 npm 缓存npm cache clean --force
• 模型调用失败：核对 API Key、网络、模型权限
• 技能不生效：openclaw skills reload、检查依赖
• 内存占用高：关闭无用 Skills、限制并发任务、升级硬件

---

四、实战篇：五大场景全案例（直接套用）

场景 1：职场办公自动化

• 指令：

plaintext

每天8点发天气+日程+未读邮件
每周五18点生成周报，发送给领导
客户邮件自动回复，标记重要事项

场景 2：开发效率提升

• 指令：

plaintext

写Python脚本：把JPEG批量转PNG
排查这段代码Bug，优化并标注修改
根据代码生成Markdown接口文档

场景 3：内容创作助手

• 指令：

plaintext

搜索2026AI趋势，写3000字干货文章
生成小红书爆款文案+标题
把文章转成视频脚本，配旁白

场景 4：文件 / 数据管理

• 指令：

plaintext

自动整理Downloads，按类型分类
备份D盘项目文件到移动硬盘
Excel数据清洗，生成可视化图表

场景 5：远程控制电脑

• 指令：

plaintext

远程重启电脑，完成后提醒
打开微信发消息：明天10点开会
定时启动软件，执行指定任务

---

五、精通路线图（30 天从小白到大神）

• 第 1-3 天：安装配置→基础指令→必装 Skills→Hello World
• 第 4-10 天：个性化设置→Workflows 自动化→常用 Skills 熟练
• 第 11-20 天：自定义 Skill→多模型协同→私有知识库→成本优化
• 第 21-30 天：复杂 Workflows 编排→二次开发→故障排查→全场景实战