subzeroclaw

一个用C语言编写的极简自主代理运行时,通过LLM与Shell直接交互完成任务。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:subzeroclaw。
它的用途是:一个用C语言编写的极简自主代理运行时,通过LLM与Shell直接交互完成任务。
完整的 Skill 内容见:https://321skill.com/skills/subzeroclaw/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“监控磁盘使用率,如果超过80%就清理/tmp目录下的旧文件。” 它会读取你预先编写的“系统监控”技能文件,理解任务后,自动执行 `df -h` 检查磁盘,计算使用率,若超过阈值则运行 `find /tmp -type f -mtime +7 -delete` 等命令进行清理,并循环检查直到任务完成。

介绍

SubZeroClaw 是一个极简的自主代理运行时,旨在解决在资源受限的边缘硬件上运行AI代理的需求。它没有复杂的框架和抽象,核心逻辑仅约550行C代码,生成约55KB的二进制文件,实现了“读取技能描述 -> 调用LLM -> 执行Shell命令 -> 循环”这一最基础的代理循环。

使用方式非常直接:用户将任务目标编写成Markdown格式的技能文件,配置好API密钥和路由端点(推荐使用其配套的unhardcoded路由器),然后运行SubZeroClaw并输入任务指令即可。代理会读取技能文件作为系统提示,然后自主调用Shell工具,循环执行直到任务完成,整个过程会生成完整的I/O日志。

它非常适合追求极致轻量、对系统资源有严格限制的开发者、运维工程师或智能体开发者,尤其是在树莓派等边缘设备上部署自动化任务。对于希望深入理解代理运行底层原理,或需要将代理能力嵌入到小型、定制化系统中的技术爱好者也很有吸引力。

需要注意的是,这是一个“无护栏”的高风险工具。它直接执行LLM生成的任意Shell命令,没有任何安全确认、沙箱保护或风险拦截机制。用户必须完全理解其危险性,仅在不含敏感数据、可承受完全损坏的隔离测试环境中使用,并强烈建议搭配具备路由和上下文压缩能力的unhardcoded路由器来管理模型调用与上下文增长。

核心特点

与依赖复杂框架(如LangChain)的代理不同,SubZeroClaw用极简的C代码直接实现了最核心的代理循环,没有任何中间抽象层,二进制文件仅55KB,构建速度极快,专为资源苛刻的边缘环境设计。其上下文压缩和模型路由等复杂功能通过外置的unhardcoded路由器以JSON策略声明,而非硬编码在代理本身,保持了核心的极度简洁。

注意事项

由于完全信任LLM输出且无任何安全机制,绝对不适合在生产环境、存有重要数据或连接互联网的主机上使用。

常见问题

SubZeroClaw安全吗?

极不安全。它无条件执行LLM生成的任何Shell命令,包括格式化磁盘等危险操作,必须在隔离的测试环境中使用。

必须使用unhardcoded路由器吗?

推荐使用以获得路由、提示词缓存亲和及上下文压缩能力。也可直连其他API,但会失去这些优化,上下文会持续增长直至被提供商拒绝。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/subzeroclaw/raw/index.md 读取 subzeroclaw 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。