Pokoclaw

真正能做事的 Claw 🚀

English | 简体中文

Setup • 什么是 Pokoclaw • 核心理念 • 适合谁用 • 为什么是 Pokoclaw • 有何不同 • 产品取舍 • 技术架构

---

Pokoclaw 是一只真正能做事的 Claw。
它把 执行、观察、控制、协作、沉淀 组合成一个长期可用的个人 AI 助理系统。

Cronjob	Introspection	Subagent

Setup

把下面这句话发给你的 AI 编程助手（例如 Claude Code、Codex 或其他类似工具）：

Read docs/onboarding.md and help me set up and run this project.

当前 onboarding 会包含飞书/Lark 配置，因为它是现在唯一支持的 channel。

---

✨ 什么是 Pokoclaw

Pokoclaw 是一个面向真实任务的个人 AI 助理。
它不是把模型接进聊天工具，也不是把工具堆进一个 bot。

它的目标，不是让 AI 停留在“响应请求”，
而是把 AI 推进到“持续做事”。

在 Pokoclaw 里，AI 不只是一个回答问题的对象。
它是一个可以被委派、被监督、被纠偏、被复盘，并且会持续进化的协作系统。

换句话说，Pokoclaw 想做的不是一个看起来很忙的 AI。
而是一个真的能替你推进任务、并且能长期协作下去的 AI 助理。

---

💫 核心理念

🔭 可观测性

大多数 Claw-like 产品 的问题，不是能力不够，而是过程不可见。

它开始执行之后，你不知道它在做什么。
你不知道它有没有跑偏。
你也不知道它到底是卡住了，还是还在继续。

Pokoclaw 从一开始就把可观测性当成一等能力：

• 运行过程不是黑箱
• 工具调用、执行进度、运行状态可以回显
• 失败不是静默消失，而是明确可见
• 用户不是只能等结果，而是始终知道它在做什么
• 系统可以查询自己的运行时状态、任务状态与部分系统记录
• 在需要的时候，系统可以结合运行日志进行自我观测与自我诊断

🎛️ 可操控性

真正的 AI 助理，不应该只会自己跑。
它必须能被人接管、打断、纠偏、暂停、继续。

Pokoclaw 强调的不是“完全自动化”，而是可操控的自动化：

• 方向不对，可以及时干预
• 任务进行中，可以停止或调整
• 用户不需要把控制权彻底交给系统
• 自动执行与人工判断之间始终保留连接

真正让人放心的，不是“它会自己干活”。
而是“它会自己干活，但始终在你的控制之内”。

🧠 Self-Harness

Pokoclaw 不只想让 AI 记住信息。
它更想让 AI 学会怎么和你更好地协作。

这就是 Pokoclaw 的 Self-Harness。

它不只是 memory，也不是往知识文件里机械地追加几行偏好。
它关注的是更深一层的事情：

• 哪些地方让用户不爽
• 哪些错误在重复发生
• 哪些协作摩擦应该被长期消除
• 哪些经验应该沉淀成未来默认行为

它的目标不是让系统“显得更聪明”。
而是让系统越来越像一个真正配合默契的助理。

不是只记住你说过什么。
而是慢慢学会，怎样做事才更适合你。

🧭 任务边界

很多 OpenClaw-like 产品 在真正开始承载工作之后，会迅速暴露一个问题：

所有事情都挤在同一个聊天流里。

调研、写代码、整理日报、查信息、追踪任务，全部混在一个上下文里。
旧任务不断插回新对话，协作很快失去秩序。

Pokoclaw 的设计不是把更多事情塞进一个窗口。
而是把不同层次的工作拆清楚：

• 主 Agent：长期在线的统一入口，像管家一样协调一切
• SubAgent：围绕具体主题长期协作的独立空间
• TaskAgent：在后台执行、完成后汇报的任务执行单元

这不是实现细节。
这是产品结构。
它决定了 AI 协作是越来越乱，还是越来越清楚。

⚙️ 无人值守能力

很多系统都声称支持自动化。
真正难的不是“能不能自动跑”，而是：

• 能不能长期稳定地跑
• 遇到权限问题怎么办
• 出错时怎么处理
• 用户不在线时，系统还能不能继续推进

Pokoclaw 关注的是真实世界里的无人值守任务，而不是演示式自动化。

它试图解决的，不只是“会不会做”，而是：

在真实权限边界、真实任务链路、真实用户习惯里，它能不能持续做下去。

---

👥 适合谁用

Pokoclaw 现在最适合这类用户：

• 开发者
• 产品经理
• 独立开发者
• 有技术背景、已经深度使用 AI 的人
• 对 agent、自动化、长期协作有真实需求的人

这不是一个一上来就试图服务所有人的产品。
它更适合那些已经明确感受到这些问题，也真正希望把 AI 用来做事的人。

---

💥 为什么是 Pokoclaw

因为现在已经不缺会聊天的 AI。
也不缺会调用工具的 AI。
甚至不缺看起来“什么都能做”的 AI。

真正稀缺的是另一种东西：

• 一个不那么黑箱的 AI
• 一个任务边界更清楚的 AI
• 一个能长期协作的 AI
• 一个真正值得托付任务的 AI

Pokoclaw 想做的，不是把已有的 Claw 再做大一点。
而是把 AI 个人助理 这件事，从产品结构上重新设计一遍。

---

🦞 有何不同

✨ OpenClaw is fun, but Pokoclaw ships.

Pokoclaw 不打算沿着“更大、更全、更多渠道、更像平台”的方向去竞争。

因为我们相信，真正决定 AI 助理体验的，不是功能表，而是产品结构。

很多 Claw 更像平台。
Pokoclaw 更像助理。

很多系统强调能力覆盖。
Pokoclaw 更强调协作质量。

很多产品能跑任务。
Pokoclaw 更在意：这些任务是否可见、可控、可持续、可托付。

我们不想做另一个更大的 Claw。
我们想做一只真正能做事的 Claw。

---

🎯 产品取舍

Pokoclaw 不追求一开始就接入所有渠道。
也不认为“接得越多”天然代表“产品越强”。

对个人 AI 助理来说，重要的不是覆盖一切表面。
而是优先选择那些真正适合 AI 协作的交互载体，把体验做到足够深。

这也是为什么，Pokoclaw 会更在意：

• 哪个渠道最适合任务协作
• 哪个渠道最适合状态反馈
• 哪个渠道最适合交互控制
• 哪个渠道最适合承载长期 AI 协作体验

不是为了兼容而兼容。
而是为了“让 AI 真正做事”而做选择。

---

🛠️ 技术架构

Pokoclaw 基于 TypeScript / Node.js 构建，围绕真实任务执行和长期协作体验来设计。

它的核心不是某个单点模型能力，而是这些结构共同作用：

• 主 Agent / SubAgent / TaskAgent 分层
• runtime orchestration
• 权限与审批链路
• 可观测事件流
• Self-Harness
• 面向真实任务的调度与执行能力

技术栈不是重点。
重点是：这些技术选择都服务于同一件事。

让 AI 不只是看起来会做事，而是真的能长期把事情做下去。

---