Skip to content

OpenClaw 简介

OpenClaw 是一个自托管的 AI Gateway,核心功能是把 Telegram、Discord、WhatsApp、飞书等 IM 渠道接入各种 AI Provider(Anthropic、OpenAI、Ollama 等),让 AI Agent 在你熟悉的聊天界面里工作。


整体架构

IM 渠道(Telegram / Discord / WhatsApp / 飞书 / ...)

              OpenClaw Gateway
              ┌─────────────────────────────┐
              │  路由 / 配对 / 沙箱隔离      │
              │  渠道管理 / Skills / 工具    │
              └─────────────────────────────┘

        AI Provider(Anthropic / OpenAI / Ollama / ...)

Gateway 是 OpenClaw 的核心进程:

  • 接收来自渠道的消息,路由到对应 Agent
  • 调用 AI Provider 完成推理
  • 将结果回写到渠道
  • 管理会话状态、凭证、沙箱隔离

核心概念

概念说明
Gateway中心调度进程,本地或远程运行
AgentAI 实体,绑定模型 + 工具 + 工作区
渠道(Channel)消息来源,如 Telegram Bot、WhatsApp、Discord
ProviderAI 推理后端,如 Anthropic、OpenAI、Ollama
配对(Pairing)控制哪些用户/设备可以与 Agent 交互的安全机制
工作区(Workspace)Agent 的文件系统 + Skills + 记忆存储

适用场景

  • 用 Telegram / Discord 控制自己的私人 AI 助手
  • 搭建团队共享的 AI Bot(带权限控制)
  • 在熟悉的 IM 工具里完成代码审查、文档生成、数据查询等自动化任务
  • 结合 Docker 沙箱隔离,给不同渠道的 Agent 分配不同的工具访问权限

快速开始

  1. 快速入门:5 分钟内跑起第一个 Agent
  2. 安装总览:所有安装方式(脚本、npm、Docker、云端)
  3. 安装后设置:个性化配置、凭证管理

问题排查

遇到问题?按症状查找: