Skip to content

armgit / ODS

Public Imported from GitHub
0

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.

24.2 KB
Raw Blame

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.