2026 年 2 月 2 日

如果你已经习惯用 AI,应该很熟悉这种体验:方案写得挺好,接下来还是得自己开网页、找文件、复制内容,再把结果塞进另一个系统。

AI 参与了工作,但流程还挂在你身上。

OpenClaw 最容易让人心动的地方,就在这里。你在聊天窗口交代一个目标,它去调用工具、处理文件,再把结果送回来。原来需要自己盯着走的几步操作,开始有机会被串成一个完整任务。

这也是我想认真拆一拆它的原因。一个开源项目能火成这样,背后一定有值得理解的需求;而要把这种需求变成每天都能用的工具,光把程序装起来还不够。

十万 Star 背后,大家究竟在期待什么

这几天,Clawdbot、Moltbot、OpenClaw 几个名字轮番出现在讨论里。如果只断断续续看过几条消息,很容易以为又出了好几个新项目。其实,它们指向的是同一个项目的更名过程。

1 月 29 日,Peter Steinberger 在 OpenClaw 的更名公告里写到:这个由周末项目发展而来的工具,GitHub Star 已经超过 10 万,一周吸引了 200 万访问者。1

这个数字最有意思的地方,是一个人的助手需求,突然获得了大量开发者的共鸣。让 AI 通过常用聊天工具接收任务、调用电脑上的工具,已经足够吸引大家来试。

现在还很难判断,这阵热度会持续多久、多少人会把它留在自己的工作流里。但至少有一件事值得认真看:大家到底想让这个助手替自己做什么?

我的理解是,OpenClaw 接住了一种积累很久的期待:用户已经知道 AI 会回答问题,接下来想要的是有人把事情做完。

它也让开发者看到了可以动手改造的空间。自己接入口、加工具、调整工作流,比等待一个封闭产品排期更直接。一个人做出一个新用法,其他人就能沿着这个方向继续试,热度便有了持续生长的材料。

但我不会拿 Star 数替代使用判断。点一下收藏的成本很低,让一个助手进入自己的日常工作,要付出的配置、调试和信任成本高得多。对个人用户来说,最后还是得回到一个问题:它能稳定替我省掉哪一段工作?

这两天的讨论,让我更关心交付和边界

2 月 1 日,宝玉整理了 Peter Steinberger 的一段访谈。其中一个提醒很实在:长时间运行本身不能说明 Agent 有用,关键还得看做出了什么。这是访谈中创始人的观点,由宝玉整理介绍。2

我觉得它正好能帮人从热闹里退半步。让一个程序连续跑一整晚并不难,难的是第二天打开电脑,能拿到一份值得用的结果,而不是一堆需要重新整理的过程记录。

卡兹克在 1 月底的《保姆级 Clawdbot 教程来了,但我还是想劝大家悠着点》中,则把体验的吸引力和权限问题放在一起谈:可以尝试,但要先想清楚把哪些操作交给它,部署时也要留意主力设备上的资料。3

这个提醒不妨直接落实到第一个任务里。比如先让它生成一份周报草稿,把输入和输出目录限定清楚,再检查文件内容;邮件发送、文件删除这类操作,可以等流程跑顺了再接。

至于聊天入口会怎样改变软件界面,现在可以提出一些猜想。查资料、导数据、做格式转换,可能越来越适合把中间步骤收起来;可到了付款、删文件、发给客户这些环节,我仍然希望看见明确的对象和结果。界面也许会更多出现在检查、纠错和做决定的位置,这还需要继续观察。

顺着这些讨论往下做,我更愿意抓住三个具体问题:任务怎么交代,结果怎么验收,哪些操作需要停下来让人决定。 这比一开始就追求全天候自主运行,更容易找到一个实用的起点。

把那句“帮我做一下”,拆开就有四层

拿一个具体需求来说:

每周五把这周的会议记录和项目更新整理成一份周报,放到指定目录,再把文件位置告诉我。

从用户视角看,这是一句话。从工程视角看,至少有四层工作。

个人助手的四层工作链路

