项目总览

日期: 2026-02-12 | 版本: 2026.2.10 | 语言: TypeScript (ESM)

OpenClaw 是一个多通道 AI 网关，核心能力是将 LLM 代理连接到多种消息通道（Telegram, Discord, Signal, Slack, iMessage, LINE, WhatsApp 等），并提供工具调用、技能系统、子代理、沙箱执行等完整的 Agentic 框架。

目录结构

src/
├── agents/           # 🧠 核心：Agent Loop、模型管理、工具、技能、子代理
├── gateway/          # 🌐 Gateway 服务器：HTTP/WS、路由、会话管理
├── plugins/          # 🔌 插件系统：加载、注册、生命周期
├── sessions/         # 📋 会话管理：session key、级别覆盖
├── channels/         # 📡 通道抽象：多平台消息适配
├── config/           # ⚙️ 配置系统：YAML/JSON 配置加载
├── infra/            # 🏗️ 基础设施：事件总线、心跳、机器名
├── cli/              # 🖥️ CLI 命令入口
├── providers/        # 🔑 模型提供商认证（GitHub Copilot, Google, Qwen）
├── hooks/            # 🪝 钩子系统
├── process/          # ⚡ 命令队列、进程管理
├── routing/          # 🔀 Session key 路由
skills/               # 📚 内置技能（顶层目录）
extensions/           # 🧩 扩展（顶层目录）

---

快速导航

• Agent Loop：/source-study/agent-loop
• 模型 Fallback：/source-study/model-fallback
• Compaction 上下文压缩：/source-study/compaction
• 子代理系统：/source-study/subagent
• Skills 系统：/source-study/skills
• Gateway：/source-study/gateway
• Plugin 系统：/source-study/plugin
• Session 管理：/source-study/session
• 设计模式：/source-study/design-patterns
• 实用技巧：/source-study/tips
• 核心依赖：/source-study/dependencies