From 78d4fc8c7ab0b45524337e189c5b892797f1afb4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Igor=20=C5=A0=C4=87eki=C4=87?= <iscekic@protonmail.com>
Date: Fri, 3 Jul 2026 13:28:26 +0200
Subject: [PATCH 1/4] fix(mobile): make agent approval cards scroll instead of
 overflowing the screen
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

PermissionCard rendered patterns/metadata (often a full command) in plain
Views with no height limit. As a pinned footer below the message list it
could grow past the screen, pushing the Deny/Allow buttons off-screen with
no way to scroll — approvals became impossible to act on.

Wrap the card body in a ScrollView capped at max-h-96 (same pattern as
QuestionCard) and let both cards shrink when the available height is
smaller (e.g. keyboard open on small screens), keeping the action buttons
pinned and reachable while the content scrolls.
---
 .../src/components/agents/permission-card.tsx | 54 ++++++++++---------
 .../src/components/agents/question-card.tsx   |  4 +-
 2 files changed, 30 insertions(+), 28 deletions(-)

diff --git a/apps/mobile/src/components/agents/permission-card.tsx b/apps/mobile/src/components/agents/permission-card.tsx
index dab191c136..74e43d83d2 100644
--- a/apps/mobile/src/components/agents/permission-card.tsx
+++ b/apps/mobile/src/components/agents/permission-card.tsx
@@ -1,5 +1,5 @@
 import { useState } from 'react';
-import { ActivityIndicator, View } from 'react-native';
+import { ActivityIndicator, ScrollView, View } from 'react-native';
 import * as Haptics from 'expo-haptics';
 
 import { Button } from '@/components/ui/button';
