01. OpenClaw 入门：打造你的个人 AI 助手

适用于 OpenClaw v2026.2 | 本文假设你熟悉基本的命令行操作，了解 AI 工具的基本概念。

TL;DR: OpenClaw 是一个拥有 231k GitHub stars 的开源个人 AI 助手。与 ChatGPT/Claude 等托管服务不同，它运行在你自己的设备上，数据完全由你控制。支持 WhatsApp、Telegram、Discord 等 10+ 渠道，可通过 Skills 扩展能力，能执行本地命令、操作文件系统、浏览网页。适合注重隐私、需要本地执行能力、想通过聊天应用操控 AI 的开发者。

什么是 OpenClaw？

一句话定义

OpenClaw 是一个自托管的 AI Agent Gateway，让你通过熟悉的聊天应用（WhatsApp、Telegram、Discord 等）与 AI 对话，AI 可以执行真实任务——写代码、发邮件、管理日程、控制智能家居等。

核心理念

“Your data, your rules” — 这是 OpenClaw 的核心理念。与 ChatGPT、Claude 等托管服务不同：

特性	OpenClaw	ChatGPT/Claude 网页版
数据存储	本地，完全控制	云端，服务商管理
执行能力	可操作本地文件、命令	受限的沙箱环境
渠道接入	10+ 聊天平台	仅网页/API
持久记忆	本地存储，永久保留	服务商控制
成本模式	API 用量计费	月度订阅
可定制性	完全开源，可修改	闭源，有限定制

项目热度

截至 2026 年 2 月，OpenClaw 在 GitHub 上拥有：

⭐ 231,000+ stars — 开源 AI 助手领域最受欢迎的项目之一
🍴 44,000+ forks — 活跃的社区参与
🔄 每日更新 — 高频迭代，功能快速演进
🦞 独特的龙虾品牌 — “EXFOLIATE! EXFOLIATE!”

核心架构

整体设计

flowchart TB
    subgraph Channels["Channels"]
        WA[WhatsApp]
        TG[Telegram]
        DC[Discord]
        SL[Slack]
        IM[iMessage]
        WC[WebChat]
    end
    
    subgraph Gateway["Gateway"]
        WS[WebSocket Server]
        SM[Session Manager]
        MR[Message Router]
        TR[Tool Registry]
    end
    
    subgraph Agent["Pi Agent"]
        PE[Prompt Engine]
        TE[Tool Executor]
        SK[Skills Manager]
    end
    
    subgraph External["External"]
        FS[File System]
        BR[Browser]
        API[API Services]
        SKL[Skills Library]
    end
    
    Channels --> MR
    MR --> SM
    SM --> Agent
    Agent --> TR
    TR --> External

关键组件

组件	职责	说明
Gateway	消息中枢	WebSocket 服务器，管理所有渠道连接、会话状态、消息路由
Channels	接入层	支持 WhatsApp、Telegram、Discord、Slack、iMessage 等 10+ 平台
Pi Agent	AI 核心	内置的 Agent 运行时，负责理解意图、调用工具、生成响应
Skills	能力扩展	社区贡献的技能包，可快速扩展 Agent 能力（如 Gmail、日历、智能家居）
Nodes	设备节点	iOS/Android/macOS 客户端，提供设备本地能力（摄像头、屏幕录制、通知）
Tools	基础工具	内置的文件操作、命令执行、浏览器控制等能力

工作流程

sequenceDiagram
    participant U as 用户
    participant C as Channel (Telegram)
    participant G as Gateway
    participant A as Pi Agent
    participant T as Tools/Skills
    
    U->>C: 发送消息 "帮我写一个 Python 脚本"
    C->>G: 消息路由
    G->>A: 投递到对应 Session
    A->>A: 理解意图，规划任务
    A->>T: 调用 write 工具
    T-->>A: 返回执行结果
    A->>A: 生成响应
    A-->>G: 返回消息
    G-->>C: 推送到渠道
    C-->>U: 显示响应

为什么选择 OpenClaw？

与竞品对比

工具	定制性	能力	自托管	多渠道	开源
OpenClaw	⭐⭐⭐⭐⭐	⭐⭐⭐⭐⭐	✅	✅ 10+	✅
AutoGPT	⭐⭐⭐⭐	⭐⭐⭐⭐	✅	❌	✅
Claude Pro	⭐⭐	⭐⭐⭐⭐	❌	❌	❌
ChatGPT Plus	⭐⭐	⭐⭐⭐	❌	❌	❌
Pi.ai	⭐	⭐⭐	❌	✅	❌
Siri	⭐	⭐⭐	❌	✅ Apple	❌

详细对比矩阵

特性	OpenClaw	ChatGPT Plus	Claude Pro	Pi.ai	Siri
自托管	✅	❌	❌	❌	❌
多渠道	✅ 10+	❌ 仅网页	❌ 仅网页	✅ 多平台	✅ Apple 生态
工具调用	✅ 无限	⚠️ 受限	⚠️ 受限	❌	⚠️ 受限
持久记忆	✅	⚠️ 有限	⚠️ 有限	✅	❌
本地执行	✅	❌	❌	❌	⚠️ 受限
数据隐私	✅ 完全控制	⚠️ 服务商	⚠️ 服务商	⚠️ 服务商	⚠️ Apple
成本模式	API 用量	$20/月	$20/月	免费/付费	免费
开源	✅ MIT	❌	❌	❌	❌
技能扩展	✅ Skills	⚠️ GPTs	❌	❌	⚠️ Shortcuts
移动端	✅ iOS/Android	✅ App	✅ App	✅ App	✅ 原生

适用场景

🎯 个人生产力

