OpenClaw Web Search Skills 配置指南

图灵平台在 CławHub 上提供了两个开箱即用的联网搜索 Skill，让 OpenClaw 可以实时检索互联网信息：

Skill	Slug	适用场景
Turing Tavily Web Search	`turing-tavily-web-search`	通用网页搜索、实时资讯、英文优先
Turing Baidu Web Search	`turing-baidu-web-search`	中文网页搜索、百度索引、国内资讯

前置要求

已完成 OpenClaw 基础集成配置
已安装 CławHub CLI：npm install -g clawhub@latest
Python 3 及 requests 包：pip3 install requests

Step 1 — 从 CławHub 安装 Skills

clawhub install turing-tavily-web-search
clawhub install turing-baidu-web-search

安装完成后，两个 Skill 会被放置在 ~/.openclaw/workspace/skills/ 目录下：

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

Step 2 — 配置凭证

打开配置文件 ~/.openclaw/openclaw.json，在顶层添加 skills 配置块：

Web 控制台
手动编辑

运行 openclaw dashboard 打开控制台
左侧菜单选择 Config > Authentication，点击 Raw
在配置编辑器末尾添加以下内容（替换实际密钥），点击 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"
        }
      }
    }
  }

使用编辑器打开配置文件：

nano ~/.openclaw/openclaw.json

在 JSON 顶层添加 skills 字段（与 models、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"
        }
      }
    }
  }
}

环境变量说明

变量	必填	说明
`TURING_API_KEY`	是	图灵平台 API 密钥，格式 `sk-...`，从图灵 Portal 获取
`TURING_CLIENT`	是	客户端标识符，固定填写 `tcl-aigc-portal`
`TURING_ENVIRONMENT`	是	部署环境，固定填写 `live`
`TURING_API_BASE`	否	API 地址，默认 `https://live-turing.cn.llm.tcljd.com`

entries key 的作用

skills.entries 中的 key（即 turing-skills）是 Skills 脚本内部读取配置时使用的固定名称，不可修改。

Step 3 — 验证

重启 OpenClaw 后，运行以下命令验证 Skill 是否正常工作：

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

# 验证百度搜索
python3 ~/.openclaw/workspace/skills/turing-baidu-web-search/scripts.py '{"q": "今日科技新闻"}'

返回包含 results 数组的 JSON 即表示配置成功。

使用示例

Tavily Web Search 参数

参数	类型	必填	默认值	说明
`query`	`str` 或 `list[str]`	是	—	搜索关键词，支持批量查询
`max_results`	`int`	否	`10`	每次查询最多返回条数（1–20）
`max_tokens_per_page`	`int`	否	`1024`	每条结果提取的最大 Token 数
`search_domain_filter`	`list[str]`	否	—	限定搜索域名（最多 20 个）

# 限制结果数量
python3 ~/.openclaw/workspace/skills/turing-tavily-web-search/scripts.py \
  '{"query": "Claude 4 release", "max_results": 5}'

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

Baidu Web Search 参数

参数	类型	必填	默认值	说明
`q`	`str`	是	—	搜索关键词
`count`	`int`	否	`10`	返回结果数量
`search_recency_filter`	`str`	否	—	时效过滤：`week`（7天）/ `month`（30天）/ `semiyear`（180天）/ `year`（365天）

# 最近 7 天的结果
python3 ~/.openclaw/workspace/skills/turing-baidu-web-search/scripts.py \
  '{"q": "中证A50最新消息", "count": 10, "search_recency_filter": "week"}'

常见问题

报错：`TURING_API_KEY must be set`

skills.entries 的 key 不是 turing-skills，或 TURING_API_KEY 值为空。检查 openclaw.json 中 skills.entries.turing-skills.env.TURING_API_KEY 是否正确填写。

报错：`ModuleNotFoundError: No module named 'requests'`

pip3 install requests

报错：`401 Unauthorized`

API 密钥无效或已过期，请到图灵 Portal 重新生成 TURING_API_KEY。

前置要求​

Step 1 — 从 CławHub 安装 Skills​

Step 2 — 配置凭证​

环境变量说明​

Step 3 — 验证​

使用示例​

Tavily Web Search 参数​

Baidu Web Search 参数​

常见问题​

报错：TURING_API_KEY must be set​

报错：ModuleNotFoundError: No module named 'requests'​

报错：401 Unauthorized​

参考资源​