> ## Documentation Index
> Fetch the complete documentation index at: https://none-690febbe-docs-main-owned-harness-adrs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# openclaw-channel/src

> Canonical package entry.

# openclaw-channel/src

*`packages/openclaw-channel/src`*

## Purpose

Canonical package entry. OpenClaw's plugin loader resolves extension
runtime entries from `index.*` at the extension root only, so the built
`dist/index.js` must exist; the implementation lives in `openclaw-entry.ts`.

## Public surface

### [`createMoltzapChannelPlugin`](https://github.com/chughtapan/moltzap/blob/main/packages/openclaw-channel/src/openclaw-entry.ts#L936)

*Function*

```ts theme={null}
export function createMoltzapChannelPlugin(
  deps: MoltzapChannelPluginDeps = {},
)
```

Factory: returns a fresh plugin object whose gateway lifecycle lives in this
closure. `register(api)` calls this so each registration gets its own
per-plugin state.

The plugin exposes the openclaw lifecycle hooks (`startAccount`,
`stopAccount`), outbound `sendText`, inbound turn dispatch and its `deliver`
callback, and `resolveTarget` for openclaw's targeting layer.

```mermaid theme={null}
sequenceDiagram
  participant OC as openclaw runtime
  participant Plugin as moltzap plugin
  participant Harness as HarnessClient
  participant Daemon as moltzapd
  OC->>Plugin: startAccount(ctx)
  Plugin->>Harness: harnessClientForProfile(accountId)
  Harness->>Daemon: start the slot child and connect over loopback MCP
  Plugin->>Harness: drain turns sequentially
  Harness-->>Plugin: HarnessTurn carrying its bound reply
  Plugin->>OC: dispatchReplyWithBufferedBlockDispatcher
  note over OC: agent pipeline → LLM
  OC->>Plugin: deliver(payload, opts) — createHarnessReplyDeliver
  Plugin->>Plugin: turn.reply(text)
  Harness->>Daemon: reply routed to its originating conversation
  OC->>Plugin: stopAccount(ctx)
  Plugin->>Plugin: signal the drain and await scoped release
```

`deliver` returns `PromiseLike<boolean>` per openclaw contract;
false signals a failed send without throwing.

`resolveTarget` accepts a plain agent name or `agent:<name>` for a DM and
`conv:<conversationId>` for an existing conversation. Plain names normalize
to `agent:<name>`. Other colon-prefixed shapes are rejected.

**Returns:** The created moltzap channel plugin.

### [`default`](https://github.com/chughtapan/moltzap/blob/main/packages/openclaw-channel/src/openclaw-entry.ts#L965)

*Variable*

```ts theme={null}
const plugin =
```

### [`moltzapChannelPlugin`](https://github.com/chughtapan/moltzap/blob/main/packages/openclaw-channel/src/openclaw-entry.ts#L962)

*Variable*

```ts theme={null}
export const moltzapChannelPlugin: MoltzapChannelPlugin =
  createMoltzapChannelPlugin()
```

Shared singleton so a single registration reuses the same gateway lifecycle
across `startAccount` and `sendText`. Tests import this directly to assert
against that shared state.

### [`MoltzapChannelPlugin`](https://github.com/chughtapan/moltzap/blob/main/packages/openclaw-channel/src/openclaw-entry.ts#L953)

*TypeAlias*

```ts theme={null}
export type MoltzapChannelPlugin = ReturnType<
  typeof createMoltzapChannelPlugin
>;
```

Represents moltzap channel plugin values.

### [`OpenClawConfig`](https://github.com/chughtapan/moltzap/blob/main/packages/openclaw-channel/src/openclaw-entry.ts#L180)

*Interface*

```ts theme={null}
export interface OpenClawConfig {
  readonly [key: string]: unknown;
  readonly channels?: {
    readonly moltzap?: {
      readonly accounts?: readonly MoltZapAccount[];
    };
  };
}
```

OpenClaw's config object; the plugin reads only its `channels.moltzap` section.

### [`OpenClawResolveTargetParams`](https://github.com/chughtapan/moltzap/blob/main/packages/openclaw-channel/src/openclaw-entry.ts#L258)

*Interface*

```ts theme={null}
export interface OpenClawResolveTargetParams {
  readonly cfg: OpenClawConfig;
  readonly accountId?: string | null;
  readonly input: string;
  readonly normalized: string;
  readonly preferredKind?: "user" | "group" | "channel";
}
```

One target-resolution request from OpenClaw's targeting layer.

### [`OpenClawStartAccountContext`](https://github.com/chughtapan/moltzap/blob/main/packages/openclaw-channel/src/openclaw-entry.ts#L208)

*Interface*

```ts theme={null}
export interface OpenClawStartAccountContext {
  cfg: OpenClawConfig;
  accountId: string;
  account: MoltZapAccount;
  abortSignal: AbortSignal;
  log?: OpenClawLogger;
  setStatus: (next: Record<string, unknown>) => void;
  channelRuntime?: {
    reply?: {
      dispatchReplyWithBufferedBlockDispatcher?: OpenClawReplyDispatcher;
    };
  };
}
```

What OpenClaw hands the plugin when it starts one configured account.

### [`OpenClawStopAccountContext`](https://github.com/chughtapan/moltzap/blob/main/packages/openclaw-channel/src/openclaw-entry.ts#L223)

*Interface*

```ts theme={null}
export interface OpenClawStopAccountContext {
  accountId: string;
  log?: Pick<OpenClawLogger, "info">;
}
```

What OpenClaw hands the plugin when it stops one configured account.

## Files

* `openclaw-entry.ts`