plain prompts instead of OpenClaw internal runtime-context envelopes, while

keeping those envelopes out of ACP transcripts.

- TTS/status: show configured TTS model, voice, and sanitized custom endpoint in `/status`, preserve OpenAI-compatible TTS instructions on custom endpoints, and retry empty Microsoft/Edge TTS output once. Addresses #46602, #47232, and #43936. Thanks @leekuangtao, @Huntterxx, and @rex993.

- Agents/Gateway: steer agent-driven config edits and restarts through the owner-only `gateway` tool, document `config.schema.lookup` as the field-doc source, and warn against using `gateway stop && gateway start` as a restart substitute on macOS. Fixes #71929. Thanks @ygc3817922006-sketch.

- Providers/vLLM: send Nemotron 3 chat-template kwargs when thinking is off

and honor configured `params.chat_template_kwargs` for OpenAI-compatible

completions, so vLLM/Nemotron replies stay visible instead of becoming

Notes:

- `gateway install` supports `--port`, `--runtime`, `--token`, `--force`, `--json`.

- Use `gateway restart` to restart a managed service. Do not chain `gateway stop` and `gateway start` as a restart substitute; on macOS, `gateway stop` intentionally disables the LaunchAgent before stopping it.

- When token auth requires a token and `gateway.auth.token` is SecretRef-managed, `gateway install` validates that the SecretRef is resolvable but does not persist the resolved token into service environment metadata.

- If token auth requires a token and the configured token SecretRef is unresolved, install fails closed instead of persisting fallback plaintext.

- For password auth on `gateway run`, prefer `OPENCLAW_GATEWAY_PASSWORD`, `--password-file`, or a SecretRef-backed `gateway.auth.password` over inline `--password`.

