新手上手20 分钟阅读

OpenClaw 完全指南：从首次安装到进阶用户

一份实操指南，涵盖从安装 OpenClaw 到编写自定义 Skills、设置自动化任务和管理多个 Agent 的全部内容。2026 年更新版。

OpenClaw Guides

Tutorial Authors

2026-03-02

什么是 OpenClaw？为什么值得关注？

OpenClaw 是一个开源 AI Agent，运行在你自己的设备上——笔记本电脑、家庭服务器或云端 VPS。与仅能回答问题的浏览器端 AI 工具不同，OpenClaw 能够采取行动：阅读你的邮件、安排会议、整理文件、通过 WhatsApp、Telegram 和 Discord 发送消息，并通过自然语言自动化重复性工作流程。

自 2026 年 1 月发布以来，该项目已超过 244,000 GitHub Stars，成为有史以来增长最快的开源仓库之一。原因很简单：人们需要一个真正能做事的 AI 助手，而不是只会纸上谈兵的 AI。

以下是一个直观的对比：

传统 AI 聊天机器人：

你："帮我整理桌面文件。" AI："好的！以下是一些建议：1. 按类型创建文件夹... 2. 相应地移动文件..."

OpenClaw：

你："帮我整理桌面文件。" OpenClaw：重命名、分类并移动了 47 个文件到 5 个文件夹 ——"完成！我已按文件类型整理好了所有内容。"

这就是核心转变：从聊天机器人到 Agent。

本指南将带你走完整个旅程——从首次安装到编写自定义 Skills 和管理多个 Agent。无论你只有 30 分钟还是一整个下午，都可以按自己的节奏逐步完成每个部分。

入门：安装与设置

前置要求

Node.js 22+（推荐 LTS 版本）—— 使用 node --version 检查
AI 模型 API Key —— Anthropic Claude（推荐）、OpenAI 或通过 Ollama 运行的本地模型
macOS、Linux 或 Windows（需 WSL2）

安装 OpenClaw

最快的方式是使用一行命令安装：

bash

curl -fsSL https://openclaw.ai/install.sh | bash

该命令会检测你的系统，按需安装依赖，并启动设置向导。如果你更喜欢使用 npm：

bash

npm install -g openclaw@latest

Docker 用户可以使用：

bash

docker pull openclaw/openclaw:latest
docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

有关每种安装方式的详细步骤，请参阅我们的快速入门指南。

运行引导向导

安装完成后，引导向导会带你完成所有配置：

bash

openclaw onboard

你需要配置以下三项内容：

AI 提供商和 API Key —— Anthropic Claude 效果最佳。如果你还没有 API Key，可以在 anthropic.com 获取。预算有限？请参阅我们的模型选择与费用指南。
消息渠道 —— 至少选择一个：Telegram 最容易上手（5 分钟即可设置）。我们为 Telegram、WhatsApp 和 Discord 提供了专门的教程。
安全模式 —— 目前选择 Sandbox 即可。等你熟悉后，可以升级为完全访问权限。

验证是否正常运行

bash

openclaw status

你应该看到：

Gateway: Running ✓
Model: Connected ✓
Channels: 1 active

现在打开你选择的消息应用，发送第一条消息。试试简单的指令：

"你能做什么？"
"现在几点了？"
"总结一下最新的科技新闻。"

如果机器人回复了，恭喜——你已经拥有了一个可以工作的 AI Agent。

核心概念：OpenClaw 的工作原理

在深入学习之前，了解 OpenClaw 的四大构建模块会很有帮助。可以这样理解：

Gateway —— 前门

Gateway 是 OpenClaw 与外部世界连接的方式。它处理来自 Telegram、Discord、WhatsApp、Web API 甚至命令行的消息。你可以同时运行多个 Gateway——例如，Telegram 用于个人用途，Slack 用于工作。

Skills —— 工具箱

Skills 代表 OpenClaw 能做的事情。每个 Skill 是一个打包好的能力：发送邮件、搜索网页、管理文件、控制浏览器。可以把它们想象成智能手机上的应用。OpenClaw 内置了一些 Skills，但真正的力量来自 Clawhub 上的社区生态系统，以及你自己编写的 Skills。

浏览我们的 Skills 目录了解有哪些可用的 Skills。

Memory —— 大脑

OpenClaw 能够跨对话记住信息。告诉它你的名字、工作时间、偏好设置——它会保留这些上下文。与无状态的聊天机器人不同，OpenClaw 会建立对你是谁以及你如何工作的持久理解，数据存储在本地 ~/.openclaw/memory/ 目录中。

Sandbox —— 安全网

Sandbox 控制 OpenClaw 在你系统上的操作权限。在 Sandbox 模式下，它无法访问任意文件或执行破坏性命令。这是你的安全防线——在尝试新 Skills 或赋予 OpenClaw 更广泛权限时尤其重要。

有关详细的安全设置，请参阅我们的安全配置模板。

安装和使用 Skills

Skills 是 OpenClaw 从"有趣的演示"变成"日常工具"的关键所在。以下是入门方法。

浏览与安装

bash

# 按关键字搜索 Skills
openclaw skills search email

