openclaw - 💡(How to fix) Fix [Feature]: session-level chat mode for lower-cost lightweight conversations [1 comments, 2 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#77025Fetched 2026-05-04 04:59:19
View on GitHub
Comments
1
Participants
2
Timeline
2
Reactions
2
Timeline (top)
commented ×1labeled ×1

Add a session-level chat mode as a lighter alternative to full agent mode.

This would let users explicitly choose between:

  • chat: lightweight conversation
  • agent: full OpenClaw execution behavior

Root Cause

Affected users are people using OpenClaw for everyday chat-style conversations in TUI, WebChat, or messaging channels where they do not actually need full agent execution behavior on every turn. The severity is moderate: it does not usually block usage, but it can make simple conversations unnecessarily expensive and heavier than needed. This pain occurs frequently in normal use, because many interactions are lightweight Q&A, summaries, clarifications, and low-risk discussion rather than file mutation or multi-step task execution. The practical consequence is higher token usage, more context growth, and unnecessary escalation into tool- or workspace-aware behavior, which can increase cost, latency, and operational complexity for otherwise simple requests.

RAW_BUFFERClick to expand / collapse

Summary

Add a session-level chat mode as a lighter alternative to full agent mode.

This would let users explicitly choose between:

  • chat: lightweight conversation
  • agent: full OpenClaw execution behavior

Problem to solve

For simple chat scenarios, the default full agent path can be heavier than needed.

Even when the user only wants a quick explanation or summary, the runtime may still carry:

  • larger system prompt sections
  • longer history
  • tool-related behavior
  • workspace-aware execution framing

That increases token usage and makes lightweight conversations more expensive than necessary.

Proposed solution

Introduce a session-level mode switch:

  • /mode chat
  • /mode agent
  • /mode

Chat mode

Intended for:

  • simple Q&A
  • explanations
  • summaries
  • low-risk conversations

Behavior:

  • lighter system prompt
  • shorter history window
  • reduced or disabled tool exposure
  • less execution-oriented behavior

Agent mode

Keeps the current full behavior for:

  • reading/writing files
  • running commands
  • browsing/searching
  • multi-step task execution
  • workspace-aware work

Introduce a session-level mode switch that lets users explicitly choose between a lightweight \chatmode and the existing fullagentmode. The minimal UX could be slash commands such as/mode chat, /mode agent, and /modefor status. Inchatmode, OpenClaw should assemble a lighter runtime context by using a shorter system prompt, a shorter history window, and reduced or disabled tool exposure, so the model behaves more like a lightweight conversational assistant. Inagentmode, OpenClaw should preserve the current full execution-oriented behavior, including workspace-aware context and full tool access. A good first version should be additive and opt-in, with session-persistent mode state so one session can stay lightweight while another stays fully agentic. As a follow-up,chat` mode could optionally support a small allowlist of lightweight read-only tools such as web search or web fetch without escalating to full agent mode.

Alternatives considered

No response

Impact

Affected users are people using OpenClaw for everyday chat-style conversations in TUI, WebChat, or messaging channels where they do not actually need full agent execution behavior on every turn. The severity is moderate: it does not usually block usage, but it can make simple conversations unnecessarily expensive and heavier than needed. This pain occurs frequently in normal use, because many interactions are lightweight Q&A, summaries, clarifications, and low-risk discussion rather than file mutation or multi-step task execution. The practical consequence is higher token usage, more context growth, and unnecessary escalation into tool- or workspace-aware behavior, which can increase cost, latency, and operational complexity for otherwise simple requests.

Evidence/examples

I built and tested a local prototype of this idea on OpenClaw v2026.3.13. In side-by-side testing with the same dev agent/model setup and similar prompts in separate clean sessions, \chatmode consistently behaved more directly and lightly, whileagentmode was more likely to expand into reads/search/execution behavior. For a token-optimization prompt, I observed roughly11k / 400kcontext usage inchatmode versus66k / 400kinagentmode, or about a 6x difference for that task shape. This suggests the savings come not only from shorter replies, but from a lighter overall runtime path with less context expansion and fewer tool-triggering behaviors. I also observed thatchatmode produced more bounded responses for prompts like “请用三句话总结 OpenClaw chat mode 的目的” and “请分析 chat mode 和 agent mode 的适用场景”, whileagent` mode more readily framed the task in terms of broader execution capabilities. If useful, I can provide implementation notes or a PR against current main.

Additional information

This proposal is intended as an additive feature, not a behavioral replacement for the current default agent path. The main goal is to provide an explicit low-cost session mode for lightweight conversations while preserving full agent behavior for execution-heavy tasks. I prototyped and validated the concept locally on v2026.3.13, but I understand any real upstream implementation should target current main. I also think session-level mode is the right granularity, because the same user may want one lightweight discussion session and another full execution-oriented session under the same agent. As a future extension, I think chat mode could support a configurable read-only lightweight tool allowlist, for example web search or web fetch, while still reserving heavy tools such as shell, browser control, file mutation, and multi-step execution for full agent mode.

extent analysis

TL;DR

Implement a session-level mode switch to allow users to choose between a lightweight "chat" mode and the existing full "agent" mode.

Guidance

  • Introduce a mode switch with slash commands (/mode chat, /mode agent, /mode) to let users explicitly choose between modes.
  • In "chat" mode, use a lighter system prompt, shorter history window, and reduced or disabled tool exposure to minimize token usage and context growth.
  • Preserve the current full execution-oriented behavior in "agent" mode, including workspace-aware context and full tool access.
  • Consider implementing session-persistent mode state to allow different sessions to have different modes.

Example

No code example is provided as the issue does not contain specific implementation details.

Notes

The proposed solution aims to provide an additive feature, not a replacement for the current default agent path, and targets reducing token usage and context growth for lightweight conversations.

Recommendation

Apply the proposed workaround by introducing a session-level mode switch, as it provides an explicit low-cost session mode for lightweight conversations while preserving full agent behavior for execution-heavy tasks.

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 [Feature]: session-level chat mode for lower-cost lightweight conversations [1 comments, 2 participants]