第一层是入口。 聊天消息、定时触发,或者网页按钮,把需求送进来。这里要知道是谁发起的、属于哪次会话。

第二层是任务。 把自然语言落实成可以追踪的对象:本周周报是哪一份、现在做到哪、失败了几次、结果存在哪里。

第三层是执行。 找会议记录、读项目更新、提取要点、写入文档。模型适合处理理解和归纳,文件操作、查重和格式检查则可以交给确定性的工具。

第四层是交付。 输出文件、列出缺失资料、通知任务完成。只有走到这里,用户才真正拿到了结果。

这四层一分开,很多使用中的别扭就有了具体原因。

比如你问“周报好了吗”,助手又从头开始找资料,问题可能是没有稳定的任务记录。它说“已经完成”,目录里却找不到文件,问题可能是没有把成功状态和输出文件对应起来。消息掉线后又投递了一次,周报发了两份,则需要检查重复处理。

所以我会先补任务这一层。它不显眼,却能把一次看起来顺畅的演示,变成一段可持续的工作流程。

第一个任务,最好选一个你每周都嫌麻烦的活

先别急着接满所有平台。找一个重复出现、输入拿得到、结果容易检查的任务,最容易判断值不值得继续投入。

起步任务 最小输入 交付结果 第一次怎么检查
会议纪要 一份会议文本 决策、待办、负责人 有没有漏掉关键行动项
项目周报 本周记录和项目更新 一份 Markdown 周报 进展和阻塞是否对应原文
资料简报 固定几个信息源 去重后的摘要与链接 有没有漏源、重复和旧消息
文件归档 一个待整理目录 分类计划与目标路径 抽查十个文件的归类

我更愿意从周报这类任务开始。它的频率足够高,结果也比较直观,而且很适合把“我到底想要什么”写清楚。

任务描述可以这样写:

1
2
3
4
5
6
7
任务:生成 2026 年第 5 周(1 月 26 日至 2 月 1 日)项目周报。
输入:input/meetings/ 和 input/project-updates/。
输出:output/weekly-2026-W05.md。
结构:本周进展、未解决问题、下周计划。
每条待办保留负责人;缺少负责人时标为待确认。
缺少资料时列入“待补充”,不要自行补全。
完成后返回文件位置,先保存为草稿。

这段话的价值在于,它同时给了执行者一个目标,也给了你一个检查结果的依据。否则只说“专业一点、全面一点”,你很难判断它下一次究竟有没有进步。

把一个重复任务做成可复用流程

动手做个小执行器:重复消息别重复干活

接下来把任务管理单独拿出来,用 Python 和 SQLite 跑一遍。先让它生成固定内容的本地草稿,任务执行的位置以后再接模型或业务工具。

这个小例子处理四件事:

  1. 同一条消息重复送达,只建一次任务。
  2. 消息换了一个 ID,但要求的是同一份周报,仍然关联到原任务。
  3. 读取资料超时,记录失败原因,下一轮继续尝试。
  4. 完成后保存文件位置,再查询时能直接找到结果。

这里最容易混淆的是两个 ID。

event_id 表示入口收到的那条消息,task_key 表示业务上要做的那件事。它们不一定一一对应。

比如聊天软件把 msg-001 重发一次,这是重复事件;你换句话说“再把这周周报给我”,收到的是新事件,但可能仍然指向同一份周报。

1
2
3
4
5
msg-001 ──→ meeting-2026-01-30
msg-001 ──→ 同一事件,直接复用

msg-002 ──→ weekly-2026-W05
msg-003 ──→ 同一份周报,关联原任务

数据库因此分成两张表:

1
2
3
4
5
6
7
8
9
10
11
12
CREATE TABLE events (
event_id TEXT PRIMARY KEY,
task_key TEXT NOT NULL
);

CREATE TABLE tasks (
task_key TEXT PRIMARY KEY,
state TEXT NOT NULL DEFAULT 'pending',
attempts INTEGER NOT NULL DEFAULT 0,
result_ref TEXT,
last_error TEXT
);

收到消息时,在同一个事务里登记事件和任务:

