fix(commands): preserve multiline args after slash command head (#79155)

HCL · HCL · commit c9e1187aafeb · 2026-05-08T11:04:32.000+08:00
normalizeCommandBody() discarded everything after the first newline when normalizing a command like: /some-command line 1 line 2 Root cause: singleLine = trimmed.slice(0, newline) dropped the tail before alias expansion and token dispatch. Fix: capture multilineTail = trimmed.slice(newline) before normalization, then re-attach it to the final resolved head at all return paths: - exact alias match - unregistered token fallback - no-args token (acceptsArgs=false) fallback - resolved canonical + args return The command head (first line) is still normalized for alias expansion and bot-mention stripping. The tail passes through verbatim so callers receive the full multiline payload. 27/27 commands-registry tests pass, including new regression test. Fixes #79155
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -8,6 +8,7 @@ Docs: https://docs.openclaw.ai
 
 - Agents/failover: harden state-aware lane suspension by persisting quota resume transitions, restoring configured lane concurrency, preserving non-quota failure reasons, and exporting model failover events through diagnostics OTLP. Thanks @BunsDev.
 - Channels/streaming: make progress draft labels scroll away with other progress lines, render structured tool rows as compact emoji/title/details, show web-search queries from provider-native argument shapes, and skip empty Discord apply-patch starts until a patch summary exists. (#79146)
+- Commands/skills: preserve multiline arguments after a slash command head so payloads like `/some-command\nline 1\nline 2` deliver all lines to the handler instead of only the first. (#79155)
 - Telegram: preserve the channel-specific 10-option poll cap in the unified outbound adapter so over-limit polls are rejected before send. (#78762) Thanks @obviyus.
 - Runtime/install: raise the supported Node 22 floor to `22.16+` so native SQLite query handling can rely on the `node:sqlite` statement metadata API while continuing to recommend Node 24. (#78921)
 - Discord/voice: include a bounded one-line STT transcript preview in verbose voice logs so live voice debugging shows what speakers said before the agent reply.
diff --git a/src/auto-reply/commands-registry-normalize.ts b/src/auto-reply/commands-registry-normalize.ts
@@ -57,6 +57,7 @@ export function normalizeCommandBody(raw: string, options?: CommandNormalizeOpti
 
   const newline = trimmed.indexOf("\n");
   const singleLine = newline === -1 ? trimmed : trimmed.slice(0, newline).trim();
+  const multilineTail = newline === -1 ? "" : trimmed.slice(newline);
 
   const colonMatch = singleLine.match(/^\/([^\s:]+)\s*:(.*)$/);
   const normalized = colonMatch
@@ -80,24 +81,27 @@ export function normalizeCommandBody(raw: string, options?: CommandNormalizeOpti
   const textAliasMap = getTextAliasMap();
   const exact = textAliasMap.get(lowered);
   if (exact) {
-    return exact.canonical;
+    return exact.canonical + multilineTail;
   }
 
   const tokenMatch = commandBody.match(/^\/([^\s]+)(?:\s+([\s\S]+))?$/);
   if (!tokenMatch) {
-    return commandBody;
+    return commandBody + multilineTail;
   }
   const [, token, rest] = tokenMatch;
   const tokenKey = `/${normalizeLowercaseStringOrEmpty(token)}`;
   const tokenSpec = textAliasMap.get(tokenKey);
   if (!tokenSpec) {
-    return commandBody;
+    return commandBody + multilineTail;
   }
   if (rest && !tokenSpec.acceptsArgs) {
-    return commandBody;
+    return commandBody + multilineTail;
   }
   const normalizedRest = rest?.trimStart();
-  return normalizedRest ? `${tokenSpec.canonical} ${normalizedRest}` : tokenSpec.canonical;
+  const resolvedHead = normalizedRest
+    ? `${tokenSpec.canonical} ${normalizedRest}`
+    : tokenSpec.canonical;
+  return resolvedHead + multilineTail;
 }
 
 export function getCommandDetection(_cfg?: OpenClawConfig): CommandDetection {
diff --git a/src/auto-reply/commands-registry.test.ts b/src/auto-reply/commands-registry.test.ts
@@ -405,6 +405,18 @@ describe("commands registry", () => {
   it("keeps unregistered dock underscore aliases unchanged", () => {
     expect(normalizeCommandBody("/dock_telegram")).toBe("/dock_telegram");
   });
+
+  it("preserves multiline args after command head — regression for #79155", () => {
+    expect(normalizeCommandBody("/btw\nfirst line\nsecond line")).toBe(
+      "/btw\nfirst line\nsecond line",
+    );
+    expect(normalizeCommandBody("/help\nline 1\nline 2\nline 3")).toBe(
+      "/help\nline 1\nline 2\nline 3",
+    );
+    expect(
+      normalizeCommandBody("/help@openclaw\nmultiline args", { botUsername: "openclaw" }),
+    ).toBe("/help\nmultiline args");
+  });
 });
 
 describe("commands registry args", () => {
