register providers, channels, tools, hooks, or trusted runtimes.

</Note>

## What Ships Today

## What ships today

`@openclaw/sdk` ships with:

`EnvironmentSelection`, `WorkspaceSelection`, `ApprovalMode`, and related

result types.

## Connect To A Gateway

## Connect to a Gateway

Create a client with an explicit Gateway URL, or inject a custom transport for

tests and embedded app runtimes.

});

```

## Run An Agent

## Run an agent

Use `oc.agents.get(id)` when the app wants an agent handle, then call

`agent.run()`.

the run itself timed out. Runtime timeouts, aborted runs, and cancelled runs are

normalized into `timed_out` or `cancelled`.

## Create And Reuse Sessions

## Create and reuse sessions

Use sessions when the app wants durable transcript state.

await session.compact({ maxLines: 200 });

```

## Stream Events

## Stream events

The SDK normalizes raw Gateway events into a stable `OpenClawEvent` envelope:

For app-wide streams, use `oc.events()`. For raw Gateway frames, use

`oc.rawEvents()`.

## Models, Tools, Artifacts, And Approvals

## Models, tools, artifacts, and approvals

Model helpers map to current Gateway methods:

await oc.environments.status(environments[0].id);

```

## Explicitly Unsupported Today

## Explicitly unsupported today

The SDK includes names for the product model we want, but it does not silently

pretend Gateway RPCs exist. These calls currently throw explicit unsupported

so work does not accidentally execute with default workspace, runtime,

environment, or approval behavior.

## App SDK Versus Plugin SDK

## App SDK vs Plugin SDK

Use the App SDK when code lives outside OpenClaw:

App SDK code should import from `@openclaw/sdk`. Plugin code should import from

documented `openclaw/plugin-sdk/*` subpaths. Do not mix the two contracts.

## Related Docs

## Related

- [OpenClaw App SDK API design](/reference/openclaw-sdk-api-design)

- [Gateway RPC reference](/reference/rpc)