paperclipai/paperclip · error · PaperclipRunnerProviderProfileError

paperclip_runner_claude_managed_profile_required

paperclip_runner_claude_managed_profile_required

Error message

Paperclip Runner Claude Managed requires a company managed-agent profile.

What it means

Guard in resolvePaperclipRunnerProviderProfile for claude_managed: config.managedProfileId must be a non-empty string identifying the company's managed-agent profile, else 'paperclip_runner_claude_managed_profile_required' is thrown. Without a profile id the run cannot resolve the qualified managed-agent (agent id, environment, beta, secret) needed to call the managed-agents API.

Source

Thrown at server/src/services/native-runtime/provider-profile.ts:343

  if (candidate === "opencode") {
    if (!model || !model.includes("/") || model.endsWith("/")) {
      throw new PaperclipRunnerProviderProfileError(
        "paperclip_runner_opencode_model_invalid",
        "Paperclip Runner OpenCode requires model in provider/model form.",
      );
    }
    return {
      provider: "opencode",
      backend: "opencode_server",
      model,
    };
  }

  if (candidate === "claude_managed") {
    const managedProfileId = optionalString(config.managedProfileId);
    if (!managedProfileId) {
      throw new PaperclipRunnerProviderProfileError(
        "paperclip_runner_claude_managed_profile_required",
        "Paperclip Runner Claude Managed requires a company managed-agent profile.",
      );
    }
    if (config.managedAgentsRetentionAcknowledged !== true) {
      throw new PaperclipRunnerProviderProfileError(
        "paperclip_runner_claude_managed_retention_required",
        "Paperclip Runner Claude Managed requires acknowledgement of stateful beta retention.",
      );
    }
    if (model !== null && model !== CLAUDE_MANAGED_QUALIFIED_MODEL) {
      throw new PaperclipRunnerProviderProfileError(
        "paperclip_runner_claude_managed_model_unqualified",
        `The Claude Managed profile requires exact model ${CLAUDE_MANAGED_QUALIFIED_MODEL}.`,
      );
    }
    return {
      provider: "claude_managed",

View on GitHub (pinned to 01ad858492)

Solutions

1. Set managedProfileId in adapterConfig to the company's managed-agent profile id or profileKey.
2. Create/qualify a managed-agent profile for the company first, then reference it.
3. Choose a different provider if no Claude Managed profile exists.

When it happens

Trigger: Thrown at server/src/services/native-runtime/provider-profile.ts:337 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@01ad858492 (2026-09-02). Data as JSON: /api/errors/ea8f97ec6d8a6da4. Report an issue: GitHub.