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

推荐订阅源

酷 壳 – CoolShell
酷 壳 – CoolShell
D
DataBreaches.Net
C
Check Point Blog
雷峰网
雷峰网
小众软件
小众软件
GbyAI
GbyAI
美团技术团队
P
Proofpoint News Feed
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
罗磊的独立博客
大猫的无限游戏
大猫的无限游戏
WordPress大学
WordPress大学
MyScale Blog
MyScale Blog
The Cloudflare Blog
阮一峰的网络日志
阮一峰的网络日志
Apple Machine Learning Research
Apple Machine Learning Research
Y
Y Combinator Blog
Jina AI
Jina AI
爱范儿
爱范儿
Last Week in AI
Last Week in AI
MongoDB | Blog
MongoDB | Blog
I
InfoQ
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
博客园 - 司徒正美

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(cli): clarify remaining required options · openclaw/o...
vincentkoc · 2026-05-09 · via Recent Commits to openclaw:main
Original file line numberDiff line numberDiff line change

@@ -2,6 +2,7 @@ import type { Command } from "commander";

22

import { runAcpClientInteractive } from "../acp/client.js";

33

import { serveAcpGateway } from "../acp/server.js";

44

import { normalizeAcpProvenanceMode } from "../acp/types.js";

5+

import { formatErrorMessage } from "../infra/errors.js";

56

import { defaultRuntime } from "../runtime.js";

67

import { formatDocsLink } from "../terminal/links.js";

78

import { theme } from "../terminal/theme.js";

@@ -33,7 +34,7 @@ export function registerAcpCli(program: Command) {

3334

const { gatewayToken, gatewayPassword } = resolveGatewayAuthOptions(opts);

3435

const provenanceMode = normalizeAcpProvenanceMode(opts.provenance as string | undefined);

3536

if (opts.provenance && !provenanceMode) {

36-

throw new Error("Invalid --provenance value. Use off, meta, or meta+receipt.");

37+

throw new Error('Invalid --provenance. Use "off", "meta", or "meta+receipt".');

3738

}

3839

await serveAcpGateway({

3940

gatewayUrl: opts.url as string | undefined,

@@ -48,7 +49,7 @@ export function registerAcpCli(program: Command) {

4849

verbose: Boolean(opts.verbose),

4950

});

5051

} catch (err) {

51-

defaultRuntime.error(String(err));

52+

defaultRuntime.error(`ACP bridge failed: ${formatErrorMessage(err)}`);

5253

defaultRuntime.exit(1);

5354

}

5455

});

Original file line numberDiff line numberDiff line change

