OpenClaw 多 Agent 架构入门：用 Telegram Bot 控制你的 AI Agent 集群

想象一下：你在 Telegram 发一条消息，背后有多个 AI Agent 协作完成你的需求——一个搜索新闻、一个写代码、一个管理日程。OpenClaw 就是这样一个开源的多 Agent 编排平台。

什么是 OpenClaw？#

OpenClaw 是一个开源的 AI Agent 运行时，让你通过 Telegram、Discord、WhatsApp 等消息平台控制 AI Agent。核心特性：

• 多 Agent 架构：多个 Agent 协同工作
• 多渠道接入：Telegram、Discord、WhatsApp、Signal、iMessage
• 持久会话：Agent 有长期记忆
• 工具系统：通过 Skills 扩展 Agent 能力
• 子 Agent 编排：主 Agent 可以调度子 Agent

架构概览#

快速开始#

1. 安装#

# macOS
brew install openclaw

# npm
npm install -g openclaw

2. 初始化#

openclaw init

这会创建 ~/.openclaw/ 目录，包含：

• workspace-content/ — Agent 的工作空间
• .env — 环境变量配置
• 配置文件

3. 配置 Telegram#

1. 在 BotFather 创建 Bot
2. 配置 Token：

openclaw config set telegram.token YOUR_BOT_TOKEN

3. 启动 Gateway：

openclaw gateway start

4. 定义 Agent 身份#

编辑 ~/.openclaw/workspace-content/SOUL.md：

# SOUL.md

你是 MyAssistant，一个个人 AI 助手。

## 性格
- 友好、高效
- 主动帮助，但不过度打扰

## 能力
- 搜索网络
- 管理文件
- 执行代码

核心概念#

Workspace#

Agent 的「家」，包含它的身份（SOUL.md）、记忆（memory/）、工具笔记（TOOLS.md）等。

Skills#

可复用的能力模块：

Sessions#

Agent 的会话管理：

• 主会话：与用户的直接对话
• 子会话：子 Agent 的独立会话
• 后台会话：定时任务等

Heartbeat#

定期唤醒 Agent 做主动检查：

<!-- HEARTBEAT.md -->
- 检查邮箱新邮件
- 查看今日日历
- 检查 GitHub 通知

高级功能#

子 Agent 编排#

主 Agent 可以启动子 Agent 处理特定任务：

// 启动编码子 Agent
sessions_spawn({
  runtime: "subagent",
  task: "修复 auth 模块的 bug",
  agentId: "coding-agent"
})

MCP 集成#

通过 MCP Server 连接外部工具：

{
  "mcpServers": {
    "github": {
      "command": "mcp-github",
      "args": ["--token", "$GITHUB_TOKEN"]
    }
  }
}

多节点部署#

通过 Node 系统，Agent 可以跨设备运行：

• 本地 Mac mini：运行主 Agent
• 远程 VPS：运行后台任务
• 手机 App：移动端接入

与 Claude Code 的关系#

OpenClaw 可以调用 Claude Code 作为编码子 Agent：

• 收到编码需求时，OpenClaw 启动 Claude Code 子会话
• Claude Code 在独立环境中完成编码
• 结果返回到 OpenClaw 主会话
• 用户通过 Telegram 收到完成通知

这种架构让你在手机上就能指挥 AI 写代码。

社区#

• GitHub: github.com/openclaw/openclaw
• Discord: discord.com/invite/clawd
• 文档: docs.openclaw.ai
• Skills 市场: clawhub.ai

原文整理自 OpenClaw 官方文档 | 来源：OpenClaw