惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

人人都是产品经理
人人都是产品经理
MongoDB | Blog
MongoDB | Blog
Google DeepMind News
Google DeepMind News
L
LangChain Blog
J
Java Code Geeks
MyScale Blog
MyScale Blog
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
WordPress大学
WordPress大学
小众软件
小众软件
Microsoft Security Blog
Microsoft Security Blog
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
月光博客
月光博客
aimingoo的专栏
aimingoo的专栏
F
Fortinet All Blogs
I
InfoQ
博客园 - 聂微东
量子位
A
About on SuperTechFans
S
SegmentFault 最新的问题
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
Apple Machine Learning Research
Apple Machine Learning Research
Hugging Face - Blog
Hugging Face - Blog
云风的 BLOG
云风的 BLOG
H
Help Net Security

Recent Commits to openclaw:main

test: merge chat side-result checks · openclaw/openclaw@ddd2c2a test: merge cron history checks · openclaw/openclaw@f7eb746 test: merge responsive navigation shell checks · openclaw/openclaw@c2e4b47 docs(changelog): add codex oauth fixes · openclaw/openclaw@628e6cd test: merge navigation routing cases · openclaw/openclaw@5d8cecb Tests: mock channel registry bundled fallback · openclaw/openclaw@2b08233 Secrets: avoid broad web search discovery for single plugin config · openclaw/openclaw@a464f59 test: merge config view browser checks · openclaw/openclaw@20cf511 fix(status): align oauth health with runtime · openclaw/openclaw@eed7116 feat: add macOS screen snapshots for monitor preview (#67954) thanks … · openclaw/openclaw@f377db1 fix: report shared auth scopes in hello-ok (#67810) thanks @BunsDev · openclaw/openclaw@0b6c39b Auto-reply: avoid eager bundled route fallback · openclaw/openclaw@3ea1bf4 Tests: narrow session binding contract setup · openclaw/openclaw@54e4e16 fix(macOS): enable undo/redo in webchat composer text input (#34962) · openclaw/openclaw@00951dc Tests: speed up channel setup promotion · openclaw/openclaw@82b529a Docs: refresh agent instructions · openclaw/openclaw@5775fe2 fix(auth): serialize OAuth refresh across agents to fix #26322 (#67876) · openclaw/openclaw@8e79080 test: allow ollama public surface boundary test · openclaw/openclaw@7d4f1a6 Docs: add test performance guardrails · openclaw/openclaw@89706d3 Tests: restore context-engine usage proof · openclaw/openclaw@e4c4f95 Tests: slim context engine runtime coverage · openclaw/openclaw@74c198f ci: retry failed custom checkouts · openclaw/openclaw@0ee5baf test: trim duplicate provider auth onboarding cases · openclaw/openclaw@1ffc02e matrix: fix sessions_spawn --thread subagent session spawning (#67643) · openclaw/openclaw@1ce2596 test: reduce auth choice fixture churn · openclaw/openclaw@857b9cd test: mock health status config boundaries · openclaw/openclaw@9d5ab4a test: mock onboard config io boundary · openclaw/openclaw@299694d test: mock legacy state plugin boundaries · openclaw/openclaw@2713089 test: mock channel install boundaries · openclaw/openclaw@b945248 test: mock doctor preview channel boundaries · openclaw/openclaw@b1a3ad4
fix: make plugin install config migration atomic · opencl...
shakkernerd · 2026-04-26 · via Recent Commits to openclaw:main

@@ -20,6 +20,7 @@ import {

2020

} from "../plugins/doctor-contract-registry.js";

2121

import {

2222

loadInstalledPluginIndexInstallRecordsSync,

23+

resolveInstalledPluginIndexRecordsStorePath,

2324

writePersistedInstalledPluginIndexInstallRecordsSync,

2425

} from "../plugins/installed-plugin-index-records.js";

2526

import { sanitizeTerminalText } from "../terminal/safe-text.js";

@@ -118,6 +119,23 @@ export { CircularIncludeError, ConfigIncludeError } from "./includes.js";

118119

export { MissingEnvVarError } from "./env-substitution.js";

119120

export { resolveShellEnvExpectedKeys } from "./shell-env-expected-keys.js";

120121122+

type ShippedPluginInstallConfigWriteMigration =

123+

| {

124+

migrated: false;

125+

}

126+

| {

127+

migrated: true;

128+

filePath: string;

129+

previousFile:

130+

| {

131+

existed: false;

132+

}

133+

| {

134+

existed: true;

135+

raw: string;

136+

};

137+

};

138+121139

const CONFIG_HEALTH_STATE_FILENAME = "config-health.json";

122140

const loggedInvalidConfigs = new Set<string>();

123141

@@ -1210,12 +1228,18 @@ export function createConfigIO(

12101228

return applyConfigOverrides(cfgWithOwnerDisplaySecret);

12111229

}

121212301213-

function migrateAndStripShippedPluginInstallConfigRecords(configRaw: unknown): unknown {

1231+

function migrateAndStripShippedPluginInstallConfigRecords(

1232+

configRaw: unknown,

1233+

options: { persist?: boolean } = {},

1234+

): unknown {

12141235

const installRecords = extractShippedPluginInstallConfigRecords(configRaw);

12151236

const stripped = stripShippedPluginInstallConfigRecords(configRaw);

12161237

if (Object.keys(installRecords).length === 0) {

12171238

return stripped;

12181239

}

1240+

if (options.persist === false) {

1241+

return stripped;

1242+

}

1219124312201244

try {

12211245

const stateDir = resolveStateDir(deps.env, deps.homedir);

@@ -1248,24 +1272,34 @@ export function createConfigIO(

1248127212491273

function ensureShippedPluginInstallConfigRecordsMigratedForWrite(

12501274

snapshot: ConfigFileSnapshot,

1251-

): void {

1275+

): ShippedPluginInstallConfigWriteMigration {

12521276

const installRecords = {

12531277

...extractShippedPluginInstallConfigRecords(snapshot.sourceConfig),

12541278

...extractShippedPluginInstallConfigRecords(snapshot.parsed),

12551279

};

12561280

if (Object.keys(installRecords).length === 0) {

1257-

return;

1281+

return { migrated: false };

12581282

}

1259128312601284

const stateDir = resolveStateDir(deps.env, deps.homedir);

1285+

const filePath = resolveInstalledPluginIndexRecordsStorePath({

1286+

env: deps.env,

1287+

stateDir,

1288+

});

12611289

const existingRecords = loadInstalledPluginIndexInstallRecordsSync({

12621290

env: deps.env,

12631291

stateDir,

12641292

});

12651293

if (Object.keys(installRecords).every((pluginId) => pluginId in existingRecords)) {

1266-

return;

1294+

return { migrated: false };

12671295

}

126812961297+

const previousFile = deps.fs.existsSync(filePath)

1298+

? ({

1299+

existed: true,

1300+

raw: deps.fs.readFileSync(filePath, "utf-8"),

1301+

} as const)

1302+

: ({ existed: false } as const);

12691303

try {

12701304

writePersistedInstalledPluginIndexInstallRecordsSync(

12711305

{

@@ -1278,6 +1312,11 @@ export function createConfigIO(

12781312

stateDir,

12791313

},

12801314

);

1315+

return {

1316+

migrated: true,

1317+

filePath,

1318+

previousFile,

1319+

};

12811320

} catch (err) {

12821321

throw new Error(

12831322

`Config write blocked: shipped plugins.installs records in ${configPath} could not be migrated into the plugin index. Fix state directory permissions or run openclaw plugins registry --refresh, then retry. ${formatErrorMessage(

@@ -1288,6 +1327,28 @@ export function createConfigIO(

12881327

}

12891328

}

129013291330+

function rollbackShippedPluginInstallConfigWriteMigration(

1331+

migration: ShippedPluginInstallConfigWriteMigration,

1332+

): void {

1333+

if (!migration.migrated) {

1334+

return;

1335+

}

1336+

if (migration.previousFile.existed) {

1337+

deps.fs.writeFileSync(migration.filePath, migration.previousFile.raw, {

1338+

encoding: "utf-8",

1339+

mode: 0o600,

1340+

});

1341+

return;

1342+

}

1343+

try {

1344+

deps.fs.unlinkSync(migration.filePath);

1345+

} catch (err) {

1346+

if ((err as NodeJS.ErrnoException)?.code !== "ENOENT") {

1347+

throw err;

1348+

}

1349+

}

1350+

}

1351+12911352

function loadConfig(): OpenClawConfig {

12921353

try {

12931354

maybeLoadDotEnvForConfig(deps.env);

@@ -1423,7 +1484,9 @@ export function createConfigIO(

14231484

}

14241485

}

142514861426-

async function readConfigFileSnapshotInternal(): Promise<ReadConfigFileSnapshotInternalResult> {

1487+

async function readConfigFileSnapshotInternal(

1488+

options: { persistShippedPluginInstallMigration?: boolean } = {},

1489+

): Promise<ReadConfigFileSnapshotInternalResult> {

14271490

maybeLoadDotEnvForConfig(deps.env);

14281491

const exists = deps.fs.existsSync(configPath);

14291492

if (!exists) {

@@ -1533,6 +1596,7 @@ export function createConfigIO(

15331596

const legacyResolution = resolveLegacyConfigForRead(resolvedConfigRaw, effectiveParsed);

15341597

const effectiveConfigRaw = migrateAndStripShippedPluginInstallConfigRecords(

15351598

legacyResolution.effectiveConfigRaw,

1599+

{ persist: options.persistShippedPluginInstallMigration !== false },

15361600

);

15371601

fallbackSourceConfig = coerceConfig(effectiveConfigRaw);

15381602

const validated = validateConfigObjectWithPlugins(effectiveConfigRaw, {

@@ -1650,7 +1714,9 @@ export function createConfigIO(

16501714

}

1651171516521716

async function readConfigFileSnapshotForWrite(): Promise<ReadConfigFileSnapshotForWriteResult> {

1653-

const result = await readConfigFileSnapshotInternal();

1717+

const result = await readConfigFileSnapshotInternal({

1718+

persistShippedPluginInstallMigration: false,

1719+

});

16541720

return {

16551721

snapshot: result.snapshot,

16561722

writeOptions: {

@@ -1719,8 +1785,13 @@ export function createConfigIO(

17191785

clearConfigCache();

17201786

const unsetPaths = resolveManagedUnsetPathsForWrite(options.unsetPaths);

17211787

let persistCandidate: unknown = cfg;

1722-

const snapshot = options.baseSnapshot ?? (await readConfigFileSnapshotInternal()).snapshot;

1723-

ensureShippedPluginInstallConfigRecordsMigratedForWrite(snapshot);

1788+

const snapshot =

1789+

options.baseSnapshot ??

1790+

(

1791+

await readConfigFileSnapshotInternal({

1792+

persistShippedPluginInstallMigration: false,

1793+

})

1794+

).snapshot;

17241795

let envRefMap: Map<string, string> | null = null;

17251796

let changedPaths: Set<string> | null = null;

17261797

if (snapshot.valid && snapshot.exists) {

@@ -1938,6 +2009,9 @@ export function createConfigIO(

19382009

`${path.basename(configPath)}.${process.pid}.${crypto.randomUUID()}.tmp`,

19392010

);

194020112012+

const pluginInstallConfigMigration =

2013+

ensureShippedPluginInstallConfigRecordsMigratedForWrite(snapshot);

2014+

let configCommitted = false;

19412015

try {

19422016

await deps.fs.promises.writeFile(tmp, json, {

19432017

encoding: "utf-8",

@@ -1961,6 +2035,7 @@ export function createConfigIO(

19612035

await deps.fs.promises.unlink(tmp).catch(() => {

19622036

// best-effort

19632037

});

2038+

configCommitted = true;

19642039

logConfigOverwrite();

19652040

logConfigWriteAnomalies();

19662041

await appendWriteAudit(

@@ -1975,6 +2050,7 @@ export function createConfigIO(

19752050

});

19762051

throw err;

19772052

}

2053+

configCommitted = true;

19782054

logConfigOverwrite();

19792055

logConfigWriteAnomalies();

19802056

await appendWriteAudit(

@@ -1984,6 +2060,9 @@ export function createConfigIO(

19842060

);

19852061

return { persistedHash: nextHash, persistedConfig: stampedOutputConfig };

19862062

} catch (err) {

2063+

if (!configCommitted) {

2064+

rollbackShippedPluginInstallConfigWriteMigration(pluginInstallConfigMigration);

2065+

}

19872066

await appendWriteAudit("failed", err);

19882067

throw err;

19892068

}