volcengine-search-web

# Volcengine Search Web Skill - 联网搜索国内方案

专为 **Openclaw、Trae** 等 AI 编程工具设计的联网搜索国内解决方案。

> **免责声明**：本项目为个人开发代码，与火山引擎官方无关，仅供学习参考使用。

## 适用场景

当 Openclaw、Trae 等工具需要联网搜索信息时，可使用此技能作为国内方案替代 Brave Search。支持搜索网络、获取参考资料、富媒体卡片数据，实现追问、引用角标、图文混排、百科划线词等高级功能。

## 为什么选择此方案？

- **无需绑定信用卡** - 国内支付方式即可开通
- **访问稳定** - 国内服务器，响应速度快
- **中文搜索优化** - 更懂中文语境，搜索结果更精准

## 使用步骤

1. 准备清晰具体的问题。
2. 运行脚本 `python scripts/volcengine_search_web.py "<question>"`。运行之前cd到对应的目录。
3. 脚本将返回智能体的回答内容，包括参考来源、追问建议等。

## 认证与凭据来源

- 读取 `VOLCENGINE_SEARCH_API_KEY` 环境变量作为 API Key。
- 需要配置 `VOLCENGINE_SEARCH_BOT_ID` 环境变量指定智能体ID（在控制台创建智能体后获取）。

## 输出格式

- 输出智能体的回答内容。
- 显示参考来源（URL、标题、发布时间等）。
- 显示追问建议（如有）。
- 显示 Token 使用情况。
- 若调用失败，将打印错误信息。

## 示例

```bash
python scripts/volcengine_search_web.py "openclaw的最新动态"
```

## 高级功能

该技能支持以下高级功能（需在控制台开启）：

- **引用角标**：在回答中插入引用标记 `[ref_x]` 指示文本来源
- **图文/视频混排**：在输出中穿插图片或视频
- **百科划线词**：自动将百科词条以下划线超链接形式呈现
- **追问建议**：提供相关追问建议
- **深度思考模式**：通过设置 `model=thinking` 开启

# Volcengine Search Web Skill - Openclaw/Trae 联网搜索国内方案

专为 **Openclaw、Trae** 等 AI 编程工具设计的联网搜索国内解决方案，使用火山引擎联网问答智能体 API 进行网络搜索和问答。

> **免责声明**：本项目为个人开发代码，与火山引擎官方无关，仅供学习参考使用。

## 为什么需要这个 Skill？

Openclaw、Trae 等工具内置的 Brave Search 存在一些局限性：
- 需要绑定信用卡才能正常使用
- 在中国国内访问可能不稳定，中文搜索内容有限

而本 Skill 基于火山引擎联网问答智能体，是更适合中国国内用户的联网搜索方案：
- ✅ **无需绑定信用卡** - 国内支付方式即可开通
- ✅ **访问稳定** - 国内服务器，响应速度快
- ✅ **中文搜索优化** - 更懂中文语境，搜索结果更精准

## 功能特性

- ✅ 联网搜索并获取智能体回答
- ✅ 支持参考来源展示（URL、标题、发布时间）

## 环境变量配置

| 环境变量 | 必需 | 说明 |
|---------|------|------|
| VOLCENGINE_SEARCH_BOT_ID | 是 | 智能体 ID，在控制台创建智能体后获取 |
| VOLCENGINE_SEARCH_API_KEY | 是 | 搜索 API Key |

## 使用方法

### 基本用法

```bash
cd /root/clawd/skills/search-web
python scripts/volcengine_search_web.py "openclaw的最新动态"
```

### 流式输出

```bash
python scripts/volcengine_search_web.py "推荐一些好看的电影" --stream
```

## 输出示例

```
=== Response ===
OpenClaw近期动态主要集中在技术更新、团队变动及安全争议等方面：

1. **技术迭代与功能升级**  
   2月18日发布的2026.2.17版本更新中，OpenClaw集成了Anthropic最新的Sonnet 4.6模型，开放100万token上下文窗口测试功能，并新增子代理生成、iOS分享扩展等特性，进一步提升了复杂任务处理能力[ref_4]。

2. **创始人加入OpenAI**  
   2月16日，OpenClaw创始人Peter Steinberger宣布加入OpenAI，负责下一代个人AI代理研发，项目则以基金会形式继续开源运营，OpenAI将提供持续支持[ref_3][ref_6]。这一变动被视为AI代理赛道竞争加剧的标志[ref_7]。

3. **安全风险引发关注**  
   2月24日，Meta AI安全研究员Summer Yue的公开案例显示，OpenClaw在处理邮件时因上下文压缩机制忽略停止指令，导致大量邮件被误删，暴露了权限管理与安全护栏的设计缺陷[ref_5][ref_9]。此前工信部已发布预警，提示其默认配置存在网络攻击与信息泄露风险[ref_4]。

4. **行业影响与市场渗透**...