# OpenClaw: MCP로 페이지 텍스트와 함께 웹 검색 추가

> MCP를 통해 OpenClaw에 LLMWebSearch를 추가하세요: openclaw mcp add, doctor --probe, 그리고 search_web이 16개의 내장 web_search 제공자와 어떻게 나란히 있는지. KYC 없이.

- URL: https://llmwebsearch.com/ko/docs/openclaw/
- 마지막 업데이트: 2026-10-22
- 발행자: LLMWebSearch (https://llmwebsearch.com)

OpenClaw는 이미 자체 목록에서 `web_search` 제공자를 선택합니다. 저희 MCP 서버를 등록하면 두 번째 검색 도구인 `search_web`이 추가되며, 이 도구의 결과에는 상위 페이지가 이미 읽힌 채로 포함되고, 에이전트가 이미 가지고 있는 링크를 위한 `read_urls`도 함께 제공됩니다.

**빠른 답변 — OpenClaw에 페이지 콘텐츠가 포함된 웹 검색 API를 추가하려면 어떻게 하나요?**

저희 MCP 페이지에서 **LLMWebSearch** MCP 서버를 저장하고, `openclaw mcp add llmwebsearch --command … --arg … --env LLMWEBSEARCH_API_KEY=…`으로 등록한 다음, `openclaw mcp doctor --probe`로 확인하세요. 에이전트는 상위 3개 페이지를 Markdown으로 포함한 결과를 주는 `search_web`을 얻으며, 이는 OpenClaw의 내장 `web_search`과 나란히 작동합니다. 검색 한 번에 1 크레딧이 들며, 2026년 10월 기준 US$1.20/1K 검색부터입니다. KYC 없이.

## OpenClaw 검색, 2026년 10월 22일 문서 기준

| 속성 | 값 |
| --- | --- |
| 내장 web_search 제공자 | 16개, Brave Search, DeepSeek, DuckDuckGo, Exa, Firecrawl, Gemini, Parallel, Perplexity, SearXNG, Tavily 포함 |
| 자동 선택 | Brave로 시작하는 고정 순서에 따라 준비된 첫 번째 API 기반 제공자 |
| 키 없는 제공자 | 자동으로 선택되지 않음; 직접 선택해야 함 |
| 저희 도구 (MCP) | 로컬 Python 서버에서 `search_web` 및 `read_urls` |
| 저희 비용 | 크레딧 1개로 검색 1회를 이용할 수 있습니다. 최대 20개의 순위 결과를 받고, 상위 3개 페이지의 본문을 읽어 Markdown으로 반환합니다. 4~10개 페이지를 읽으면 크레딧 2개가 됩니다. 오류로 끝난 호출에는 비용이 청구되지 않습니다 |
| 저희 페이지 리더 | `LLMWebSearch/1.0 (+https://llmwebsearch.com/bot/)`, robots.txt 준수 |

## OpenClaw에 web_search가 있는데 왜 저희 검색을 추가하나요?

한 번의 호출로 결과와 함께 페이지 텍스트를 얻기 위해서입니다. OpenClaw의 웹 도구 페이지에는 `web_search`을 위한 16개의 내장 제공자가 나열되어 있으며, 아무것도 설정하지 않으면 고정된 자동 감지 순서로 선택됩니다. 저희 도구는 그 선택을 대체하지 않고, 모델이 의도적으로 호출할 수 있는 두 번째 옵션을 추가합니다.

`search_web`은 첫 페이지가 이미 Markdown으로 읽힌 상태의 번호 매겨진 소스를 반환하므로, 에이전트는 각 링크를 따로 가져오지 않고도 답변하고 인용할 수 있습니다. `read_urls`는 에이전트가 다른 곳에서 찾은 최대 20개의 링크를 동일한 리더를 통해 읽습니다.

## MCP 서버를 어떻게 등록하나요?

먼저 [MCP 페이지](https://llmwebsearch.com/ko/docs/mcp/)에서 Python 서버를 설정하세요: 파일 하나에, 가상 환경에 `mcp` 및 `httpx` 패키지를 더한 것입니다. 그런 다음 `openclaw mcp add`으로 OpenClaw에 저장하세요. OpenClaw의 레지스트리 문서는 stdio 플래그 `--command`, `--arg`, `--env` 및 `--cwd`을 설명하며, 저장된 서버가 변경되는 동안 로컬 Gateway를 중지할 것을 요청합니다.

다음으로 `openclaw mcp doctor --probe`을 실행하세요. `--probe` 없이는 doctor가 저장된 설정만 확인하지만, 함께 사용하면 서버가 연결되는지도 확인합니다.

*서버 등록 및 확인*

```bash
openclaw mcp add llmwebsearch \
  --command /home/you/llmwebsearch/.venv/bin/python \
  --arg /home/you/llmwebsearch/llmwebsearch_mcp.py \
  --env LLMWEBSEARCH_API_KEY=your-key

openclaw mcp doctor llmwebsearch --probe
```

## 에이전트가 search_web을 볼 수 있나요?

일반적인 프로필에서는 그렇습니다. OpenClaw의 레지스트리 문서에 따르면 구성된 MCP 도구는 `coding` 및 `messaging` 도구 프로필에 나타납니다. `minimal` 프로필은 이를 숨기고, `tools.deny: ["bundle-mcp"]`은 이를 끄므로, 도구가 보이지 않으면 이 두 설정을 확인하세요.

도구의 docstring은 모델에게 무엇을 반환하는지 알려줍니다. 우선적으로 사용하게 하려면 에이전트 지침에 한 줄을 추가하세요. 예를 들어 "페이지를 인용해야 할 때 search_web을 사용하세요"와 같습니다.

## LLMWebSearch를 web_search provider로 선택할 수 있나요?

현재는 불가능합니다. OpenClaw 문서에 따르면 provider 설정은 번들 및 설치된 플러그인 매니페스트에서 선언한 provider만 허용합니다. 저희는 OpenClaw 플러그인을 배포하지 않으므로, 저희 검색은 고유한 이름을 가진 MCP 도구 형태로 제공됩니다.

실제로 에이전트 입장에서 달라지는 것은 거의 없습니다. `web_search`을 호출하듯 `search_web`을 호출하면 됩니다. 또한 OpenClaw 로그와 사용 내역에서 둘을 쉽게 구분할 수 있습니다.

## 저희 리더는 검색 결과의 사이트를 어떻게 처리하나요?

모든 호출에 동일하게 처리합니다. 저희 리더는 robots.txt를 준수합니다. 자신을 LLMWebSearch로 소개하고, 사이트가 리더를 위해 또는 모든 로봇을 위해 작성한 규칙을 따르며, 읽기가 허용되지 않은 페이지의 콘텐츠는 제외합니다. robots.txt에 Content-Signal: ai-input=no를 설정한 사이트는 해당 페이지의 콘텐츠가 결과에 포함되지 않습니다. 사이트가 저희 리더를 거부하면, 결과는 콘텐츠 없이 해당 사이트의 상태와 함께 반환됩니다. 저희는 CAPTCHA를 풀거나 계정에 로그인하거나 차단 또는 페이월을 우회하지 않습니다.

따라서 로그인 뒤에 있는 페이지는 콘텐츠 없이 반환됩니다. 로그인한 상태의 사이트라면 세션을 그대로 사용하는 OpenClaw 자체 브라우저 도구가 적합합니다.

## OpenClaw로 검색하면 비용이 얼마나 드나요?

최대 3페이지를 읽는 `search_web` 호출당 1크레딧이며, 실패한 호출은 무료입니다. 이미 URL을 알고 있는 페이지를 읽는 경우, 콘텐츠와 함께 반환되는 3개 페이지 단위로 크레딧 1개가 청구되며, 호출당 최대 20개 URL까지 가능합니다. 거부되거나 실패한 URL은 집계되지 않습니다. 채팅 채널 전반에서 하루 25회 검색하는 어시스턴트는 한 달에 약 750크레딧을 사용하므로, 검색 5,000회(US$9.25)로 6개월 이상 사용할 수 있습니다. 검색 크레딧에는 만료일이 없습니다. 이번 달에 사용하지 않은 크레딧은 내년에도 그대로 남아 있습니다.

OpenClaw에 전용 API 키를 발급해 사용량이 다른 프로젝트와 구분되도록 하세요.

## OpenClaw: 자주 묻는 질문

### OpenClaw 자체 web_search를 꺼야 하나요?

그럴 필요 없습니다. 둘 다 켜둘 수 있습니다. 청구서와 로그를 하나로 통합해 모든 검색을 하나의 provider로 처리하고 싶을 때만 내장 기능을 끄세요.

### 샌드박스 환경의 OpenClaw에서도 작동하나요?

MCP 서버는 HTTPS로 `https://llmwebsearch.com/api/v1`을 호출하는 로컬 프로세스입니다. 샌드박스가 이 프로세스를 시작하고 해당 주소에 접근할 수 있어야 합니다.

### Control UI에서 서버를 관리할 수 있나요?

OpenClaw는 저장된 MCP 서버를 설정의 `mcp.servers` 아래에 보관합니다. 문서에 따르면 지원되는 실시간 MCP 설정은 Control UI에서 관리하며, 명령줄에서 저장된 서버를 변경하려면 로컬 Gateway를 중지해야 한다고 안내합니다.

## 출처

1. [웹 도구](https://docs.openclaw.ai/tools/web) — OpenClaw docs (read 2026-10-22)
2. [저장된 MCP 서버 관리](https://docs.openclaw.ai/cli/mcp/registry) — OpenClaw docs (read 2026-10-22)

---

LLMWebSearch: LLMWebSearch는 AI 에이전트를 위한 웹 검색 API로, 순위가 매겨진 결과와 함께 상위 페이지의 본문을 Markdown으로 반환하며, 신분증 업로드 없이 암호화폐로 결제합니다. US$1.20/1K 검색부터 시작하는 선불 크레딧은 만료되지 않습니다. KYC 없이 — 신분증도, 셀피도, 서류도 필요 없습니다. 암호화폐로 결제하세요.