一步一步教你如何构建自己的AI代理

从简单的聊天循环到轻量级的OpenClaw ,一步一步教你构建自己的 AI 代理。

概述

18 个循序渐进的步骤,教你如何构建一个最小化的 OpenClaw 版本。每个步骤包括:

  • 逐一README.md分析关键部件和设计决策。

  • 可运行的代码库。

示例项目: pickle-bot - 我们的参考实现

教程结构

第一阶段:单代理程序(步骤 1-7)

构建一个功能齐全的智能体,它可以聊天、使用工具、学习技能、记住对话并访问互联网。

  • 00-chat-loop - 仅聊天循环

  • 01-工具- 给你的代理人一个工具。

  • 02-技能- 扩展您的代理功能SKILL.md

  • 03-持久性- 保存您的对话。

  • 04-斜杠命令- 用户直接控制会话。

  • 05-压缩- 收拾好你的历史,继续前行……

  • 06-web-tools - 您的经纪人想要看看更广阔的世界。

第二阶段:事件驱动架构(步骤 8-11)

重构为事件驱动架构,以实现可扩展性和多平台支持。

  • 07-事件驱动- 将您的代理暴露在 CLI 之外。

  • 08-config-hot-reload - 无需重启即可编辑。

  • 09-频道- 通过手机与您的代理人通话。

  • 10-websocket - 想以编程方式与您的代理进行交互吗?

第三阶段:自主与多智能体(步骤 12-16)

添加计划任务、代理协作和智能路由。

  • 11-多代理路由- 将正确的任务路由到正确的代理。

  • 12-cron-heartbeat - 一个在你睡觉时工作的代理。

  • 13-多层提示- 更多上下文,更多上下文,更多上下文。

  • 14-post-message-back - 您的经纪人想和您谈谈。

  • 15-agent-dispatch - 您的代理人希望与朋友一起工作!

第四阶段:生产与规模化(步骤 17-18)

具备可靠性和长期存储功能。

  • 16-并发控制- 同时运行的 Pickle 进程过多?

  • 17-记忆- 记住我!

如何使用本教程

配置 API 密钥

在执行任何步骤之前,您需要配置 API 密钥:

  1. 复制示例配置:

    cp default_workspace/config.example.yaml default_workspace/config.user.yaml
    
  2. config.user.yaml请使用您的 API 密钥进行编辑:

    • 请参阅LiteLLM 提供商列表,了解所有支持的提供商。

    • 请查看提供商示例以获取一些示例。

  3. 只需按照每个步骤操作,阅读并尝试一下即可。

TypeScript类型体操太烧脑了

升级文档写得不够详细