Skip to main content

OpenClaw Web Search Skills Configuration Guide

The Turing Platform provides two ready-to-use web search Skills on ClawHub, enabling OpenClaw to retrieve real-time information from the internet:

SkillSlugUse Case
Turing Tavily Web Searchturing-tavily-web-searchGeneral web search, real-time news, English-first
Turing Baidu Web Searchturing-baidu-web-searchChinese web search, Baidu index, domestic content

Prerequisites


Step 1 — Install Skills from ClawHub

clawhub install installs skills into the ./skills directory within the current directory. To match the paths used throughout this guide, switch to your OpenClaw workspace directory before installing:

cd ~/.openclaw/workspace
clawhub install turing-tavily-web-search
clawhub install turing-baidu-web-search

After installation, both Skills will be located under ~/.openclaw/workspace/skills/:

~/.openclaw/workspace/skills/
├── turing-tavily-web-search/
│ ├── SKILL.md
│ └── scripts.py
└── turing-baidu-web-search/
├── SKILL.md
└── scripts.py

Step 2 — Configure Credentials

Open the configuration file ~/.openclaw/openclaw.json and add a skills block at the top level:

  1. Run openclaw dashboard to open the console
  2. Select Config > Authentication from the left menu, then click Raw
  3. Append the following content to the configuration editor (replace the placeholder key values), then click Save → Update
"skills": {
"entries": {
"turing-skills": {
"env": {
"TURING_API_KEY": "sk-xxxx",
"TURING_API_BASE": "https://live-turing.cn.llm.tcljd.com",
"TURING_CLIENT": "tcl-aigc-portal",
"TURING_ENVIRONMENT": "live"
}
}
}
}

Environment Variable Reference

VariableRequiredDescription
TURING_API_KEYYesTuring Platform API key in the format sk-..., obtained from the Turing Portal
TURING_CLIENTYesClient identifier; must be set to tcl-aigc-portal
TURING_ENVIRONMENTYesDeployment environment; must be set to live
TURING_API_BASENoAPI base URL; defaults to https://live-turing.cn.llm.tcljd.com
About the entries key

The key under skills.entries (i.e., turing-skills) is a fixed name used internally by the Skills scripts when reading configuration. Do not change it.


Step 3 — Verify

After restarting OpenClaw, run the following commands to verify that the Skills are working correctly:

# Verify Tavily search
python3 ~/.openclaw/workspace/skills/turing-tavily-web-search/scripts.py '{"query": "OpenAI latest news"}'

# Verify Baidu search
python3 ~/.openclaw/workspace/skills/turing-baidu-web-search/scripts.py '{"q": "今日科技新闻"}'

A JSON response containing a results array indicates that the configuration is successful.


Usage Examples

Tavily Web Search Parameters

ParameterTypeRequiredDefaultDescription
querystr or list[str]YesSearch query; supports batch queries
max_resultsintNo10Maximum number of results per query (1–20)
max_tokens_per_pageintNo1024Maximum number of tokens extracted per result
search_domain_filterlist[str]NoRestrict results to specific domains (up to 20)
# Limit number of results
python3 ~/.openclaw/workspace/skills/turing-tavily-web-search/scripts.py \
'{"query": "Claude 4 release", "max_results": 5}'

# Filter by domain
python3 ~/.openclaw/workspace/skills/turing-tavily-web-search/scripts.py \
'{"query": "transformer architecture", "search_domain_filter": ["arxiv.org"]}'

Baidu Web Search Parameters

ParameterTypeRequiredDefaultDescription
qstrYesSearch query
countintNo10Number of results to return
search_recency_filterstrNoRecency filter: week (7 days) / month (30 days) / semiyear (180 days) / year (365 days)
# Results from the past 7 days
python3 ~/.openclaw/workspace/skills/turing-baidu-web-search/scripts.py \
'{"q": "中证A50最新消息", "count": 10, "search_recency_filter": "week"}'

Troubleshooting

Error: TURING_API_KEY must be set

The key under skills.entries is not turing-skills, or the TURING_API_KEY value is empty. Check that skills.entries.turing-skills.env.TURING_API_KEY is correctly set in openclaw.json.

Error: ModuleNotFoundError: No module named 'requests'

pip3 install requests

Error: 401 Unauthorized

The API key is invalid or expired. Regenerate TURING_API_KEY from the Turing Portal.


Reference Resources