OpenClaw是什么？2026年AI智能体网关工具深度解析

OpenClaw 🦞 简介

OpenClaw 是一个适用于任何操作系统的 AI 智能体网关（Gateway），旨在无缝连接 WhatsApp、Telegram、Discord、iMessage 等主流通讯应用与后端 AI 智能体（如 Pi）。它通过一个统一的网关进程，为构建和部署个人或企业级 AI 助手提供了强大、灵活的基础设施。

OpenClaw is an AI Agent Gateway (Gateway) compatible with any operating system, designed to seamlessly connect mainstream communication applications like WhatsApp, Telegram, Discord, and iMessage with backend AI agents (such as Pi). Through a unified gateway process, it provides a powerful and flexible infrastructure for building and deploying personal or enterprise-level AI assistants.

“Shell it! Shell it!” — Probably said by a space lobster

“去壳！去壳！” — 大概是一只太空龙虾说的

适用于任何操作系统的 AI 智能体 Gateway 网关，支持 WhatsApp、Telegram、Discord、iMessage 等。 发送消息，随时随地获取智能体响应。通过插件可添加 Mattermost 等更多渠道。

An AI Agent Gateway for any operating system, supporting WhatsApp, Telegram, Discord, iMessage, and more. Send messages and receive agent responses anytime, anywhere. Additional channels like Mattermost can be added via plugins.

入门指南 ---- 安装 OpenClaw 并在几分钟内启动 Gateway 网关。
运行向导 ---- 通过 openclaw onboard 和配对流程进行引导式设置。
打开控制界面 ------ 启动浏览器仪表板，管理聊天、配置和会话。

Getting Started Guide ---- Install OpenClaw and launch the Gateway in minutes.
Run the Wizard ---- Guided setup via openclaw onboard and pairing process.
Open Control UI ------ Launch the browser dashboard to manage chats, configurations, and sessions.

OpenClaw 通过单个 Gateway 网关进程将聊天应用连接到 Pi 等编程智能体。它为 OpenClaw 助手提供支持，并支持本地或远程部署。

OpenClaw connects chat applications to programmable agents like Pi through a single Gateway process. It powers the OpenClaw assistant and supports both local and remote deployments.

核心架构与工作原理

网关：统一的事实来源

Gateway 网关是 OpenClaw 架构的核心，作为会话管理、消息路由和渠道连接的唯一事实来源。它负责处理所有入站和出站消息，确保通信的一致性与可靠性。

The Gateway is the core of OpenClaw's architecture, serving as the single source of truth for session management, message routing, and channel connectivity. It handles all inbound and outbound messages, ensuring consistency and reliability in communication.

核心功能特性

多渠道网关支持

通过单个 Gateway 网关进程，原生支持连接 WhatsApp、Telegram、Discord 和 iMessage，简化了多平台集成的复杂性。

Through a single Gateway process, natively supports connecting WhatsApp, Telegram, Discord, and iMessage, simplifying the complexity of multi-platform integration.

可扩展的插件渠道

架构设计支持通过扩展包灵活添加更多通讯渠道，例如 Mattermost，满足企业或特定场景的定制化需求。

The architecture supports flexibly adding more communication channels, such as Mattermost, via extension packages to meet the customized needs of enterprises or specific scenarios.

智能的多智能体路由

支持按智能体、工作区或消息发送者进行会话隔离与路由，实现精细化的权限管理和资源分配。

Supports session isolation and routing by agent, workspace, or message sender, enabling fine-grained permission management and resource allocation.

丰富的媒体交互

具备发送和接收图片、音频及文档文件的能力，使 AI 智能体能够进行更自然、更丰富的上下文交互。

Capable of sending and receiving images, audio, and document files, enabling AI agents to engage in more natural and context-rich interactions.

可视化的 Web 控制界面

提供功能完整的浏览器仪表板，用于实时聊天监控、系统配置管理、会话状态查看以及节点管理。

Provides a fully-featured browser dashboard for real-time chat monitoring, system configuration management, session status viewing, and node management.

移动设备节点支持

支持配对 iOS 和 Android 设备作为移动节点，并利用 Canvas 功能实现高级交互体验。

Supports pairing iOS and Android devices as mobile nodes and utilizes Canvas functionality for advanced interactive experiences.

快速入门指南

三步启动你的第一个网关

按照以下步骤，快速完成 OpenClaw 的安装与基础配置。

Follow the steps below to quickly complete the installation and basic configuration of OpenClaw.

1. 安装 OpenClaw
   通过 npm 全局安装最新版本的 OpenClaw。

   Install OpenClaw globally via npm.

   npm install -g openclaw@latest
   

