跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI算法

基于 Python 的极简 OpenClaw Agent 实现:openclaw-mini

openclaw-mini 是基于 Python 实现的极简 OpenClaw 风格 AI 助手项目。它利用 Discord 作为交互通道,结合本地 Codex CLI 进行模型推理,并通过 Markdown 文件(SOUL.md 和 skills)定义行为逻辑。该架构避免了复杂的多 Agent 管理和 API 封装,强调代码可读性与本地迭代效率。适合希望快速搭建可控 Discord AI 机器人的开发者,采用 Unix 哲学设计,各组件职责单一明确。

AiEngineer发布于 2026/3/28更新于 2026/10/27101 浏览
基于 Python 的极简 OpenClaw Agent 实现:openclaw-mini

如果你关注过 OpenClaw 这个项目,可能会觉得它功能完整但结构相对复杂,而且不是用 Python 实现。

对于很多想快速搭建一个 本地运行的 Discord AI 助手 的开发者来说,可能更希望有一个:

  • 架构更简单
  • 全 Python 实现
  • 不需要自己封装 OpenAI API
  • 本地运行即可

这时候,推荐看看这个项目:

openclaw-mini 它是一个 OpenClaw 风格的'极简版本',专注在一个清晰的路径上: Discord + 本地 Codex CLI + Markdown 驱动的行为定义。


openclaw-mini 是什么?