场景	功能
邮件管理	自动分类、智能回复、日程提取
日程管理	日历集成、会议提醒、任务追踪
知识管理	笔记整理、信息检索、自动归档
生活助手	账单追踪、购物清单、健康记录

典型用户：自由职业者、独立开发者、知识工作者

使用方式：

通过 WhatsApp 指派任务：“帮我整理今天的邮件，标记重要的”
自动提取邮件中的日程，同步到日历
晚上自动生成当日总结报告

💻 开发者工作流

flowchart LR
    subgraph Dev["Daily Development"]
        A[Code Review] --> B[Auto Testing]
        B --> C[CI/CD Trigger]
        C --> D[Deploy Monitor]
    end
    
    subgraph Claw["OpenClaw Integration"]
        E[Telegram Command] --> F[Repo Operations]
        F --> G[Test Execution]
        G --> H[Result Notification]
    end
    
    A -.-> E
    D -.-> H

典型用户：软件工程师、DevOps 工程师、技术主管

使用方式：

在 Telegram 中直接触发代码审查
自动运行测试套件，失败时发送通知
监控 CI/CD 流水线，异常时自动告警

🚀 创业者/小团队

典型用户：初创公司、小企业主、内容创作者

使用方式：

自动发布社交媒体内容
客服机器人自动回复常见问题
自动收集竞品信息并生成报告

🏠 技术爱好者

典型用户：智能家居玩家、DIY 爱好者、技术极客

使用方式：

集成 Home Assistant，语音控制家电
自动化数据备份和同步
构建个性化的信息仪表盘

不适用场景

场景	原因	替代方案
完全非技术用户	需要命令行操作和配置	ChatGPT、Pi.ai
企业级合规要求	需要自行保障安全和审计	企业版 AI 服务
无服务器环境	需要本地运行	云托管 AI 服务
临时/轻度使用	配置成本较高	ChatGPT 网页版

快速体验（5 分钟预览）

⚠️ 前置要求：Node.js >= 22，以及一个 AI API Key（推荐 Anthropic Claude）

# 1. 全局安装
npm install -g openclaw@latest

# 2. 启动入门向导
openclaw onboard --install-daemon

# 3. 启动 Gateway
openclaw gateway --port 18789

# 4. 测试对话
openclaw agent --message "你好，介绍一下你自己"

如果你已经完成安装，可以跳到第二篇：环境搭建与首次运行。

Skills 生态系统

OpenClaw 的强大之处在于其 Skills 技能系统。社区已经贡献了超过 5,700+ 个技能包：

类别	Skills 数量	代表技能
编码助手	133+	coding-agent, debug-pro, tdd-guide
搜索研究	253+	web-search, deepwiki, exa-search
开发运维	212+	docker-essentials, git-workflows, deploy-agent
网页自动化	139+	browser-control, puppeteer-skill
数据分析	46+	data-analyzer, budget-variance
日程管理	50+	calendar-skill, task-manager
智能家居	56+	home-assistant, smart-home-io

安装技能示例

# 从 ClawHub 安装技能
openclaw skill install gmail

# 或手动复制到技能目录
cp -r ./my-custom-skill ~/.openclaw/workspace/skills/

限制与注意事项

技术门槛

✅ 需要 Node.js >= 22 环境
✅ 需要基本的命令行操作能力
✅ 需要配置 AI API Key
⚠️ 渠道配置（如 Telegram Bot）有一定学习曲线

成本考虑

项目	说明
OpenClaw 本身	免费开源
AI API 费用	按实际用量计费（Anthropic/OpenAI）
服务器费用	如需远程部署，约 $5-20/月
渠道费用	Telegram/Discord 免费，WhatsApp Business 可能收费

已知限制

性能依赖本地硬件：复杂任务可能需要较好的 CPU/内存
渠道限制：WhatsApp 需要手机在线维持连接
模型限制：API 调用受限于所选模型的限制
并发能力：单个 Gateway 实例处理能力有限

本系列教程规划

阶段	文章	内容概要
快速入门	第1-4篇	入门介绍、环境搭建、渠道配置、核心概念
进阶使用	第5-10篇	多模型配置、Skills系统、Skills开发、Agent定制
高级配置	第11-15篇	多Agent路由、安全配置、远程部署、移动端、自动化
实战案例	第16-20+篇	知识管理、办公自动化、编程助手、智能家居、团队协作

系列目录

阶段	文章	预计发布
快速入门	第1-4篇	第一周
进阶使用	第5-10篇	第二-三周
高级配置	第11-15篇	第四周
实战案例	第16-20+篇	持续更新

资源	链接	说明
官方网站	openclaw.ai	产品介绍和用户案例
GitHub 仓库	github.com/openclaw/openclaw	源码、Issues、Releases
官方文档	docs.openclaw.ai	完整的功能文档
Skills 市场	clawhub.com	5700+ 社区技能
Discord 社区	discord.gg/clawd	实时讨论和帮助

小结

OpenClaw 代表了个人 AI 助手的一种新范式：自托管、多渠道、可扩展、开源免费。它不是一个简单的聊天机器人，而是一个可以真正帮你做事的 AI 代理。

如果你：

想要完全控制自己的数据
需要 AI 执行真实的本地任务
希望通过熟悉的聊天应用与 AI 交互
愿意投入一些时间学习和配置

那么 OpenClaw 值得你深入探索。

进一步阅读

OpenClaw 官方文档 — 完整的功能文档
GitHub 仓库 — 源码、Issues、Releases
ClawHub Skills — 5700+ 社区技能
Discord 社区 — 实时讨论和帮助
Awesome OpenClaw Skills — 精选技能列表

下一篇预告：环境搭建与首次运行 — 5 分钟完成安装，启动你的个人 AI 助手。

更新记录：

2026-02-26：初版发布，基于 OpenClaw v2026.2

系列导航：