ODS V3 Pre-Release: Public testing and refinement ahead of the official V3 launch. Turn your PC, Mac, or Linux box into a private AI server.
title: Pixel configuration source map doc_type: reference audience: [owner, operator, contributor, security-reviewer] feature_status: mixed owners: [documentation, configuration] sources_of_truth: [.env.example, onboarding.example.json, configs/, control/, deploy/] generated_by: scripts/docs/generate-config-reference.mjs last_verified_at: generated
Pixel configuration source map
This catalog covers the audited 42 canonical JSON, YAML, and environment examples. It distinguishes authored inputs, generated output shapes, private component policy, evaluation inputs, and repository contracts. It does not make every field safe to edit or every component enabled.
Configuration lifecycle
Owner-authored onboarding or overlay input is validated before Pixel generates private configuration. A reviewed plan precedes apply. Installed runtime state and content-free evidence are outputs, not configuration inputs. Changing a private component policy requires that component's validated reconfigure/restart path; copying an example into place never grants capability or authority.
| Example | Classification | Custody | Apply/reload boundary | Format | Top-level fields or environment keys |
|---|---|---|---|---|---|
.env.example |
generated-output template | repository example; generated live file is private | rerun configure, review plan, then apply; do not hand-edit generated live output | environment | APPLY_CONFIG, OPENCLAW_BIN, OPENCLAW_HOME, PIXEL_ACTION_PROPOSAL_DIR, PIXEL_ACTION_RESULT_DIR, PIXEL_AGENT_ID, PIXEL_AGENT_NAME, PIXEL_BACKUP_AGE_RECIPIENT, PIXEL_BACKUP_ALLOWED_SIGNERS, PIXEL_BACKUP_SIGNING_KEY, PIXEL_CALENDAR_DIRECT_ENABLED, PIXEL_CALENDAR_DIRECT_MAX_PER_HOUR, PIXEL_CALENDAR_ID, PIXEL_CAPABILITY_PROFILE, PIXEL_COURIER_SYSTEMD_DIR, PIXEL_DEPLOYMENT_PROFILE, PIXEL_DISCORD_PLUGIN_VERSION, PIXEL_EMBEDDING_CACHE, PIXEL_EMBEDDING_MODEL, PIXEL_ENABLE_REFERENCE_MODEL, PIXEL_FRONTIER_AUTH_MODE, PIXEL_FRONTIER_BROKER_ENABLED, PIXEL_FRONTIER_BROKER_ENV, PIXEL_FRONTIER_BROKER_GROUP, PIXEL_FRONTIER_BROKER_INSTALL_DIR, PIXEL_FRONTIER_BROKER_STATE_DIR, PIXEL_FRONTIER_BROKER_SYSTEMD_DIR, PIXEL_FRONTIER_BROKER_UNIT, PIXEL_FRONTIER_BROKER_USER, PIXEL_FRONTIER_CANCEL_DIR, PIXEL_FRONTIER_CREDENTIAL_PATH, PIXEL_FRONTIER_CREDENTIAL_SOURCE, PIXEL_FRONTIER_EVENT_DIR, PIXEL_FRONTIER_POLICY_PATH, PIXEL_FRONTIER_READER_USER, PIXEL_FRONTIER_REQUEST_DIR, PIXEL_FRONTIER_RESULT_DIR, PIXEL_FRONTIER_STATE_DIR, PIXEL_GATEWAY_PORT, PIXEL_GOOGLE_ACCOUNT, PIXEL_GOOGLE_CLIENT_FILE, PIXEL_GOOGLE_CONFIG_DIR, PIXEL_GOOGLE_TOKEN_PATH, PIXEL_INSTALL_DIR, PIXEL_LIMB_CALENDAR_ENABLED, PIXEL_LIMB_EMAIL_ENABLED, PIXEL_LIMB_FRONTIER_ENABLED, PIXEL_LIMB_OPERATIONS_ENABLED, PIXEL_LIMB_SOCIAL_ENABLED, PIXEL_LIMB_WEB_ENABLED, PIXEL_LLAMA_CPP_PLUGIN_VERSION, PIXEL_LLAMA_IMAGE, PIXEL_MODEL_API_KEY, PIXEL_MODEL_BASE_URL, PIXEL_MODEL_CONTEXT_WINDOW, PIXEL_MODEL_ID, PIXEL_MODEL_MAX_TOKENS, PIXEL_MODEL_NAME, PIXEL_MODEL_PROVIDER, PIXEL_MODEL_REASONING, PIXEL_OAUTH_REDIRECT_URI, PIXEL_OPENCLAW_VERSION, PIXEL_OPS_BROKER_ENABLED, PIXEL_OPS_BROKER_ENV, PIXEL_OPS_BROKER_GROUP, PIXEL_OPS_BROKER_INSTALL_DIR, PIXEL_OPS_BROKER_STATE_DIR, PIXEL_OPS_BROKER_SYSTEMD_DIR, PIXEL_OPS_BROKER_UNIT, PIXEL_OPS_BROKER_USER, PIXEL_OPS_CANCEL_DIR, PIXEL_OPS_EVENT_DIR, PIXEL_OPS_INVENTORY_PATH, PIXEL_OPS_POLICY_PATH, PIXEL_OPS_READER_USER, PIXEL_OPS_REQUEST_DIR, PIXEL_OPS_RESULT_DIR, PIXEL_OPS_STATE_DIR, PIXEL_PRIVATE_ONBOARDING_PATH, PIXEL_REFERENCE_MODEL_FILE, PIXEL_REFERENCE_MODEL_PORT, PIXEL_RELEASE_VERSION, PIXEL_SANDBOX_IMAGE, PIXEL_SEARXNG_BASE_URL, PIXEL_SEARXNG_IMAGE, PIXEL_SEARXNG_PLUGIN_VERSION, PIXEL_SKIP_ENDPOINT_CHECKS, PIXEL_SKIP_NPM_CI, PIXEL_SOURCE_ACTION_UNIT, PIXEL_SOURCE_BROKER_ENABLED, PIXEL_SOURCE_BROKER_ENV, PIXEL_SOURCE_BROKER_INSTALL_DIR, PIXEL_SOURCE_BROKER_STATE_DIR, PIXEL_SOURCE_BROKER_SYSTEMD_DIR, PIXEL_SOURCE_BROKER_TIMER, PIXEL_SOURCE_BROKER_UNIT, PIXEL_SOURCE_BROKER_USER, PIXEL_SOURCE_CALENDAR_FUTURE_DAYS, PIXEL_SOURCE_CALENDAR_PAST_DAYS, PIXEL_SOURCE_DIRECT_PATH_UNIT, PIXEL_SOURCE_DIRECT_UNIT, PIXEL_SOURCE_GMAIL_MAX_PAGES, PIXEL_SOURCE_GMAIL_PAGE_SIZE, PIXEL_SOURCE_GMAIL_QUERY, PIXEL_SOURCE_GMAIL_SENT_MAX_PAGES, PIXEL_SOURCE_GMAIL_SENT_PAGE_SIZE, PIXEL_SOURCE_GMAIL_SENT_QUERY, PIXEL_SOURCE_PROJECTION_DIR, PIXEL_SOURCE_READER_USER, PIXEL_SOURCE_RECONCILE_UNIT, PIXEL_SOURCE_STALE_AFTER_MS, PIXEL_SOURCE_TOKEN_PATH, PIXEL_SYSTEMD_UNIT, PIXEL_TIME_ZONE, PIXEL_WEB_COURIER_ALLOWED_PORTS, PIXEL_WEB_COURIER_BROWSER_PATH, PIXEL_WEB_COURIER_DOMAIN_INTERVAL, PIXEL_WEB_COURIER_ENABLED, PIXEL_WEB_COURIER_LOG_PATH, PIXEL_WEB_COURIER_NAV_TIMEOUT_MS, PIXEL_WEB_COURIER_SCREENSHOT_CAP, PIXEL_WEB_COURIER_TEXT_CAP, PIXEL_WEB_COURIER_UNIT, PIXEL_WEB_COURIER_WHEELHOUSE, PIXEL_WORKSPACE |
client-overlay.example.json |
owner-authored input template | copy to an owner-private path before adding real values | validate and regenerate; review the resulting plan before apply | JSON | $schema, capabilityProfile, clientId, core, extensions, frontier, licensing, operatorAccess, privacy, schemaVersion, usability |
control/access-adapter.example.json |
private control-policy input template | owner-private installed-host input | validate, then reconfigure/restart only the owning control component | JSON | $schema, access, boundary, limits, listen, publicOrigin, schemaVersion, upstream |
control/policy.example.json |
private control-policy input template | owner-private installed-host input | validate, then reconfigure/restart only the owning control component | JSON | actions, backup, schemaVersion, views |
control/work-authoring.example.json |
private control-policy input template | owner-private installed-host input | validate, then reconfigure/restart only the owning control component | JSON | $schema, boundary, draftDirectory, inputCatalogFile, maxDrafts, objectStoreDirectory, policyFile, schemaVersion |
control/work-launch.example.json |
private control-policy input template | owner-private installed-host input | validate, then reconfigure/restart only the owning control component | JSON | $schema, boundary, draftDirectory, environmentFile, launchDirectory, maxLaunches, schemaVersion |
control/work-service.example.json |
private control-policy input template | owner-private installed-host input | validate, then reconfigure/restart only the owning control component | JSON | $schema, boundary, dockerGroup, flockPath, installRoot, maxBundles, nodePath, schemaVersion, serviceDirectory, serviceGroup, serviceUser, watchdogSeconds |
deploy/agent-comparison/assistant-template.example.json |
qualification or evaluation input template | disposable/private evaluation state | starts a new exact evaluation only; grants no runtime or promotion authority | JSON | $schema, actionJournalRoots, boundary, chatEnvironment, embeddingCachePath, embeddingModel, openclawBinaryPath, proxyListenPort, sandboxImage, schemaVersion, searxngBaseUrl |
deploy/agent-comparison/pair-system.example.json |
qualification or evaluation input template | disposable/private evaluation state | starts a new exact evaluation only; grants no runtime or promotion authority | JSON | $schema, boundary, candidateSourceArchiveSha256, capabilityRetentionEvidencePath, codexBoundaryImage, codexRunnerImage, codexSurfaceQualificationPath, launchArgumentsPath, modelArtifactManifestPath, modelArtifactPath, pixelSystemConfigPath, preflightPath, schemaVersion |
deploy/agent-comparison/pixel-system.example.json |
qualification or evaluation input template | disposable/private evaluation state | starts a new exact evaluation only; grants no runtime or promotion authority | JSON | $schema, assistantTemplatePath, boundary, environmentTemplatePath, modelBackendTemplatePath, policyTemplatePath, runtimeRoot, schemaVersion |
deploy/frontier-broker/policy.chatgpt.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | authority, budgets, dataPolicy, deployment, provider, retention, routing, schemaVersion, taskClasses |
deploy/frontier-broker/policy.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | authority, budgets, dataPolicy, deployment, provider, retention, routing, schemaVersion, taskClasses |
deploy/github-broker/policy.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | allowedOperations, allowedRepositories, apiVersion, boundary, enabled, maxBodyBytes, maxReconcilePages, schemaVersion |
deploy/github-broker/proposal.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | actionId, boundary, createdAt, operation, repository, schemaVersion, source, status, values |
deploy/ops-broker/action-packs.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | actions, authorityGrants, schemaVersion, targetPlaceholder |
deploy/ops-broker/policy.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | actions, authority, defaultTimeoutSeconds, deployment, download, identityCacheSeconds, maxOutputBytes, maxTimeoutSeconds, maxWorkers, maxWorkflowSteps, planTtlMinutes, schemaVersion, sshBinary, targets, workflowWorkers |
deploy/ops-runner/actions.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | collectSources, jobRoot, maxArtifactBytes, repositories, schemaVersion, services |
deploy/ops-runner/managed.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | allowReboot, artifactRoots, deployments, maxPackageBytes, packages, schemaVersion, services, verifiedArtifactRoot |
deploy/release-operator/config.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | readers, receiptRoot, schemaVersion, units |
deploy/release-operator/pixel-config.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | brokerBytes, bundleRoot, inboxRoot, nodePath, ownerUid, pixelWorkGid, pixelWorkUid, readersEnabled, rebootRoot, receiptRoot, runtimePath, runtimeTreeSha256, schemaVersion, systemctlPath, systemdAnalyzePath |
deploy/work-broker/policy.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | $schema, enabled, executor, localModel, maxLeaseSeconds, maxRequestAgeSeconds, policyId, profiles, retention, runner, schemaVersion, security, verifier |
deploy/work-codex-provider/egress-policy.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | $schema, allowedHosts, allowedPorts, boundary, connectTimeoutSeconds, denyConnectToUnlistedHosts, denyIpLiterals, denyPlainHttp, denyPrivateAddressResolution, idleTimeoutSeconds, logRequestBodies, logResponseBodies, maxConcurrentTunnels, maxTunnelBytes, mode, schemaVersion |
deploy/work-codex-provider/policy.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | $schema, authorization, boundary, credentialCustody, dataPolicy, deployment, enabled, execution, provider, retention, schemaVersion, taskClasses, transport |
deploy/work-controller/context-session-input.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | $schema, artifacts, decisions, schemaVersion, summary, unresolvedRisks |
deploy/work-controller/goal-brief-data.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | $schema, boundary, dataClassification, milestones, objective, schemaVersion |
deploy/work-controller/goal-brief.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | $schema, boundary, dataClassification, milestones, objective, schemaVersion |
deploy/work-controller/goal-controller-capability-environment.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | $schema, archiveLimits, boundary, capabilityRuntime, executorPath, modelBackendLaunchPath, objectStore, policyPath, runtime, schemaVersion, stateRoot, workspaceRoot |
deploy/work-controller/goal-controller-environment.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | $schema, archiveLimits, boundary, executorPath, modelBackendLaunchPath, objectStore, policyPath, runtime, schemaVersion, stateRoot, workspaceRoot |
deploy/work-controller/goal-controller-knowledge-environment.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | $schema, archiveLimits, boundary, executorPath, knowledgeRuntime, modelBackendLaunchPath, objectStore, policyPath, runtime, schemaVersion, stateRoot, workspaceRoot |
deploy/work-controller/goal-declaration.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | $schema, boundary, dataClassification, milestones, objective, schemaVersion |
deploy/work-controller/input-catalog.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | $schema, boundary, catalogId, createdAt, entries, schemaVersion |
deploy/work-controller/input-selection-data.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | $schema, boundary, createdAt, entries, schemaVersion, selectionId |
deploy/work-controller/input-selection.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | $schema, boundary, createdAt, entries, schemaVersion, selectionId |
deploy/work-controller/model-backend-llama.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | $schema, accelerator, backendNetwork, boundary, containerUser, environmentPath, modelSource, providerOptions, publishLoopbackPort, readiness, resources, runtimeCacheSeed, schemaVersion |
deploy/work-controller/model-backend-vllm.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | $schema, accelerator, backendNetwork, boundary, containerUser, environmentPath, modelSource, providerOptions, publishLoopbackPort, readiness, resources, runtimeCacheSeed, schemaVersion |
deploy/work-controller/model-campaign-maintenance.example.json |
qualification or evaluation input template | disposable/private evaluation state | starts a new exact evaluation only; grants no runtime or promotion authority | JSON | $schema, boundary, campaign, candidateSourceArchiveSha256, custody, dockerPath, materializationRoot, outputRoot, pairConfigurationPath, production, pythonPath, schemaVersion, sourceCommit, sourceRoot |
deploy/work-controller/model-qualification-docker.example.json |
qualification or evaluation input template | disposable/private evaluation state | starts a new exact evaluation only; grants no runtime or promotion authority | JSON | $schema, backendConfigPath, boundary, evidenceRoot, qualificationConfigPath, runnerImageDigest, schemaVersion |
deploy/work-controller/model-qualification-maintenance.example.json |
qualification or evaluation input template | disposable/private evaluation state | starts a new exact evaluation only; grants no runtime or promotion authority | JSON | $schema, boundary, custody, production, qualificationDockerConfigPath, schemaVersion |
deploy/work-provider-router/router-policy.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | $schema, allowedModes, authority, boundary, createdAt, enabledRemoteProviders, mode, preference, qualification, routerPolicyId, schemaVersion |
deploy/work-provider/private-policy.example.json |
private component-policy input template | broker/operator-private state outside Git after customization | validate and use the owning installer/reconfigure path; file presence grants no authority | JSON | $schema, authority, boundary, budgets, createdAt, credentialCustody, dataPolicy, enabled, fallback, policyId, providerId, schemaVersion, transport, verification |
onboarding.example.json |
owner-authored input template | copy to an owner-private path before adding real values | validate and regenerate; review the resulting plan before apply | JSON | agentId, agentName, agentSkills, calendarDirectEnabled, calendarId, calendarLimbEnabled, capabilityProfile, deploymentName, deploymentProfile, emailLimbEnabled, embeddingCache, embeddingModel, frontierAuthMode, frontierBudgetProfile, frontierCredentialFile, frontierLimbEnabled, frontierPolicyFile, frontierTaskPacks, gatewayExtensions, gatewayPort, googleAccount, installDir, localCapabilityPacks, modelApiKey, modelBaseUrl, modelContextWindow, modelId, modelMaxTokens, modelName, modelPrivateHosts, modelProvider, modelReasoning, openclawBin, openclawHome, operationsActionPacks, operationsLimbEnabled, operationsPolicyFile, organization, ownerName, releaseOperator, searxngBaseUrl, socialLimbEnabled, timeZone, webLimbEnabled, workspace |
OPENCLAW-UPSTREAM-REVIEW.example.json |
repository review-contract template | candidate branch after exact source binding | upstream review workflow only; not runtime configuration | JSON | candidateManifestSha256, decisions, generalReview, intakeSourceCommit, schemaVersion |
Additional templates outside the 42-file denominator
Custody rule
Examples belong in the repository. Generated .env files, private policies, OAuth tokens, model keys, operator state, and evidence do not. Use the configuration workflow to create private state; never copy live credentials into examples or documentation. Defaults and constraints remain authoritative in the linked schemas and generator source; an example value is not a universal default.