🔧 Claw 安装教程

系统要求

  • Python 3.8 或更高版本
  • pip 包管理工具
  • Git（推荐）
  • 支持 Windows / macOS / Linux

快速安装

使用 pip 一键安装：

pip install claw-core

或通过源码安装：

git clone https://github.com/pyva/claw.git
cd claw
pip install -e .

验证安装

安装完成后，运行以下命令验证：

claw --version

若显示版本号，即表示安装成功 ✅

⚙️ 配置教程

基础配置

首次运行将自动生成配置文件 ~/.claw/config.yaml，关键配置项：

# config.yaml 示例
core:
  log_level: info
  max_workers: 4
plugins:
  enabled:
    - skill_loader
    - auto_update
storage:
  path: ./data
  cache_ttl: 3600

环境变量（可选）

通过环境变量覆盖配置（优先级更高）：

export CLAW_LOG_LEVEL=debug
export CLAW_STORAGE_PATH=/custom/path

插件配置

在 config.yaml 中启用/禁用插件，或动态加载：

# 启用自定义技能插件
plugins:
  custom_skill:
    path: ./my_skills
    auto_reload: true

🎯 技能 Skill

内置技能

Web 抓取 数据解析 定时任务 API 调用 文件处理 日志监控

自定义技能开发

创建 my_skill.py 并继承 BaseSkill：

from claw.skills import BaseSkill

class MySkill(BaseSkill):
    def execute(self, params):
        # 你的逻辑
        return {"result": "success"}

将文件放入 skills/ 目录，Claw 将自动识别加载。

技能调用示例

# 命令行调用
claw run my_skill --param1=value1

# Python 代码调用
from claw import Claw
claw = Claw()
result = claw.execute("my_skill", param1="value1")

🌐 SkillHub

什么是 SkillHub？

SkillHub 是云霄Claw的官方技能市场，提供社区共享的高质量技能插件，支持一键安装、版本管理、依赖自动解析。

浏览与安装技能

# 搜索技能
claw hub search 数据清洗

# 安装技能
claw hub install data-cleaner@1.2.0

# 查看已安装
claw hub list

贡献你的技能

欢迎将你的技能发布到 SkillHub：

  1. 按规范打包技能（含 skill.yaml 描述文件）
  2. 提交到 https://hub.pyva.cn/submit
  3. 通过审核后自动上架

审核标准：功能完整、文档清晰、无隐私收集、兼容主流环境

❓ 常见问题

安装时提示 "Permission denied" 怎么办？

Linux/macOS 用户可尝试：
pip install --user claw-core
或使用虚拟环境隔离安装，避免系统权限问题。

配置文件修改后不生效？

Claw 启动时会缓存配置。修改后请：
① 重启 Claw 进程
② 或添加 --reload-config 参数强制重载

技能执行超时如何处理？

在技能配置中设置 timeout 参数（单位：秒）：

skills:
  my_skill:
    timeout: 120  # 最长执行 2 分钟
超时后自动终止并返回错误，避免阻塞主进程。

如何升级 Claw 到最新版本？

使用 pip 升级：
pip install --upgrade claw-core
升级后建议运行 claw migrate 同步配置格式。

SkillHub 无法连接？

检查：
• 网络是否可访问 hub.pyva.cn
• 是否配置了代理（如需）：
export HTTPS_PROXY=http://proxy:port
• 本地 DNS 解析是否正常

↑