openclaw

关注公众号 jb51net

关闭
AI > openclaw >

OpenClaw 从新手到中级完整教程

脚本之家

什么是 OpenClaw

OpenClaw（曾用名 ClawdBot/Moltbot）是 2026 年最火的开源 AI Agent 项目，GitHub 已获得超过 68,000 星标。它不是普通的聊天机器人，而是一个真正能够执行任务的个人 AI 助理。

本地执行 数据存储在你的设备上，无需上传云端 完全掌控隐私和数据安全

真实执行 不仅是对话，能实际操作你的电脑 自动化处理邮件、日历、文件管理等任务

多平台消息 支持 WhatsApp、Telegram、Discord、Slack 等 10+ 平台 从单一入口管理所有通讯

持久记忆 跨会话保存上下文和用户偏好 随着时间推移越来越了解你，持续提升效率

开源免费 完全开源，只需自备 API Key 免费，完全自主控制

OpenClaw vs 传统 AI 助手

传统 AI（如 ChatGPT）：

OpenClaw：

这就是“聊天机器人”和“AI Agent”的本质区别。

新手阶段：基础入门

第一步：环境准备

系统要求

🔨 实践任务 1：检查环境

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

# Windows 访问 nodejs.org 下载安装

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

第二步：安装 OpenClaw

方法一：NPM 安装（推荐新手）

# 全局安装 OpenClaw
npm install -g openclaw

# 验证安装
openclaw --version

方法二：Docker 安装（推荐有 Docker 经验者）

# 拉取镜像
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

向导会引导你完成：

配置 API Key

如果你还没有 API Key，可以通过以下途径获取：

OpenAI GPT: platform.openai.com

API 聚合服务：apiyi.com

（支持多模型，新用户有免费额度）

🔨 实践任务 3：完成初始化

运行 openclaw onboard 并完成所有配置步骤。

✅ 完成标准：

第四步：第一次对话

启动 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 与外部世界交互的方式：

Skills（技能）

Skills 是 OpenClaw 的能力扩展，类似于“插件”或“应用”：

Memory（记忆）

OpenClaw 会记住：

Sandbox（沙盒）

沙盒模式限制 OpenClaw 的系统访问权限，保护你的电脑安全：

🔨 实践任务 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（使用 Tavily 替代 Brave）
openclaw skills install @openclaw/tavily-search

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

安装至少 3 个 Skills

测试每个 Skill 的功能

记录哪些 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"

4.授权访问

openclaw integrations google authorize

🔨 实践任务 7：Google 集成实践

完成以下任务：

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

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

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

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

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

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

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

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

OpenClaw 可以定期自动执行任务。

创建每日简报

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

OpenClaw 会自动创建一个定时任务（cron job）。

查看定时任务

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

# 查看任务详情
openclaw cron show <task-id>

# 禁用任务
openclaw cron disable <task-id>

# 删除任务
openclaw cron delete <task-id></task-id></task-id></task-id>

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

创建以下定时任务：

✅ 完成标准： 至少创建 2 个定时任务并验证它们能正常运行

第九步：配置持久记忆

OpenClaw 的记忆系统让它能记住你的偏好。

训练你的助手

告诉 OpenClaw 关于你的信息：

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

查看记忆

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

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

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

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

中级阶段：高级应用

第十步：编写自定义 Skill

Skills 使用 YAML 或 Markdown 格式定义。

Skill 基本结构

创建文件 ~/.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: "📰 今日科技新闻摘要：

{{summary}}"

安装自定义 Skill

# 重新加载 Skills
openclaw skills reload

# 测试 Skill
openclaw skills test "每日新闻摘要"

🔨 实践任务 10：创建自定义 Skill

创建一个自定义 Skill，实现以下功能之一：

✅ 完成标准： 成功创建并运行一个自定义 Skill

第十一步：多 Agent 管理

你可以运行多个 OpenClaw 实例，每个有不同的配置和用途。

创建多个 Agent

# 创建工作用 Agent
openclaw create-agent work
openclaw config --agent work set ai.model "claude-sonnet-4.6"

# 创建个人用 Agent
openclaw create-agent personal
openclaw config --agent personal set ai.model "gpt-5.3"

# 切换 Agent
openclaw switch-agent work
openclaw switch-agent personal

# 列出所有 Agent
openclaw list-agents

使用场景

🔨 实践任务 11：配置多 Agent

创建至少 2 个不同用途的 Agent，并为它们配置不同的：

✅ 完成标准： 能够在不同 Agent 之间切换并使用

第十二步：Docker 沙盒安全实践

Docker 沙盒提供最强的安全隔离。

配置 Docker 沙盒

# 安装 Docker（如果还没有）
# macOS: 下载 Docker Desktop
# Linux: sudo apt install docker.io

# 配置 OpenClaw 使用 Docker 沙盒
openclaw config set sandbox.mode "docker"
openclaw config set sandbox.docker.image "openclaw/sandbox:latest"

# 测试沙盒
openclaw sandbox test

