第一章：OpenClaw 项目概览与核心定位

OpenClaw 是一个自托管的个人 AI 助手 Gateway。它的目标不是做某一个聊天平台上的简单 Bot，而是在用户自己的设备、服务器或容器中运行一个统一控制平面，把 WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Matrix、飞书、LINE、Mattermost、Nextcloud Talk、Nostr、Twitch、Zalo、QQ、WeChat、WebChat 等入口连接到同一个 AI 助手系统。

1.1 一句话理解

OpenClaw 可以理解为：一个本地优先、单一信任边界、面向个人助手场景的多通道 AI Gateway。聊天平台只是入口，真正的核心是 Gateway，它负责会话、通道、模型、工具、节点、技能、插件、配置和安全策略。

1.2 它解决什么问题

传统 AI 助手常见问题是入口分散、会话割裂、工具割裂和控制权不足。OpenClaw 通过一个长驻 Gateway 把这些资源统一起来：手机上用 Telegram/WhatsApp，桌面上用 Control UI，自动化用 cron/webhook，设备能力通过节点暴露，模型和工具由统一配置管理。

1.3 核心能力

• 多通道消息网关：多个聊天平台可同时接入同一 Gateway。
• 自托管控制平面：配置、状态、会话和工作区通常位于本地 ~/.openclaw。
• Agent-native：围绕智能体会话、工具调用、技能、工作区、模型路由构建。
• 工具系统：支持文件、命令、浏览器、网页搜索、消息发送、Canvas、节点、定时任务、媒体生成等。
• 技能系统：兼容 AgentSkills 风格的 SKILL.md，用于向智能体注入操作流程。
• 插件生态：插件可以注册通道、工具、模型 provider、技能、语音和媒体能力。
• Control UI 与节点：通过浏览器、macOS/iOS/Android/headless 节点扩展交互界面。

1.4 与普通 Bot 的区别

普通 Bot 多半只处理“某个平台的一条消息进来，然后调用模型回复”。OpenClaw 则有统一 Gateway、会话路由、工具策略、DM pairing、allowlist、沙箱、模型 fallback、技能加载、插件发现和节点配对。它更像个人 AI 助手的操作系统网关，而不是单个聊天机器人脚本。

1.5 适合谁

OpenClaw 适合希望自托管个人 AI 助手、从多个消息入口访问助手、让 AI 使用真实工具、研究 Agent Gateway 架构、或需要把聊天、自动化、设备和模型统一起来的开发者和高级用户。不适合想要完全免维护托管产品，或想把一个 Gateway 作为对抗性多租户服务的人。

1.6 仓库结构速览

仓库中重要内容包括：项目主页说明、docs/ 官方文档，package.json npm 包定义，openclaw.mjs CLI 入口，extensions/ 插件与通道扩展，apps/ 伴随应用，skills/ 内置技能，Dockerfile 与 docker-compose.yml 容器部署资源。

1.7 学习顺序

建议先理解 Gateway 定位，再完成安装和 onboarding；随后接入 WebChat 或 Telegram；再学习 openclaw.json、模型、通道安全、Agent 工作区、工具策略、技能插件；最后再研究远程访问、自动化、Docker 和源码开发。