# OpenClaw

OpenClaw 에이전트 Google Search 및 YouTube 도구를 연구 및 반복 브리핑에 대 한 제공.

Canonical 참고: https://flashdata.dev/ko/docs/integrations/openclaw
검토: 2026-11-05 FlashData

<a id="choose"></a>

## 시작하기 전에

OpenClaw 설치 및 작업이 있습니다. 이 호스팅 MCP 설정은 Google Search, YouTube Search, Metadata 및 Transcript의 OAuth를 사용합니다. 로그인 중에 FlashData 계정을 만들 수 있습니다.

- [CLI 기술을 사용하거나 시험 시작](https://flashdata.dev/ko/docs/integrations/openclaw/reference.md#cli)
- [OpenClaw 설치](https://docs.openclaw.ai/start/getting-started)

<a id="setup"></a>

## 1. MCP 서버 추가

기계 및 OpenClaw 프로파일에 이것을 실행하면 게이트웨이를 실행합니다. 서버 구성을 저장합니다. 로그인 및 도구는 아래 호출하여 에이전트가 실제로 사용할 수 있는지 확인합니다. 이 페이지의 모든 명령에 대한 동일한 프로파일을 사용하십시오.

### Bash / PowerShell 7

```bash
openclaw mcp set flashdata '{
  "url": "https://data.flashdata.dev/mcp",
  "transport": "streamable-http",
  "auth": "oauth",
  "oauth": {
    "scope": "mcp:research",
    "clientMetadataUrl": "https://api.flashdata.dev/oauth/clients/openclaw.json"
  }
}'
```


<a id="oauth"></a>

## 2. 계정 만들기

로그인 명령을 실행합니다. 브라우저에서 로그인하거나 계정을 만들고 확인한 다음 액세스 권한을 부여합니다. 로그인을 확인하려면 터미널을 기다립니다. 계정의 크레딧을 사용.

### 로그인

```bash
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probe
```


<a id="connection-check"></a>

### 무료 연결

Control UI 또는 연결된 채팅 채널에서 새로운 대화를 엽니다. 이 프롬프트를 전송; 두 호출은 성공해야합니다. 성공적인 레지스트리 프로브는이 대화가 도구를 사용할 수 있다는 것을 증명하지 않습니다.

#### 당신의 대리인에 붙여넣기

```text
flashdata MCP 연결을 사용하세요.
get_balance에는 {}, get_pricing에는 {"source":"google_search","request_count":1}를 전달해 호출하세요.
사용 가능한 크레딧과 예상 요금을 보고하세요. 검색은 실행하지 마세요.
```


<a id="first-task"></a>

## 3. 첫 번째 작업을 실행

당신의 연결 대리인에 이것을 보내십시오. 체크는 무료입니다; 단일 검색은 크레딧을 사용합니다.

### 첫 번째 작업 프롬프트

```text
flashdata MCP 서버를 사용하십시오. Google 검색의 잔액과 가격을 확인합니다.
펀딩된 경우, 쿼리 "battery recycling research", num 5 및 모드 "realtime"로 한 번 google_search를 호출합니다.
소스 제목, URLs 및 발췌와 함께 짧은 간결을 제공합니다.
Cite 소스 및 보고서 실제 크레딧 사용. 이 작업을 중지합니다.
```


<a id="result"></a>

### 당신이 볼 수 있습니다

완료된 google_search 도구는 status: done, results[].organic의 소스 링크 및 그 소스에 따라 답변을 호출합니다. 사용법은 usage.credits에서 옵니다; 결과의 수가 아닙니다. 빈 결과는 빈으로 보고되어야 합니다.

- [Inspect 요청 내역](https://flashdata.dev/app/jobs)

<a id="tools"></a>

## 자주 묻는 질문

이 OAuth 연결은 연구 공구를 포함합니다. YouTube Download는 API 또는 CLI를 통해 소유자 API 열쇠와 목적지 저장을 사용합니다.

| 의논하기 | MCP 도구 |
| --- | --- |
| 답변 및 구현을위한 웹 소스 찾기 | google_search |
| 관련 YouTube 동영상 찾기 | youtube_search |
| 동영상 제목, 채널 및 메타데이터 읽기 | youtube_metadata |
| 요약에 대한 비디오의 성적표 | youtube_transcript |
| 사용 가능한 신용 및 요청 비용 확인 | get_balance · get_pricing |

- [MCP 도구 및 스키마](https://flashdata.dev/ko/docs/mcp/reference.md)
- [YouTube Download 설정](https://flashdata.dev/ko/docs/guides/youtube-download-guide/reference.md)

<a id="recurring"></a>

## recurring 작업에 대한 액세스 재사용

OpenClaw 프로필 및 에이전트를 사용하여 첫 번째 작업을 통과했습니다. 게이트웨이의 예정된 실행은 동일한 MCP 연결 및 도구 권한이 있어야 합니다.


<a id="reuse-check"></a>

### 저장된 접근

예약된 환경에서 신선한 세션에서 무료 체크를 실행하십시오. 두 호출은 새로운 브라우저 로그인없이 성공해야합니다.

#### 자주 묻는 질문

```text
기존 flashdata MCP 연결을 재사용하세요.
get_balance에는 {}, get_pricing에는 {"source":"google_search","request_count":1}를 전달해 호출하세요.
두 호출의 성공 여부를 보고하세요. 검색하거나 새로운 접근 권한을 만들지 마세요.
```


<a id="schedule"></a>

### 반복 작업 만들기

호스트의 스케줄러에서 09:00 Asia/Shanghai.에서 매일 예를 들어, 시간과 시간대를 선택하십시오. 작업체로 이것을 사용하십시오. 한 번 실행하고 재발을 활성화하기 전에 저장된 보고서를 확인합니다.

#### 작업 몸

```text
기존 플래시 데이터 MCP 연결을 재사용합니다. get_balance 및 get_pricing를 한 Google 검색에 체크하십시오.
허용하고 자금을 받으면 실행 google_search 한 번에 "battery recycling research" num로 5 및 모드 "realtime".
사용 된 소스 URLs, 발췌 및 실제 크레딧으로 날짜 된 보고서를 저장하십시오.
수정된 접근 또는 충분한 신용을 중지하십시오; Retry-After를 존중하십시오. 시험판을 만들지 마십시오, 새로운 허가를 요청하거나, 그 결과가 알 수 없는 요청을 반복하십시오.
```

- [작업 가이드](https://flashdata.dev/ko/docs/guides/recurring-tasks/reference.md)
- [CLI 스케줄링 및 복구](https://flashdata.dev/ko/docs/guides/cli-automation/reference.md#recurring)

<a id="credentials"></a>

### Credential 저장과 새로 고침

이 구성은 OpenClaw 연산자의 공유 OAuth 연결을 사용합니다. 채팅 참가자를 허용하고 FlashData 계정과 그 잔액을 사용할 수 있습니다. 각 sender를 위한 별도의 계정을 제공하지 않습니다.

호스트는 회전식 갱신 토큰을 사용하여 유효 기간이 1시간인 OAuth 액세스 토큰을 갱신합니다. 90일 권한 부여가 만료되거나 취소되면 다시 연결하세요. 각 설치는 자체 토큰 저장소를 사용합니다. 호스트 간에 갱신 토큰 파일을 공유하지 마세요.


<a id="revoke"></a>

### 재연결

1. 일시 정지 예정된 작업, 다음 OAuth 연결 FlashData Settings → Connected apps.
2. 저장된 연결로 get_balance를 한 번 호출하도록 에이전트에 요청하세요. 인증이 실패하거나 재연결을 요청해야 합니다. 이 확인 중에 새 로그인을 승인하지 마세요.
3. 아래 명령어로 로컬 OAuth 자격 증명을 제거하십시오. 나중에 다시 연결하려면 소유자 승인과 함께 2를 반복하고 무료 연결 확인을 실행하십시오.

#### 저장된 OAuth 자격 제거

```bash
openclaw mcp logout flashdata
```

- [Connected apps](https://flashdata.dev/app/settings/connections)

<a id="options"></a>

## 더 많은 설정 옵션

MCP 연결에 워크플로우 기술을 추가하거나 CLI 액세스 또는 로컬 MCP 서버를 선택하십시오.


<a id="skills"></a>

### MCP 기술 추가

flashdata-mcp 기술은 연결된 도구를 사용하는 에이전트를 가르칩니다. 위 연결을 재사용합니다.

Node.js 22.20+ 및 npm로 활성 OpenClaw 작업 공간에서이 실행됩니다. 완전한 기술은 skills/flashdata-mcp.에 저장됩니다 새로운 대화를 시작하고 flashdata-mcp를 사용하도록 요청하십시오.

#### OpenClaw 작업 공간에

```bash
npx skills add flashdatadev/flashdata-skills --skill flashdata-mcp --agent openclaw --copy
openclaw skills list --eligible
```

- [CLI 설치](https://flashdata.dev/ko/docs/guides/flashdata-cli/reference.md#install)
- [MCP 기술 읽기](https://github.com/flashdatadev/flashdata-skills/tree/main/skills/flashdata-mcp)
- [업데이트 또는 기술을 제거](https://flashdata.dev/ko/docs/guides/agent-skill-management/reference.md)

<a id="cli"></a>

### CLI 기술을 사용하거나 시험 시작

FlashData CLI v1.2.1를 설치하고 활성 OpenClaw 작업 공간에서 실행하십시오. 1개의 접근 탭을 선택하십시오. 예제는 MCP OAuth과 별도로 기본 CLI 프로파일을 사용합니다. 기존 --profile 및 --state-dir를 유지하면 사용자 정의를 사용할 수 있습니다.

Node.js 22.20+ 및 npm에서 아래의 두 가지 워크플로우 기술을 설치합니다. 새로운 OpenClaw 대화를 시작 후. 기본 CLI의 설정 명령은 OpenClaw를 대상으로하지 않습니다.

#### CLI 워크플로우 기술 설치

```bash
npx skills add flashdatadev/flashdata-skills --skill flashdata google-search --agent openclaw --copy
openclaw skills list --eligible
```

#### 기존 API 키

숨겨지은 프롬프트에서 google_search 권한을 가진 열쇠를 붙여 넣으십시오. 무인비행기 수입을 위해, 당신의 비밀 매니저에서 auth login --api-key-stdin --non-interactive에 관을 배관하십시오.

##### 1. 수입 및 확인 키

```bash
flashdata auth login
flashdata auth status --json --non-interactive
```

##### 2. 잔액 및 비용 확인 - 검색 없음

```bash
flashdata account balance --json --non-interactive
flashdata search "battery recycling research" --num 5 --dry-run --json --non-interactive

# accessVerified와 estimateAvailable가 true인 경우에만 계속,
# google_search는 허용되고, availableCredits는 estimatedCredits를 덮습니다.
```

##### 3. 한 번 실행 → ./openclaw-first-search.json

```bash
flashdata search "battery recycling research" --num 5 --run-id openclaw-first-search-001 --output openclaw-first-search.json --json --non-interactive

# 저장된 파일을 읽으십시오: 상태, results[].organic, usage.credits.
# 맨끝 JSON는 산출 경로를 보고합니다; 회복을 위한 뛰기 ID를 지킵니다.
```


#### 저장 CLI 액세스

기존 키 또는 평가판을 재사용하십시오. FLASHDATA_API_KEY가 설정되면 저장된 키에 우선이 걸립니다. auth status에 의해 표시된 계정을 확인합니다.

##### 1. 재사용 및 저장된 액세스 확인

```bash
flashdata auth status --json --non-interactive
```

##### 2. 잔액 및 비용 확인 - 검색 없음

```bash
flashdata account balance --json --non-interactive
flashdata search "battery recycling research" --num 5 --dry-run --json --non-interactive

# accessVerified와 estimateAvailable가 true인 경우에만 계속,
# google_search는 허용되고, availableCredits는 estimatedCredits를 덮습니다.
```

##### 3. 한 번 실행 → ./openclaw-first-search.json

```bash
flashdata search "battery recycling research" --num 5 --run-id openclaw-first-search-001 --output openclaw-first-search.json --json --non-interactive

# 저장된 파일을 읽으십시오: 상태, results[].organic, usage.credits.
# 맨끝 JSON는 산출 경로를 보고합니다; 회복을 위한 뛰기 ID를 지킵니다.
```


#### Eligible 시험

기존의 평가판을 재사용하거나 한번 등록하십시오. 만료된 경우, 소진 또는 재조정, 복구 또는 청구. CLI 작업을 반복하기 전에 계정을 주장하고 auth status에서 recurringAllowed: true를 확인합니다.

##### 1. 설정 및 시험 접근 확인

```bash
flashdata init --name "OpenClaw research" --client openclaw --audience personal --scopes google_search --non-interactive
flashdata auth status --json --non-interactive
```

##### 2. 잔액 및 비용 확인 - 검색 없음

```bash
flashdata account balance --json --non-interactive
flashdata search "battery recycling research" --num 5 --dry-run --json --non-interactive

# accessVerified와 estimateAvailable가 true인 경우에만 계속,
# google_search는 허용되고, availableCredits는 estimatedCredits를 덮습니다.
```

##### 3. 한 번 실행 → ./openclaw-first-search.json

```bash
flashdata search "battery recycling research" --num 5 --run-id openclaw-first-search-001 --output openclaw-first-search.json --json --non-interactive

# 저장된 파일을 읽으십시오: 상태, results[].organic, usage.credits.
# 맨끝 JSON는 산출 경로를 보고합니다; 회복을 위한 뛰기 ID를 지킵니다.
```


- [다운로드 CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)
- [CLI 설치](https://flashdata.dev/ko/docs/guides/flashdata-cli/reference.md#install)
- [저장된 결과를 복구](https://flashdata.dev/ko/docs/guides/cli-automation/reference.md#recover)
- [CLI 작업을 재발송하기 전에 클레임](https://flashdata.dev/ko/docs/guides/agent-onboarding/reference.md)

<a id="local"></a>

### API 키로 로컬 MCP 실행

Node.js 22.18+, npm 및 API 키와 google_search의 첫 번째 작업에 대한 권한이 필요합니다. 이 실행 @flashdata-dev/mcp 0.2.0; 그것은 FlashData CLI의 저장된 키 또는 MCP OAuth 토큰을 읽지 않습니다.

실제로 게이트웨이를 실행하는 환경에서의 키를 설정합니다. 아래 프롬프트는 단말 발사 게이트웨이입니다. 서비스 또는 컨테이너의 경우, 주사 FLASHDATA_API_KEY 를 통해 secret/environment 설정 및 재시작. 다른 맨끝에 있는 열쇠를 수출하는 것은 달리는 서비스를 새롭게 하지 않을 것입니다.

설정 후, 새로운 에이전트 세션에서 위의 무료 연결 체크 프롬프트를 실행합니다. 모두 체크 패스를 한 번, first-task prompt를 사용하십시오. API-key 액세스는 mcp 로그인이 필요하지 않습니다.

#### Bash

##### 1. 인쇄 없이 열쇠를 놓으십시오

```bash
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
```

##### 2. Gateway의 프로필에 등록 및 프로브

```bash
openclaw mcp set flashdata '{
  "command": "npx",
  "args": [
    "--yes",
    "--package=@flashdata-dev/mcp@0.2.0",
    "flashdata-mcp"
  ],
  "env": {
    "FLASHDATA_API_KEY": "${FLASHDATA_API_KEY}"
  }
}'
openclaw mcp doctor flashdata --probe
```


#### PowerShell 7 (Windows)

##### 1. 인쇄 없이 열쇠를 놓으십시오

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```

##### 2. Gateway의 프로필에 등록 및 프로브

```powershell
openclaw mcp set flashdata '{
  "command": "npx.cmd",
  "args": [
    "--yes",
    "--package=@flashdata-dev/mcp@0.2.0",
    "flashdata-mcp"
  ],
  "env": {
    "FLASHDATA_API_KEY": "${FLASHDATA_API_KEY}"
  }
}'
openclaw mcp doctor flashdata --probe
```


- [무료 연결 체크를 실행](https://flashdata.dev/ko/docs/integrations/openclaw/reference.md#connection-check)
- [API 키 생성](https://flashdata.dev/app/api-keys)
- [로컬 MCP 문서](https://github.com/flashdatadev/flashdata-mcp)

<a id="help"></a>

## 관련 상품

| 의 의 | 이 글을 |
| --- | --- |
| FlashData 도구 없음 | 오픈 클로 mcp 의사 flashdata --probe를 실행하십시오. Gateway profile and Agents tool policy를 확인한 후, 신선한 대화를 엽니다. |
| 기술 누락 | openclaw 기술 목록 --eligible 및 openclaw 기술 체크를 실행 활성화 프로필. 작업 공간 기술 및 기술 수당을 확인합니다. |
| invalid_client / callback | 단계 1를 정확히 비교하십시오. 호스트의 콜백을 시작할 수 있는 브라우저의 인증. |
| 401 | 연결 또는 키가 재발 또는 만료되었는지 확인하십시오. OAuth를 위해, 소유자 승인을 가진 반복 표시에서; CLI를 위해, flashdata auth status를 실행하십시오. 신용을 추가하면 인증이 되지 않습니다. |
| 403 | 요청된 소스 권한 확인. 연구 OAuth는 YouTube Download를 포함하지 않습니다; 그것의 API-key 설치를 사용하십시오. 재발송하기 전에 허가를 수정합니다. |
| 402 | get_balance 또는 flashdata 계정 잔액을 확인하십시오. Billing에서 크레딧을 추가하거나 작업을 중지하십시오. 다시 로그인하면 크레딧을 추가하지 않습니다. |
| 429 | Retry-After만큼 기다리고 동시 실행 수를 줄이세요. 현재 프로필과 등록 증명을 유지하고 대체 체험을 만들지 마세요. |
| 로컬 MCP는 키를 읽을 수 없습니다 | 호스트 프로세스가 시작되고 다시 시작되는 FLASHDATA_API_KEY를 설정합니다. flashdata auth login에 의해 저장된 열쇠는 국부적으로 MCP에 자동적으로 수출되지 않습니다. |
| CLI 출력 파일 이미 존재 | 읽기 ./openclaw-first-search.json. 저장된 성공을 다시 내보내기 위해 플래시 데이터 runs show openclaw-first-search-001 --result --output openclaw-first-search-copy.json를 원래 프로필으로 사용하십시오. ID를 새로운 검색에만 사용하세요. |
| 계획된 작업 실패 | 그 환경에서 무료 재사용 체크를 실행하십시오. OS 사용자, 호스트 프로필, 자격점 및 도구 권한 일치. |
| 타임아웃 또는 알 수없는 결과 | 요청 또는 작업 ID를 유지하고 재조정하기 전에 History를 확인하십시오. 반환 continuation IDs를 위한 get_result를 사용하십시오. |

- [복구 가이드](https://flashdata.dev/ko/docs/guides/agent-recovery/reference.md)
- [OpenClaw MCP 문서](https://docs.openclaw.ai/cli/mcp/transports)

<a id="compatibility"></a>

## OAuth 검증 노트

OAuth 로그인, 콜백, 저장된 자격 증명, 무료 가격 통화, 새로 고침 및 재발견은 OpenClaw 2026.10.5 2026-10-21를 가진 Windows에 확인되었습니다. 즉, 유료 쿼리 또는 예정된 실행을 유효하지 않았다. 설정 지침은 2026-11-05의 호스트 문서에 대해 확인되었습니다.

- [공식 기술](https://github.com/flashdatadev/flashdata-skills)
- [MCP 패키지 및 소스](https://github.com/flashdatadev/flashdata-mcp)