2. 运行引导程序并安装守护进程
   使用 onboard 命令完成初始设置，并安装后台服务。

   Use the onboard command to complete initial setup and install the background service.

   openclaw onboard --install-daemon
   

3. 登录渠道并启动网关
   登录你的 WhatsApp 账户（或其他渠道），然后启动网关服务。

   Log in to your WhatsApp account (or other channels) and then start the gateway service.

   openclaw channels login
   openclaw gateway --port 18789
   

需要完整的安装和开发环境设置？请参阅快速开始文档。

Need a complete installation and development environment setup? Please refer to the Quickstart documentation.

访问管理仪表板

Gateway 网关成功启动后，你可以通过浏览器访问控制界面进行管理。

Once the Gateway is successfully started, you can access the control interface via a browser for management.

• 本地访问默认地址：http://127.0.0.1:18789/

  Local Access Default Address

• 远程访问方案：可通过官方 Web 界面 或利用 Tailscale 等工具实现安全远程访问。

  Remote Access Solutions: Can be achieved via the official Web Interface or tools like Tailscale for secure remote access.

进阶配置（可选）

OpenClaw 的配置文件位于 ~/.openclaw/openclaw.json。系统设计为开箱即用，但也提供了丰富的配置项以满足高级需求。

OpenClaw's configuration file is located at ~/.openclaw/openclaw.json. The system is designed to work out-of-the-box but also provides rich configuration options for advanced needs.

• 默认行为：如果不进行任何修改，OpenClaw 将使用内置的 Pi 二进制文件以 RPC 模式运行，并自动为每个消息发送者创建独立的会话。

  Default Behavior: If no modifications are made, OpenClaw will run in RPC mode using the built-in Pi binary and automatically create independent sessions for each message sender.

• 访问控制：若需限制访问权限，可以从配置 channels.whatsapp.allowFrom（允许的号码列表）和针对群组的 requireMention（要求提及）规则开始。

  Access Control: To restrict access, you can start by configuring channels.whatsapp.allowFrom (list of allowed numbers) and requireMention rules for groups.

配置示例：

Configuration Example:

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

深入探索与资源

从这里开始你的旅程

OpenClaw 提供了全面的文档来帮助你深入探索各项功能。

OpenClaw provides comprehensive documentation to help you explore its features in depth.

• 文档中心 —— 所有文档和指南，按用例分类。

  Documentation Hub —— All documentation and guides, categorized by use case.

• 配置详解 —— 核心 Gateway 网关设置、令牌和模型提供商配置。

  Configuration Details —— Core Gateway settings, tokens, and model provider configurations.

• 远程访问 —— SSH 和 tailnet 等远程访问模式详解。

  Remote Access —— Detailed explanations of remote access modes like SSH and tailnet.

• 渠道配置 —— WhatsApp、Telegram、Discord 等渠道的具体设置方法。

  Channel Configuration —— Specific setup methods for channels like WhatsApp, Telegram, and Discord.

• 节点管理 —— iOS 和 Android 节点的配对与 Canvas 功能使用指南。

  Node Management —— Guide for pairing iOS and Android nodes and using Canvas functionality.

• 帮助中心 —— 常见问题修复方法和故障排除入口。

  Help Center —— Common fixes and troubleshooting entry points.

了解更多高级主题

对于希望充分利用 OpenClaw 能力的开发者，以下主题值得深入研究。

For developers looking to fully leverage OpenClaw's capabilities, the following topics are worth深入研究.

• 完整功能列表 —— 查看全部支持的渠道、路由策略和媒体功能。

  Complete Feature List —— View all supported channels, routing strategies, and media features.

• 多智能体路由 —— 深入了解工作区隔离和按智能体进行的会话管理机制。

  Multi-Agent Routing —— Deep dive into workspace isolation and session management mechanisms by agent.

• 安全指南 —— 关于令牌管理、访问白名单和安全控制的最佳实践。

  Security Guide —— Best practices for token management, access whitelisting, and security controls.

• 故障排除 —— Gateway 网关常见诊断步骤和错误解决方法。

  Troubleshooting —— Common diagnostic steps and error resolution methods for the Gateway.

• 关于与致谢 —— 了解项目起源、贡献者名单和开源许可证信息。

  About & Credits —— Learn about the project's origins, contributor list, and open-source license information.

通过 OpenClaw，开发者可以构建一个统一、强大且可扩展的 AI 智能体接入层，让智能助手的能力轻松触达用户日常使用的每一个聊天应用。

With OpenClaw, developers can build a unified, powerful, and scalable AI agent access layer, allowing the capabilities of intelligent assistants to easily reach every chat application users use daily.