`openclaw tasks`

先听这页的人话版

这一页不是在堆术语，它像把“`openclaw tasks`”这台小机器搬到桌上，当着你的面拆开给你看。你先不用全记住，先抓住它到底在忙什么：Inspect durable background tasks and Task Flow state. With no sub魔法口令, openclaw tasks is equiva…。

如果把这页当成“给普通人看的版本”，你最应该带走的是：它到底在教你一件什么事、什么时候要这样做、以及哪里最容易踩坑。

原始路径：/cli/tasks 章节数量：11 查看原文

第 1 站

Start Here

这一节主要在解释“Start Here”到底是干什么的，以及你什么时候会遇到它。

这段在解决什么

这一节主要在解释“Start Here”到底是干什么的，以及你什么时候会遇到它。

为什么值得看

如果你是第一次接触 OpenClaw，这一节最值得看的不是术语本身，而是它背后的使用场景和限制。

真要动手时

真正动手时，先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。

先别急着背术语

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Inspect durable background tasks and Task Flow state. With no sub魔法口令, openclaw tasks is equivalent to openclaw tasks l…。

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Inspect durable background tasks and Task Flow state. With no sub魔法口令, openclaw tasks is equivalent to openclaw tasks l…。

原文小纸条

Inspect durable background tasks and Task Flow state. With no subcommand, openclaw tasks is equivalent to openclaw tasks list.

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：See Background Tasks for the lifecycle and delivery 聪明脑袋模型.

原文小纸条

See Background Tasks for the lifecycle and delivery model.

第 2 站

Usage

这一节主要在解释“Usage”到底是干什么的，以及你什么时候会遇到它。

这段在解决什么

这一节主要在解释“Usage”到底是干什么的，以及你什么时候会遇到它。

为什么值得看

如果你是第一次接触 OpenClaw，这一节最值得看的不是术语本身，而是它背后的使用场景和限制。

真要动手时

真正动手时，先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。

先别急着背术语

这一小段像旁白，在提醒我们镜头已经切到下一站。

像魔法口令拆解

这是一句直接对 OpenClaw 说的话，像你把任务清清楚楚塞到它手里。

这一句是在直接叫 OpenClaw 动起来：“openclaw tasks”。你可以把它想成一句说出口就要执行的差事。
这一句是在直接叫 OpenClaw 动起来：“openclaw tasks list”。你可以把它想成一句说出口就要执行的差事。
这一句是在直接叫 OpenClaw 动起来：“openclaw tasks list --runtime acp”。你可以把它想成一句说出口就要执行的差事。

原文代码块

openclaw tasks
openclaw tasks list
openclaw tasks list --runtime acp
openclaw tasks list --status running
openclaw tasks show <lookup>
openclaw tasks notify <lookup> state_changes
openclaw tasks cancel <lookup>
openclaw tasks audit
openclaw tasks maintenance
openclaw tasks maintenance --apply
openclaw tasks flow list
openclaw tasks flow show <lookup>
openclaw tasks flow cancel <lookup>

第 3 站

Root Options

这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。

这段在解决什么

这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。

为什么值得看

你理解的是能力边界，不只是功能名字。

真要动手时

如果这节里同时出现命令、配置和例子，优先先看例子，再回头看配置。

先别急着背术语

这一小段像旁白，在提醒我们镜头已经切到下一站。

像准备清单

这一串条目别硬背，把它当成“Root Options”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：--json: output JSON.、--runtime <name>: filter by kind: sub机器人朋…、--status <name>: filter by status: queued…。

原文小纸条

--json: output JSON.
--runtime <name>: filter by kind: subagent, acp, cron, or cli.
--status <name>: filter by status: queued, running, succeeded, failed, timed_out, cancelled, or lost.

第 4 站

`list`

这一节主要在解释“`list`”到底是干什么的，以及你什么时候会遇到它。

这段在解决什么

这一节主要在解释“`list`”到底是干什么的，以及你什么时候会遇到它。

为什么值得看

如果你是第一次接触 OpenClaw，这一节最值得看的不是术语本身，而是它背后的使用场景和限制。

真要动手时

真正动手时，先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。

先别急着背术语

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Lists tracked background tasks newest first.

像魔法口令拆解

这是一句直接对 OpenClaw 说的话，像你把任务清清楚楚塞到它手里。

这一句是在直接叫 OpenClaw 动起来：“openclaw tasks list [--runtime <name>] [--status <name>] [--json]”。你可以把它想成一句说出口就要执行的差事。

原文代码块

openclaw tasks list [--runtime <name>] [--status <name>] [--json]

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Lists tracked background tasks newest first.

原文小纸条

Lists tracked background tasks newest first.

第 5 站

`show`

这一节主要在解释“`show`”到底是干什么的，以及你什么时候会遇到它。

这段在解决什么

这一节主要在解释“`show`”到底是干什么的，以及你什么时候会遇到它。

为什么值得看

如果你是第一次接触 OpenClaw，这一节最值得看的不是术语本身，而是它背后的使用场景和限制。

真要动手时

真正动手时，先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。

先别急着背术语

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Shows one task by task ID, run ID, or session key.

像魔法口令拆解

这是一句直接对 OpenClaw 说的话，像你把任务清清楚楚塞到它手里。

这一句是在直接叫 OpenClaw 动起来：“openclaw tasks show <lookup> [--json]”。你可以把它想成一句说出口就要执行的差事。

原文代码块

openclaw tasks show <lookup> [--json]

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Shows one task by task ID, run ID, or session key.

原文小纸条

Shows one task by task ID, run ID, or session key.

第 6 站

`notify`

这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。

这段在解决什么

这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。

为什么值得看

这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”，读懂它比记术语更重要。

真要动手时