@@ -38,37 +38,39 @@ export function PermissionCard({
     .join(' ');
 
   return (
-    <View className="mx-4 my-2 overflow-hidden rounded-xl border border-border bg-card">
+    <View className="mx-4 my-2 shrink overflow-hidden rounded-xl border border-border bg-card">
       <View className="border-b border-border bg-secondary px-4 py-3">
         <Text className="text-sm font-medium">Permission Required</Text>
       </View>
 
-      <View className="gap-3 p-4">
-        <Text className="text-sm text-foreground">
-          Allow <Text className="font-medium">{permissionDisplay}</Text>?
-        </Text>
+      <ScrollView className="max-h-96 shrink">
+        <View className="gap-3 p-4">
+          <Text className="text-sm text-foreground">
+            Allow <Text className="font-medium">{permissionDisplay}</Text>?
+          </Text>
 
-        {patterns.length > 0 && (
-          <View className="gap-1 rounded-lg bg-muted p-2">
-            <Text className="text-xs font-medium text-muted-foreground">Applies to:</Text>
-            {patterns.map((pattern, index) => (
-              <Text key={index} className="text-xs text-muted-foreground">
-                • {pattern}
-              </Text>
-            ))}
-          </View>
-        )}
+          {patterns.length > 0 && (
+            <View className="gap-1 rounded-lg bg-muted p-2">
+              <Text className="text-xs font-medium text-muted-foreground">Applies to:</Text>
+              {patterns.map((pattern, index) => (
+                <Text key={index} className="text-xs text-muted-foreground">
+                  • {pattern}
+                </Text>
+              ))}
+            </View>
+          )}
 
-        {metadata && Object.keys(metadata).length > 0 && (
-          <View className="gap-1">
-            {Object.entries(metadata).map(([key, value]) => (
-              <Text key={key} className="text-xs text-muted-foreground">
-                {key}: {String(value)}
-              </Text>
-            ))}
-          </View>
-        )}
-      </View>
+          {metadata && Object.keys(metadata).length > 0 && (
+            <View className="gap-1">
+              {Object.entries(metadata).map(([key, value]) => (
+                <Text key={key} className="text-xs text-muted-foreground">
+                  {key}: {String(value)}
+                </Text>
+              ))}
+            </View>
+          )}
+        </View>
+      </ScrollView>
 
       <View className="flex-row gap-2 border-t border-border p-3">
         <Button
diff --git a/apps/mobile/src/components/agents/question-card.tsx b/apps/mobile/src/components/agents/question-card.tsx
index 1a54f881a7..7a49c85181 100644
--- a/apps/mobile/src/components/agents/question-card.tsx
+++ b/apps/mobile/src/components/agents/question-card.tsx
@@ -135,12 +135,12 @@ export function QuestionCard({
   const hasAnyAnswer = hasOptionSelected || hasCustomAnswer;
 
   return (
-    <View className="mx-4 my-2 overflow-hidden rounded-xl border border-border bg-card">
+    <View className="mx-4 my-2 shrink overflow-hidden rounded-xl border border-border bg-card">
       <View className="border-b border-border bg-secondary px-4 py-3">
         <Text className="text-sm font-medium">Agent Needs Input</Text>
       </View>
 
-      <ScrollView className="max-h-96" keyboardShouldPersistTaps="handled">
+      <ScrollView className="max-h-96 shrink" keyboardShouldPersistTaps="handled">
         <View className="gap-4 p-4">
           {questions.map((question, qIndex) => {
             const allowCustom = question.custom !== false;

From f763bddcf593a786afc109fb94d602afc0fcc57d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Igor=20=C5=A0=C4=87eki=C4=87?= <iscekic@protonmail.com>
Date: Fri, 3 Jul 2026 13:34:24 +0200
Subject: [PATCH 2/4] fix(mobile): render markdown tables as a chip that opens
 a full-screen modal

Tables previously rendered inside a horizontal ScrollView within the
message bubble, which caused two Android-reported bugs:

- Scrolling the table leftward activated the bubble's swipe-to-reply pan
  gesture (12px activation offset), making tables with more than 2
  columns unusable.
- A horizontal ScrollView inside a width-constrained bubble mis-measures
  its height on RN Fabric (same bug already worked around for code
  blocks), producing overlapping messages in the FlashList.

Tables now render as a compact 'View table' chip inline; tapping it opens
a full-screen modal where the table scrolls both ways with roomier
columns. No horizontal ScrollView ever renders inside a bubble anymore.

Applies to both kiloclaw chat and cloud agents chat via the shared
MarkdownText renderer.
---
 .../src/components/agents/markdown-palette.ts |   6 +
 .../src/components/agents/markdown-table.tsx  | 200 ++++++++++++++++++
 .../src/components/agents/markdown-text.tsx   | 127 ++---------
 3 files changed, 220 insertions(+), 113 deletions(-)
 create mode 100644 apps/mobile/src/components/agents/markdown-table.tsx

diff --git a/apps/mobile/src/components/agents/markdown-palette.ts b/apps/mobile/src/components/agents/markdown-palette.ts
index c5efd6a91e..7653250ca3 100644
--- a/apps/mobile/src/components/agents/markdown-palette.ts
+++ b/apps/mobile/src/components/agents/markdown-palette.ts
@@ -9,6 +9,9 @@ export type MarkdownPalette = {
   mutedTextColor: string;
   codeBackground: string;
   borderColor: string;
+  // The bubble surface this palette's ink is designed to sit on. Needed when
+  // palette-colored content renders outside its bubble (e.g. the table modal).
+  surfaceColor: string;
 };
 
 // Derive a translucent variant of a theme token so we can tint dividers and
@@ -40,6 +43,7 @@ export function getPalette(variant: MarkdownVariant, colors: ThemeColors): Markd
       mutedTextColor: withAlpha(ink, 0.7),
       codeBackground: withAlpha(ink, 0.1),
       borderColor: withAlpha(ink, 0.2),
+      surfaceColor: colors.primary,
     };
   }
   if (variant === 'user') {
@@ -50,6 +54,7 @@ export function getPalette(variant: MarkdownVariant, colors: ThemeColors): Markd
       mutedTextColor: withAlpha(ink, 0.7),
       codeBackground: withAlpha(ink, 0.1),
       borderColor: withAlpha(ink, 0.2),
+      surfaceColor: colors.accentSoft,
     };
   }
   return {
@@ -57,6 +62,7 @@ export function getPalette(variant: MarkdownVariant, colors: ThemeColors): Markd
     mutedTextColor: colors.mutedForeground,
     codeBackground: colors.muted,
     borderColor: colors.border,
+    surfaceColor: colors.card,
   };
 }
 
diff --git a/apps/mobile/src/components/agents/markdown-table.tsx b/apps/mobile/src/components/agents/markdown-table.tsx
new file mode 100644
index 0000000000..f10af1325f
--- /dev/null
+++ b/apps/mobile/src/components/agents/markdown-table.tsx
@@ -0,0 +1,200 @@
+import { Table2, X } from 'lucide-react-native';
+import { type ReactNode, useState } from 'react';
+import { Modal, Pressable, ScrollView, Text, useWindowDimensions, View } from 'react-native';
+import { useSafeAreaInsets } from 'react-native-safe-area-context';
+
+import { useThemeColors } from '@/lib/hooks/use-theme-colors';
+
+import { type MarkdownPalette } from './markdown-palette';
+
+const MODAL_COLUMN_MIN_WIDTH = 148;
+const MODAL_HORIZONTAL_PADDING = 16;
+
+type MarkdownTableProps = {
+  palette: MarkdownPalette;
+  header: ReactNode[][];
+  rows: ReactNode[][][];
+};
+
+function getColumnCount(header: ReactNode[][], rows: ReactNode[][][]): number {
+  let columnCount = header.length;
+  for (const row of rows) {
+    if (row.length > columnCount) {
+      columnCount = row.length;
+    }
+  }
+  return columnCount;
+}
+
+function formatTableSummary(columnCount: number, rowCount: number): string {
+  const columns = columnCount === 1 ? 'column' : 'columns';
+  const rows = rowCount === 1 ? 'row' : 'rows';
+  return `${columnCount} ${columns} · ${rowCount} ${rows}`;
+}
+
+// Markdown tables never fit inside a chat bubble: a horizontal ScrollView in a
+// width-constrained bubble both mis-measures its height on Fabric (overlapping
+// messages) and fights the swipe-to-reply pan gesture. Instead we render a
+// compact "View table" chip inline and show the full table in a modal, where
+// it can scroll both ways with the whole screen available.
+export function MarkdownTable({ palette, header, rows }: Readonly<MarkdownTableProps>) {
+  const [open, setOpen] = useState(false);
+  const colors = useThemeColors();
+  const insets = useSafeAreaInsets();
+  const { width: windowWidth } = useWindowDimensions();
+
+  const columnCount = getColumnCount(header, rows);
+  const columnWidth = Math.max(
+    MODAL_COLUMN_MIN_WIDTH,
+    Math.floor((windowWidth - MODAL_HORIZONTAL_PADDING * 2) / Math.max(columnCount, 1))
+  );
+
+  return (
+    <>
+      <Pressable
+        onPress={() => {
+          setOpen(true);
+        }}
+        accessibilityRole="button"
+        accessibilityLabel="View table"
+        className="my-1 flex-row items-center gap-2.5 self-start rounded-lg border px-3 py-2 active:opacity-70"
+        // eslint-disable-next-line react-native/no-inline-styles -- dynamic per-variant colors
+        style={{ backgroundColor: palette.codeBackground, borderColor: palette.borderColor }}
+      >
+        <Table2 size={18} color={palette.textColor} />
+        <View>
+          {/* eslint-disable-next-line react-native/no-inline-styles -- dynamic per-variant text color */}
+          <Text className="text-sm font-medium" style={{ color: palette.textColor }}>
+            View table
+          </Text>
+          {/* eslint-disable-next-line react-native/no-inline-styles -- dynamic per-variant text color */}
+          <Text className="text-xs" style={{ color: palette.mutedTextColor }}>
+            {formatTableSummary(columnCount, rows.length)}
+          </Text>
+        </View>
+      </Pressable>
+
+      <Modal
+        visible={open}
+        animationType="slide"
+        onRequestClose={() => {
+          setOpen(false);
+        }}
+      >
+        <View className="flex-1 bg-background">
+          <View
+            className="flex-row items-center justify-between border-b border-border bg-background px-4"
+            style={{ paddingTop: insets.top, height: insets.top + 56 }}
+          >
+            <Text className="text-lg font-semibold text-foreground">Table</Text>
+            <Pressable
+              onPress={() => {
+                setOpen(false);
+              }}
+              className="h-10 w-10 items-center justify-center rounded-md bg-secondary active:opacity-70"
+              accessibilityRole="button"
+              accessibilityLabel="Close table"
+            >
+              <X size={20} color={colors.foreground} />
+            </Pressable>
+          </View>
+          <ScrollView
+            className="flex-1"
+            contentContainerClassName="p-4"
+            contentContainerStyle={{ paddingBottom: insets.bottom + 16 }}
+          >
+            <ScrollView horizontal showsHorizontalScrollIndicator>
+              <View
+                className="self-start overflow-hidden rounded-md border"
+                // eslint-disable-next-line react-native/no-inline-styles -- dynamic per-variant colors
+                style={{ borderColor: palette.borderColor, backgroundColor: palette.surfaceColor }}
+              >
+                <TableRow
+                  palette={palette}
+                  cells={header}
+                  columnCount={columnCount}
+                  columnWidth={columnWidth}
+                  isHeader
+                  isLastRow={rows.length === 0}
+                />
+                {rows.map((row, rowIdx) => (
+                  <TableRow
+                    key={rowIdx}
+                    palette={palette}
+                    cells={row}
+                    columnCount={columnCount}
+                    columnWidth={columnWidth}
+                    isLastRow={rows.length - 1 === rowIdx}
+                  />
+                ))}
+              </View>
+            </ScrollView>
+          </ScrollView>
+        </View>
+      </Modal>
+    </>
+  );
+}
+
+type TableRowProps = {
+  palette: MarkdownPalette;
+  cells: ReactNode[][];
+  columnCount: number;
+  columnWidth: number;
+  isLastRow: boolean;
+  isHeader?: boolean;
+};
+
+function TableRow({
+  palette,
+  cells,
+  columnCount,
+  columnWidth,
+  isLastRow,
+  isHeader = false,
+}: TableRowProps) {
+  return (
+    <View
+      className="flex-row"
+      // eslint-disable-next-line react-native/no-inline-styles -- dynamic per-variant header background
+      style={isHeader ? { backgroundColor: palette.codeBackground } : undefined}
+    >
+      {Array.from({ length: columnCount }, (_, colIdx) => (
+        <TableCell
+          key={colIdx}
+          palette={palette}
+          width={columnWidth}
+          hasRightBorder={colIdx < columnCount - 1}
+          hasBottomBorder={isHeader || !isLastRow}
+        >
+          {cells[colIdx] ?? []}
+        </TableCell>
+      ))}
+    </View>
+  );
+}
+
+type TableCellProps = {
+  palette: MarkdownPalette;
+  width: number;
+  hasRightBorder: boolean;
+  hasBottomBorder: boolean;
+  children: ReactNode;
+};
+
+function TableCell({ palette, width, hasRightBorder, hasBottomBorder, children }: TableCellProps) {
+  return (
+    <View
+      className="p-2"
+      // eslint-disable-next-line react-native/no-inline-styles -- dynamic column width and per-variant border color
+      style={{
+        width,
+        borderColor: palette.borderColor,
+        borderRightWidth: hasRightBorder ? 1 : 0,
+        borderBottomWidth: hasBottomBorder ? 1 : 0,
+      }}
+    >
+      {children}
+    </View>
+  );
+}
diff --git a/apps/mobile/src/components/agents/markdown-text.tsx b/apps/mobile/src/components/agents/markdown-text.tsx
index 7381f866d4..2cde2cd9d5 100644
--- a/apps/mobile/src/components/agents/markdown-text.tsx
+++ b/apps/mobile/src/components/agents/markdown-text.tsx
@@ -1,13 +1,5 @@
 import { type ReactNode, useMemo } from 'react';
-import {
-  Linking,
-  ScrollView,
-  Text,
-  type TextStyle,
-  useColorScheme,
-  View,
-  type ViewStyle,
-} from 'react-native';
+import { Linking, Text, type TextStyle, useColorScheme, View, type ViewStyle } from 'react-native';
 import { Renderer, useMarkdown } from 'react-native-marked';
 
 import { useThemeColors } from '@/lib/hooks/use-theme-colors';
@@ -18,6 +10,7 @@ import {
   type MarkdownPalette,
   type MarkdownVariant,
 } from './markdown-palette';
+import { MarkdownTable } from './markdown-table';
 
 type MarkdownTextProps = {
   value: string;
@@ -28,15 +21,17 @@ type MarkdownTextProps = {
 // The library's default `Renderer` renders code blocks with the `em` text
 // style (italic) and renders tables with fixed column widths that frequently
 // overflow the screen with no way to scroll within a chat bubble. We subclass
-// it to render code blocks in a monospace font and to render tables with our
-// own layout that scales to the container.
+// it to render code blocks in a monospace font and to render tables as a
+// "View table" chip that opens a full-screen modal (see `MarkdownTable`).
 //
-// Notes on horizontal scrolling for code blocks: the default library renders
-// code inside a horizontal ScrollView, but on RN 0.83 Fabric a horizontal
-// ScrollView inside a width-constrained bubble produces spurious vertical
-// height (measured up to ~10x the actual content height, growing as sibling
-// messages re-rendered the list). We render code as a plain wrapping Text
-// instead — readable in chat, and it avoids the Fabric measurement bug.
+// Notes on horizontal scrolling: the default library renders code (and we
+// previously rendered tables) inside a horizontal ScrollView, but on RN 0.83
+// Fabric a horizontal ScrollView inside a width-constrained bubble produces
+// spurious vertical height (measured up to ~10x the actual content height,
+// growing as sibling messages re-rendered the list), and its scroll gesture
+// loses to the chat bubble's swipe-to-reply pan. We render code as a plain
+// wrapping Text and tables behind a chip instead — no horizontal ScrollView
+// ever renders inside a bubble.
 class MarkdownRenderer extends Renderer {
   private readonly palette: MarkdownPalette;
   private readonly selectable: boolean;
@@ -140,108 +135,14 @@ class MarkdownRenderer extends Renderer {
   override table(
     header: ReactNode[][],
     rows: ReactNode[][][],
-    tableStyle: ViewStyle | undefined,
+    _tableStyle: ViewStyle | undefined,
     _rowStyle: ViewStyle | undefined,
     _cellStyle: ViewStyle | undefined
   ): ReactNode {
-    let columnCount = header.length;
-    for (const row of rows) {
-      if (row.length > columnCount) {
-        columnCount = row.length;
-      }
-    }
-
-    return (
-      <ScrollView key={this.getKey()} horizontal showsHorizontalScrollIndicator={false}>
-        <View style={tableStyle}>
-          <TableRow
-            palette={this.palette}
-            cells={header}
-            columnCount={columnCount}
-            isHeader
-            isLastRow={rows.length === 0}
-          />
-          {rows.map((row, rowIdx) => (
-            <TableRow
-              key={rowIdx}
-              palette={this.palette}
-              cells={row}
-              columnCount={columnCount}
-              isLastRow={rows.length - 1 === rowIdx}
-            />
-          ))}
-        </View>
-      </ScrollView>
-    );
+    return <MarkdownTable key={this.getKey()} palette={this.palette} header={header} rows={rows} />;
   }
 }
 
-const TABLE_COLUMN_MIN_WIDTH = 120;
-const TABLE_COLUMN_TARGET_TOTAL_WIDTH = 320;
-
-function getColumnWidth(columnCount: number): number {
-  return Math.max(
-    TABLE_COLUMN_MIN_WIDTH,
-    Math.floor(TABLE_COLUMN_TARGET_TOTAL_WIDTH / Math.max(columnCount, 1))
-  );
-}
-
-type TableRowProps = {
-  palette: MarkdownPalette;
-  cells: ReactNode[][];
-  columnCount: number;
-  isLastRow: boolean;
-  isHeader?: boolean;
-};
-
-function TableRow({ palette, cells, columnCount, isLastRow, isHeader = false }: TableRowProps) {
-  const columnWidth = getColumnWidth(columnCount);
-  return (
-    <View
-      className="flex-row"
-      // eslint-disable-next-line react-native/no-inline-styles -- dynamic per-variant header background
-      style={isHeader ? { backgroundColor: palette.codeBackground } : undefined}
-    >
-      {Array.from({ length: columnCount }, (_, colIdx) => (
-        <TableCell
-          key={colIdx}
-          palette={palette}
-          width={columnWidth}
-          hasRightBorder={colIdx < columnCount - 1}
-          hasBottomBorder={isHeader || !isLastRow}
-        >
-          {cells[colIdx] ?? []}
-        </TableCell>
-      ))}
-    </View>
-  );
-}
-
-type TableCellProps = {
-  palette: MarkdownPalette;
-  width: number;
-  hasRightBorder: boolean;
-  hasBottomBorder: boolean;
-  children: ReactNode;
-};
-
-function TableCell({ palette, width, hasRightBorder, hasBottomBorder, children }: TableCellProps) {
-  return (
-    <View
-      className="p-2"
-      // eslint-disable-next-line react-native/no-inline-styles -- dynamic column width and per-variant border color
-      style={{
-        width,
-        borderColor: palette.borderColor,
-        borderRightWidth: hasRightBorder ? 1 : 0,
-        borderBottomWidth: hasBottomBorder ? 1 : 0,
-      }}
-    >
-      {children}
-    </View>
-  );
-}
-
 export function MarkdownText({
   value,
   variant = 'assistant',

From 617483a2fd091f5cc441ad8fde6ffcff424a406e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Igor=20=C5=A0=C4=87eki=C4=87?= <iscekic@protonmail.com>
Date: Fri, 3 Jul 2026 13:50:40 +0200
Subject: [PATCH 3/4] fix(kiloclaw): resolve kilo-chat attachments against the
 agent working dir
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

OpenClaw resolves the media workspace to ~/.openclaw/workspace and gates
local attachment paths to its own local roots. The kiloclaw agent works in
/root/clawd (process cwd), which is neither — so a generated file (e.g. a
markdown report) could not be attached: relative filePaths resolved into
the wrong directory (file not found) and absolute paths under /root/clawd
were rejected by local-roots gating whenever host fs read was restricted.

Resolve agent-relative paths against the process cwd (falling back to the
OpenClaw workspace) and append the cwd to the allowed local roots passed
to the OpenClaw media loader. Also hint the model toward absolute paths
for upload-file, whose buffer is hydrated by OpenClaw core before the
plugin can fix up the path.
---
 .../kiloclaw/plugins/kilo-chat/src/channel.ts |  2 +-
 .../kilo-chat/src/media-delivery.test.ts      | 52 +++++++++++++++++++
 .../plugins/kilo-chat/src/media-delivery.ts   | 36 +++++++++++--
 3 files changed, 84 insertions(+), 6 deletions(-)

diff --git a/services/kiloclaw/plugins/kilo-chat/src/channel.ts b/services/kiloclaw/plugins/kilo-chat/src/channel.ts
index 1d80a18564..33173d7729 100644
--- a/services/kiloclaw/plugins/kilo-chat/src/channel.ts
+++ b/services/kiloclaw/plugins/kilo-chat/src/channel.ts
@@ -182,7 +182,7 @@ const pluginBase = createChannelPluginBase({
       '- Kilo Chat uses the shared `message` tool. Prefer `target` for explicit conversation destinations; omit it to act in the current conversation when supported.',
       '- `send`: pass `message` plus `target`; `conversationId` and `groupId` are accepted compatibility aliases. To send any attachment, pass base64 `buffer`, `filename`, and `contentType`, or pass a local workspace path with `filePath`/`media` and a caption in `message`.',
       '- For generated text files or arbitrary local file types, prefer `send` with `filePath`/`media`, or `upload-file` with base64 `buffer`. Do not use `upload-file` with a local `filePath` for plain text or unknown file types.',
-      '- `upload-file`: use for direct file uploads when you already have base64 `buffer`, `filename`, and `contentType`; local `media`/`path`/`filePath` is best for images, audio, video, PDF, and Office documents.',
+      '- `upload-file`: use for direct file uploads when you already have base64 `buffer`, `filename`, and `contentType`; local `media`/`path`/`filePath` is best for images, audio, video, PDF, and Office documents. Prefer absolute file paths (e.g. `/root/clawd/report.md`).',
       '- Kilo Chat actions: `channel-list` lists conversations with optional `limit`; `channel-create` creates a conversation with optional `name`.',
       '- `read`: omit `target` for the current conversation, or pass `target`/`conversationId`; use `limit` and `before` for pagination.',
       '- `react`: pass `messageId` and the actual emoji in `emoji`; set `remove=true` to remove that emoji. If `messageId` is omitted, the current inbound message is used when available.',
diff --git a/services/kiloclaw/plugins/kilo-chat/src/media-delivery.test.ts b/services/kiloclaw/plugins/kilo-chat/src/media-delivery.test.ts
index 263ebd8808..52d9906705 100644
--- a/services/kiloclaw/plugins/kilo-chat/src/media-delivery.test.ts
+++ b/services/kiloclaw/plugins/kilo-chat/src/media-delivery.test.ts
@@ -27,6 +27,58 @@ describe('loadOutboundMedia', () => {
     }
   });
 
+  it('resolves relative paths against the agent working dir, not the OpenClaw workspace', async () => {
+    const agentDir = await mkdtemp(join(tmpdir(), 'kilo-chat-agent-'));
+    const openclawWorkspace = await mkdtemp(join(tmpdir(), 'kilo-chat-ws-'));
+    const previousCwd = process.cwd();
+    try {
+      await writeFile(join(agentDir, 'report.md'), '# Weekly Report');
+      process.chdir(agentDir);
+
+      const media = await loadOutboundMedia('report.md', {
+        mediaAccess: {
+          localRoots: [openclawWorkspace],
+          workspaceDir: openclawWorkspace,
+          readFile: async path => Buffer.from(await readFile(path)),
+        },
+      });
+
+      expect(media.buffer.toString('utf8')).toBe('# Weekly Report');
+      expect(media.fileName).toBe('report.md');
+    } finally {
+      process.chdir(previousCwd);
+      await rm(agentDir, { recursive: true, force: true });
+      await rm(openclawWorkspace, { recursive: true, force: true });
+    }
+  });
+
+  it('allows files under the agent working dir even when it is outside the configured local roots', async () => {
+    const agentDir = await mkdtemp(join(tmpdir(), 'kilo-chat-agent-'));
+    const openclawWorkspace = await mkdtemp(join(tmpdir(), 'kilo-chat-ws-'));
+    const previousCwd = process.cwd();
+    try {
+      const filePath = join(agentDir, 'report.md');
+      await writeFile(filePath, '# Weekly Report');
+      process.chdir(agentDir);
+
+      // No readFile → exercises the real OpenClaw loader and its local-roots gating.
+      const media = await loadOutboundMedia(filePath, {
+        mediaAccess: {
+          localRoots: [openclawWorkspace],
+          workspaceDir: openclawWorkspace,
+        },
+      });
+
+      expect(media.buffer.toString('utf8')).toBe('# Weekly Report');
+      expect(media.contentType).toBe('text/markdown');
+      expect(media.fileName).toBe('report.md');
+    } finally {
+      process.chdir(previousCwd);
+      await rm(agentDir, { recursive: true, force: true });
+      await rm(openclawWorkspace, { recursive: true, force: true });
+    }
+  });
+
   it('passes custom mediaReadFile through to the OpenClaw media loader', async () => {
     const media = await loadOutboundMedia('/virtual/generated.txt', {
       mediaLocalRoots: 'any',
diff --git a/services/kiloclaw/plugins/kilo-chat/src/media-delivery.ts b/services/kiloclaw/plugins/kilo-chat/src/media-delivery.ts
index f2d261090f..1ea1b12eee 100644
--- a/services/kiloclaw/plugins/kilo-chat/src/media-delivery.ts
+++ b/services/kiloclaw/plugins/kilo-chat/src/media-delivery.ts
@@ -2,6 +2,7 @@ import {
   loadOutboundMediaFromUrl,
   type OutboundMediaLoadOptions,
 } from 'openclaw/plugin-sdk/outbound-media';
+import { existsSync } from 'node:fs';
 import { basename, isAbsolute, resolve } from 'node:path';
 import type { ContentBlock, KiloChatClient } from './client.js';
 import { ATTACHMENT_MAX_BYTES } from './synced/schemas.js';
@@ -90,10 +91,31 @@ function resolveFilename(contentType: string | undefined, suggested: string | un
   return 'file.bin';
 }
 
+// The kiloclaw agent works in the process cwd (/root/clawd), but OpenClaw's
+// media workspace defaults to ~/.openclaw/workspace — a directory the agent
+// never writes to. Resolve agent-relative paths against cwd first and include
+// cwd in the allowed local roots, so files the agent generates are attachable.
+function agentWorkingDir(): string {
+  return process.cwd();
+}
+
+function hasUriScheme(raw: string): boolean {
+  return /^[a-z][a-z0-9+.-]*:/i.test(raw.trim());
+}
+
+function withAgentDirRoot(
+  roots: OutboundMediaLoadOptions['mediaLocalRoots']
+): readonly string[] | 'any' {
+  if (roots === 'any') return roots;
+  return [...(roots ?? []), agentWorkingDir()];
+}
+
 function resolveLocalMediaPath(mediaUrl: string, context: OutboundMediaLoadContext): string {
+  if (isAbsolute(mediaUrl) || hasUriScheme(mediaUrl)) return mediaUrl;
+  const cwdPath = resolve(agentWorkingDir(), mediaUrl);
+  if (existsSync(cwdPath)) return cwdPath;
   const workspaceDir = context.mediaAccess?.workspaceDir;
-  if (workspaceDir && !isAbsolute(mediaUrl)) return resolve(workspaceDir, mediaUrl);
-  return mediaUrl;
+  return workspaceDir ? resolve(workspaceDir, mediaUrl) : cwdPath;
 }
 
 function inferMimeFromFilename(fileName: string | undefined): string | undefined {
@@ -118,10 +140,14 @@ export async function loadOutboundMedia(
   }
 
   const channelMediaAccess = mediaAccessForChannelRead(context.mediaAccess);
-  const loaded = await loadOutboundMediaFromUrl(mediaUrl, {
+  const localRoots = withAgentDirRoot(context.mediaLocalRoots ?? channelMediaAccess?.localRoots);
+  const loaded = await loadOutboundMediaFromUrl(resolveLocalMediaPath(mediaUrl, context), {
     maxBytes: ATTACHMENT_MAX_BYTES,
-    mediaAccess: channelMediaAccess,
-    mediaLocalRoots: context.mediaLocalRoots ?? channelMediaAccess?.localRoots,
+    mediaAccess: channelMediaAccess && {
+      ...channelMediaAccess,
+      ...(localRoots === 'any' ? {} : { localRoots: [...localRoots] }),
+    },
+    mediaLocalRoots: localRoots,
   });
   return {
     buffer: Buffer.isBuffer(loaded.buffer) ? loaded.buffer : Buffer.from(loaded.buffer),

From 23752533b00baf733278bb929892fee4950c4cb1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Igor=20=C5=A0=C4=87eki=C4=87?= <iscekic@protonmail.com>
Date: Fri, 3 Jul 2026 14:25:18 +0200
Subject: [PATCH 4/4] fix(kiloclaw): tighten hasUriScheme to avoid
 misclassifying colon filenames

---
 .../kilo-chat/src/media-delivery.test.ts      | 25 +++++++++++++++++++
 .../plugins/kilo-chat/src/media-delivery.ts   |  2 +-
 2 files changed, 26 insertions(+), 1 deletion(-)

diff --git a/services/kiloclaw/plugins/kilo-chat/src/media-delivery.test.ts b/services/kiloclaw/plugins/kilo-chat/src/media-delivery.test.ts
index 52d9906705..286d19816c 100644
--- a/services/kiloclaw/plugins/kilo-chat/src/media-delivery.test.ts
+++ b/services/kiloclaw/plugins/kilo-chat/src/media-delivery.test.ts
@@ -52,6 +52,31 @@ describe('loadOutboundMedia', () => {
     }
   });
 
+  it('resolves relative filenames containing colons against the agent working dir', async () => {
+    const agentDir = await mkdtemp(join(tmpdir(), 'kilo-chat-agent-'));
+    const openclawWorkspace = await mkdtemp(join(tmpdir(), 'kilo-chat-ws-'));
+    const previousCwd = process.cwd();
+    try {
+      await writeFile(join(agentDir, 'report:2026-07-03.md'), '# Weekly Report');
+      process.chdir(agentDir);
+
+      const media = await loadOutboundMedia('report:2026-07-03.md', {
+        mediaAccess: {
+          localRoots: [openclawWorkspace],
+          workspaceDir: openclawWorkspace,
+          readFile: async path => Buffer.from(await readFile(path)),
+        },
+      });
+
+      expect(media.buffer.toString('utf8')).toBe('# Weekly Report');
+      expect(media.fileName).toBe('report:2026-07-03.md');
+    } finally {
+      process.chdir(previousCwd);
+      await rm(agentDir, { recursive: true, force: true });
+      await rm(openclawWorkspace, { recursive: true, force: true });
+    }
+  });
+
   it('allows files under the agent working dir even when it is outside the configured local roots', async () => {
     const agentDir = await mkdtemp(join(tmpdir(), 'kilo-chat-agent-'));
     const openclawWorkspace = await mkdtemp(join(tmpdir(), 'kilo-chat-ws-'));
diff --git a/services/kiloclaw/plugins/kilo-chat/src/media-delivery.ts b/services/kiloclaw/plugins/kilo-chat/src/media-delivery.ts
index 1ea1b12eee..ba979f4694 100644
--- a/services/kiloclaw/plugins/kilo-chat/src/media-delivery.ts
+++ b/services/kiloclaw/plugins/kilo-chat/src/media-delivery.ts
@@ -100,7 +100,7 @@ function agentWorkingDir(): string {
 }
 
 function hasUriScheme(raw: string): boolean {
-  return /^[a-z][a-z0-9+.-]*:/i.test(raw.trim());
+  return /^[a-z][a-z0-9+.-]*:\/\//i.test(raw.trim());
 }
 
 function withAgentDirRoot(