1
2
3
4
5
6
7
8
9
10
11
12
with db:
changed = db.execute(
'INSERT OR IGNORE INTO events VALUES (?, ?)',
(event_id, task_key)
).rowcount
if not changed:
return '重复事件,复用已有任务'

db.execute(
'INSERT OR IGNORE INTO tasks(task_key) VALUES (?)',
(task_key,)
)

需要重新生成时,也别把用户一直困在“已有结果”里。可以给任务增加版本,例如 weekly-2026-W05-v2,或者提供明确的“重新生成”操作。复用旧结果和重做一份,应当是两个能区分的动作。

实际跑一下

在本系列目录下执行,Python 3.10+ 即可:

1
python3 examples/openclaw_task_demo.py --self-test

脚本会先处理会议纪要和周报,再让周报第一轮遇到一次模拟超时。关闭数据库连接后重新打开,第二轮继续完成周报,最后再发送一条要求同一份周报的新消息。

任务去重、重试与结果落盘的实际运行记录

本地脚本实际输出。完整代码:openclaw_task_demo.py,代码见文末。

结果里最值得看的是最后两行任务记录:会议纪要执行了一次,周报执行了两次,两项最终都是 done,各自对应一份结果文件。

这时,助手就能给出更有用的回答:周报已经完成,文件在这里;或者资料读取失败,已经尝试一次,下一轮会重试。用户不需要盯着日志,也能知道事情有没有继续往前走。

出错以后,助手也得知道下一步怎么走

把任务状态画出来,恢复逻辑会更容易说清楚。

任务状态与失败处理

有些失败适合自动重试,例如短暂网络超时。有些失败应该立即停下,例如没有文件权限、找不到必填字段,或者要求访问的资料根本不存在。

如果不分类型,所有错误都重试三次,既浪费调用,也把真正需要补充的信息藏起来了。更实用的做法是:可恢复故障进入重试,缺资料进入等待,达到上限就给出明确原因。

还有一个容易漏掉的细节:外部动作已经完成,本地却还没记账。

例如邮件发出了,进程随后退出,任务表仍显示未完成。下次重试可能把邮件再发一次。对这类动作,需要把同一个任务标识传给支持幂等的下游接口,或者记录待发送事件并核对回执。遇到无法判断的状态,就把对象和当前进展展示出来,让人决定。

上面的小脚本采用单执行器,演示有界重试和可重复写入的本地文件。扩展成常驻服务时,还需要增加任务领取锁、退避等待,以及对长期停留在 running 的任务进行恢复检查。这些机制应该在连接真实业务动作之前想清楚。

装好之后,连续用一周,再决定继续加什么

我会先记三笔账。

第一笔是时间。 做同样一份周报,人工原本花多久,现在还需要检查和修改多久。把准备资料、处理错误的时间也算进去,才知道到底省在哪里。

第二笔是费用。 一个任务调用几次模型、有没有重复读取整份资料、失败重试消耗多少。对于稳定格式的任务,可以先让脚本处理字段、去重与格式转换,把需要判断的部分再交给模型。

第三笔是返工。 一周做了五次,哪些步骤每次都要你纠正?如果总是漏掉负责人,就补输出检查;如果总在错误目录找文件,就修输入约定。把反复出现的问题改进流程,比每次在聊天里重新提醒更有用。

用满一周之后,再决定要不要加聊天入口、定时调度和更多工具。每增加一项能力,都能对应到一个真实的麻烦,系统就更容易保持清楚。

OpenClaw 的热度说明,大家对个人助手的期待已经很具体了:可以交代任务,过一会儿回来拿结果。

我愿意沿着这个方向继续试。先挑一个每周都要做的任务,让它连续交付几次;等到文件找得到、失败说得清、重复请求也处理妥当,再把更多事情交过去。那个时候,它才会从一个新鲜工具,慢慢变成工作习惯。

完整实验代码

保存为 examples/openclaw_task_demo.py 后,使用前文命令运行。

展开完整 Python 示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
#!/usr/bin/env python3
"""Agent 任务执行层示例:持久化、两层去重、有界重试、幂等文件输出。"""
import argparse
import json
import sqlite3
import tempfile
from pathlib import Path