@@ -232,7 +232,7 @@ export function registerCronAddCommand(cron: Command) {

232232
233233

const name = normalizeOptionalString(opts.name) ?? "";

234234

if (!name) {

235-

throw new Error("--name is required");

235+

throw new Error("Cron job name is required. Pass --name <name>.");

236236

}

237237
238238

const description = normalizeOptionalString(opts.description);

Original file line numberDiff line numberDiff line change

@@ -104,14 +104,14 @@ function resolveDirectSchedule(options: NormalizedScheduleOptions): CronSchedule

104104

if (options.at) {

105105

const atIso = parseAt(options.at, options.tz);

106106

if (!atIso) {

107-

throw new Error("Invalid --at; use ISO time or duration like 20m");

107+

throw new Error("Invalid --at. Use an ISO timestamp or a duration like 20m.");

108108

}

109109

return { kind: "at", at: atIso };

110110

}

111111

if (options.every) {

112112

const everyMs = parseDurationMs(options.every);

113113

if (!everyMs) {

114-

throw new Error("Invalid --every; use e.g. 10m, 1h, 1d");

114+

throw new Error("Invalid --every. Use a duration like 10m, 1h, or 1d.");

115115

}

116116

return { kind: "every", everyMs };

117117

}

Original file line numberDiff line numberDiff line change

@@ -7,7 +7,9 @@ import type { DaemonStatusOptions } from "./types.js";

77

export async function runDaemonStatus(opts: DaemonStatusOptions) {

88

try {

99

if (opts.requireRpc && !opts.probe) {

10-

defaultRuntime.error("Gateway status failed: --require-rpc cannot be used with --no-probe.");

10+

defaultRuntime.error(

11+

"Gateway status failed: --require-rpc needs probing enabled. Remove --no-probe or drop --require-rpc.",

12+

);

1113

defaultRuntime.exit(1);

1214

return;

1315

}

Original file line numberDiff line numberDiff line change

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

3030

import { sanitizeForLog } from "../terminal/ansi.js";

3131

import { getTerminalTableWidth, renderTable } from "../terminal/table.js";

3232

import { theme } from "../terminal/theme.js";

33+

import { formatCliCommand } from "./command-format.js";

3334

import { applyParentDefaultHelpAction } from "./program/parent-default-help.js";

3435

import { withProgress } from "./progress.js";

3536

@@ -509,7 +510,9 @@ function resolveRequiredDeviceRole(

509510

if (deviceId && role) {

510511

return { deviceId, role };

511512

}

512-

defaultRuntime.error("--device and --role required");

513+

defaultRuntime.error(

514+

`--device and --role are required. Run ${formatCliCommand("openclaw devices list")} to choose a paired device.`,

515+

);

513516

defaultRuntime.exit(1);

514517

return null;

515518

}

@@ -608,7 +611,9 @@ export function registerDevicesCli(program: Command) {

608611

.action(async (deviceId: string, opts: DevicesRpcOpts) => {

609612

const trimmed = deviceId.trim();

610613

if (!trimmed) {

611-

defaultRuntime.error("deviceId is required");

614+

defaultRuntime.error(

615+

`deviceId is required. Run ${formatCliCommand("openclaw devices list")} to choose a paired device.`,

616+

);

612617

defaultRuntime.exit(1);

613618

return;

614619

}

Original file line numberDiff line numberDiff line change

@@ -2,6 +2,7 @@ import type { Command } from "commander";

22

import { defaultRuntime } from "../../runtime.js";

33

import { normalizeOptionalString } from "../../shared/string-coerce.js";

44

import { getTerminalTableWidth } from "../../terminal/table.js";

5+

import { formatCliCommand } from "../command-format.js";

56

import { getNodesTheme, runNodesCommand } from "./cli-utils.js";

67

import { parsePairingList } from "./format.js";

78

import { renderPendingPairingRequestsTable } from "./pairing-render.js";

@@ -80,7 +81,9 @@ export function registerNodesPairingCommands(nodes: Command) {

8081

await runNodesCommand("remove", async () => {

8182

const nodeId = await resolveNodeId(opts, normalizeOptionalString(opts.node) ?? "");

8283

if (!nodeId) {

83-

defaultRuntime.error("--node required");

84+

defaultRuntime.error(

85+

`--node is required. Run ${formatCliCommand("openclaw nodes pairing pending")} to choose a node request.`,

86+

);

8487

defaultRuntime.exit(1);

8588

return;

8689

}

@@ -106,7 +109,9 @@ export function registerNodesPairingCommands(nodes: Command) {

106109

const nodeId = await resolveNodeId(opts, normalizeOptionalString(opts.node) ?? "");

107110

const name = normalizeOptionalString(opts.name) ?? "";

108111

if (!nodeId || !name) {

109-

defaultRuntime.error("--node and --name required");

112+

defaultRuntime.error(

113+

`--node and --name are required. Run ${formatCliCommand("openclaw nodes pairing pending")} to choose a node, then rerun with --name <displayName>.`,

114+

);

110115

defaultRuntime.exit(1);

111116

return;

112117

}

Original file line numberDiff line numberDiff line change

@@ -4,6 +4,7 @@ import { defaultRuntime } from "../runtime.js";

44

import { normalizeOptionalString } from "../shared/string-coerce.js";

55

import { formatDocsLink } from "../terminal/links.js";

66

import { theme } from "../terminal/theme.js";

7+

import { formatCliCommand } from "./command-format.js";

78

import type { GatewayRpcOpts } from "./gateway-rpc.js";

89

import { addGatewayClientOptions, callGatewayFromCli } from "./gateway-rpc.js";

910

@@ -62,7 +63,9 @@ export function registerSystemCli(program: Command) {

6263

async () => {

6364

const text = normalizeOptionalString(opts.text) ?? "";

6465

if (!text) {

65-

throw new Error("--text is required");

66+

throw new Error(

67+

`--text is required. Example: ${formatCliCommand('openclaw system event --text "deploy finished"')}.`,

68+

);

6669

}

6770

const mode = normalizeWakeMode(opts.mode);

6871

return await callGatewayFromCli("wake", opts, { mode, text }, { expectFinal: false });

Original file line numberDiff line numberDiff line change

@@ -20,6 +20,7 @@ import { defaultRuntime } from "../runtime.js";

2020

import { normalizeOptionalString } from "../shared/string-coerce.js";

2121

import { formatDocsLink } from "../terminal/links.js";

2222

import { theme } from "../terminal/theme.js";

23+

import { formatCliCommand } from "./command-format.js";

2324
2425

export function registerWebhooksCli(program: Command) {

2526

const webhooks = program

@@ -109,7 +110,9 @@ function parseGmailSetupOptions(raw: Record<string, unknown>): GmailSetupOptions

109110

const accountRaw = raw.account;

110111

const account = normalizeOptionalString(accountRaw) ?? "";

111112

if (!account) {

112-

throw new Error("--account is required");

113+

throw new Error(

114+

`--account is required. Example: ${formatCliCommand("openclaw webhooks gmail setup --account default")}.`,

115+

);

113116

}

114117

const common = parseGmailCommonOptions(raw);

115118

return {

Original file line numberDiff line numberDiff line change

@@ -413,7 +413,9 @@ export async function modelsAuthPasteTokenCommand(

413413

const agentDir = await resolveModelsAuthAgentDir(opts.agent);

414414

const rawProvider = normalizeOptionalString(opts.provider);

415415

if (!rawProvider) {

416-

throw new Error("Missing --provider.");

416+

throw new Error(

417+

`Missing --provider. Run ${formatCliCommand("openclaw models status")} or ${formatCliCommand("openclaw plugins list")} to choose a provider.`,

418+

);

417419

}

418420

const provider = normalizeProviderId(rawProvider);

419421

const profileId =

Original file line numberDiff line numberDiff line change

@@ -146,7 +146,9 @@ export function applyNonInteractiveGatewayConfig(params: {

146146

if (authMode === "password") {

147147

const password = opts.gatewayPassword?.trim();

148148

if (!password) {

149-

runtime.error("Missing --gateway-password for password auth.");

149+

runtime.error(

150+

"Missing --gateway-password for password auth. Pass --gateway-password or use --gateway-auth token.",

151+

);

150152

runtime.exit(1);

151153

return null;

152154

}