佛系程序员_ OpenClaw 手动指定 duckduckgo 作为搜索 provider

学习笔记

发布日期: 2026-04-16 12:36:37

喜欢量: 6 个

阅读次数: 59

### 一、获取 Brave Search API Key 完整步骤（含绑卡、免费...

openclaw config配置时，
你看不到 DuckDuckGo 选项，是因为**当前 OpenClaw 版本/默认配置里没内置它**，但可以**手动改配置文件直接启用，完全免API Key、免绑卡、免费无限用**。下面给你**Windows 下完整、可直接复制的步骤**：

### 一、核心原理
OpenClaw 支持手动指定 `duckduckgo` 作为搜索 provider，走 DuckDuckGo 公开接口（`https://api.duckduckgo.com/`），**不需要任何密钥/登录**。

### 二、找到并编辑 OpenClaw 配置文件
#### 1. 定位配置目录（Windows 默认路径）
```
C:\Users\Administrator\.openclaw\
```
有两个关键文件：`openclaw.json`（主配置）、`.env`（环境变量）

#### 2. 方法一：修改 openclaw.json（推荐，全局生效）
用记事本/VS Code 打开 `C:\Users\Administrator\.openclaw\openclaw.json`，**添加/修改 web 搜索配置**：
```json
{
  "tools": {
    "web": {
      "search": {
        "provider": "duckduckgo",
        "duckduckgo": {
          "region": "cn-zh",  // 或 us-en，按你需要
          "safeSearch": "moderate"
        }
      }
    }
  },
  "models": {
    "providers": {
      "ollama": {
        "baseUrl": "http://127.0.0.1:11434",
        "apiKey": "ollama-local"
      }
    }
  }
}
```
- 关键：把 `provider` 设为 `"duckduckgo"`，**覆盖默认的 Brave/Perplexity**
- 保存文件，关闭

#### 3. 方法二：用 .env 环境变量（极简，不用改json）
在 `.openclaw` 目录新建/编辑 `.env` 文件，添加一行：
```env
OPENCLAW_TOOLS_WEB_SEARCH_PROVIDER=duckduckgo
```
保存即可

### 三、重启 OpenClaw 生效

### 四、验证是否生效
运行搜索测试：
```powershell

```
- 正常返回联网结果 = 配置成功
- 报错：检查 `openclaw.json` 格式（逗号、引号别错）、重启服务

### 五、为什么向导里看不到 DuckDuckGo？
- **内置选项只显示 Brave/Perplexity/Grok**，不显示 DuckDuckGo
- 手动写配置是官方支持的方式，**完全可用、稳定、免费**

### 六、避坑提醒
1. 不要用 `openclaw configure --section web` 向导，它不会显示 DuckDuckGo，直接改文件
2. DuckDuckGo 公开接口**无速率/次数限制、完全免费、隐私无追踪**
3. 若仍报错，删除 `.openclaw` 下的缓存文件，再重启

**完整可复制的 openclaw.json 最终配置**

```
"web": {
      "search": {
        "provider": "duckduckgo",
        "duckduckgo": {
          "region": "cn-zh",  // 或 us-en，按你需要
          "safeSearch": "moderate"
        },
        "enabled": true,
        "openaiCodex": {}
      },
      "fetch": {
        "enabled": true
      }
    }
```

# Brave Search API Key 完整步骤

### 一、获取 Brave Search API Key 完整步骤（含绑卡、免费额度）
#### 1. 进入 Brave Search API 官网注册/登录
打开：https://brave.com/search/api/ → 点击 **Get Started / Try for free** → 用邮箱注册/登录（需邮箱验证）

#### 2. 选择免费计划（必须绑卡，仅验证、不扣费）
- 进入 API 控制台：https://api-dashboard.search.brave.com/
- 进入 **Plans** → 选择 **Free (Search)** 计划：**每月免费 2000 次查询（约1000次有效搜索）、速率1次/秒**
- 必须绑定**国际信用卡（Visa/Mastercard）**：仅做身份验证，**不会自动扣费、免费额度用完即停**；预扣 $1 验证，几分钟内退回

#### 3. 创建并复制 API Key
- 控制台左侧 → **API Keys** → 点击 **Add API Key**
- 填写名称（如 openclaw）、用途选 Personal → 点击 **Create**
- 生成的 Key 以 **bsc_** 开头，**只显示一次，立即复制保存到安全地方**

### 二、OpenClaw 配置 Brave Search（2种方式）
#### 方式1：命令行配置（推荐）
```powershell
openclaw configure --section web
```
- 选择：**Brave Search (Requires API key)**
- 粘贴你的 `bsc_xxxx` API Key → 一路回车确认

#### 方式2：手动写入配置文件（.env）
在 OpenClaw 配置目录（默认 `C:\Users\Administrator\.openclaw`）新建/编辑 `.env` 文件，添加：
```env
BRAVE_API_KEY=bsc_你的完整API密钥
```

### 三、关键注意事项（避坑）
1. **免费额度**：每月 2000 次请求，用完自动暂停，不会扣费；可在 Brave 控制台设置**用量上限**，防止超额
2. **绑卡必选**：免费计划也必须绑卡，无国际卡无法使用 Brave Search，建议改用 **DuckDuckGo（无密钥、完全免费）**
3. **密钥安全**：不要泄露、不要硬编码到代码里，仅在本地 `.env` 或环境变量中使用

直接配置成 **DuckDuckGo（免密钥、零成本）**，彻底避开绑卡和API Key麻烦。

yyii

http://www.amtb.info/show/MzYy

本博客所有文章除特別声明外,转载请注明来源佛系程序员 !