# 查看特定 Skill 的详细信息
openclaw skills info @openclaw/email-manager

# 安装它
openclaw skills install @openclaw/email-manager

管理你的 Skills

bash

# 列出所有已安装的 Skills
openclaw skills list

# 更新所有 Skills
openclaw skills update

# 移除不再需要的 Skill
openclaw skills remove @openclaw/file-organizer

在安装第三方 Skills 之前，请查看我们的 Skills 安全检查清单以确保安全。

设置自动化任务（定时任务）

OpenClaw 最实用的功能之一就是定时自动化。你不必每天早上都让 Agent 执行某件事，只需设置一次就可以让它自动运行。

创建每日简报

只需用自然语言告诉你的 Agent：

"每天早上 8 点，给我发送一份简报，包含今天的天气、日历事件和未读邮件数量。"

OpenClaw 会自动创建定时任务。你也可以手动管理它们：

bash

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

# 查看特定任务的详细信息
openclaw cron show <task-id>

# 暂停任务
openclaw cron disable <task-id>

# 恢复任务
openclaw cron enable <task-id>

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

自动化创意

每日简报 —— 每天早上获取天气 + 日历 + 未读邮件
每周总结 —— 周五下午汇报本周活动
价格追踪 —— 监控商品页面，降价时提醒你
下班提醒 —— 晚上 6 点温馨提醒收工
收件箱清理 —— 每晚自动归档低优先级邮件

配置持久化 Memory

OpenClaw 的 Memory 系统使它变得个性化。你提供的上下文越多，它为你服务得越好。

教你的 Agent 了解你

发送这样一条消息：

"记住关于我的这些信息：我叫 Alex。我是一名产品经理。我的工作时间是周一到周五，上午 9 点到下午 6 点，时区 GMT+8。我喜欢简洁的回复。我用英语交流，但也能读中文。"

OpenClaw 会将这些信息存储在长期 Memory 中，并应用到未来的每次交互中。

查看和编辑 Memory

bash

# 查看你的 Agent 记住了什么
cat ~/.openclaw/memory/long-term.json

# 或者在聊天中直接询问
"你了解我哪些信息？"

你也可以更正或删除记忆：

"忘掉我之前的工作时间。我现在的工作时间是上午 10 点到晚上 7 点。"

Memory 的工作原理

OpenClaw 使用三层 Memory：

短期 Memory —— 当前对话上下文（每次会话结束后清除）
长期 Memory —— 关于你的持久信息（偏好、习惯、个人资料）
情景 Memory —— 过往交互记录（用于长期模式识别）

这种分层方式意味着你使用 Agent 的时间越长，它就越好用，而无需不断提醒。

编写你的第一个自定义 Skill

当内置和社区 Skills 无法满足你的特定需求时，你可以自己编写。OpenClaw Skills 使用简单的 YAML 格式。

Skill 结构

在 ~/.openclaw/skills/daily-news.yaml 创建一个新文件：

yaml

name: "Daily Tech News"
description: "Fetches and summarizes today's top tech headlines"
version: "1.0.0"

triggers:
  - "tech news"
  - "today's news"
  - "news summary"

steps:
  - action: web_search
    query: "top tech news today"
    max_results: 5

  - action: summarize
    content: "{{search_results}}"
    style: "bullet_points"

  - action: respond
    message: |
      Here's your tech news summary:

      {{summary}}

测试它

bash

# 重新加载 Skills 以识别新文件
openclaw skills reload

# 测试它
openclaw skills test "Daily Tech News"

然后在对话中试试："给我今天的科技新闻。"

构建更复杂的 Skills

Skills 可以将多个动作串联起来：

web_search —— 搜索网页
summarize —— 将文本压缩为要点或段落
respond —— 发送格式化的回复
file_read / file_write —— 读取或创建文件
shell_exec —— 执行 Shell 命令（需要相应权限）
http_request —— 调用外部 API

你可以将这些组合起来构建工作流，例如：搜索机票价格 → 对比结果 → 将摘要写入文件 → 通过 Telegram 通知你。

多 Agent 管理

随着使用的深入，你可能需要为生活的不同方面创建独立的 Agent——一个用于工作，一个用于个人事务，一个用于实验。

创建 Agent

bash

# 创建一个使用 Claude Sonnet 的工作 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 "claude-haiku-4-5"

# 列出所有 Agent
openclaw list-agents

# 在不同 Agent 之间切换
openclaw switch-agent work

为什么使用多个 Agent？

| Agent | 模型 | 连接到 | 用途 | |-------|------|--------|------| | Work | Claude Sonnet | Slack, Gmail, Linear | 专业工作、邮件分流 | | Personal | Claude Haiku | Telegram, Google Calendar | 日程安排、提醒、个人事务 | | Lab | Ollama（本地） | 仅命令行 | 测试新 Skills、实验 |

每个 Agent 拥有自己独立的 Memory、Skills 和渠道连接——彼此完全隔离。

浏览器自动化

OpenClaw 能够控制浏览器来执行超越简单 API 调用的任务：填写表单、从网页提取数据、跨站比价或截图。

启用 Browser Control

