claw0：从零构建AI智能体网关
通过10个渐进式章节，从零开始构建一个生产级别的AI智能体网关，涵盖工具调用、多通道路由、自动化和高并发。
- Star 数
- ★ 3.4k
- 最近更新
- 3 个月前
- 主语言
- Python
- FA 评分
- 28/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- AI 开发者想从零理解 AI 智能体的核心机制，通过逐步编码学习概念
- 不适合
- 需要开箱即用生产级网关的团队，这是教学代码
- 只使用 OpenAI 或本地模型的团队，目前仅支持 Anthropic API
- 需要 Docker 或云部署方案的团队，仓库未提供
这个 Agent 能做什么，适合哪些场景？
claw0 是一个教学仓库，旨在帮助开发者从零开始构建一个类似 OpenClaw 的 AI 智能体网关。仓库包含10个循序渐进的章节，每个章节都是一个可运行的 Python 文件，每个章节引入一个核心概念，从基础的智能体循环到并发控制。代码支持的通道包括 Telegram 和飞书，并实现了会话持久化、心跳定时任务、消息投递队列和弹性重试机制。学习完成后，用户能够理解并自信地阅读 OpenClaw 的生产代码。仓库提供英文、中文、日文三种语言的代码和文档。
每个章节都是一个独立的 Python 脚本，展示了智能体网关的特定方面。例如，s01 实现基本的智能体循环（while True + stop_reason），s02 添加工具调用（dispatch table），s03 实现 JSONL 会话持久化，s04 集成 Telegram 和飞书通道，s05 实现网关路由（5层绑定），s06 实现智能体人格（SOUL.md 等文件），s07 添加心跳和定时任务，s08 实现消息队列，s09 实现重试和认证轮换，s10 实现命名通道并发控制。用户通过运行这些脚本，并配置 Anthropic API 密钥，即可体验从零搭建智能体网关的全过程。
- AI 开发者想从零理解 AI 智能体的核心机制，通过逐步编码学习概念
- 需要为 Telegram 或飞书构建自动化聊天机器人的团队，可参考通道实现
- 希望实现消息持久化和可靠投递的开发者，可学习 s03 和 s08 的队列设计
- 对智能体自主性和定时任务有需求的用户，可参考 s07 的心跳和调度
- 需要在多用户或多通道环境下保证并发安全的开发者，可学习 s10 的命名通道机制
- 希望为智能体赋予个性化人格和记忆能力的用户，可参考 s06 的实现
如何安装或部署这个 Agent？
- 克隆仓库：git clone https://github.com/shareAI-lab/claw0.git && cd claw0。2. 安装依赖：pip install -r requirements.txt。3. 复制 .env.example 为 .env 并编辑设置 ANTHROPIC_API_KEY 和 MODEL_ID。4. 确保 Python 3.11+。
如何使用这个 Agent？
运行任何章节（例如英文版）：python sessions/en/s01_agent_loop.py。按顺序学习，每个章节依赖前一个，例如 s03 依赖 s02，s04 依赖 s03，依此类推。建议按 s01 到 s10 顺序运行，并同时阅读对应的 .md 文档。
这个 Agent 有哪些优点和局限？
- 渐进式教学，每节只引入一个新概念，代码逐步构建
- 支持三种语言（中英日），代码和文档并存
- 涵盖生产级特性：认证轮换、重试洋葱、并发控制
- 提供清晰的依赖图和架构图，便于理解整体设计
- 可运行，快速上手
- 仅支持 Anthropic API，依赖其密钥
- 未提供 Docker 或云部署配置，需自行部署
- 教学代码可能简化了实际生产环境的复杂性
- 未明确说明测试覆盖或生产就绪性
这个 Agent 与同类方案有什么区别？
仓库提及了姊妹项目 learn-claude-code，该仓库侧重于智能体内部设计（如规划、上下文压缩、团队协作），而 claw0 侧重网关路由、通道和主动行为。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| claw0：从零构建AI智能体网关 当前 | 28 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 3.4k | 3 个月前 | Python | Claude API |
| Claude Code 从零实现 | 60 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 2.8k | 3 个月前 | Python | OpenAI API · Claude API |
| 学习 Claude Code：智能体赋能（Harness）工程实战 | 48 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 79k | 20 天前 | Python | Claude API |
| 冬瓜的 AI 学习笔记：Pi-Agent SDK 深度教程 | 23 · 缺口较多 | 网页应用免费 | ★ 3.4k | 1 个月前 | MDX | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示仓库是教学性教程，没有实际执行代码，因此没有权限管理、用户确认、数据流透明、敏感数据处理、依赖安全、外部影响、回滚或来源归属的实质内容。所有信任相关标准得分为0，因为没有证据表明这些方面被处理。
自洽性得2分：README中描述的10个部分和依赖关系在结构上一致，但未提供代码验证。依赖可用性得1分：列出了依赖项，但未提供版本锁定或可用性保证。失败消息得0分：没有关于错误处理或用户可见失败消息的文档。
受众和场景得2分：明确面向学习AI代理的开发者，提供了多语言支持。能力边界得1分：描述了每个部分的范围，但未明确说明限制。触发精度得0分：没有定义触发条件。环境适配得1分：提到了Python版本和API密钥，但未提供详细的环境配置指南。
信息架构得2分：清晰的目录结构和分节说明。安装说明得2分：提供了快速开始步骤。命名稳定性得1分：部分命名一致，但未提及API稳定性。示例和FAQ得2分：提供了运行示例，但无FAQ。已知限制得0分：未提及。许可证得2分：MIT许可证。版本变更日志得0分：无。维护责任得1分：未明确，但仓库有组织归属。
输出可用性得2分：代码和文档并置，便于学习。边际价值得2分：提供了从基础到高级的渐进式学习路径。成本效益得1分：需要API密钥和依赖，但作为教育项目成本合理。
声明可追溯性得1分：README中的声明与文件结构部分对应，但未提供代码验证。跨来源佐证得0分：无外部验证。事实与推断分离得1分：部分区分了描述和推断，但不够明确。
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 源码中未见：来源归属可核验从官方仓库或包源安装，核对发布者和仓库地址，避免同名仿冒包。
- 仓库是教学性教程，不包含实际可运行的代理产品，因此信任相关标准无法评估。
- 依赖项未固定版本，可能存在供应链风险。
- 未提供测试或验证，所有声明仅基于README。