知识模块
🦞 OpenClaw 知识库
一、概览与核心概念
概述与核心概念

一、OpenClaw 概览与核心概念

1.1 OpenClaw 是什么？

OpenClaw 🦞 是一个自托管 AI 智能体 Gateway 网关，支持 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等更多平台。

"EXFOLIATE! EXFOLIATE!" — 可能是一只太空龙虾说的

一句话理解

发一条消息，就能从你的口袋里收到智能体回复。

通过一个 Gateway 网关运行内置渠道、内置渠道插件、WebChat 和移动节点。

1.2 工作原理

Gateway 网关是会话、路由和渠道连接的唯一事实来源。

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│  聊天应用    │────▶│   Gateway    │────▶│  AI 智能体   │
│ WhatsApp    │     │   网关进程    │     │  (Pi/LLM)   │
│ Telegram    │◀────│              │◀────│  工具执行    │
│ Discord     │     │  端口:18789   │     │  会话管理    │
└─────────────┘     └──────────────┘     └─────────────┘

架构核心

  1. 单一 Gateway 进程 — 所有渠道连接、会话路由、智能体调度的中心
  2. 多渠道复用 — 一个端口同时处理 WebSocket、HTTP API、Control UI
  3. 智能体运行时 — 内置 Pi 智能体，支持工具调用、会话管理
  4. 自托管 — 完全运行在你的机器上，数据不经过第三方

1.3 关键能力

多渠道网关

通过单个 Gateway 进程连接 Discord、iMessage、Signal、Slack、Telegram、WhatsApp、WebChat 等更多渠道。

插件渠道

内置插件可在当前常规版本中添加 Matrix、Nostr、Twitch、Zalo 等更多渠道。

多智能体路由

按智能体、工作区或发送者实现隔离会话。

媒体支持

发送和接收图片、音频和文档。

Web 控制面板

用于聊天、配置、会话和节点的浏览器仪表板。

移动节点

配对 iOS 和 Android 节点，支持 Canvas、相机和语音工作流。

1.4 功能完整列表

渠道能力

  • 内置渠道: Discord、Google Chat、iMessage（旧版）、IRC、Signal、Slack、Telegram、WebChat、WhatsApp
  • 内置插件渠道: BlueBubbles (iMessage)、Feishu、LINE、Matrix、Mattermost、Microsoft Teams、Nextcloud Talk、Nostr、QQ Bot、Synology Chat、Tlon、Twitch、Zalo、Zalo Personal
  • 可选单独安装渠道插件: Voice Call、WeChat 等
  • 支持基于提及激活的群聊
  • 通过允许列表和配对机制保障私信安全

智能体能力

  • 具有工具流式传输的内置智能体运行时
  • 按工作区或发送方隔离会话的多智能体路由
  • 会话：私聊会合并到共享的 main；群组彼此隔离
  • 针对长回复的流式传输与分块

认证和提供商

  • 35+ 模型提供商（Anthropic、OpenAI、Google 等）
  • 通过 OAuth 的订阅认证（如 OpenAI Codex）
  • 自定义和自托管提供商支持（vLLM、SGLang、Ollama，以及任何兼容 OpenAI 或兼容 Anthropic 的端点）

多媒体

  • 图片、音频、视频和文档的输入与输出
  • 共享的图片生成和视频生成能力表面
  • 语音消息转录
  • 支持多个提供商的文本转语音

应用和界面

  • WebChat 和浏览器 Control UI
  • macOS 菜单栏配套应用
  • iOS 节点，支持配对、Canvas、相机、屏幕录制、定位和语音
  • Android 节点，支持配对、聊天、语音、Canvas、相机和设备命令

工具和自动化

  • 浏览器自动化、exec、沙箱隔离
  • Web 搜索（Brave、DuckDuckGo、Exa、Firecrawl、Gemini、Grok、Kimi、MiniMax Search、Ollama Web 搜索、Perplexity、SearXNG、Tavily）
  • Cron 作业和心跳调度
  • Skills、插件和工作流管线（Lobster）

1.5 与同类方案的区别

维度OpenClaw其他方案
托管方式自托管，数据在你手里云端托管，数据在第三方
渠道数量一个 Gateway 服务所有渠道通常一个渠道一个服务
智能体编码智能体原生支持通用聊天机器人
开源MIT 许可证部分闭源
控制力完全控制配置和行为受限于平台能力

1.6 你需要什么？

  1. Node 24（推荐），或 Node 22 LTS（22.14+）
  2. 一个 API Key — 你选择的模型提供商
  3. 5 分钟时间 — 安装和设置
  4. 一台机器 — macOS、Linux 或 Windows

💡 为了获得最佳质量与安全性，请使用最新一代中能力最强的模型。

🦞 OpenClaw 首页安装与快速开始