Technical Guide

20. 总结：读完后你应该能做什么

收束 OpenClaw 源码教程，回到 CLI、Gateway、Agent Runtime、Channels、Tools 和扩展系统。

回到一开始的问题

OpenClaw 不难安装，难的是看懂它怎么转起来。

它同时包含：

CLI
Gateway
Channels
Agent Runtime
Tools
Skills
Cron
Plugins
MCP
Sandbox
State Dir
Companion apps

如果不分层，源码一定会看乱。

这套教程的主线

openclaw 命令启动
→ Gateway 常驻
→ Channel 收到消息
→ pairing / allowlist 判断
→ 路由到 agent/session
→ Agent Runtime 构造上下文和工具面
→ LLM provider 流式响应
→ 工具调用和结果回填
→ session 保存
→ Gateway 投递结果

这条线就是 OpenClaw 源码阅读主线。

你现在应该能分清这些概念

CLI 和 Gateway

CLI 是本地操作入口。

Gateway 是常驻控制平面。

Gateway 和 Channel

Gateway 负责路由和控制。

Channel 负责具体平台接入。

Agent Runtime 和 Tools

Runtime 负责模型、上下文、session、stream、tool call。

Tools 负责真实动作，并受 policy、sandbox、sender、group、provider 影响。

Skill、Plugin、MCP

Skill 是过程知识。

Plugin 是 OpenClaw 扩展体系。

MCP 是外部工具协议接入。

三者不要混。

最重要的二开判断

想改 OpenClaw 时，先判断：

入口层：CLI / Gateway / Channel
运行层：Agent Runtime / Provider / Sessions
能力层：Tools / Skills / Plugins / MCP / Cron
边界层：Config / Sandbox / Security / Logging

层级判断对了，源码位置通常就不会差太远。

后续可以继续加的实战

这套目前是源码阅读主线。后面可以继续补实战篇：

写一个最小 Skill
写一个只读 Tool
接一个 MCP server
新增一个简单 Plugin
配置一个安全的 Telegram/Feishu channel
写一个 Cron 日报任务
排查一次 provider 401

最后一句

OpenClaw 的价值不是“支持很多平台”这么简单。