面向 AI 助手：本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/agent-plan-personal-search.md，全部文档索引见 https://ark.volcengine.com/llms.txt。

豆包搜索

豆包搜索是面向大模型构建的搜索服务，通过灵活 API 形式提供多垂类、多信源搜索能力，用于补充模型训练数据截止后的最新事实、核验信息出处、获取时效性内容，提升大模型回答的知识面和可信度。

能力介绍#

豆包搜索支持的核心能力如下，详情参见 豆包搜索 API 文档。

  • 网页搜索：返回标题、来源站点、URL、摘要、正文等结构化字段，单次最多 50 条。
  • 多模态搜索：对文本 query 返回图片内容（包括图片标题、URL、尺寸与形状）。
  • 权威来源过滤：可限定返回可信度高的各类官方站点内容。
  • 时间范围筛选：支持近一天/周/月/年的快捷枚举，或自定义日期区间。
  • Query 改写：对口语化长问题自动改写为搜索式 query，提升召回。

使用豆包搜索#

步骤一：订阅套餐并开通豆包搜索#

  1. 在 开通管理-Agent Plan 页面购买 Agent Plan 个人版套餐。套餐说明参见套餐概览。
  2. 在控制台单击Harness，开启豆包搜索的抵扣开关。
    image-20260908-205106-259.png
  3. 获取 Agent Plan 的专属 API Key，用于在工具中完成 Skill 或 MCP 的配置。
    image-20260908-203322-616.png

步骤二：在工具中使用豆包搜索#

目前支持通过 MCP Server 或 Skill 两种方式在工具中使用豆包搜索。具体接入方式参见 AI 工具接入指南。

前置准备：已安装 Python 3.12+、uv。其中 uv 安装命令如下：

  • macOS / Linux

    Bash
    curl -LsSf https://astral.sh/uv/install.sh | sh

  • Windows

    Bash
    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Skill 接入方式#

通过 Skill 方式为 AI 工具快速安装并接入豆包搜索能力。以下为常用 AI 工具的配置方案，其他工具可按需选择通过命令安装或通过对话安装方式完成豆包搜索 Skill 的安装并使用。

  1. 安装并配置 Claude Code，具体步骤见 Claude Code。

  2. 在终端执行以下命令为 Claude Code 安装并接入豆包搜索 Skill byted-web-search。

    Bash
    npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-web-search --agent claude-code

  3. 安装完成后，执行claude命令启动 Claude Code。

  4. 通过对话方式提供 Agent Plan 的 API Key 完成 Skill 的配置。

  5. 配置完成后，可以在 Claude Code 中使用豆包搜索能力。

  1. 安装并配置 OpenCode，具体步骤见 OpenCode。

  2. 在终端执行以下命令为 OpenCode 安装并接入豆包搜索 Skill byted-web-search。

    Bash
    npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-web-search --agent opencode

  3. 安装完成后，执行opencode命令启动 OpenCode。

  4. 通过对话方式提供 Agent Plan 的 API Key 完成 Skill 的配置。

  5. 配置完成后，可以在 OpenCode 中使用豆包搜索能力。

  1. 安装并配置 OpenClaw，具体步骤见 OpenClaw。

  2. 在终端执行以下命令为 OpenClaw 安装并接入豆包搜索 Skill byted-web-search。

    Bash
    npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-web-search --agent openclaw

  3. 安装完成后，执行以下命令启动 OpenClaw。

    Bash
    openclaw tui

  4. 在对话框中输入 Agent Plan 的 API Key ，完成 Skill 配置。

  5. Skill 配置完成后可以在 OpenClaw 中使用豆包搜索能力。

  1. 安装并配置 Hermes Agent，具体步骤见 Hermes Agent。

  2. 在终端执行以下命令为 Hermes Agent 安装并接入豆包搜索 Skill byted-web-search。

    Bash
    npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-web-search --agent hermes-agent

  3. 安装完成后，启动 Hermes Agent。

  4. 在对话框中输入 Agent Plan 的 API Key 完成 Skill 的配置。

  5. 配置完成后，可以在 Hermes Agent 中使用豆包搜索能力。

hermes-searching.png

MCP 接入方式#

