Novita sandbox environments require an API key in config or

Error message

Novita sandbox environments require an API key in config or NOVITA_API_KEY.

What it means

Error "Novita sandbox environments require an API key in config or NOVITA_API_KEY." thrown in paperclipai/paperclip.

Source

Thrown at packages/plugins/sandbox-providers/novita/src/plugin.ts:76

  if (!config.apiKey && !process.env.NOVITA_API_KEY?.trim()) {
    errors.push("Novita sandbox environments require an API key in config or NOVITA_API_KEY.");
  }
  if (!config.requestedCwd.startsWith("/")) {
    errors.push("requestedCwd must be an absolute path.");
  }
  if (config.timeoutMs < 10_000) {
    errors.push("timeoutMs must be at least 10000.");
  }
  if (config.requestTimeoutMs < 1_000) {
    errors.push("requestTimeoutMs must be at least 1000.");
  }
  return errors;
}

function resolveApiKey(config: NovitaDriverConfig): string {
  const apiKey = config.apiKey ?? process.env.NOVITA_API_KEY?.trim() ?? "";
  if (!apiKey) {
    throw new Error("Novita sandbox environments require an API key in config or NOVITA_API_KEY.");
  }
  return apiKey;
}

function sandboxOpts(config: NovitaDriverConfig) {
  return {
    apiKey: resolveApiKey(config),
    ...(config.domain ? { domain: config.domain } : {}),
    ...(config.secure == null ? {} : { secure: config.secure }),
    timeoutMs: config.timeoutMs,
    requestTimeoutMs: config.requestTimeoutMs,
  };
}

function formatErrorMessage(error: unknown): string {
  return error instanceof Error ? error.message : String(error);
}

View on GitHub (pinned to 120ae5428f)

Solutions

Set NOVITA_API_KEY or configure apiKey in the environment config.

When it happens

Trigger: Thrown at packages/plugins/sandbox-providers/novita/src/plugin.ts:76 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@120ae5428f (2026-08-18). Data as JSON: /api/errors/461d841cbc80a931. Report an issue: GitHub.