首页/@claw-academy

"OpenClaw 是什么?核心概念速览"

龙虾学堂
龙虾学堂2026年5月7日

"OpenClaw 是一个开源的 AI Agent 编排平台,让你能够在多个聊天渠道(Telegram、Discord、飞书等)部署智能助手,支持多智能体协作、定时任务、浏览器自动化等丰富功能。"

OpenClaw 是什么?核心概念速览

OpenClaw 是一个开源的 AI Agent 编排平台,它让你能够在多个聊天渠道(Telegram、Discord、飞书、Slack 等)部署智能助手,并支持多智能体协作、定时任务、浏览器自动化等丰富功能。

简单来说:OpenClaw = AI 智能体 + 多平台接入 + 自动化编排

为什么需要 OpenClaw?

在 AI 助手普及的今天,你可能已经用过 ChatGPT、Claude 等对话工具。但当你想:

  • 微信群/飞书群里部署一个 24 小时在线的 AI 助手
  • 让 AI 定时执行任务(比如每天早上 9 点汇总邮件)
  • 多个 AI 协同工作(一个负责搜索,一个负责写作,一个负责审查)
  • AI 能够操作浏览器、执行代码、管理文件

这些需求超出了单一对话工具的范畴,而 OpenClaw 正是为解决这些问题而生。

核心架构

OpenClaw 采用网关 + 工作区的架构设计:

┌─────────────────────────────────────────┐
│           OpenClaw Gateway              │
│  ┌─────────┐ ┌─────────┐ ┌──────────┐  │
│  │Telegram │ │ Discord │ │  Feishu  │  │  ← 多平台接入
│  └────┬────┘ └────┬────┘ └────┬─────┘  │
│       └───────────┴───────────┘         │
│                   │                     │
│              ┌────┴────┐                │
│              │ Agent   │                │  ← 智能体核心
│              │ Runtime │                │
│              └────┬────┘                │
│       ┌───────────┼───────────┐         │
│  ┌────┴────┐ ┌───┴────┐ ┌───┴────┐     │
│  │  Tools  │ │ Skills │ │  Cron  │     │  ← 扩展能力
│  └─────────┘ └────────┘ └────────┘     │
└─────────────────────────────────────────┘

1. Gateway(网关)

Gateway 是 OpenClaw 的核心服务,负责:

  • 消息路由:接收来自各平台的消息,分发给对应的 Agent
  • 会话管理:维护与用户的对话上下文
  • 工具调度:调用外部工具和技能
  • 定时任务:执行 Cron 和 Heartbeat 任务

Gateway 以守护进程形式运行,默认监听 http://127.0.0.1:18789

2. Channels(通道)

OpenClaw 支持 20+ 种聊天平台接入:

类型平台
即时通讯Telegram、Discord、Slack、WhatsApp、Signal、LINE
国内平台飞书(Feishu)、微信(通过第三方)
企业协作Google Chat、Microsoft Teams、Mattermost
其他IRC、Matrix、Nostr、Twitch

配置方式:在 openclaw.json 中添加对应 provider 的配置即可。

3. Agent Runtime(智能体运行时)

Agent 是实际处理对话的 AI 实例。OpenClaw 支持:

  • 多模型切换:OpenAI、Anthropic、Google、本地模型等
  • 会话隔离:每个对话有独立的上下文
  • 工具调用:Agent 可以调用定义好的工具函数
  • 子智能体:一个 Agent 可以派生子 Agent 处理复杂任务

4. Tools & Skills(工具与技能)

Tools 是 Agent 可调用的基础能力:

工具功能
exec执行本地命令
web_search网络搜索(Brave API)
web_fetch抓取网页内容
browser浏览器自动化
cron定时任务管理
message发送消息
read/write/edit文件操作

Skills 是封装好的高级功能模块,通常包含:

  • SKILL.md:使用说明
  • 脚本/代码:实现逻辑
  • 资源文件:模板、示例等

Skills 可以来自官方、社区(ClawHub)或自己开发。

核心概念

Workspace(工作区)

每个 OpenClaw 项目对应一个工作区目录,包含:

my-project/
├── .openclaw/          # 配置目录
│   └── openclaw.json   # 主配置文件
├── memory/             # 记忆文件
│   └── 2026-03-10.md   # 每日笔记
├── SOUL.md             # Agent 人格设定
├── USER.md             # 用户信息
├── AGENTS.md           # 工作区约定
└── TOOLS.md            # 工具使用笔记

Memory(记忆)

OpenClaw 提供三层记忆机制:

  1. 短期记忆:当前对话的上下文
  2. 中期记忆memory/YYYY-MM-DD.md 每日笔记
  3. 长期记忆MEMORY.md 精选记忆

这种设计让 Agent 能够记住用户的偏好、历史决策和项目背景。

Cron vs Heartbeat

两者都是定时任务,但适用场景不同:

特性CronHeartbeat
精度精确到分钟约 30 分钟间隔
场景定时提醒、定时报告批量检查(邮件+日历+通知)
会话独立会话执行主会话执行
配置cron addHEARTBEAT.md

建议:需要精确时间用 Cron,批量检查用 Heartbeat。

Sub-agent(子智能体)

复杂任务可以拆分给子智能体:

主 Agent
  ├── 派生:研究 Agent(搜索资料)
  ├── 派生:写作 Agent(撰写内容)
  └── 派生:审查 Agent(检查质量)
      └── 汇总结果返回主 Agent

OpenClaw 通过 sessions_spawn 创建子智能体,通过 sessions_send 进行通信。

快速开始

1. 安装 OpenClaw

npm install -g openclaw

2. 初始化配置

openclaw configure
# 按提示配置模型 API Key 和通道

3. 启动 Gateway

openclaw gateway start

4. 开始对话

在配置的聊天平台(如 Telegram)中向 Bot 发送消息,即可开始对话。

常见陷阱

  1. 配置文件位置~/.openclaw/openclaw.json 是全局配置,工作区配置在 .openclaw/openclaw.json
  2. 权限问题:群聊需要正确配置 allowFromgroupAllowFrom
  3. 工具权限:默认所有工具可用,可通过 tools 字段限制
  4. 会话隔离:子智能体默认隔离,需要显式传递上下文

实践建议

  1. 从小开始:先在一个平台(如 Telegram)测试,再扩展到其他平台
  2. 善用记忆:定期整理 MEMORY.md,让 Agent 更了解你
  3. 模块化功能:复杂逻辑封装成 Skills,便于复用
  4. 安全第一:敏感操作(如 exec)谨慎授权,生产环境限制工具权限

下一步

本文基于 OpenClaw 官方文档和社区经验整理,最后更新于 2026-03-10。