OpenClaw 🦞¶

OpenClaw 是一个自托管网关，通过渠道插件将你喜欢的聊天应用（Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等）连接到 AI 编程智能体。你只需在自己的机器（或服务器）上运行一个 Gateway 进程，它就会成为你的消息应用与始终可用的 AI 助手之间的桥梁。

它适合谁？ 适合希望有一个可随时通过消息联系的 AI 助手的开发者、高级用户和团队——无需放弃对自己数据的控制，也无需依赖托管服务。同一个网关既可以在单台笔记本电脑上作为个人助手运行，也可以作为共享的团队部署运行；唯一的区别只是配置。

它有什么不同？

自托管：运行在你的硬件上，遵循你的规则
多渠道：一个 Gateway 同时服务所有已配置的渠道插件
智能体原生：为具备工具使用、会话、记忆和多智能体路由能力的编程智能体而构建
开源：MIT 许可证，社区驱动

完整的架构说明——可信网关、不可信执行、确定性策略，以及一个产品如何同时覆盖个人与团队使用场景——请参阅为什么选择 OpenClaw。

你需要什么？ Node 26（推荐），或其他受支持的版本：Node 24.16+ 或 Node 26.1+。你还需要一个来自所选提供商的 API 密钥，以及 5 分钟时间。为了获得最佳质量和安全性，请使用可用的最强最新一代模型。

工作原理¶

flowchart LR
  A["Chat apps + plugins"] --> B["Gateway"]
  B --> C["OpenClaw agent"]
  B --> D["CLI"]
  B --> E["Web Control UI"]
  B --> F["macOS app"]
  B --> G["iOS and Android nodes"]

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

核心能力¶

多渠道网关

通过单个 Gateway 进程即可接入 Discord、iMessage、Signal、Slack、Telegram、WhatsApp、WebChat 等。

插件渠道

渠道插件可添加 Matrix、Nostr、Twitch、Zalo 等；官方插件按需安装。

多智能体路由

为每个智能体、工作区或发送者提供隔离会话。

媒体支持

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

Web Control UI

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

移动节点

配对 iOS 和 Android 节点，用于相机、屏幕和语音功能的工作流。

技能

教智能体学会可按需加载的可重复执行流程。

自动化

使用 cron 任务、钩子和 Webhook 按计划执行工作。

构建插件

基于插件 SDK 编写你自己的渠道、提供商和工具插件。

快速开始¶

1. 安装 OpenClaw

macOS / Linux / WSL2Windows (PowerShell)

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

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

安装程序会检测你的操作系统，在需要时安装 Node，安装 OpenClaw，然后开始引导流程。其他安装方式（npm、pnpm、bun、Docker、Nix、从源码安装）请参见安装页面。

2. 完成引导流程

引导流程提供快速开始和自定义设置两种选项。快速开始会复用检测到的 AI 访问配置，通过一次真实补全请求进行验证，并在前台运行 Gateway 的同时打开 Web 仪表盘。自定义设置则会走完整的引导流程。openclaw onboard --classic 则会打开经典的分步向导。

3. 安装 Gateway 服务

快速入门会将 Gateway 保留在前台。按 Ctrl+C，然后安装后台服务：

openclaw gateway install

4. 聊天

在浏览器中打开 Control UI 并发送一条消息：

openclaw dashboard

或者连接一个频道（Telegram 最快），并从手机聊天。

需要完整的安装和开发环境配置？请参阅入门指南。

仪表盘¶

Gateway 启动后，在浏览器中打开 Control UI。

本地默认：http://127.0.0.1:18789/
远程访问：Web 界面和 Tailscale

配置（可选）¶

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

如果你什么都不做，OpenClaw 会使用内置的 OpenClaw 智能体运行时；私聊共享智能体的主会话，每个群聊拥有自己的会话。
如果你想收紧权限，请从 channels.whatsapp.allowFrom 开始，并（针对群聊）配置提及规则。

示例：

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