构建你自己的 OpenClaw

这是一个教你构建自己的 AI Agent 的循序渐进教程，内容涵盖从简单的聊天循环到轻量级版本的 OpenClaw。

概览

本教程包含 18 个渐进式步骤，旨在教你构建一个极简版的 OpenClaw。每个步骤均包含：

• 一份详细介绍核心组件和设计决策的 README.md。
• 一套可运行的代码库。

示例项目： pickle-bot —— 我们的参考实现。

教程结构

第一阶段：功能完备的单体 Agent（第 1-7 步）

构建一个功能齐全的 Agent，能够进行对话、使用工具、学习技能、记忆对话内容并访问互联网。

• 00-chat-loop - 基础聊天循环
• 01-tools - 为你的 Agent 添加工具
• 02-skills - 通过 SKILL.md 扩展你的 Agent
• 03-persistence - 保存你的对话记录
• 04-slash-commands - 通过斜杠命令直接控制会话
• 05-compaction - 压缩历史记录并持续对话
• 06-web-tools - 让你的 Agent 探索更大的世界

第二阶段：事件驱动架构（第 8-11 步）

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

• 07-event-driven - 将你的 Agent 扩展至 CLI 之外
• 08-config-hot-reload - 无需重启即可修改配置
• 09-channels - 在手机上与你的 Agent 对话
• 10-websocket - 以编程方式与你的 Agent 进行交互

第三阶段：自主与多 Agent 协作（第 12-16 步）

添加定时任务、Agent 协作以及智能路由功能。

• 11-multi-agent-routing - 将合适的任务分配给合适的 Agent
• 12-cron-heartbeat - 让你的 Agent 在你睡觉时工作
• 13-multi-layer-prompts - 更多上下文，更多上下文，更多上下文
• 14-post-message-back - 让你的 Agent 主动与你沟通
• 15-agent-dispatch - 让你的 Agent 寻找伙伴共同工作

第四阶段：生产环境与规模化（第 17-18 步）

提升可靠性和长期记忆的功能。

• 16-concurrency-control - 同时运行过多的 Pickle 任务？
• 17-memory - 记住我！

如何使用本教程

配置 API Keys

在运行任何步骤之前，你需要配置你的 API keys：

1. 复制示例配置文件：

   cp default_workspace/config.example.yaml default_workspace/config.user.yaml
   

2. 编辑 config.user.yaml 并填入你的 API keys：

   • 查看 LiteLLM providers 获取支持的提供商完整列表
   • 查看 Provider Examples 获取一些配置示例

3. 按照每个步骤进行阅读和尝试。

贡献

每个步骤都在独立的模块中实现。欢迎随时提出改进建议！