@ks-ai/web

KSDR 平台的 OpenClaw plugin。打包 5 个 web 相关 skill，对应 KSDR 的 web search / web fetch / general deep research / company deep research / web agent 能力。

Skills

| Skill | 触发场景 | 实现位置 | |---|---|---| | ks-web-search | 搜索网页、查找信息 | skills/ks-web-search/scripts/web_search_api.py | | ks-web-fetch | 抓取网页 / 提取页面内容（含 SPA） | skills/ks-web-fetch/scripts/web_fetch_api.py | | ks-general-deep-research | 行业 / 市场 / 技术 / 政策深度研究报告 | skills/ks-deep-research/scripts/research_api.py | | ks-company-deep-research | 客户拜访 / 竞对分析 / 公司画像 | skills/ks-company-deep-research/scripts/research_api.py | | ks-web-agent | 通用 web 操作（搜索 / 抓取 / 爬虫 / 浏览器自动化），自动积累 sub-web skill | skills/ks-web-agent/scripts/site_skill_client.py |

配置

5 个 skill 共用一个 ksdr API key（KSDR_API_KEY）：

# KClaw 用户：通过 OpenClaw 配置（任何一个 skill 配置都会自动同步到全部 5 处）
openclaw config set skills.entries.ks-web-agent.apiKey "ksdr-xxxx"

# CC 用户：在 shell rc 中
export KSDR_API_KEY="ksdr-xxxx"

安装

KClaw

openclaw plugins install @ks-ai/web
# 或本地 tarball
docker cp ks-ai-web-1.x.x.tgz kclaw-openclaw-gateway-1:/tmp/
docker exec kclaw-openclaw-gateway-1 openclaw plugins install /tmp/ks-ai-web-1.x.x.tgz

CC（Claude Code）

cd ~/.claude/skills
bash /path/to/skills-hub/install-cc.sh
# 装 ks-web-agent；其他 4 个 skill 在 CC 上未走 install-cc.sh 路径
# （SKILL.md 用 {baseDir} 占位符是 OpenClaw 专属约定，CC 端目前仅 ks-web-agent 走 install 路径）

ks-web-agent 独有：sub-web skill 体系

ks-web-agent 是一个"越用越聪明"的 web 操作 skill。它有两类 sub-web skill：

1. 系统 skill：仓库内 skills/ks-web-agent/site-skills/<domain>/，随 npm 包发布。
2. 用户 skill：保存在 ksdr-ksp 服务端，PUT/GET 多版本管理；命中后写入本地数据根缓存。

Stop / 软提示双轨

| Runtime | 触发机制 | 行为 | |---|---|---| | CC | SKILL.md frontmatter hooks.Stop → stop-check-experience.sh | 强阻塞：未沉淀域名第一次 block，第二次自动 pass | | KClaw | web/index.ts 注册 before_prompt_build hook | 软提示：每次 LLM prompt 构建前向 system prompt 注入"⚠️ 未沉淀域名"提醒 |

OpenClaw 的 agent_end hook 是 fire-and-forget（Promise<void> \| void），不能阻塞 agent。所以 KClaw 端不能完全等价 CC Stop hook 的强阻塞语义，改用软提示。详见设计文档（Obsidian）。

数据根目录：${OPENCLAW_STATE_DIR}/data/ks-web-agent/（KClaw）或 ~/.cache/ks-web-agent/（CC），下含 pending/ traffic/ site-skills/ library_outbox/ client.log stop-hook.log。

开发与发布

# 测试 ks-web-agent 单元测试
cd skills/ks-web-agent/scripts && python3 -m pytest test_*.py -v

# 验证 npm pack 文件清单
npm pack --dry-run

# 发布
npm pack
git tag v1.x.x && git push --tags
npm publish --access public

# KClaw 升级
docker exec kclaw-openclaw-gateway-1 openclaw plugins update web

migrate-and-update.sh

帮老用户从 plugin 包内 config.json 迁移到 OpenClaw 全局配置（v1.0.4 引入）。在 KClaw 升级前自动跑：

bash migrate-and-update.sh

加新 skill 时记得同步在 migrate-and-update.sh 里加 openclaw config set skills.entries.<new-skill>.apiKey 一行。

相关文档

• monorepo 总览：../README.md
• AI 协作指南：../CLAUDE.md
• ks-web-agent 设计文档：~/Documents/second_brain/个人/事业/Projects/evo_crawl/ks-web-agent 双 runtime 整合到 skills-hub 设计.md
• ks-web-agent 实施计划：~/Documents/second_brain/个人/事业/Projects/evo_crawl/ks-web-agent 双 runtime 整合到 skills-hub 实施计划.md