从配置修复到生产级架构：搜索 Agent 云天眼的完整演进实录

一个配置错误引发的全链路架构升级，成长为生产级检索执行器

梦行志收录于码艺轩・以技立身，实干谋生

2026-07-20 约 2432 字预计阅读 5 分钟

/images/Code-Art-Studio-images/search-scout-yuntianyan-evolution/search-scout-yuntianyan-evolution.webp

从配置修复到生产级架构：搜索 Agent 云天眼的完整演进实录

起因：一个配置错误

2026 年 7 月 20 日，在一次例行运维检查中，发现 search-scout-yuntianyan（信息搜索师云天眼）在 openclaw.json 中存在两个注册错误，导致 Gateway 无法正常启动：

tools.profile 被误写为 "default"——OpenClaw 只允许 "minimal"、"coding"、"messaging"、"full" 四种 profile，"default" 直接导致验证失败
workspace 路径指向 agency-agents/——未遵循标准命名规范 workspace-{agent-id}/

修复三部曲：修正 profile 为 "messaging"、重设 workspace 路径、迁移所有人格文件至标准目录，清理旧目录后重启验证通过。

能力扩充：技能与工具的全面升级

基础修复只是开始。真正的重头戏是对 agent 能力的全面扩充——从最初的 7 项技能扩展到 21 项，工具从 9 个增加到 16 个。

搜索能力矩阵

搜索类型	新增技能	覆盖平台
通用搜索	`agent-reach`	小红书、Twitter、B站、Reddit、V2EX 等 13 平台
网页抓取	`bb-browser`、`browser-use`、`jina-reader`	36 平台 CLI，反爬能力
学术搜索	`sn-search-academic`	ArXiv、PubMed、Wikipedia
代码搜索	`sn-search-code`	GitHub、Stack Overflow、Hacker News
图片搜索	`sn-search-image`	Serper.dev
通用搜索	`web-search`	DuckDuckGo
深度研究	`sn-dimension-research` 等 4 项	多维度研究流水线
分析框架	`hv-analysis`、`wolfram-alpha`	横纵分析法、知识图谱

工具与 MCP

新增 7 项工具：sessions_yield、image、memory_search、memory_get、brave-search 系列、firecrawl。其中 firecrawl 从禁用状态启用，与 brave-search 和 chrome-devtools 构成三大 MCP 服务。

配置层面同步升级：tools.profile 从 "messaging" 调整为 "coding"（更匹配检索执行器的工具需求），新增 model 主模型 sensenova/deepseek-v4-flash 及 4 个 fallback 模型。

架构升级：从搜索助手到生产级检索执行器

如果说前面的修复和扩充是"换零件"，那接下来的架构升级就是"重构引擎"。在 GROK 和 GPT 两轮深度建议下，agent 的整个运行范式被重新定义。

GROK 建议落地

三个关键改变：

输出模板升级：从 P-XXX（选品原型卡）升级为 E-XXX（通用检索证据卡），更贴合搜索场景
工具触发规则化：9 种工具各附触发条件，不再靠优先级堆砌
补充完整规范链：查询规则、去重规则、证据强度判定标准、失败分型

GPT 建议落地：三项关键决策

决策 1：移除质量裁决字段 E-XXX 卡不再包含 evidence_strength / verification_status 这类主观评级字段，改为客观采集状态：retrieval_status、access_mode、content_location、extraction_method、source_relation。证据评级交给下游的 source-auditor Agent 去完成——谁采集谁负责客观记录，谁审计谁负责质量判断，职责分离。

决策 2：任务契约 + 三文件交付 引入 YAML 格式的任务契约，每次任务交付三件套：

task_contract.yaml  →  task_id / query_seeds / platform_scope / time_scope / locale / max_records / output_dir
manifest.json      →  任务元数据 + 执行摘要
records.jsonl      →  逐条检索记录（JSONL 格式）
results.md         →  人类可读的检索报告

输出目录按 task_id 命名：outputs/search/YYYY-MM-DD/SRCH-YYYYMMDD-NNN/

决策 3：检索预算 / 缓存 / 审计日志 引入三个生产级必备机制：

检索预算：max 5 query seeds / 3 variants per seed / 10 candidate URLs per query / 20 fetched pages / 30 max records
缓存指纹：SHA256 fingerprint + 6h/24h/30d 分级缓存 TTL
审计日志：query_log.jsonl + run_summary，每次检索可追溯

其他规范补充

查询策略矩阵：6 种任务类型（官方/新闻/商品/讨论/公司/学术）各附工具优先级和参数预设
字段可用性机制：found / unavailable / not_public / blocked / not_applicable
数据清洗边界：明确的允许/禁止清单
访问合规：robots.txt 尊重、限速、不绕过访问控制

最终状态

经过一天的完整治理，云天眼的最终配置状态如下：

{
  "id": "search-scout-yuntianyan",
  "name": "信息搜索师云天眼",
  "workspace": "~/.openclaw/workspace-search-scout-yuntianyan",
  "model": {
    "primary": "sensenova/deepseek-v4-flash",
    "fallbacks": [
      "longcat/LongCat-2.0",
      "sapiens/agnes-2.0-flash",
      "zai/glm-4.7-flash",
      "freellmapi/auto"
    ]
  },
  "skills": 21,
  "tools": { "profile": "coding", "alsoAllow": 16 },
  "subagents": { "model": "sensenova/deepseek-v4-flash" }
}

文件清单

核心规范文件 AGENTS.md（6665 bytes）和 TOOLS.md（7096 bytes）是本次升级的精华交付，完整定义了任务契约、E-XXX 卡、检索预算、缓存策略和审计日志的全套规范。

待办与展望

本次升级留下了几个 P1 待办项：

search-index.jsonl 缓存索引入口：需要在 workspace 创建实际索引文件，将缓存策略落地
schemas/ 目录：将 records.jsonl / manifest.json 的 schema 拆出独立文件，方便复用
平台别名表：如"小红书" = xiaohongshu / xhs 等映射，统一查询参数
错误码映射表：各工具错误码 → 失败分型映射，标准化失败处理

这些将在后续迭代中逐步补齐。

参考来源

OpenClaw 官方文档：Gateway 配置参考
GROK 架构建议：检索 Agent 输出模板设计
GPT 架构建议：任务契约与三文件交付机制
agent-reach 技能文档：13 平台多后端路由

关联阅读

[[2026-07-01-1916-为Agent统一补充中文名称与Emoji|为Agent统一补充中文名称与Emoji]]
[[2026-06-08-1802-视觉设计师云天光图片技能配置|视觉设计师云天光图片技能配置记录]]
[[2026-06-27-0837-skill-factory转发kb-writer任务模式|Skill Factory 转发 kb-writer 任务模式]]
[[新建Agent操作手册|新建 Agent 操作手册]]

–全文完–

若你有故事想讲、有困惑想聊、或是想找个人说说心里话，甚至只是吐槽发泄一下情绪，都欢迎来找我聊聊：　　　《内容已折叠，点击展开》

希望我写的每一个字，成为我自己和某个人活下去、拼下去的力量。　　　　　　　　　　　　　　　　　　　　　《内容已折叠，点击展开》

“技术终归是工具，而我们一次次认真把问题理顺，守住的其实不只是页面样式和代码输出，还有那一点不愿被混乱打败的心气，是每一个深夜仍愿点灯前行的人。”

转载请注明来自https://oklife.me。