</Accordion>

<Accordion title="runtime.tasks.flow → runtime.tasks.flows">

<Accordion title="runtime.tasks.flow → runtime.tasks.managedFlows">

**Old**: `runtime.tasks.flow` (singular) returned a live task-flow accessor.

**New**: `runtime.tasks.flows` (plural) returns DTO-based TaskFlow access,

which is import-safe and does not require the full task runtime to be

loaded.

**New**: `runtime.tasks.managedFlows` keeps the managed TaskFlow mutation

runtime for plugins that create, update, cancel, or run child tasks from a

flow. Use `runtime.tasks.flows` when the plugin only needs DTO-based reads.

```typescript

// Before

const flow = api.runtime.tasks.flow(ctx);

const flow = api.runtime.tasks.flow.fromToolContext(ctx);

// After

const flows = api.runtime.tasks.flows(ctx);

const flow = api.runtime.tasks.managedFlows.fromToolContext(ctx);

```

</Accordion>

Inside the Gateway this runtime is in-process. In plugin CLI commands it calls the configured Gateway over RPC, so commands such as `openclaw googlemeet recover-tab` can inspect paired nodes from the terminal. Node commands still go through normal Gateway node pairing, command allowlists, and node-local command handling.

</Accordion>

<Accordion title="api.runtime.taskFlow">

<Accordion title="api.runtime.tasks.managedFlows">

Bind a Task Flow runtime to an existing OpenClaw session key or trusted tool context, then create and manage Task Flows without passing an owner on every call.

```typescript

const taskFlow = api.runtime.taskFlow.fromToolContext(ctx);

const taskFlow = api.runtime.tasks.managedFlows.fromToolContext(ctx);

const created = taskFlow.createManaged({

controllerId: "my-plugin/review-batch",

- Request body size and timeout guards

- Fixed-window rate limiting

- In-flight request limiting

- Owner-bound TaskFlow access through `api.runtime.taskFlow.bindSession(...)`

- Owner-bound TaskFlow access through `api.runtime.tasks.managedFlows.bindSession(...)`

## Request format

return null;

}

const taskFlow =

api.runtime?.taskFlow && ctx.sessionKey

? api.runtime.taskFlow.fromToolContext(ctx)

api.runtime?.tasks.managedFlows && ctx.sessionKey

? api.runtime.tasks.managedFlows.fromToolContext(ctx)

: undefined;

return createLobsterTool(api, { taskFlow }) as AnyAgentTool;

}) as OpenClawPluginToolFactory,

};

type BoundTaskFlow = ReturnType<

NonNullable<OpenClawPluginApi["runtime"]>["taskFlow"]["bindSession"]

NonNullable<OpenClawPluginApi["runtime"]>["tasks"]["managedFlows"]["bindSession"]

>;

type FlowRecord = ReturnType<BoundTaskFlow["createManaged"]>;

} from "./lobster-taskflow.js";

type BoundTaskFlow = ReturnType<

NonNullable<OpenClawPluginApi["runtime"]>["taskFlow"]["bindSession"]

NonNullable<OpenClawPluginApi["runtime"]>["tasks"]["managedFlows"]["bindSession"]

>;

type JsonLike =

import type { OpenClawPluginApi } from "../runtime-api.js";

export type BoundTaskFlow = ReturnType<

NonNullable<OpenClawPluginApi["runtime"]>["taskFlow"]["bindSession"]

NonNullable<OpenClawPluginApi["runtime"]>["tasks"]["managedFlows"]["bindSession"]

>;

export function createFakeTaskFlow(overrides?: Partial<BoundTaskFlow>): BoundTaskFlow {

source: "test",

pluginConfig: params?.pluginConfig ?? {},

runtime: {

taskFlow: {

bindSession: vi.fn(({ sessionKey }: { sessionKey: string }) => ({ sessionKey })),

tasks: {

managedFlows: {

bindSession: vi.fn(({ sessionKey }: { sessionKey: string }) => ({ sessionKey })),

},

},

} as unknown as OpenClawPluginApi["runtime"],

registerHttpRoute: params?.registerHttpRoute ?? vi.fn(),

});

for (const route of routes) {

const taskFlow = api.runtime.taskFlow.bindSession({

const taskFlow = api.runtime.tasks.managedFlows.bindSession({

sessionKey: route.sessionKey,

});

const target: TaskFlowWebhookTarget = {

} from "../runtime-api.js";

import type { WebhookSecretInput } from "./config.js";

type BoundTaskFlowRuntime = ReturnType<PluginRuntime["taskFlow"]["bindSession"]>;

type BoundTaskFlowRuntime = ReturnType<PluginRuntime["tasks"]["managedFlows"]["bindSession"]>;

type JsonValue = null | boolean | number | string | JsonValue[] | { [key: string]: JsonValue };