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:
| Skill | Slug | Use Case |
|---|---|---|
| Turing Tavily Web Search | turing-tavily-web-search | General web search, real-time news, English-first |
| Turing Baidu Web Search | turing-baidu-web-search | Chinese web search, Baidu index, domestic content |
Prerequisites
- Completed OpenClaw basic integration setup
- ClawHub CLI installed:
npm install -g clawhub@latest - Python 3 and the
requestspackage:pip3 install requests
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:
- Web Console
- Manual Edit
- Run
openclaw dashboardto open the console - Select Config > Authentication from the left menu, then click Raw
- 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"
}
}
}
}
Open the configuration file with an editor:
nano ~/.openclaw/openclaw.json
Add the skills field at the top level of the JSON object (at the same level as models and agents):
{
"models": { ... },
"agents": { ... },
"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
| Variable | Required | Description |
|---|---|---|
TURING_API_KEY | Yes | Turing Platform API key in the format sk-..., obtained from the Turing Portal |
TURING_CLIENT | Yes | Client identifier; must be set to tcl-aigc-portal |
TURING_ENVIRONMENT | Yes | Deployment environment; must be set to live |
TURING_API_BASE | No | API base URL; defaults to https://live-turing.cn.llm.tcljd.com |
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
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | str or list[str] | Yes | — | Search query; supports batch queries |
max_results | int | No | 10 | Maximum number of results per query (1–20) |
max_tokens_per_page | int | No | 1024 | Maximum number of tokens extracted per result |
search_domain_filter | list[str] | No | — | Restrict 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
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q | str | Yes | — | Search query |
count | int | No | 10 | Number of results to return |
search_recency_filter | str | No | — | Recency 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.