Docs: https://docs.openclaw.ai

## Unreleased

### Changes

### Fixes

- CLI/Claude: run the same prompt-build hooks and trigger/channel context on `claude-cli` turns as on direct embedded runs, keeping Claude Code sessions aligned with OpenClaw workspace identity, routing, and hook-driven prompt mutations. (#70625) Thanks @mbelinky.

## 2026.4.22

### Changes

setup. If you want to reuse an existing Claude login on the same host, use the

Anthropic Claude CLI path in onboarding/configure.

Recommended host setup for Claude CLI reuse:

```bash

# Run on the gateway host

claude auth login

claude auth status --text

openclaw models auth login --provider anthropic --method cli --set-default

```

This is a two-step setup:

1. Log Claude Code itself into Anthropic on the gateway host.

2. Tell OpenClaw to switch Anthropic model selection to the local `claude-cli`

backend and store the matching OpenClaw auth profile.

If `claude` is not on `PATH`, either install Claude Code first or set

`agents.defaults.cliBackends.claude-cli.command` to the real binary path.

Manual token entry (any provider; writes `auth-profiles.json` + updates config):

```bash

the prompt. Skill env/API key overrides are still applied by OpenClaw to the

child process environment for the run.

Before OpenClaw can use the bundled `claude-cli` backend, Claude Code itself

must already be logged in on the same host:

```bash

claude auth login

claude auth status --text

openclaw models auth login --provider anthropic --method cli --set-default

```

Use `agents.defaults.cliBackends.claude-cli.command` only when the `claude`

binary is not already on `PATH`.

## Sessions

- If the CLI supports sessions, set `sessionArg` (e.g. `--session-id`) or

expect(params.senderIsOwner).toBe(false);

});

it("forwards channel context through the compat wrapper", () => {

const params = buildRunClaudeCliAgentParams({

sessionId: "openclaw-session",

sessionFile: "/tmp/session.jsonl",

workspaceDir: "/tmp",

prompt: "hi",

timeoutMs: 1_000,

runId: "run-claude-channel-wrapper",

messageChannel: "telegram",

messageProvider: "acp",

});

expect(params.messageChannel).toBe("telegram");

expect(params.messageProvider).toBe("acp");

});

it("forwards static extra system prompt through the compat wrapper", () => {

const params = buildRunClaudeCliAgentParams({

sessionId: "openclaw-session",

sessionId: params.sessionId,

sessionKey: params.sessionKey,

agentId: params.agentId,

trigger: params.trigger,

sessionFile: params.sessionFile,

workspaceDir: params.workspaceDir,

config: params.config,

// Ignore it here so the compatibility wrapper does not accidentally resume

// an incompatible Claude session on the generic runner path.

images: params.images,

messageChannel: params.messageChannel,

messageProvider: params.messageProvider,

senderIsOwner: params.senderIsOwner,

};

}