([https://clawhub.ai](https://clawhub.ai)) for skills discovery. It tells the model to

consult docs first for OpenClaw behavior, commands, configuration, or architecture, and to

run `openclaw status` itself when possible (asking the user only when it lacks access).

For configuration specifically, it points agents to the `gateway` tool action

`config.schema.lookup` for exact field-level docs and constraints, then to

`docs/gateway/configuration.md` and `docs/gateway/configuration-reference.md`

for broader guidance.

## Related

- `config.schema.lookup` returns one path-scoped schema node for drill-down tooling

- `pnpm config:docs:check` / `pnpm config:docs:gen` validate the config-doc baseline hash against the current schema surface

Agent lookup path: use the `gateway` tool action `config.schema.lookup` for

exact field-level docs and constraints before edits. Use

[Configuration](/gateway/configuration) for task-oriented guidance and this page

for the broader field map, defaults, and links to subsystem references.

Dedicated deep references:

- [Memory configuration reference](/reference/memory-config) for `agents.defaults.memorySearch.*`, `memory.qmd.*`, `memory.citations`, and dreaming config under `plugins.entries.memory-core.config.dreaming`

See the [full reference](/gateway/configuration-reference) for every available field.

Agents and automation should use `config.schema.lookup` for exact field-level

docs before editing config. Use this page for task-oriented guidance and

[Configuration reference](/gateway/configuration-reference) for the broader

field map and defaults.

<Tip>

**New to configuration?** Start with `openclaw onboard` for interactive setup, or check out the [Configuration Examples](/gateway/configuration-examples) guide for complete copy-paste configs.

</Tip>

- `config.apply` only when you intend to replace the entire config

- `update.run` for explicit self-update plus restart

Agents should treat `config.schema.lookup` as the first stop for exact

field-level docs and constraints. Use [Configuration reference](/gateway/configuration-reference)

when they need the broader config map, defaults, or links to dedicated

subsystem references.

<Note>

Control-plane writes (`config.apply`, `config.patch`, `update.run`) are

rate-limited to 3 requests per 60 seconds per `deviceId+clientIp`. Restart

openclaw gateway stop

```

Use `openclaw gateway restart` for restarts. Do not chain `openclaw gateway stop` and `openclaw gateway start`; on macOS, `gateway stop` intentionally disables the LaunchAgent before stopping it.

LaunchAgent labels are `ai.openclaw.gateway` (default) or `ai.openclaw.<profile>` (named profile). `openclaw doctor` audits and repairs service config drift.

</Tab>

For partial changes, prefer `config.schema.lookup` then `config.patch`. Use

`config.apply` only when you intentionally replace the entire config.

For broader config docs, read [Configuration](/gateway/configuration) and

[Configuration reference](/gateway/configuration-reference).

The tool also refuses to change `tools.exec.ask` or `tools.exec.security`;

legacy `tools.bash.*` aliases normalize to the same protected exec paths.

});

}

function collectActionValues(schema: unknown, values: Set<string>): void {

if (!schema || typeof schema !== "object") {

return;

}

const record = schema as Record<string, unknown>;

if (typeof record.const === "string") {

values.add(record.const);

}

if (Array.isArray(record.enum)) {

for (const value of record.enum) {

if (typeof value === "string") {

values.add(value);

}

}

}

if (Array.isArray(record.anyOf)) {

for (const variant of record.anyOf) {

collectActionValues(variant, values);

}

}

}

function expectConfigMutationCall(params: {

callGatewayTool: {

mock: {

expect(tool.ownerOnly).toBe(true);

});

it("exposes restart and config actions in the gateway tool schema", async () => {

const tool = requireGatewayTool();

const parameters = tool.parameters as {

properties?: Record<string, unknown>;

};

const values = new Set<string>();

collectActionValues(parameters.properties?.action, values);

expect([...values]).toEqual(

expect.arrayContaining(["restart", "config.get", "config.patch", "config.apply"]),

);

});

it("schedules SIGUSR1 restart", async () => {

const kill = vi.spyOn(process, "kill").mockImplementation(() => true);

const restartSignalKillCalls = () =>

describe("createOpenClawCodingTools", () => {

const testConfig: OpenClawConfig = {};

it("exposes gateway config and restart actions to owner sessions", () => {

const tools = createOpenClawCodingTools({ config: testConfig, senderIsOwner: true });

const gateway = tools.find((tool) => tool.name === "gateway");

expect(gateway).toBeDefined();

const parameters = gateway?.parameters as {

properties?: Record<string, unknown>;

};

const action = parameters.properties?.action as

| { const?: unknown; enum?: unknown[] }

| undefined;

const values = new Set<string>();

collectActionValues(action, values);

expect([...values]).toEqual(

expect.arrayContaining(["restart", "config.get", "config.patch", "config.apply"]),

);

});

it("preserves action enums in normalized schemas", () => {

const defaultTools = createOpenClawCodingTools({ config: testConfig, senderIsOwner: true });

const toolNames = ["canvas", "nodes", "cron", "gateway", "message"];

});

expect(prompt).toContain("## OpenClaw CLI Quick Reference");

expect(prompt).toContain("use the first-class `gateway` tool");

expect(prompt).toContain(

"Only use CLI service lifecycle commands when the user explicitly asks",

);

expect(prompt).toContain("openclaw gateway restart");

expect(prompt).toContain("Do not chain `openclaw gateway stop`");

expect(prompt).toContain("Do not invent commands");

});

it("points agents to config field docs and broader configuration docs", () => {

const prompt = buildAgentSystemPrompt({

workspaceDir: "/tmp/openclaw",

docsPath: "/tmp/openclaw/docs",

});

expect(prompt).toContain("For config field docs");

expect(prompt).toContain("`gateway` tool action `config.schema.lookup`");

expect(prompt).toContain("docs/gateway/configuration.md");

expect(prompt).toContain("docs/gateway/configuration-reference.md");

});

it("guides runtime completion events without exposing internal metadata", () => {

const prompt = buildAgentSystemPrompt({

workspaceDir: "/tmp/openclaw",

expect(prompt).toContain("config.schema.lookup");

expect(prompt).toContain("config.apply");

expect(prompt).toContain("config.patch");

expect(prompt).toContain("Config writes hot-reload when possible");

expect(prompt).toContain("update.run");

expect(prompt).not.toContain("Use config.schema to");

expect(prompt).not.toContain("config.schema, config.apply");