paperclipai/paperclip · error

gateway not connected

Error message

gateway not connected

What it means

Error "gateway not connected" thrown in paperclipai/paperclip.

Solutions

1. Start or reconnect the OpenClaw gateway before executing.
2. Check gateway configuration and connectivity.

When it happens

Trigger: Thrown at packages/adapters/openclaw-gateway/src/server/execute.ts:712 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@3f1d897a7c (2026-08-18). Data as JSON: /api/errors/28426cf11969fe5f. Report an issue: GitHub.

Appendix: source

Thrown at packages/adapters/openclaw-gateway/src/server/execute.ts:727

      }),
      timeoutMs,
      "gateway websocket open timeout",
    );

    const nonce = await withTimeout(this.challengePromise, timeoutMs, "gateway connect challenge timeout");
    const signedConnectParams = buildConnectParams(nonce);

    const hello = await this.request<Record<string, unknown> | null>("connect", signedConnectParams, {
      timeoutMs,
    });

    return hello;
  }

  async request<T>(
    method: string,
    params: unknown,
    opts: GatewayClientRequestOptions,
  ): Promise<T> {
    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
      throw new Error("gateway not connected");
    }

    const id = randomUUID();
    const frame: GatewayRequestFrame = {
      type: "req",
      id,
      method,
      params,
    };

    const payload = JSON.stringify(frame);
    const requestPromise = new Promise<T>((resolve, reject) => {
      const timer =
        opts.timeoutMs > 0
          ? setTimeout(() => {

View on GitHub (pinned to 3f1d897a7c)