openclaw-mini 是一个最小可用的 OpenClaw 风格 Agent,专注做三件事:

  • ✅ 使用 Discord 作为输入输出通道
  • ✅ 使用本地 Codex CLI 执行模型推理
  • ✅ 使用 SOUL.md + skills/*.md 定义行为

没有复杂的多 Agent 管理,没有庞大的中间层抽象。

它的核心目标是:

做一个你能在一个下午完整读懂的 AI Agent 架构。


它的运行机制:非常干净的一条主线

读过代码之后,你会发现整个控制流非常清晰。

1️⃣ 启动入口:main.py

  • 加载环境变量
  • 启动 Discord 客户端

没有额外框架,没有复杂生命周期管理。


2️⃣ bot.py:处理消息

当收到 Discord 消息时:

  • 过滤 bot 自己发的消息
  • 处理内置命令:
    • /help
    • /skills
    • /soul

如果不是命令,则进入模型处理流程。


3️⃣ 构造提示词(Prompt 拼接)

普通消息会被封装为一个完整 instruction,包含:

  • SOUL.md 的内容(Agent 的人格和行为原则)
  • skills/*.md 的所有技能卡片内容
  • 用户原始消息

它的思路是:

用 Markdown 驱动行为,而不是在代码里写大量逻辑。

这是一种非常干净的'提示工程驱动架构'。


4️⃣ llm.py:调用本地 Codex CLI

这里是最有意思的设计。

它 不在 Python 里直接调用 OpenAI API, 而是调用:

codex exec --json --output-last-message 

然后读取模型的最终输出。

也就是说:

  • Python 只负责 I/O 和流程
  • 模型会话由 Codex CLI 管理
  • 对话状态由 Codex CLI 线程维护

本地 Codex 会话的设计:非常聪明

每一个 Discord 会话会映射到一个:

✅ 持久化 Codex thread ID

线程信息保存在:

.codex-discord-sessions.json 

并支持:

  • TTL 过期控制(CODEX_SESSION_TTL_SEC)
  • 超时自动重建
  • 会话持续上下文

这样做的好处是:

✅ 不需要自己实现对话历史拼接 ✅ 不需要维护 token 限制逻辑 ✅ 不需要管理复杂的 API session

全部交给 Codex CLI。


为什么这个设计很实用?

对于个人开发者或小团队,这种架构有几个明显优势:

✅ 1. 可读性极高

整个代码量很小,逻辑线性。

你可以在一个晚上完全理解:

  • 消息如何进来
  • Prompt 如何构造
  • 模型如何调用
  • 会话如何持久化

✅ 2. 本地迭代极快

你只需要:

  1. 安装 openAI Codex CLI
  2. 配置 Discord Token
  3. 修改 Markdown 文件

改完 SOUL.md 或某个 skill 文件,重启即可生效。


✅ 3. 运维非常轻量

项目已经包含:

  • systemd 模板
  • launchd 模板
  • 环境变量控制参数:
    • CODEX_SANDBOX
    • approval 策略
    • 超时时间
    • 模型选择

这意味着:

它是'最小可生产部署'的结构。


它适合什么人?

如果你想做:

  • 🎯 一个 Discord 专用 AI 助手
  • 🧠 一个本地可控的 Agent
  • 🛠 一个可以完全理解其内部机制的系统
  • 🐍 一个纯 Python 技术栈项目

那么 openclaw-mini 是非常合适的起点。


和完整 OpenClaw 的区别

对比项OpenClawopenclaw-mini
架构复杂度高低
语言非 Python✅ Python
多 Agent 支持强简化
上手难度偏高✅ 非常友好
适合人群进阶构建者✅ 快速原型开发者

如果你觉得 OpenClaw 太重、太抽象、太工程化, openclaw-mini 是一个非常好的'轻量入口'。


总结

openclaw-mini 做了一件很聪明的事情:

把复杂性留给 Codex CLI,把结构简化到最小。

Discord 负责输入输出, Markdown 负责行为定义, Codex 负责推理, Python 负责连接。

这是一种非常'Unix 哲学'的设计方式: 每个组件做好一件事。

如果你正在考虑做一个本地 AI Discord Agent, 我建议从它开始,而不是一上来就搭一个复杂框架。


Repo

https://github.com/robotlearner001/openclaw-mini

目录

  1. openclaw-mini 是什么?
  2. 它的运行机制:非常干净的一条主线
  3. 1️⃣ 启动入口:main.py
  4. 2️⃣ bot.py:处理消息
  5. 3️⃣ 构造提示词(Prompt 拼接)
  6. 4️⃣ llm.py:调用本地 Codex CLI
  7. 本地 Codex 会话的设计:非常聪明
  8. 为什么这个设计很实用?
  9. ✅ 1. 可读性极高
  10. ✅ 2. 本地迭代极快
  11. ✅ 3. 运维非常轻量
  12. 它适合什么人?
  13. 和完整 OpenClaw 的区别
  14. 总结
  15. Repo

更多推荐文章

查看全部
  • 更高级的 RAG 架构:提升 AI 大模型回答准确性
  • C++ 类与对象完全解析
  • Rust 语言的前世今生与核心技术解析
  • Python 爬虫技术入门:原理、工具与实战流程
  • MySQL GROUP BY 语句语法及实例演示
  • C++ STL vector 底层原理与模拟实现
  • 前端文档预览避坑指南:为何放弃微软 Office Online 接口
  • Kafka 核心机制与架构深度解析
  • Windows 系统下 PyCharm 激活 Python 虚拟环境指南
  • 绕过Stable Diffusion安全过滤:PGD视觉提示词注入攻击实践
  • Linux 泰山派 RK3566 驱动开发:环境搭建与内核编译
  • B 站 PC 端自动开启字幕用户脚本
  • Linux Ext2 文件系统深度解析
  • AI Agent 实战指南:从零搭建生产级框架与核心实现
  • SBUS 协议详解:从原理、硬件接口到 STM32 代码实现
  • Python-100-Days:Python 百天从新手到大师学习路径
  • Python Django Web 框架核心功能与实战
  • 从零搭建可落地 AI Agent:开发全流程与实战
  • WebGIS 实战:WKT 转 GeoJSON 技巧与 Leaflet 集成
  • C++ STL set 容器详解与实战用法

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Gemini 图片去水印

    基于开源反向 Alpha 混合算法去除 Gemini/Nano Banana 图片水印,支持批量处理与下载。 在线工具,Gemini 图片去水印在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online