From 99a87cd822ec68940da4df01a02cb1ee97361a62 Mon Sep 17 00:00:00 2001
From: Mrunal Patel <mrunalp@gmail.com>
Date: Tue, 7 Jul 2026 15:44:07 -0700
Subject: [PATCH] Fix Podman sandbox CI checks

---
 docs/.i18n/glossary.zh-CN.json        |  4 ++++
 docs/docs_map.md                      | 10 ++++++++++
 extensions/podman/src/backend.test.ts |  4 +++-
 extensions/podman/src/backend.ts      |  2 +-
 4 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/docs/.i18n/glossary.zh-CN.json b/docs/.i18n/glossary.zh-CN.json
index 4bc968088388..e62dfa54c16b 100644
--- a/docs/.i18n/glossary.zh-CN.json
+++ b/docs/.i18n/glossary.zh-CN.json
@@ -99,6 +99,10 @@
     "source": "OpenAI provider",
     "target": "OpenAI provider"
   },
+  {
+    "source": "Podman plugin",
+    "target": "Podman 插件"
+  },
   {
     "source": "Mantis",
     "target": "Mantis"
diff --git a/docs/docs_map.md b/docs/docs_map.md
index c6ed073662a9..3e8e0b8b0586 100644
--- a/docs/docs_map.md
+++ b/docs/docs_map.md
@@ -4041,6 +4041,7 @@ Do not edit it by hand; run `pnpm docs:map:gen`.
   - H2: Supported capability matrix
   - H2: Docker backend
   - H3: Sandboxed browser
+  - H2: Podman backend
   - H2: SSH backend
   - H2: OpenShell backend
   - H2: Workspace access
@@ -4856,6 +4857,7 @@ Do not edit it by hand; run `pnpm docs:map:gen`.
 - Headings:
   - H2: Prerequisites
   - H2: Quick start
+  - H2: Agent sandbox backend
   - H2: Podman and Tailscale
   - H2: Systemd (Quadlet, optional)
   - H2: Config, env, and storage
@@ -7221,6 +7223,14 @@ Do not edit it by hand; run `pnpm docs:map:gen`.
   - H2: Surface
   - H2: Related docs
 
+## plugins/reference/podman.md
+
+- Route: /plugins/reference/podman
+- Headings:
+  - H1: Podman plugin
+  - H2: Distribution
+  - H2: Surface
+
 ## plugins/reference/policy.md
 
 - Route: /plugins/reference/policy
diff --git a/extensions/podman/src/backend.test.ts b/extensions/podman/src/backend.test.ts
index 9e0da3b1682a..b6aa4c110429 100644
--- a/extensions/podman/src/backend.test.ts
+++ b/extensions/podman/src/backend.test.ts
@@ -1,6 +1,8 @@
-import type { CreateSandboxBackendParams, SandboxConfig } from "openclaw/plugin-sdk/sandbox";
+import type { CreateSandboxBackendParams } from "openclaw/plugin-sdk/sandbox";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
+type SandboxConfig = CreateSandboxBackendParams["cfg"];
+
 const podmanMocks = vi.hoisted(() => ({
   execPodman: vi.fn(),
   execPodmanRaw: vi.fn(),
diff --git a/extensions/podman/src/backend.ts b/extensions/podman/src/backend.ts
index 9feb5d4a4dc8..5583400f0305 100644
--- a/extensions/podman/src/backend.ts
+++ b/extensions/podman/src/backend.ts
@@ -180,7 +180,7 @@ async function ensurePodmanContainer(params: {
   const expectedHash = computePodmanConfigHash(params.createParams);
   const state = await podmanContainerState(params.pluginConfig, containerName);
   let hasContainer = state.exists;
-  let running = state.running;
+  const running = state.running;
   if (hasContainer) {
     const currentHash = await readPodmanContainerLabel(
       params.pluginConfig,