mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-11 12:10:45 +08:00
oliver
dbbe3add6a
同时收敛启动与运维脚本默认行为（含 wiki worker）、更新 Admin 可观测性与相关测试，降低首轮时延并提高运行稳定性。 Made-with: Cursor
100 lines
2.2 KiB
Markdown
100 lines
2.2 KiB
Markdown
---
|
|
summary: "Ollama Web Search via your configured Ollama host"
|
|
read_when:
|
|
- You want to use Ollama for web_search
|
|
- You want a key-free web_search provider
|
|
- You need Ollama Web Search setup guidance
|
|
title: "Ollama Web Search"
|
|
---
|
|
|
|
# Ollama Web Search
|
|
|
|
OpenClaw supports **Ollama Web Search** as a bundled `web_search` provider.
|
|
It uses Ollama's experimental web-search API and returns structured results
|
|
with titles, URLs, and snippets.
|
|
|
|
Unlike the Ollama model provider, this setup does not need an API key by
|
|
default. It does require:
|
|
|
|
- an Ollama host that is reachable from OpenClaw
|
|
- `ollama signin`
|
|
|
|
## Setup
|
|
|
|
<Steps>
|
|
<Step title="Start Ollama">
|
|
Make sure Ollama is installed and running.
|
|
</Step>
|
|
<Step title="Sign in">
|
|
Run:
|
|
|
|
```bash
|
|
ollama signin
|
|
```
|
|
|
|
</Step>
|
|
<Step title="Choose Ollama Web Search">
|
|
Run:
|
|
|
|
```bash
|
|
openclaw configure --section web
|
|
```
|
|
|
|
Then select **Ollama Web Search** as the provider.
|
|
|
|
</Step>
|
|
</Steps>
|
|
|
|
If you already use Ollama for models, Ollama Web Search reuses the same
|
|
configured host.
|
|
|
|
## Config
|
|
|
|
```json5
|
|
{
|
|
tools: {
|
|
web: {
|
|
search: {
|
|
provider: "ollama",
|
|
},
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
Optional Ollama host override:
|
|
|
|
```json5
|
|
{
|
|
models: {
|
|
providers: {
|
|
ollama: {
|
|
baseUrl: "http://ollama-host:11434",
|
|
},
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
If no explicit Ollama base URL is set, OpenClaw uses `http://127.0.0.1:11434`.
|
|
|
|
If your Ollama host expects bearer auth, OpenClaw reuses
|
|
`models.providers.ollama.apiKey` (or the matching env-backed provider auth)
|
|
for web-search requests too.
|
|
|
|
## Notes
|
|
|
|
- No web-search-specific API key field is required for this provider.
|
|
- If the Ollama host is auth-protected, OpenClaw reuses the normal Ollama
|
|
provider API key when present.
|
|
- OpenClaw warns during setup if Ollama is unreachable or not signed in, but
|
|
it does not block selection.
|
|
- Runtime auto-detect can fall back to Ollama Web Search when no higher-priority
|
|
credentialed provider is configured.
|
|
- The provider uses Ollama's experimental `/api/experimental/web_search`
|
|
endpoint.
|
|
|
|
## Related
|
|
|
|
- [Web Search overview](/tools/web) -- all providers and auto-detection
|
|
- [Ollama](/providers/ollama) -- Ollama model setup and cloud/local modes
|