openclaw - 💡(How to fix) Fix Bug: /v1/responses endpoint client tools not passed to Agent [2 comments, 3 participants]

Bug Description

When sending requests to the /v1/responses endpoint with a tools field targeting an Agent (model: "agent:..."), the client-provided function tools are silently ignored. The Agent only sees its built-in platform tools (read, write, exec, web_fetch, browser, etc.) and has no knowledge of the client tools.

Reproduction

curl -X POST http://<gateway>:18789/v1/responses \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -H "x-openclaw-agent-id: specialist-planner" \
  -d '{
    "model": "agent:specialist-planner",
    "input": "List your available tools",
    "tools": [{"type":"function","function":{"name":"test_tool","description":"A test tool","parameters":{"type":"object","properties":{}}}}],
    "tool_choice": "auto",
    "stream": false
  }'

Expected: Agent response includes test_tool in its available tools.
Actual: Agent only lists built-in platform tools; test_tool is completely absent.

Root Cause

In src/agents/pi-embedded-runner/run.ts, runEmbeddedPiAgent() calls runEmbeddedAttempt() (~line 929) by individually listing each param field, but omits clientTools. This causes params.clientTools in src/agents/pi-embedded-runner/run/attempt.ts to always be undefined.

The downstream handling code in attempt.ts is fully implemented and correct:

• Line 1563: const clientTools = toolsEnabled ? params.clientTools : undefined;
• Lines 1871-1885: toClientToolDefinitions() conversion
• Line 1887: allCustomTools = [...customTools, ...clientToolDefs] merge into session

But none of this code is ever triggered because the value is never passed through.

Fix

PR: #52171

One line in src/agents/pi-embedded-runner/run.ts:

             images: params.images,
+            clientTools: params.clientTools,
             disableTools: params.disableTools,