bash

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

# 启用它
openclaw config set browser.enabled true

# 显示浏览器窗口（设为 true 用于调试）
openclaw config set browser.headless false

使用场景

"打开 GitHub，找到今天热门的趋势仓库。"
"打开 Amazon，搜索机械键盘，列出评分最高的前 3 个并附上价格。"
"在 example.com 上用我的信息填写联系表单。"
"对我的个人作品网站截图。"

浏览器自动化功能强大但资源消耗较高。请将其用于真正需要与网页进行可视化交互的任务——对于简单的数据获取，使用 Web Search Skill 更快也更经济。

聊天之外的集成

OpenClaw 不仅仅连接消息应用。以下是一些热门集成：

Google Workspace

bash

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

连接后，你可以通过自然语言管理 Gmail、Google Calendar 和 Google Drive。

项目管理（Linear、Jira）

bash

openclaw skills install @openclaw/linear
openclaw config set integrations.linear.apiKey "YOUR_API_KEY"

"在 Linear 中创建一个高优先级任务：修复登录页面重定向 Bug。"

笔记应用（Obsidian、Notion）

bash

openclaw skills install @openclaw/obsidian
openclaw config set integrations.obsidian.vaultPath "/path/to/vault"

"在 Obsidian 中创建一篇标题为 'Meeting Notes — March 2' 的新笔记，包含今天的讨论要点。"

完整的支持平台列表，请查看我们的渠道集成目录。

安全与费用控制

Docker Sandbox

为获得最大隔离性，可以在 Docker Sandbox 内运行 OpenClaw：

bash

openclaw config set sandbox.mode "docker"
openclaw config set sandbox.docker.image "openclaw/sandbox:latest"
openclaw sandbox test

这会将文件系统访问、网络访问和 Shell 执行限制在预定义的范围内。

运行安全审计

bash

openclaw security audit --deep

此命令会检查权限配置错误、暴露的令牌和其他常见问题。

有关完整的安全加固指南，请阅读端口暴露与远程访问。

控制你的支出

API 费用可能会累积。以下是设置防护措施的方法：

bash

# 设置每日请求限制
openclaw config set ai.dailyLimit 1000

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

# 查看使用情况
openclaw stats usage
openclaw stats cost

典型月度费用：

| 使用级别 | 说明 | 预估费用 | |---------|------|---------| | 轻度 | 每天 10-20 次对话 | $5–10/月 | | 中度 | 50-100 次对话 + 定时任务 | $20–30/月 | | 重度 | 自动化 + 浏览器控制 | $50–100/月 |

想深入了解费用优化？请参阅我们的模型选择与费用指南。

故障排除速查表

| 症状 | 可能原因 | 解决方法 | |------|---------|---------| | 启动时出现 EADDRINUSE | 端口 18789 已被占用 | openclaw gateway start --port 18790 | | 401 Unauthorized | API Key 无效或过期 | openclaw config set api-key | | 机器人没有响应 | 渠道未连接 | 检查 openclaw status 和渠道配置 | | 响应缓慢 | 模型过载或网络问题 | 尝试更轻量的模型或检查网络连接 | | Skills 未加载 | 安装后需要重新加载 | openclaw skills reload |

更多详细的故障排除方法，请参阅我们的常见错误指南。

实用诊断命令

bash

# 全面健康检查
openclaw doctor

# 查看日志
openclaw logs

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

下一步

你已经掌握了大量内容。根据你的兴趣，以下是后续方向：

想接入更多渠道？ 探索我们的 50+ 渠道集成指南——从 Slack 和 Teams 到 WeChat 和 Line。
关注安全？ 阅读 Skills 安全检查清单和安全配置指南。
想要自托管？ 查看我们的远程访问与端口暴露指南。
准备贡献代码？ OpenClaw GitHub 仓库欢迎 Pull Request、Skill 贡献和 Bug 报告。

OpenClaw 代表了我们与 AI 交互方式的真正转变——从寻求建议到委派真实任务。这个项目发展迅速，社区不断壮大，现在正是开始构建你自己的 AI Agent 系统的最佳时机。

什么是 OpenClaw？为什么值得关注？

入门：安装与设置

前置要求

安装 OpenClaw

运行引导向导

验证是否正常运行

核心概念：OpenClaw 的工作原理

Gateway —— 前门

Skills —— 工具箱

Memory —— 大脑

Sandbox —— 安全网

安装和使用 Skills

浏览与安装

推荐首先安装的五个 Skills

管理你的 Skills

设置自动化任务（定时任务）

创建每日简报

自动化创意

配置持久化 Memory

教你的 Agent 了解你

查看和编辑 Memory

Memory 的工作原理

编写你的第一个自定义 Skill

Skill 结构

测试它

构建更复杂的 Skills

多 Agent 管理

创建 Agent

为什么使用多个 Agent？

浏览器自动化

启用 Browser Control

使用场景

聊天之外的集成

Google Workspace

项目管理（Linear、Jira）

笔记应用（Obsidian、Notion）

安全与费用控制

Docker Sandbox

运行安全审计

控制你的支出

故障排除速查表

实用诊断命令

下一步