你可以把这一节当成权限说明书，真正配置时优先盯住 default、required、allow、deny 这几个词。

先别急着背术语

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Changes the notification policy for a running task.

像魔法口令拆解

这是一句直接对 OpenClaw 说的话，像你把任务清清楚楚塞到它手里。

这一句是在直接叫 OpenClaw 动起来：“openclaw tasks notify <lookup> <done_only|state_changes|silent>”。你可以把它想成一句说出口就要执行的差事。

原文代码块

openclaw tasks notify <lookup> <done_only|state_changes|silent>

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Changes the notification policy for a running task.

原文小纸条

Changes the notification policy for a running task.

第 7 站

`cancel`

这一节主要在解释“`cancel`”到底是干什么的，以及你什么时候会遇到它。

这段在解决什么

这一节主要在解释“`cancel`”到底是干什么的，以及你什么时候会遇到它。

为什么值得看

如果你是第一次接触 OpenClaw，这一节最值得看的不是术语本身，而是它背后的使用场景和限制。

真要动手时

真正动手时，先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。

先别急着背术语

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Cancels a running background task.

像魔法口令拆解

这是一句直接对 OpenClaw 说的话，像你把任务清清楚楚塞到它手里。

这一句是在直接叫 OpenClaw 动起来：“openclaw tasks cancel <lookup>”。你可以把它想成一句说出口就要执行的差事。

原文代码块

openclaw tasks cancel <lookup>

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Cancels a running background task.

原文小纸条

Cancels a running background task.

第 8 站

`audit`

这一节主要在解释“`audit`”到底是干什么的，以及你什么时候会遇到它。

这段在解决什么

这一节主要在解释“`audit`”到底是干什么的，以及你什么时候会遇到它。

为什么值得看

如果你是第一次接触 OpenClaw，这一节最值得看的不是术语本身，而是它背后的使用场景和限制。

真要动手时

真正动手时，先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。

先别急着背术语

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Surfaces stale, lost, delivery-failed, or otherwise inconsistent task and Task Flow records. Lost tasks retained until…。

像魔法口令拆解

这是一句直接对 OpenClaw 说的话，像你把任务清清楚楚塞到它手里。

这一句是在直接叫 OpenClaw 动起来：“openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]”。你可以把它想成一句说出口就要执行的差事。

原文代码块

openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Surfaces stale, lost, delivery-failed, or otherwise inconsistent task and Task Flow records. Lost tasks retained until…。

原文小纸条

Surfaces stale, lost, delivery-failed, or otherwise inconsistent task and Task Flow records. Lost tasks retained until cleanupAfter are warnings; expired or unstamped lost tasks are errors.

第 9 站

`maintenance`

这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。

这段在解决什么

这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。

为什么值得看

你理解的是能力边界，不只是功能名字。

真要动手时

如果这节里同时出现命令、配置和例子，优先先看例子，再回头看配置。

先别急着背术语

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Previews or applies task and Task Flow reconciliation, cleanup stamping, pruning, and stale cron run session registry c…。

像魔法口令拆解

这是一句直接对 OpenClaw 说的话，像你把任务清清楚楚塞到它手里。

这一句是在直接叫 OpenClaw 动起来：“openclaw tasks maintenance [--apply] [--json]”。你可以把它想成一句说出口就要执行的差事。

原文代码块

openclaw tasks maintenance [--apply] [--json]

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Previews or applies task and Task Flow reconciliation, cleanup stamping, pruning, and stale cron run session registry c…。

原文小纸条

Previews or applies task and Task Flow reconciliation, cleanup stamping, pruning, and stale cron run session registry cleanup. For cron tasks, reconciliation uses persisted run logs/job state before marking an old active task lost, so completed cron runs do not become false audit errors just because the in-memory Gateway runtime state is gone. Offline CLI audit is not authoritative for the Gateway's process-local cron active-job set. CLI tasks with a run id/source id are marked lost when their live Gateway run context is gone, even if an old child-session row remains. When applied, maintenance also prunes cron:<jobId>:run:<uuid> session registry rows older than 7 days while preserving currently running cron jobs and leaving non-cron session rows untouched.

第 10 站

`flow`

这一节主要在解释“`flow`”到底是干什么的，以及你什么时候会遇到它。

这段在解决什么

这一节主要在解释“`flow`”到底是干什么的，以及你什么时候会遇到它。

为什么值得看

如果你是第一次接触 OpenClaw，这一节最值得看的不是术语本身，而是它背后的使用场景和限制。

真要动手时

真正动手时，先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。

先别急着背术语

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Inspects or cancels durable Task Flow state under the task ledger.

像魔法口令拆解

这是一句直接对 OpenClaw 说的话，像你把任务清清楚楚塞到它手里。

这一句是在直接叫 OpenClaw 动起来：“openclaw tasks flow list [--status <name>] [--json]”。你可以把它想成一句说出口就要执行的差事。
这一句是在直接叫 OpenClaw 动起来：“openclaw tasks flow show <lookup> [--json]”。你可以把它想成一句说出口就要执行的差事。
这一句是在直接叫 OpenClaw 动起来：“openclaw tasks flow cancel <lookup>”。你可以把它想成一句说出口就要执行的差事。

原文代码块

openclaw tasks flow list [--status <name>] [--json]
openclaw tasks flow show <lookup> [--json]
openclaw tasks flow cancel <lookup>

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Inspects or cancels durable Task Flow state under the task ledger.

原文小纸条

Inspects or cancels durable Task Flow state under the task ledger.

第 11 站

`openclaw tasks`：命令行这颗按钮到底按哪儿

`openclaw tasks`

Start Here

Usage

Root Options

`list`

`show`

`notify`

`cancel`

`audit`

`maintenance`

`flow`

Related