沙盒限制

Docker 沙盒会限制：

🔨 实践任务 12：安全配置

✅ 完成标准： 安全审计通过，沙盒正常工作

第十三步：浏览器控制

OpenClaw 可以控制浏览器执行复杂的网页操作。

启用浏览器控制

# 安装浏览器控制插件
openclaw plugins install @openclaw/browser-control

# 配置浏览器
openclaw config set browser.enabled true
openclaw config set browser.headless false  # false 表示显示浏览器窗口

使用示例

打开浏览器，访问 GitHub，搜索 "openclaw"，并告诉我前 3 个结果
帮我在亚马逊上搜索 "机械键盘"，找到评分最高的 3 个产品，记录价格

🔨 实践任务 13：浏览器自动化

使用浏览器控制完成以下任务：

✅ 完成标准： 成功完成至少 1 个浏览器自动化任务

第十四步：与其他工具集成

Linear 集成（项目管理）

# 安装 Linear Skill
openclaw skills install @openclaw/linear

# 配置 API Key
openclaw config set integrations.linear.apiKey "YOUR_LINEAR_API_KEY"

使用示例：

在 Linear 中创建一个新任务："修复登录页面的 bug"，优先级高

Obsidian 集成（笔记）

# 安装 Obsidian Skill
openclaw skills install @openclaw/obsidian

# 配置 Obsidian vault 路径
openclaw config set integrations.obsidian.vaultPath "/path/to/obsidian/vault"

使用示例：

在 Obsidian 中创建一篇新笔记，标题是"OpenClaw 学习笔记"

🔨 实践任务 14：集成第三方工具

选择至少 2 个你常用的工具，将它们与 OpenClaw 集成：

✅ 完成标准： 成功集成并使用至少 2 个第三方工具

第十五步：高级配置优化

性能优化

# 配置缓存
openclaw config set cache.enabled true
openclaw config set cache.ttl 3600

# 配置并发请求
openclaw config set ai.maxConcurrentRequests 3

# 配置超时
openclaw config set ai.timeout 30000

成本控制

# 设置每日 API 调用限制
openclaw config set ai.dailyLimit 1000

# 设置每月预算（美元）
openclaw config set ai.monthlyBudget 50

# 查看使用统计
openclaw stats usage
openclaw stats cost

日志和调试

# 启用详细日志
openclaw config set logging.level "debug"

# 查看日志
openclaw logs

# 查看特定时间的日志
openclaw logs --since "2026-02-20"

# 导出日志
openclaw logs --export logs.txt

🔨 实践任务 15：优化配置

✅ 完成标准：

实践任务清单

新手阶段（必做）

进阶阶段（推荐）

中级阶段（进阶）

实战项目（挑战）

常见问题解答

Q1: OpenClaw 的技术要求是什么？

OpenClaw 主要面向有一定技术背景的用户。你需要：

但安装过程已经大大简化，只要你能运行 npm 命令，就能使用 OpenClaw。

Q2: 如何管理安全风险？

关键安全建议：

Q3: API 成本大概是多少？

取决于使用强度：

省钱技巧：

Q4: 可以使用本地模型吗？

可以！OpenClaw 支持通过 Ollama 连接本地模型：

# 安装 Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# 下载模型
ollama pull llama3.2

# 配置 OpenClaw
openclaw config set ai.provider "ollama"
openclaw config set ai.model "llama3.2"
openclaw config set ai.baseUrl "http://localhost:11434"

注意：本地模型的能力通常不如云端大模型，复杂任务可能表现不佳。

Q5: OpenClaw 支持中文吗？

完全支持！OpenClaw 有中文社区维护的汉化版本：

你也可以使用英文版，它能理解和回复中文。

Q6: 如何备份我的配置？

# 备份整个工作目录
cp -r ~/.openclaw ~/.openclaw-backup

# 或使用 Git 同步（推荐）
cd ~/.openclaw
git init
git add .
git commit -m "Initial backup"
git remote add origin YOUR_GITHUB_REPO
git push -u origin main

OpenClaw 支持 GitHub 同步功能，可以自动备份配置。

Q7: 遇到问题如何调试？

# 1. 查看日志
openclaw logs

# 2. 运行健康检查
openclaw doctor

# 3. 运行安全审计
openclaw security audit

# 4. 启用调试模式
openclaw config set logging.level "debug"
openclaw

# 5. 查看配置
openclaw config list

Q8: 可以在服务器上运行吗？

可以！很多用户在 VPS 或云服务器上运行 OpenClaw：

推荐平台：

注意事项：

学习资源

官方资源

视频教程

文字教程

中文资源

社区

下一步

完成这个教程后，你应该已经掌握了 OpenClaw 从基础到中级的大部分核心技能。接下来你可以：

OpenClaw 代表了 AI 助手的下一步：从“会说话的工具”到“会做事的助手”。对于愿意花时间配置的用户来说，它可以成为真正的数字分身。

祝你在 OpenClaw 的探索之旅中收获满满！