🦞 clawdo — AI智能体缺失的待办事项清单

你的智能体拥有记忆文件、定时任务和聊天功能，唯独缺少待办事项清单。

无法直接表达“有空时处理这个”既非“在UTC 14:00执行”，也非“当前对话中立即处理”。只需…记住它、追踪它，在空闲时主动处理。

这就是clawdo。

安装指南

clawhub install clawdo    # installs skill + docs into your workspace
npm install -g clawdo     # install the CLI binary

环境要求：Node.js ≥18

快速入门

# Capture a task
clawdo add "update dependencies" --urgency soon

# Agent checks its queue (heartbeat, cron, conversation — wherever)
clawdo inbox --format json

# Agent works it
clawdo start a3f2
clawdo done a3f2 --json

添加 → 收件箱 → 开始 → 完成· 通过SQLite实现持久化状态存储。所有命令均支持--json输出格式，确保智能体解析结构化数据而非终端艺术字符。

适用场景

clawdo适用于所有智能体工作场景：

• 心跳循环——“队列中有任务吗？让我在检查间隙处理它”
• 定时任务——“每小时处理一项任务”
• 对话交互— "J提到要修复认证模块，我来记录一下"
• 管道与子代理— 非TTY安全，无交互式提示

心跳集成示例

# In HEARTBEAT.md — runs every ~30 minutes
TASKS=$(clawdo inbox --format json)
AUTO=$(echo "$TASKS" | jq '.autoReady | length')

if [ "$AUTO" -gt 0 ]; then
  TASK=$(clawdo next --auto --json | jq -r '.task.id')
  clawdo start "$TASK" --json
  # ... do the work ...
  clawdo done "$TASK" --json
fi

自主级别

任务可标记权限层级，以控制代理在无人监督时允许执行的操作：

默认设置：协作模式（安全模式）。

核心规则：自主权是许可，而非建议。一旦设定，代理无法更改。若代理失败3次，自主权降级为协作模式。安全级别仅降不升。

代理提议，人类批准。代理任务始终以待批准状态开始。需由人类执行clawdo confirm <id>指令方可执行。

使用说明

人类用户端

# Add tasks — inline metadata parsing
clawdo add "deploy new API +backend auto-notify now"
#           └── text ──────┘ └project┘ └─level──┘ └urg┘

# View
clawdo list                       # active tasks
clawdo list --status proposed     # agent suggestions
clawdo next                       # highest priority

# Review agent proposals
clawdo confirm <id>               # approve
clawdo reject <id>                # reject

# Work
clawdo start <id>
clawdo done <id>
clawdo done abc,def,ghi           # complete several

代理端

# Check inbox (structured)
clawdo inbox --format json

# Propose work
clawdo propose "add input validation" --level auto --json

# Execute
TASK=$(clawdo next --auto --json | jq -r '.task.id // empty')
if [ -n "$TASK" ]; then
  clawdo start "$TASK" --json
  # ... do the work ...
  clawdo done "$TASK" --json
fi

收件箱返回状态：自主就绪、自主通知就绪、紧急、逾期、待批准，不新鲜的,已阻止.

内联语法

clawdo add "fix auth bug +backend @code auto soon"

• +单词→ 项目
• @单词→ 上下文
• 自动/自动通知/协作→ 自主级别
• 现在/很快/随时/某天→ 紧急程度
• 截止日期:年-月-日→ 截止日期

安全

• 不可变的自主性— 代理无法提升权限
• 提案限制— 最多5个活跃提案，60秒冷却时间
• 提示注入防护— 输入净化，参数化SQL语句
• 审计追踪— 记录所有状态变更的只追加日志
• 安全ID生成—crypto.randomInt()，无模偏差

资源

• GitHub： https://github.com/LePetitPince/clawdo
• npm： https://www.npmjs.com/package/clawdo
• 完整文档： clawdo --help

许可证

MIT