OpenClaw Skill 大全：从零开始掌握核心技能与实战避坑指南

2次阅读

共计 1471 个字符，预计需要花费 4 分钟才能阅读完成。

最近帮同事排查一个 OpenClaw 爬虫卡死的问题：项目用 异步抓取 + 同步存储 组合，每秒 200 个请求直接把 MySQL 拖垮。更典型的是另一个案例——开发者用 递归解析 处理分页，结果遇到深度 100+ 的目录结构直接爆栈。这些问题的本质都是 对技能特性理解不足导致的组合失误。

import openclaw as oc

# 推荐：异步请求模板（自动重试 3 次）async def fetch(url):
    claw = oc.AsyncClaw(retry=3)
    # 注意！timeout 必须小于框架默认的 60s
    return await claw.get(url, timeout=30)

协同用例 ：搭配 缓存技能 可减少重复请求

# 缓存技能组合（redis 过期时间 1 小时）@oc.cache_skill(ttl=3600, backend='redis')
async def fetch_with_cache(url):
    return await fetch(url)

典型误用：
– 错误：在协程内用 requests.get() 导致事件循环阻塞
– 修正：所有 IO 操作必须使用 AsyncClaw

# 自动识别网页结构（优先尝试 XPath）data = oc.parse_skill(html)
              .extract('//div[@class="price"]')
              .first()  # 取第一个匹配项

性能对比：
| 解析方式 | 10 万次操作耗时 |
|—————-|—————-|
| 正则表达式 | 2.3s |
| parse_skill | 1.7s |

# 协程池控制（最大并发 50）async with oc.ConcurrentSkill(workers=50) as pool:
    tasks = [pool.submit(fetch, url) for url in urls]
    results = await asyncio.gather(*tasks)

事件循环原理：
1. 每个 worker 对应一个协程槽位
2. 就绪协程通过 epoll 事件驱动切换
3. 遇到 await 主动让出执行权

# 根据状态码重试（502 重试 5 次）@oc.retry_skill(
    retries=5,
    conditions={502: True, 404: False}  # 404 不重试
)
async def fetch_retry(url):
    return await fetch(url)

共享资源必须用 LockSkill 装饰
数据库连接池大小不超过max_connections*0.8
避免在技能内修改全局变量

try:
    await risky_operation()
except oc.NetworkError as e:
    await oc.alert_skill(f"网络异常: {e}")
except Exception as e:
    oc.log_skill.error(f"未知错误: {e}")
    raise  # 关键错误必须终止流程