- Mac app: redesign Settings pages with consistent card layouts, cached navigation, cleaner permissions/voice/skills/cron/exec/debug panes, and steadier spacing around the native sidebar.

- Skills: rename the repo-local Codex closeout review skill and helper to `autoreview` while preserving the Codex-first fallback behavior.

- Skills: add a meme-maker skill for curated template search, local SVG/PNG rendering, Imgflip hosted rendering, and Know Your Meme provenance links.

- Browser: surface pending and recently handled modal dialogs in snapshots, return `blockedByDialog` when an action opens a modal, and allow `browser dialog --dialog-id` to answer pending dialogs.

- Agents/tools: shorten built-in tool descriptions and schema hints across media, messaging, sessions, cron, Gateway, web, image/PDF, TTS, nodes, and plan tools while preserving routing guardrails.

- Skills: add node inspector debugging, fused diagram generation, and throwaway spike workflow skills.

- CLI/plugins: add `defineToolPlugin` plus `openclaw plugins build`, `validate`, and `init` for typed simple tool plugins with generated manifest metadata, optional tool declarations, and context factories.

openclaw browser waitfordownload

openclaw browser download <ref> report.pdf

openclaw browser dialog --accept

openclaw browser dialog --dismiss --dialog-id d1

```

Managed Chrome profiles save ordinary click-triggered downloads into the OpenClaw

downloads directory (`/tmp/openclaw/downloads` by default, or the configured temp

root). Use `waitfordownload` or `download` when the agent needs to wait for a

specific file and return its path; those explicit waiters own the next download.

When an action opens a modal dialog, the action response returns

`blockedByDialog` with `browserState.dialogs.pending`; pass `--dialog-id` to

answer it directly. Dialogs handled outside OpenClaw appear under

`browserState.dialogs.recent`.

## State and storage

openclaw browser upload /tmp/openclaw/uploads/file.pdf

openclaw browser fill --fields '[{"ref":"1","type":"text","value":"Ada"}]'

openclaw browser dialog --accept

openclaw browser dialog --dismiss --dialog-id d1

openclaw browser wait --text "Done"

openclaw browser wait "#main" --url "**/dash" --load networkidle --fn "window.ready===true"

openclaw browser evaluate --fn '(el) => el.textContent' --ref 7

Notes:

- `upload` and `dialog` are **arming** calls; run them before the click/press that triggers the chooser/dialog.

- `upload` and `dialog` are **arming** calls; run them before the click/press that triggers the chooser/dialog. If an action opens a modal, the action response includes `blockedByDialog` and `browserState.dialogs.pending`; pass that `dialogId` to respond directly. Dialogs handled outside OpenClaw appear under `browserState.dialogs.recent`.

- `click`/`type`/etc require a `ref` from `snapshot` (numeric `12`, role ref `e12`, or actionable ARIA ref `ax12`). CSS selectors are intentionally not supported for actions. Use `click-coords` when the visible viewport position is the only reliable target.

- Download, trace, and upload paths are constrained to OpenClaw temp roots: `/tmp/openclaw{,/downloads,/uploads}` (fallback: `${os.tmpdir()}/openclaw/...`).

- `upload` can also set file inputs directly via `--input-ref` or `--element`.

- **Screenshots** - page captures and `--ref` element captures work; CSS `--element` selectors do not. `--full-page` cannot combine with `--ref` or `--element`. Playwright is not required for page or ref-based element screenshots.

- **Actions** - `click`, `type`, `hover`, `scrollIntoView`, `drag`, and `select` require snapshot refs (no CSS selectors). `click-coords` clicks visible viewport coordinates and does not require a snapshot ref. `click` is left-button only. `type` does not support `slowly=true`; use `fill` or `press`. `press` does not support `delayMs`. `type`, `hover`, `scrollIntoView`, `drag`, `select`, `fill`, and `evaluate` do not support per-call timeouts. `select` accepts a single value.

- **Wait / upload / dialog** - `wait --url` supports exact, substring, and glob patterns; `wait --load networkidle` is not supported. Upload hooks require `ref` or `inputRef`, one file at a time, no CSS `element`. Dialog hooks do not support timeout overrides.

- **Wait / upload / dialog** - `wait --url` supports exact, substring, and glob patterns; `wait --load networkidle` is not supported. Upload hooks require `ref` or `inputRef`, one file at a time, no CSS `element`. Dialog hooks do not support timeout overrides or `dialogId`.

- **Dialog visibility** - Managed browser action responses include `blockedByDialog` and `browserState.dialogs.pending` when an action opens a modal dialog; snapshots also include pending dialog state. Respond with `browser dialog --accept/--dismiss --dialog-id <id>` while a dialog is pending. Dialogs handled outside OpenClaw appear under `browserState.dialogs.recent`.

- **Managed-only features** - batch actions, PDF export, download interception, and `responsebody` still require the managed browser path.

</Accordion>

}

params.onTabActivity?.(readStringValue(snapshot.targetId) ?? targetId);

if (snapshot.format === "ai") {

const dialogStateFields = {

...(snapshot.blockedByDialog ? { blockedByDialog: true } : {}),

...(snapshot.browserState !== undefined ? { browserState: snapshot.browserState } : {}),

};

if (snapshot.blockedByDialog) {

const wrapped = wrapBrowserExternalJson({

kind: "snapshot",

payload: {

format: snapshot.format,

targetId: snapshot.targetId,

url: snapshot.url,

...dialogStateFields,

},

});

return {

content: [{ type: "text" as const, text: wrapped.wrappedText }],

details: {

...wrapped.safeDetails,

format: snapshot.format,

targetId: snapshot.targetId,

url: snapshot.url,

...dialogStateFields,

},

};

}

const extractedText = snapshot.snapshot ?? "";

const wrappedSnapshot = wrapExternalContent(extractedText, {

source: "browser",

imagePath: snapshot.imagePath,

imageType: snapshot.imageType,

refsFallback,

...dialogStateFields,

externalContent: {

untrusted: true,

source: "browser",

targetId: snapshot.targetId,

url: snapshot.url,

nodeCount: snapshot.nodes.length,

...(snapshot.blockedByDialog ? { blockedByDialog: true } : {}),

...(snapshot.browserState !== undefined ? { browserState: snapshot.browserState } : {}),

externalContent: {

untrusted: true,

source: "browser",

paths: Type.Optional(Type.Array(Type.String())),

inputRef: Type.Optional(Type.String()),

timeoutMs: Type.Optional(Type.Number()),

dialogId: Type.Optional(Type.String()),

accept: Type.Optional(Type.Boolean()),

promptText: Type.Optional(Type.String()),

// Legacy flattened act params (preferred: request={...})

expect(details.nodeCount).toBe(1);

});

it("preserves pending dialog state in ai snapshot results", async () => {

browserClientMocks.browserSnapshot.mockResolvedValueOnce({

ok: true,

format: "ai",

targetId: "t1",

url: "https://example.com",

snapshot: "",

blockedByDialog: true,

browserState: {

dialogs: {

pending: [{ id: "d1", type: "confirm", message: "Continue?" }],

recent: [],

},

},

});

const tool = createBrowserTool();

const result = await tool.execute?.("call-1", { action: "snapshot", snapshotFormat: "ai" });

const text = firstResultText(result);

expect(text).toContain('"blockedByDialog": true');

expect(text).toContain('"id": "d1"');

const details = externalContentDetails(result, "snapshot") as {

blockedByDialog?: unknown;

browserState?: { dialogs?: { pending?: Array<{ id?: string }> } };

};

expect(details.blockedByDialog).toBe(true);

expect(details.browserState?.dialogs?.pending?.[0]?.id).toBe("d1");

});

it("wraps tabs output as external content", async () => {

browserClientMocks.browserTabs.mockResolvedValueOnce([

{

case "dialog": {

const accept = Boolean(params.accept);

const promptText = readStringValue(params.promptText);

const dialogId = readStringValue(params.dialogId);

const { targetId, timeoutMs } = readOptionalTargetAndTimeout(params);

if (proxyRequest) {

const result = await proxyRequest({

body: {

accept,

promptText,

dialogId,

targetId,

timeoutMs,

},

const result = await browserToolDeps.browserArmDialog(baseUrl, {

accept,

promptText,

dialogId,

targetId,

timeoutMs,

profile,

url?: string;

result?: unknown;

results?: Array<{ ok: boolean; error?: string }>;

blockedByDialog?: boolean;

browserState?: unknown;

};

const BROWSER_ACT_REQUEST_TIMEOUT_SLACK_MS = 5_000;

opts: {

accept: boolean;

promptText?: string;

dialogId?: string;

targetId?: string;

timeoutMs?: number;

profile?: string;

body: JSON.stringify({

accept: opts.accept,

promptText: opts.promptText,

dialogId: opts.dialogId,

targetId: opts.targetId,

timeoutMs: opts.timeoutMs,

}),

targetId: string;

url: string;

nodes: SnapshotAriaNode[];

blockedByDialog?: boolean;

browserState?: unknown;

}

| {

ok: true;

labelsSkipped?: number;

imagePath?: string;

imageType?: "png" | "jpeg";

blockedByDialog?: boolean;

browserState?: unknown;

};

export async function browserStatus(