openclaw - 💡(How to fix) Fix Feishu streaming card: allow custom header title instead of hardcoded session name [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#54340Fetched 2026-04-08 01:28:46
View on GitHub
Comments
0
Participants
1
Timeline
0
Reactions
0
Author
Participants

Code Example

// openclaw.json
{
  "channels": {
    "feishu": {
      "cardHeader": {
        "title": "小爪",           // custom display name
        "template": "blue"        // color theme
      }
    }
  }
}

---

{
  "agents": {
    "defaults": {
      "displayName": "小爪"
    }
  }
}

---

const displayTitle = config.channels?.feishu?.cardHeader?.title 
  ?? options?.header?.title 
  ?? agentConfig?.displayName
  ?? "OpenClaw";
RAW_BUFFERClick to expand / collapse

Problem

When using Feishu channel with renderMode: "card" (streaming cards), the card header always shows the internal session/agent identifier (e.g., "main") as the title. This is not meaningful to end users and looks like a debug label.

Screenshot showing "main" as card title

Expected Behavior

Allow customizing the streaming card header title via configuration, for example:

// openclaw.json
{
  "channels": {
    "feishu": {
      "cardHeader": {
        "title": "小爪",           // custom display name
        "template": "blue"        // color theme
      }
    }
  }
}

Or per-agent:

{
  "agents": {
    "defaults": {
      "displayName": "小爪"
    }
  }
}

Current Behavior

The StreamingCard class in extensions/feishu/src/streaming-card.ts sets the header title from options.header.title, which is populated with the agent/session ID (e.g., "main"). There is no user-facing config to override this.

Use Case

  • Users deploy OpenClaw as a team assistant bot in Feishu group chats
  • The card header is visible to all group members
  • Showing "main" looks unprofessional; a custom name (bot name, task description, etc.) would be much better

Suggested Implementation

In streaming-card.ts around line 184-188, fall back to a configured display name when options.header.title is the raw session ID:

const displayTitle = config.channels?.feishu?.cardHeader?.title 
  ?? options?.header?.title 
  ?? agentConfig?.displayName
  ?? "OpenClaw";

Environment

  • OpenClaw version: 2026.3.23-2
  • Channel: Feishu (websocket mode)
  • renderMode: card
  • streaming: true

extent analysis

Fix Plan

To fix the issue, we need to update the streaming-card.ts file to allow customization of the streaming card header title.

Step-by-Step Solution

  1. Update streaming-card.ts: Modify the displayTitle assignment to use the configured display name when options.header.title is the raw session ID.
const displayTitle = config.channels?.feishu?.cardHeader?.title 
  ?? options?.header?.title 
  ?? agentConfig?.displayName 
  ?? "OpenClaw";
  1. Add configuration options: Ensure that the openclaw.json configuration file allows for customizing the streaming card header title.
{
  "channels": {
    "feishu": {
      "cardHeader": {
        "title": "小爪",
        "template": "blue"
      }
    }
  }
}

Alternatively, you can configure the display name per-agent:

{
  "agents": {
    "defaults": {
      "displayName": "小爪"
    }
  }
}
  1. Verify configuration: Make sure to restart the OpenClaw service after updating the configuration file.

Verification

To verify that the fix worked, check the Feishu group chat and ensure that the streaming card header title displays the custom name instead of the internal session/agent identifier.

Extra Tips

  • Make sure to update the OpenClaw version to the latest release to ensure you have the latest features and bug fixes.
  • If you encounter any issues, check the OpenClaw logs for errors and adjust the configuration as needed.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - 💡(How to fix) Fix Feishu streaming card: allow custom header title instead of hardcoded session name [1 participants]