核心用法
glm-web-search 是智谱 AI 官方提供的 GLM 联网搜索 MCP 技能,基于 HTTP 协议与智谱大模型平台交互,实现实时网络信息检索。核心流程包括:
1. 依赖检查:通过 npx mcporter 验证工具可用性,支持零安装直接调用
2. 密钥配置:自动检测 ~/.openclaw/config/glm.json 中的 API Key,支持从现有配置文件智能提取或引导用户手动输入
3. 服务注册:使用 mcporter 将智谱官方 MCP 端点(https://open.bigmodel.cn/api/mcp/web_search_prime/mcp)添加为本地可调用服务
4. 搜索执行:通过 mcporter call glm-search.webSearchPrime query="..." 发起检索,返回结构化结果(标题、URL、摘要、网站信息、图标)
显著优点
- 官方背书:直接接入智谱 GLM 生态,模型理解能力与搜索质量有保障
- 实时性强:突破大模型知识截止日期限制,获取最新网络资讯
- 结果结构化:自动提取网页元信息,便于后续处理与引用
- 配置自动化:支持从现有 agent 配置文件智能迁移 API Key,降低配置门槛
- 零依赖安装:基于 npx 的 mcporter 工具,无需全局安装即可使用
潜在缺点与局限性
- 密钥依赖:强制要求智谱 API Key,无免费额度说明,存在使用成本
- 平台锁定:仅支持智谱官方服务,无法切换至其他搜索引擎或 MCP provider
- 网络要求:需稳定连接智谱云端服务,离线环境不可用
- 工具单一:仅提供
webSearchPrime单一工具,无高级筛选(如时间范围、站点限定) - 代理兼容性:HTTP MCP 模式在部分企业代理环境可能需要额外配置
适合人群
- 需要获取实时新闻、热点资讯的内容创作者与分析师
- 开发 AI Agent 需补充外部知识检索能力的工程师
- 使用智谱生态(ChatGLM、GLM-4)寻求原生联网增强的用户
- 对搜索结果结构化质量有要求,希望减少网页清洗工作的场景
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 密钥泄露 | API Key 明文存储于本地配置文件 | 设置文件权限 `chmod 600`,避免提交至版本控制 |
| 搜索结果偏差 | 依赖智谱算法排序,可能存在信息茧房 | 交叉验证多个来源,关键信息人工复核 |
| 服务可用性 | 官方服务端点故障或限流 | 实现调用重试与降级策略 |
| 合规风险 | 搜索内容可能含敏感/版权信息 | 遵守 robots.txt,商业用途确认授权 |
| 成本不可控 | 按调用量计费,高频使用费用累积 | 监控用量,设置预算告警 |
技术规格
- 协议:HTTP MCP(非 stdio)
- 认证:Bearer Token
- 端点:
https://open.bigmodel.cn/api/mcp/web_search_prime/mcp - 官方文档:https://docs.bigmodel.cn/cn/coding-plan/mcp/search-mcp-server