以下为常用 AI 工具的 MCP 接入方案，其他工具可通过对话方式让模型完成 MCP 的接入。

  1. 安装并配置 Claude Code，具体步骤见 Claude Code。

  2. 编辑配置文件~/.claude.json，添加 MCP 配置。其中 <AGENT_PLAN_API_KEY> 需替换为 Agent Plan 的 API Key。

    JSON
    {
  ...
  "mcpServers": {
    "mcp-server-askecho-search-infinity": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_askecho_search_infinity",
        "mcp-server-askecho-search-infinity"
      ],
      "env": {
        "ASK_ECHO_SEARCH_INFINITY_API_KEY": "<AGENT_PLAN_API_KEY>"
      }
    }
  }
  ...
}
  1. 在终端执行claude命令启动 Claude 服务后，输入/mcp后看到mcp-server-askecho-search-infinity，说明配置成功。
  1. MCP 安装完成后即可使用豆包搜索能力。

  1. 安装并配置 OpenCode，具体步骤见 OpenCode。

  2. 编辑配置文件~/.config/opencode/opencode.json，添加 MCP 配置。其中 <AGENT_PLAN_API_KEY> 需替换为 Agent Plan 的 API Key。

    JSON
    {
  ...
  "mcp": {
    "mcp-server-askecho-search-infinity": {
      "type": "local",
      "enabled": true,
      "command": ["uvx", "--from", "git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_askecho_search_infinity", "mcp-server-askecho-search-infinity"],
      "environment": {
        "ASK_ECHO_SEARCH_INFINITY_API_KEY": "<AGENT_PLAN_API_KEY>"
      }
    }
  }
  ...
}
  1. 在终端执行opencode命令启动 OpenCode 服务后，输入/mcp后看到mcp-server-askecho-search-infinity状态为 Enabled，说明配置成功。
  1. MCP 安装完成后即可使用豆包搜索能力。

  1. 安装并配置 OpenClaw，具体步骤见 OpenClaw。

  2. 在终端执行如下命令安装 MCPorter。

    Bash
    npm install -g mcporter

  3. 编辑配置文件~/.openclaw/openclaw.json，添加 MCP 配置。其中 <AGENT_PLAN_API_KEY> 需替换为 Agent Plan 的 API Key。

    JSON
    {
  ...
  "mcp": {
    "servers": {
      "mcp-server-askecho-search-infinity": {
        "command": "uvx",
        "args": [
          "--from",
          "git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_askecho_search_infinity",
          "mcp-server-askecho-search-infinity"
        ],
        "env": {
          "ASK_ECHO_SEARCH_INFINITY_API_KEY": "<AGENT_PLAN_API_KEY>"
        }
      }
    }
  },
  "skills": {
    "entries": {
      "mcporter": {
        "enabled": true
      }
    }
  }
  ...
}

  1. 在终端执行如下命令使配置生效。

    Bash
    openclaw gateway restart

  2. 在项目目录下，执行如下命令查看已安装的 mcp-server-askecho-search-infinity MCP。

    Bash
    mcporter list

  3. 启动 OpenClaw 后，即可使用豆包搜索能力。

用户权益#

使用联网搜索（Beta版）的用户权益#

2026年7月1日起，联网搜索（Beta版）的限时免费权益活动结束，每月免费额度发生变更。

  • 变更前：根据下单的 Agent Plan 套餐类型发放每月免费额度，该额度专属于 Agent Plan 获取的搜索 API Key 调用。套餐到期时，下单附赠的免费搜索额度也将回收。
    • Small：每月赠送 50 次免费搜索额度。
    • Medium：每月赠送 150 次免费搜索额度。
    • Large：每月赠送 400 次免费搜索额度。
    • Max：每月赠送 800 次免费搜索额度。
  • 变更后：以火山引擎主账号 ID 维度，每月发放 500 次免费额度（每月1日重置），免费额度不专属于 Agent Plan 获取的搜索 API Key 调用，在火山引擎的所有开通方式下都会被优先消耗。

使用豆包搜索的用户权益#

以火山引擎主账号 ID 维度，每月发放 500 次免费额度（每月1日重置），免费额度不专属于 Agent Plan 获取的 API Key 调用，在火山引擎的所有开通方式下都会被优先消耗。

实践教程#

搭建个人投资助手网站
基于 Agent Plan + 豆包搜索 + 专业数据集，搭建一个面向普通投资者的个人投资助手网站。

搭建短视频网站
基于 Agent Plan + 豆包搜索，搭建一个抖音同款短视频网站。

搭建学习教育网站
基于 Agent Plan + 豆包搜索，搭建一个绘声绘色学古诗-教育网站。

常见问题#

  • 如何关闭豆包搜索服务？

    豆包搜索是按量后付费型产品，当前官网无法主动关停服务。如有关停需求可提交 工单申请。

  • 如何查看豆包搜索付费用量统计？

    可以在 豆包搜索控制台数据管理 查看豆包搜索付费用量信息。

  • 豆包搜索和联网内容插件有什么区别？

    豆包搜索和联网内容插件的区别请参见 豆包搜索产品简介。

服务协议#