add web search

Author: betaHi

README.md

@@ -128,6 +128,38 @@ project-local `.claude/settings.json` and `.claude/settings.local.json` and
 applied to Claude requests only when the model supports reasoning. If it is not
 configured, Claude requests do not infer or attach a reasoning effort.
 
+## Web Search
+
+Not every Copilot model can run web search. If web search is not configured or
+the selected backend cannot search, the bridge tells the client how to configure
+`COPILOT_WEB_SEARCH_BACKEND` and does not switch models automatically.
+
+For Claude Code, configure web search in the user-level
+`~/.claude/settings.json`:
+
+```json
+{
+  "env": {
+    "COPILOT_WEB_SEARCH_BACKEND": "gpt-5.5"
+  }
+}
+```
+
+For Codex CLI, configure the same backend as a top-level key in
+`~/.codex/config.toml`:
+
+```toml
+COPILOT_WEB_SEARCH_BACKEND = "gpt-5.5"
+```
+
+| Value | Search path | Requirement |
+| ----- | ----------- | ----------- |
+| Copilot model id, for example `gpt-5.5` | Copilot HTTP `/responses` + `web_search_preview` | The model must support Copilot Responses web search. |
+| `searxng` | Local SearXNG at `http://localhost:8080` | Start SearXNG yourself. Setup guide: https://github.com/betaHi/openclaw-searxng-search. |
+| `copilot-cli` or `copilot` | GitHub Copilot CLI `web_search` tool, using the current request model | Install and sign in to GitHub Copilot CLI yourself. |
+
+The bridge never installs Docker, SearXNG, or Copilot CLI automatically.
+
 ## Start flags
 
 Common:

src/bridges/claude/anthropic-types.ts

@@ -52,6 +52,35 @@ export interface AnthropicToolUseBlock {
   input: Record<string, unknown>
 }
 
+export interface AnthropicServerToolUseBlock {
+  type: "server_tool_use"
+  id: string
+  name: "web_search"
+  input: Record<string, unknown>
+}
+
+export interface AnthropicWebSearchResultBlock {
+  type: "web_search_tool_result"
+  tool_use_id: string
+  content:
+    | Array<{
+        type: "web_search_result"
+        title: string
+        url: string
+        encrypted_content?: string
+        page_age?: string | null
+      }>
+    | {
+        type: "web_search_tool_result_error"
+        error_code:
+          | "too_many_requests"
+          | "invalid_input"
+          | "max_uses_exceeded"
+          | "query_too_long"
+          | "unavailable"
+      }
+}
+
 export interface AnthropicThinkingBlock {
   type: "thinking"
   thinking: string
@@ -65,6 +94,8 @@ export type AnthropicUserContentBlock =
 export type AnthropicAssistantContentBlock =
   | AnthropicTextBlock
   | AnthropicToolUseBlock
+  | AnthropicServerToolUseBlock
+  | AnthropicWebSearchResultBlock
   | AnthropicThinkingBlock
 
 export interface AnthropicUserMessage {
@@ -106,6 +137,9 @@ export interface AnthropicResponse {
     cache_creation_input_tokens?: number
     cache_read_input_tokens?: number
     service_tier?: "standard" | "priority" | "batch"
+    server_tool_use?: {
+      web_search_requests?: number
+    }
   }
 }
 
@@ -129,6 +163,10 @@ export interface AnthropicContentBlockStartEvent {
     | (Omit<AnthropicToolUseBlock, "input"> & {
         input: Record<string, unknown>
       })
+    | (Omit<AnthropicServerToolUseBlock, "input"> & {
+        input: Record<string, unknown>
+      })
+    | AnthropicWebSearchResultBlock
     | { type: "thinking"; thinking: string }
 }
 

src/bridges/claude/non-stream-translation.ts

@@ -567,14 +567,22 @@ function translateAnthropicToolsToOpenAI(
     return undefined
   }
 
-  return anthropicTools.map((tool) => ({
-    type: "function",
-    function: {
-      name: toolNameMapper.toOpenAI(tool.name),
-      description: tool.description,
-      parameters: tool.input_schema,
-    },
-  }))
+  const tools = anthropicTools.flatMap((tool) => {
+    if (!tool.input_schema) {
+      return []
+    }
+
+    return [{
+      type: "function" as const,
+      function: {
+        name: toolNameMapper.toOpenAI(tool.name),
+        description: tool.description,
+        parameters: tool.input_schema,
+      },
+    }]
+  })
+
+  return tools.length > 0 ? tools : undefined
 }
 
 function translateAnthropicToolChoiceToOpenAI(