重构主控编排与运行时预热链路，统一工作区提示词/专家调度协议并补齐 wiki 记忆注入与写回闭环。

同时收敛启动与运维脚本默认行为（含 wiki worker）、更新 Admin 可观测性与相关测试，降低首轮时延并提高运行稳定性。 Made-with: Cursor
2026-10-18 17:13:25 +08:00 · 2026-04-26 08:34:33 +08:00 · 2026-04-26 08:34:33 +08:00 · dbbe3add6a
commit dbbe3add6a
parent 4a23b715a2
14438 changed files with 2693620 additions and 2546 deletions
--- a/openclaw/extensions/tavily/skills/tavily/SKILL.md
+++ b/openclaw/extensions/tavily/skills/tavily/SKILL.md
@ -0,0 +1,94 @@
+---
+name: tavily
+description: Tavily web search, content extraction, and research tools.
+metadata:
+  { "openclaw": { "emoji": "🔍", "requires": { "config": ["plugins.entries.tavily.enabled"] } } }
+---
+
+# Tavily Tools
+
+## When to use which tool
+
+| Need                         | Tool             | When                                                          |
+| ---------------------------- | ---------------- | ------------------------------------------------------------- |
+| Quick web search             | `web_search`     | Basic queries, no special options needed                      |
+| Search with advanced options | `tavily_search`  | Need depth, topic, domain filters, time ranges, or AI answers |
+| Extract content from URLs    | `tavily_extract` | Have specific URLs, need their content                        |
+
+## web_search
+
+Tavily powers this automatically when selected as the search provider. Use for
+straightforward queries where you don't need Tavily-specific options.
+
+| Parameter | Description              |
+| --------- | ------------------------ |
+| `query`   | Search query string      |
+| `count`   | Number of results (1-20) |
+
+## tavily_search
+
+Use when you need fine-grained control over search behavior.
+
+| Parameter         | Description                                                           |
+| ----------------- | --------------------------------------------------------------------- |
+| `query`           | Search query string (keep under 400 characters)                       |
+| `search_depth`    | `basic` (default, balanced) or `advanced` (highest relevance, slower) |
+| `topic`           | `general` (default), `news` (real-time updates), or `finance`         |
+| `max_results`     | Number of results, 1-20 (default: 5)                                  |
+| `include_answer`  | Include an AI-generated answer summary (default: false)               |
+| `time_range`      | Filter by recency: `day`, `week`, `month`, or `year`                  |
+| `include_domains` | Array of domains to restrict results to                               |
+| `exclude_domains` | Array of domains to exclude from results                              |
+
+### Search depth
+
+| Depth      | Speed  | Relevance | Best for                                     |
+| ---------- | ------ | --------- | -------------------------------------------- |
+| `basic`    | Faster | High      | General-purpose queries (default)            |
+| `advanced` | Slower | Highest   | Precision, specific facts, detailed research |
+
+### Tips
+
+- **Keep queries under 400 characters** — think search query, not prompt.
+- **Break complex queries into sub-queries** for better results.
+- **Use `include_domains`** to focus on trusted sources.
+- **Use `time_range`** for recent information (news, current events).
+- **Use `include_answer`** when you need a quick synthesized answer.
+
+## tavily_extract
+
+Use when you have specific URLs and need their content. Handles JavaScript-rendered
+pages and returns clean markdown. Supports query-focused chunking for targeted
+extraction.
+
+| Parameter           | Description                                                        |
+| ------------------- | ------------------------------------------------------------------ |
+| `urls`              | Array of URLs to extract (1-20 per request)                        |
+| `query`             | Rerank extracted chunks by relevance to this query                 |
+| `extract_depth`     | `basic` (default, fast) or `advanced` (for JS-heavy pages, tables) |
+| `chunks_per_source` | Chunks per URL, 1-5 (requires `query`)                             |
+| `include_images`    | Include image URLs in results (default: false)                     |
+
+### Extract depth
+
+| Depth      | When to use                                                 |
+| ---------- | ----------------------------------------------------------- |
+| `basic`    | Simple pages — try this first                               |
+| `advanced` | JS-rendered SPAs, dynamic content, tables, embedded content |
+
+### Tips
+
+- **Max 20 URLs per request** — batch larger lists into multiple calls.
+- **Use `query` + `chunks_per_source`** to get only relevant content instead of full pages.
+- **Try `basic` first**, fall back to `advanced` if content is missing or incomplete.
+- If `tavily_search` results already contain the snippets you need, skip the extract step.
+
+## Choosing the right workflow
+
+Follow this escalation pattern — start simple, escalate only when needed:
+
+1. **`web_search`** — Quick lookup, no special options needed.
+2. **`tavily_search`** — Need depth control, topic filtering, domain filters, time ranges, or AI answers.
+3. **`tavily_extract`** — Have specific URLs, need their full content or targeted chunks.
+
+Combine search + extract when you need to find pages first, then get their full content.