SCHEMA = '''
CREATE TABLE IF NOT EXISTS events(event_id TEXT PRIMARY KEY, task_key TEXT NOT NULL);
CREATE TABLE IF NOT EXISTS tasks(
task_key TEXT PRIMARY KEY, state TEXT NOT NULL DEFAULT 'pending',
attempts INTEGER NOT NULL DEFAULT 0, result_ref TEXT, last_error TEXT
);
'''

def connect(path):
db = sqlite3.connect(path)
db.executescript(SCHEMA)
return db

def submit(db, event_id, task_key):
with db:
changed = db.execute('INSERT OR IGNORE INTO events VALUES (?, ?)', (event_id, task_key)).rowcount
if not changed:
return '重复事件,复用已有任务'
changed = db.execute('INSERT OR IGNORE INTO tasks(task_key) VALUES (?)', (task_key,)).rowcount
return '新建任务' if changed else '同一业务任务,复用已有结果'

def work(db, output):
rows = db.execute("SELECT task_key, attempts FROM tasks WHERE state IN ('pending','retry') AND attempts < 3 ORDER BY task_key").fetchall()
for key, attempts in rows:
with db:
db.execute("UPDATE tasks SET state='running', attempts=attempts+1 WHERE task_key=?", (key,))
try:
# 固定故障注入:周报第一轮失败,用于观察下一轮恢复。
if key.startswith('weekly') and attempts == 0:
raise TimeoutError('模拟资料读取超时')
dest = output / (key + '.md')
tmp = dest.with_suffix('.tmp')
tmp.write_text(f'# 任务交付:{key}\n\n状态:已生成本地草稿。\n\n这是执行层示例,正文使用固定内容。\n')
tmp.replace(dest)
with db:
db.execute("UPDATE tasks SET state='done', result_ref=?, last_error=NULL WHERE task_key=?", (dest.name, key))
print(f'完成 {key} -> {dest.name}')
except TimeoutError as error:
with db:
db.execute("UPDATE tasks SET state=?, last_error=? WHERE task_key=?", ('failed' if attempts+1 >= 3 else 'retry', str(error), key))
print(f'重试 {key}:{error}')

def run(base):
base.mkdir(parents=True, exist_ok=True)
path = base / 'tasks.sqlite3'
db = connect(path)
for event,key in [('msg-001','meeting-2026-01-30'),('msg-001','meeting-2026-01-30'),('msg-002','weekly-2026-W05')]:
print(event, '=>', submit(db,event,key))
print('\n第一轮执行'); work(db,base); db.close()
# 关闭再打开连接,验证任务状态保存在磁盘,而非进程变量中。
db = connect(path)
print('\n重新连接数据库,执行第二轮'); work(db,base)
print('\n新消息要求生成同一份周报')
print('msg-003 =>',submit(db,'msg-003','weekly-2026-W05'))
rows = db.execute('SELECT task_key, state, attempts, result_ref FROM tasks ORDER BY task_key').fetchall()
print('\n最终任务表')
for row in rows: print(' | '.join(map(str,row)))
assert len(rows)==2 and all(row[1]=='done' for row in rows)
assert rows[0][2]==1 and rows[1][2]==2
assert len(list(base.glob('*.md')))==2
print('\n验证通过:3 个唯一消息事件 / 2 个业务任务 / 2 份结果文件')
db.close()

if __name__ == '__main__':
parser=argparse.ArgumentParser(); parser.add_argument('--self-test',action='store_true'); args=parser.parse_args()
if args.self_test:
with tempfile.TemporaryDirectory(prefix='openclaw-task-demo-') as tmp: run(Path(tmp))
else:
base=Path(__file__).resolve().parent/'output'/'openclaw-v2-asof-2026-02-02'
if (base/'tasks.sqlite3').exists():
raise SystemExit('演示目录已有运行结果。请用 --self-test 在独立临时目录重跑,已有结果保持不变。')
run(base)

延伸阅读