开发与工程 agent-gatewaytutorialanthropictelegramfeishupythonconcurrency

claw0:从零构建AI智能体网关

通过10个渐进式章节,从零开始构建一个生产级别的AI智能体网关,涵盖工具调用、多通道路由、自动化和高并发。

FollowAgents 评估 · FARS-2.1
不推荐
28/ 100 五分制 1.4 / 5
1 2 3 4 5 6
1信任安全0 / 29 · 0.0/5

证据显示仓库是教学性教程,没有实际执行代码,因此没有权限管理、用户确认、数据流透明、敏感数据处理、依赖安全、外部影响、回滚或来源归属的实质内容。所有信任相关标准得分为0,因为没有证据表明这些方面被处理。

2可靠稳定5 / 14 · 1.8/5

自洽性得2分:README中描述的10个部分和依赖关系在结构上一致,但未提供代码验证。依赖可用性得1分:列出了依赖项,但未提供版本锁定或可用性保证。失败消息得0分:没有关于错误处理或用户可见失败消息的文档。

3适用触发6 / 18 · 1.7/5

受众和场景得2分:明确面向学习AI代理的开发者,提供了多语言支持。能力边界得1分:描述了每个部分的范围,但未明确说明限制。触发精度得0分:没有定义触发条件。环境适配得1分:提到了Python版本和API密钥,但未提供详细的环境配置指南。

4规范维护8 / 18 · 2.2/5

信息架构得2分:清晰的目录结构和分节说明。安装说明得2分:提供了快速开始步骤。命名稳定性得1分:部分命名一致,但未提及API稳定性。示例和FAQ得2分:提供了运行示例,但无FAQ。已知限制得0分:未提及。许可证得2分:MIT许可证。版本变更日志得0分:无。维护责任得1分:未明确,但仓库有组织归属。

5有效结果7 / 13 · 2.7/5

输出可用性得2分:代码和文档并置,便于学习。边际价值得2分:提供了从基础到高级的渐进式学习路径。成本效益得1分:需要API密钥和依赖,但作为教育项目成本合理。

6证据核验2 / 8 · 1.3/5

声明可追溯性得1分:README中的声明与文件结构部分对应,但未提供代码验证。跨来源佐证得0分:无外部验证。事实与推断分离得1分:部分区分了描述和推断,但不够明确。

证据充分度: 评估于 2026年8月9日 审查版本 0fbf0eb1bd65
源码中未见的安全控制:最小权限约束、执行前用户确认、数据流向说明、敏感信息处理、依赖安全审查、外部影响披露、回滚或恢复路径、来源归属可核验
使用前请注意
  • 仓库是教学性教程,不包含实际可运行的代理产品,因此信任相关标准无法评估。
  • 依赖项未固定版本,可能存在供应链风险。
  • 未提供测试或验证,所有声明仅基于README。
评估证据 [1][2]
查看完整评分方法 →

这个 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 密钥,即可体验从零搭建智能体网关的全过程。

  1. AI 开发者想从零理解 AI 智能体的核心机制,通过逐步编码学习概念
  2. 需要为 Telegram 或飞书构建自动化聊天机器人的团队,可参考通道实现
  3. 希望实现消息持久化和可靠投递的开发者,可学习 s03 和 s08 的队列设计
  4. 对智能体自主性和定时任务有需求的用户,可参考 s07 的心跳和调度
  5. 需要在多用户或多通道环境下保证并发安全的开发者,可学习 s10 的命名通道机制
  6. 希望为智能体赋予个性化人格和记忆能力的用户,可参考 s06 的实现

这个 Agent 有哪些优点和局限?

优点
  • 渐进式教学,每节只引入一个新概念,代码逐步构建
  • 支持三种语言(中英日),代码和文档并存
  • 涵盖生产级特性:认证轮换、重试洋葱、并发控制
  • 提供清晰的依赖图和架构图,便于理解整体设计
  • 可运行,快速上手
局限
  • 仅支持 Anthropic API,依赖其密钥
  • 未提供 Docker 或云部署配置,需自行部署
  • 教学代码可能简化了实际生产环境的复杂性
  • 未明确说明测试覆盖或生产就绪性

如何安装或部署这个 Agent?

  1. 克隆仓库: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 与同类方案有什么区别?

仓库提及了姊妹项目 learn-claude-code,该仓库侧重于智能体内部设计(如规划、上下文压缩、团队协作),而 claw0 侧重网关路由、通道和主动行为。

常见问题

我需要什么密钥?
需要 Anthropic API 密钥(ANTHROPIC_API_KEY),并设置模型ID(MODEL_ID)。
支持哪些聊天平台?
目前明确支持 Telegram 和飞书(Feishu),在 s04 中实现。
我能否在生产中使用这些代码?
代码旨在教学,但包含了重试、队列等生产级概念,可作为基础,但需自行加固和部署。
学习这个需要哪些前置知识?
需要 Python 编程基础和对 API 的基本了解。

相关 Agents