openclaw - ✅(Solved) Fix [Bug]: Regression in 2026.4.24: agent harness "claude-cli" is not registered, all gateway requests fail [1 pull requests, 6 comments, 4 participants]

openclaw2026-04-26 23:57:10

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.

GitHub issue URL

Helpful · Quick feedback

GitHub stats

openclaw/openclaw#72434•Fetched 2026-04-27 05:30:10

View on GitHub

Comments

Participants

Timeline

Reactions

Author

Participants

Timeline (top)

commented ×6cross-referenced ×5labeled ×2closed ×1

After upgrading from 2026.4.23 to 2026.4.24, every gateway request fails with "Requested agent harness 'claude-cli' is not registered and PI fallback is disabled" — affecting all Claude model fallbacks and compaction.

Error Message

~/.openclaw/logs/gateway.err.log excerpt during 2026.4.24:

2026-04-26T16:34:28.026-07:00 [gateway/channels] channel startup failed: Error: Requested agent harness "claude-cli" is not registered and PI fallback is disabled. 2026-04-26T16:35:34.562-07:00 [diagnostic] lane task error: lane=main durationMs=2 error="Error: Requested agent harness "claude-cli" is not registered and PI fallback is disabled." 2026-04-26T16:35:34.570-07:00 [model-fallback/decision] model fallback decision: decision=candidate_failed requested=anthropic/claude-opus-4-7 candidate=anthropic/claude-opus-4-7 reason=unknown next=anthropic/claude-sonnet-4-6 detail=Requested agent harness "claude-cli" is not registered and PI fallback is disabled. 2026-04-26T16:35:34.582-07:00 [model-fallback/decision] model fallback decision: decision=candidate_failed requested=anthropic/claude-opus-4-7 candidate=anthropic/claude-opus-4-6 reason=unknown next=anthropic/claude-opus-4-5 detail=Requested agent harness "claude-cli" is not registered and PI fallback is disabled. 2026-04-26T16:35:34.592-07:00 [model-fallback/decision] model fallback decision: decision=candidate_failed requested=anthropic/claude-opus-4-7 candidate=anthropic/claude-sonnet-4-5 reason=unknown next=anthropic/claude-haiku-4-5 detail=Requested agent harness "claude-cli" is not registered and PI fallback is disabled. 2026-04-26T16:36:38.386-07:00 [gateway] request handler failed: Error: Requested agent harness "claude-cli" is not registered and PI fallback is disabled.

Root Cause

Fix Action

Fix / Workaround

Workaround: pin [email protected] until a fix is released. Users on Anthropic Claude CLI as their provider should hold off upgrading.

PR fix notes

PR #72590: test(anthropic): cover legacy embeddedHarness migration path

Repository: openclaw/openclaw
Author: 1fanwang
State: open | merged: False
Link: https://github.com/openclaw/openclaw/pull/72590

Description (problem / solution / changelog)

What

Adds a single test inside extensions/anthropic/cli-migration.test.ts that gives buildAnthropicCliMigrationResult a 4.23-carry-over config — agents.defaults.embeddedHarness.runtime: "claude-cli" — and asserts the output configPatch emits the canonical agentRuntime.id. ~27 net lines, no behavior change.

Why

Regression coverage for #72434. buildAnthropicCliMigrationResult is well-tested for clean-config inputs (the existing it("keeps anthropic defaults and selects the claude-cli runtime", ...) passes a config with no embeddedHarness block). The 5b9be2cdb1 fix introduced the canonical agentRuntime.id key, but the legacy-input-shape path it's actually fixing has no explicit test pinning it.

This addresses part of #72576 (claude-cli backend regression-prevention test). Test-only; no production code touched.

Reproducer / verification

Locally on this branch:

$ pnpm test extensions/anthropic/cli-migration.test.ts -- -t 'migrates a 4.23-carry-over'
 Test Files  1 passed (1)
      Tests  1 passed | 11 skipped (12)
   Duration  4.22s

Environment: macOS 25.3.0, Node 22.22.2, openclaw repo at 6c1cffa7f8 (origin/main head at PR open time).

Why this passes "test-only / refactor" per CLAUDE.md

CODEOWNERS line: "maint/refactor/tests ok". This is a test-only change inside the anthropic extension package boundary; no plugin SDK seams added; no public contract change.

Changed files

extensions/anthropic/cli-migration.test.ts (modified, +27/-0)

Code Example

~/.openclaw/logs/gateway.err.log excerpt during 2026.4.24:

2026-04-26T16:34:28.026-07:00 [gateway/channels] channel startup failed: Error: Requested agent harness "claude-cli" is not registered and PI fallback is disabled.
2026-04-26T16:35:34.562-07:00 [diagnostic] lane task error: lane=main durationMs=2 error="Error: Requested agent harness "claude-cli" is not registered and PI fallback is disabled."
2026-04-26T16:35:34.570-07:00 [model-fallback/decision] model fallback decision: decision=candidate_failed requested=anthropic/claude-opus-4-7 candidate=anthropic/claude-opus-4-7 reason=unknown next=anthropic/claude-sonnet-4-6 detail=Requested agent harness "claude-cli" is not registered and PI fallback is disabled.
2026-04-26T16:35:34.582-07:00 [model-fallback/decision] model fallback decision: decision=candidate_failed requested=anthropic/claude-opus-4-7 candidate=anthropic/claude-opus-4-6 reason=unknown next=anthropic/claude-opus-4-5 detail=Requested agent harness "claude-cli" is not registered and PI fallback is disabled.
2026-04-26T16:35:34.592-07:00 [model-fallback/decision] model fallback decision: decision=candidate_failed requested=anthropic/claude-opus-4-7 candidate=anthropic/claude-sonnet-4-5 reason=unknown next=anthropic/claude-haiku-4-5 detail=Requested agent harness "claude-cli" is not registered and PI fallback is disabled.
2026-04-26T16:36:38.386-07:00 [gateway] request handler failed: Error: Requested agent harness "claude-cli" is not registered and PI fallback is disabled.

RAW_BUFFERClick to expand / collapse

Bug type

Behavior bug (incorrect output/state without crash)

Beta release blocker

Summary

Steps to reproduce

On macOS with OpenClaw 2026.4.23 working correctly (Anthropic Claude CLI provider, default model claude-cli/claude-opus-4-7), upgrade with: npm install -g openclaw@latest
Verify version: openclaw --version (shows 2026.4.24)
Restart gateway: pkill -f openclaw-gateway (auto-respawns)
Open the dashboard URL and send any message in the web UI, OR click Compact when context is full
Observe failure: every request returns "Requested agent harness 'claude-cli' is not registered and PI fallback is disabled."
Run openclaw configure --section model and re-select Anthropic > Anthropic Claude CLI; the configure flow completes successfully but does not resolve the runtime error.
Rolling back via npm install -g [email protected] restores full functionality.

Expected behavior

Same behavior as 2026.4.23: gateway accepts requests, embedded harness "claude-cli" is registered, messages route to the configured Claude model, and Compact works against accumulated context.

Actual behavior

Every gateway request fails with the harness registration error. Gateway log (~/.openclaw/logs/gateway.err.log) shows:

The fallback chain attempts (and fails on) every model: opus-4-7 → sonnet-4-6 → opus-4-6 → opus-4-5 → sonnet-4-5 → haiku-4-5. Channel startup itself fails. Compact button in the web UI surfaces the same error to the user.

Config field agents.defaults.embeddedHarness.runtime is still "claude-cli" (carried over from 2026.4.23 install) — implying the harness name was renamed or its registration moved in 2026.4.24 without a config migration.

OpenClaw version

2026.4.24 (cbcfdf6) — broken 2026.4.23 (a979721) — working (rollback target)

Operating system

Mac OS 26.4.1

Install method

npm global (npm install -g openclaw)

Model

anthropic/claude-opus-4-7 (default), with fallbacks: claude-sonnet-4-6, claude-opus-4-6, claude-opus-4-5, claude-sonnet-4-5, claude-haiku-4-5

Provider / routing chain

openclaw -> claude-cli (embedded harness) -> Anthropic API

Additional provider/model setup details

Auth profile: anthropic:claude-cli (oauth, sourced from Claude CLI Keychain via openclaw configure --section model). Embedded harness configured as agents.defaults.embeddedHarness.runtime = "claude-cli" in ~/.openclaw/openclaw.json — this value was set by 2026.4.23 and not modified by the upgrade or by re-running configure on 2026.4.24. Claude Code CLI (the underlying claude binary) is version 2.1.114 and is independently logged in (claude auth status shows loggedIn: true, subscriptionType: max).

Logs, screenshots, and evidence

~/.openclaw/logs/gateway.err.log excerpt during 2026.4.24:

2026-04-26T16:34:28.026-07:00 [gateway/channels] channel startup failed: Error: Requested agent harness "claude-cli" is not registered and PI fallback is disabled.
2026-04-26T16:35:34.562-07:00 [diagnostic] lane task error: lane=main durationMs=2 error="Error: Requested agent harness "claude-cli" is not registered and PI fallback is disabled."
2026-04-26T16:35:34.570-07:00 [model-fallback/decision] model fallback decision: decision=candidate_failed requested=anthropic/claude-opus-4-7 candidate=anthropic/claude-opus-4-7 reason=unknown next=anthropic/claude-sonnet-4-6 detail=Requested agent harness "claude-cli" is not registered and PI fallback is disabled.
2026-04-26T16:35:34.582-07:00 [model-fallback/decision] model fallback decision: decision=candidate_failed requested=anthropic/claude-opus-4-7 candidate=anthropic/claude-opus-4-6 reason=unknown next=anthropic/claude-opus-4-5 detail=Requested agent harness "claude-cli" is not registered and PI fallback is disabled.
2026-04-26T16:35:34.592-07:00 [model-fallback/decision] model fallback decision: decision=candidate_failed requested=anthropic/claude-opus-4-7 candidate=anthropic/claude-sonnet-4-5 reason=unknown next=anthropic/claude-haiku-4-5 detail=Requested agent harness "claude-cli" is not registered and PI fallback is disabled.
2026-04-26T16:36:38.386-07:00 [gateway] request handler failed: Error: Requested agent harness "claude-cli" is not registered and PI fallback is disabled.

Impact and severity

Affected: All users on 2026.4.24 with default Anthropic Claude CLI provider (the standard setup created by openclaw configure --section model). Severity: High - blocks all gateway functionality. Web UI accepts the user message but cannot get any model response. Compact fails. Channel startup fails on boot. Frequency: Always (deterministic; reproduces 100% of the time after upgrade until rollback). Consequence: Tool is unusable on 2026.4.24 with the most common provider configuration. Users must roll back to 2026.4.23, which still has the disappearing-messages bug from issue #69406.

Additional information

This is a regression. Last known good: 2026.4.23 (a979721). First known bad: 2026.4.24 (cbcfdf6).

Important: 2026.4.24 fixes the disappearing-messages bug from issue #69406 (verified — messages persist correctly through re-renders in the web UI on 2026.4.24). Rolling back to 2026.4.23 reintroduces that bug. Please preserve the #69406 fix when addressing this harness regression.

Workaround: pin [email protected] until a fix is released. Users on Anthropic Claude CLI as their provider should hold off upgrading.

extent analysis

TL;DR

The most likely fix is to update the configuration to reflect changes in the agent harness registration in OpenClaw version 2026.4.24.

Guidance

Verify the agent harness configuration: Check the ~/.openclaw/openclaw.json file to ensure that the agents.defaults.embeddedHarness.runtime field is correctly set to the expected value for the Anthropic Claude CLI provider in OpenClaw 2026.4.24.
Re-run the configuration flow: Run openclaw configure --section model and re-select the Anthropic Claude CLI provider to ensure that any necessary configuration updates are applied.
Check for updates to the Claude CLI: Verify that the Claude Code CLI (version 2.1.114) is compatible with OpenClaw 2026.4.24 and that there are no updates available that may resolve the issue.
Test with a clean configuration: Try resetting the OpenClaw configuration to its default state and re-configuring the Anthropic Claude CLI provider to see if the issue persists.

Example

No code snippet is provided as the issue appears to be related to configuration and compatibility rather than code.

Notes

The issue may be related to a change in the agent harness registration process in OpenClaw 2026.4.24, which is not reflected in the configuration carried over from 2026.4.23. Preserving the fix for issue #69406 is crucial when addressing this regression.

Recommendation

Apply a workaround by pinning [email protected] until a fix is released, as this version does not exhibit the harness registration issue, although it reintroduces the disappearing-messages bug from issue #69406.

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?

FAQ

Expected behavior

Same behavior as 2026.4.23: gateway accepts requests, embedded harness "claude-cli" is registered, messages route to the configured Claude model, and Compact works against accumulated context.

#api #tokenizer error #prompt formatting #chain error #runtime error

Still need to ship something?

×6

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

openclaw - ✅(Solved) Fix [Bug]: Regression in 2026.4.24: agent harness "claude-cli" is not registered, all gateway requests fail [1 pull requests, 6 comments, 4 participants]

Recommended Tools

GitHub issue graph ai analysis

Error Message

Root Cause

Fix Action

Fix / Workaround

PR fix notes

PR #72590: test(anthropic): cover legacy embeddedHarness migration path

Description (problem / solution / changelog)

What

Why

Reproducer / verification

Why this passes "test-only / refactor" per CLAUDE.md

Changed files

Code Example

Bug type

Beta release blocker

Summary

Steps to reproduce

Expected behavior

Actual behavior

OpenClaw version

Operating system

Install method

Model

Provider / routing chain

Additional provider/model setup details

Logs, screenshots, and evidence

Impact and severity

Additional information

extent analysis

TL;DR

Guidance

Example

Notes

Recommendation

FAQ

Expected behavior

Still need to ship something?

RELATED_DISCOVERY

TRENDING