01-首页概述

简介

OpenClaw 是一个自托管的 AI Agent 网关，连接您最喜欢的聊天应用（WhatsApp、Telegram、Discord、iMessage 等）与 AI 编程助手（如 Pi）。

您可以在自己的机器（或服务器）上运行单个 Gateway 进程，它成为您的消息应用与始终可用的 AI 助手之间的桥梁。

目标用户

开发者和高级用户，希望拥有一个可以从任何地方发送消息的个人 AI 助手——无需放弃数据控制权或依赖托管服务。

核心特点

所需条件

• Node 22+
• API 密钥（推荐 Anthropic）
• 5 分钟设置时间

工作原理

Gateway 是会话、路由和频道连接的单一真实来源。

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  WhatsApp   │────▶│             │      │  AI Agent   │
│  Telegram   │────▶│   Gateway   │────▶│    (Pi)     │
│   Discord   │────▶│             │      │             │
│   iMessage  │────▶│             │      │             │
└─────────────┘     └─────────────┘     └─────────────┘

快速开始

1. 安装 OpenClaw（推荐）

macOS/Linux

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

Windows（PowerShell）

iwr -useb https://openclaw.ai/install.ps1 | iex

2. 运行引导向导

openclaw onboard --install-daemon

向导配置认证、网关设置和可选频道。

3. 检查 Gateway

如果安装了服务，它应该已经在运行：

openclaw gateway status

4. 打开控制 UI

openclaw dashboard

如果控制 UI 加载成功，您的 Gateway 已准备好使用。

仪表板

Gateway 启动后打开浏览器控制 UI：

• 本地默认：http://127.0.0.1:18789
• 远程访问：参见 Web surfaces 和 Tailscale

配置（可选）

配置文件位于 ~/.openclaw/openclaw.json。

• 如果您不做任何操作，OpenClaw 使用捆绑的 Pi 二进制文件以 RPC 模式运行，每个发送者有独立会话。
• 如果您想锁定它，从 channels.whatsapp.allowFrom 开始，对于群组使用提及规则。

示例配置

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+15555550123"],
      "groups": { "*": { "requireMention": true } }
    }
  },
  "messages": { 
    "groupChat": { "mentionPatterns": ["@openclaw"] } 
  }
}

关键能力

✅ 多频道支持（WhatsApp、Telegram、Discord、iMessage、Signal、Slack 等）
✅ 工具使用（浏览器、文件操作、执行命令等）
✅ 会话管理和记忆
✅ 多 Agent 路由
✅ 自托管和隐私优先
✅ 开源和社区驱动

文档导航

• 快速开始
• 安装指南
• 频道配置
• 安全配置
• 故障排除

来源：https://docs.openclaw.ai