OpenClaw Skills Clawdbot文档专家（Clawdbot Documentation Expert）技能使用参考手册

概述

Clawddocs 是 Clawdbot 的文档专家技能，它提供了决策树导航、搜索脚本、文档获取、版本跟踪和配置片段功能，能够帮助用户导航、理解和配置 Clawdbot 的所有功能，涵盖提供商、网关、自动化、平台和工具等各个方面。

技能信息

• 名称：clawddocs
• 描述：Clawdbot 文档专家，具备决策树导航、搜索脚本、文档获取、版本跟踪功能，同时提供所有 Clawdbot 功能的配置片段
• 版本：1.2.2
• 作者：NicholasSpisak
• 许可证：MIT

👤 作者：NicholasSpisak
🦞 官方地址：https://clawhub.ai/NicholasSpisak/clawddocs
👉 Skills 下载地址：clawddocs-1.2.2.zip

快速开始

当用户询问关于 Clawdbot 的问题时，首先需要确定他们的需求：

🎯 决策树

• "我如何设置 X？" → 查看providers/或start/目录
  • Discord、Telegram、WhatsApp 等 → 查看providers/<名称>
  • 首次使用 → 查看start/getting-started、start/setup
• "为什么 X 无法工作？" → 查看故障排除相关内容
  • 通用问题 → 查看debugging、gateway/troubleshooting
  • 提供商特定问题 → 查看providers/troubleshooting
  • 浏览器工具问题 → 查看tools/browser-linux-troubleshooting
• "我如何配置 X？" → 查看gateway/或concepts/目录
  • 主配置 → 查看gateway/configuration、gateway/configuration-examples
  • 特定功能 → 查看相关的concepts/页面
• "X 是什么？" → 查看concepts/目录
  • 架构、会话、队列、模型等相关内容
• "我如何自动化 X？" → 查看automation/目录
  • 定时任务 → 查看automation/cron-jobs
  • Webhooks → 查看automation/webhook
  • Gmail → 查看automation/gmail-pubsub
• "我如何安装 / 部署？" → 查看install/或platforms/目录
  • Docker → 查看install/docker
  • Linux 服务器 → 查看platforms/linux
  • macOS 应用 → 查看platforms/macos

可用脚本

所有脚本都位于./scripts/目录下：

核心脚本

./scripts/sitemap.sh # 按类别显示所有文档
./scripts/cache.sh status # 检查缓存状态
./scripts/cache.sh refresh # 强制刷新站点地图缓存

搜索与发现

./scripts/search.sh discord # 按关键词查找文档
./scripts/recent.sh 7 # 查看最近N天更新的文档
./scripts/fetch-doc.sh gateway/configuration # 获取特定文档

全文索引（需要 qmd 工具）

./scripts/build-index.sh fetch # 下载所有文档
./scripts/build-index.sh build # 构建搜索索引
./scripts/build-index.sh search "webhook retry" # 语义搜索

版本跟踪

./scripts/track-changes.sh snapshot # 保存当前状态
./scripts/track-changes.sh list # 显示所有快照
./scripts/track-changes.sh since 2026-01-01 # 查看指定日期之后的变更

文档分类

🚀 入门指南 (/start/)

首次设置、入门引导、常见问题、向导

🔧 网关与操作 (/gateway/)

配置、安全、健康检查、日志、Tailscale、故障排除

💬 提供商 (/providers/)

Discord、Telegram、WhatsApp、Slack、Signal、iMessage、Microsoft Teams

🧠 核心概念 (/concepts/)

代理、会话、消息、模型、队列、流式传输、系统提示

🛠️ 工具 (/tools/)

Bash、浏览器、技能、反应、子代理、思考工具

⚡ 自动化 (/automation/)

定时任务、Webhooks、轮询、Gmail 发布 / 订阅

💻 命令行工具 (/cli/)

网关、消息、沙箱、更新命令

📱 平台 (/platforms/)

macOS、Linux、Windows、iOS、Android、Hetzner

📡 节点 (/nodes/)

摄像头、音频、图像、位置、语音

🌐 网页端 (/web/)

网页聊天、仪表盘、控制界面

📦 安装 (/install/)

Docker、Ansible、Bun、Nix、更新

📚 参考 (/reference/)

模板、RPC、设备模型

配置片段

你可以在./snippets/common-configs.md中找到现成的配置模板：

提供商设置

Discord

{
  "discord": {
    "token": "${DISCORD_TOKEN}",
    "guilds": {
      "*": {
        "requireMention": false
      }
    }
  }
}

Telegram

{
  "telegram": {
    "token": "${TELEGRAM_TOKEN}"
  }
}

WhatsApp

{
  "whatsapp": {
    "sessionPath": "./whatsapp-sessions"
  }
}

网关配置

{
  "gateway": {
    "host": "0.0.0.0",
    "port": 8080
  }
}

代理默认设置

{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-sonnet-4-5"
    }
  }
}

定时任务

{
  "cron": [
    {
      "id": "daily-summary",
      "schedule": "0 9 * * *",
      "task": "summary"
    }
  ]
}

工作流程

1. 确定需求：使用上面的决策树确定用户的需求
2. 搜索文档：如果不确定，使用./scripts/search.sh <关键词>进行搜索
3. 获取文档：使用./scripts/fetch-doc.sh <路径>或者浏览器获取指定文档
4. 参考配置片段：使用snippets/目录中的配置示例
5. 引用源 URL：在回答用户问题时，引用文档的源 URL

使用技巧

• 尽可能使用缓存的站点地图（TTL 为 1 小时）
• 对于复杂问题，使用全文索引进行搜索
• 使用recent.sh查看最近更新的文档
• 提供snippets/目录中的特定配置片段
• 文档链接格式：https://docs.clawd.bot/<路径>

示例交互

用户："如何让我的机器人只在 Discord 中被 @时才响应？" 你：

1. 获取providers/discord文档
2. 找到requireMention设置
3. 提供配置片段：

{
  "discord": {
    "guilds": {
      "*": {
        "requireMention": true
      }
    }
  }
}

1. 链接：https://docs.clawd.bot/providers/discord

用户："文档有什么更新？" 你：

1. 运行./scripts/recent.sh 7
2. 总结最近更新的页面
3. 询问用户是否需要深入了解某个特定更新

工具代码说明

search.sh（文档关键词搜索脚本）

#!/bin/bash
## 按关键词搜索文档
if [ -z "$1" ]; then
  echo "用法: search.sh <关键词>"
  exit 1
fi
echo "正在搜索包含关键词的文档: $1"
## 完整版本中，该脚本会搜索全文索引

sitemap.sh（文档站点地图生成脚本）

#!/bin/bash
## 站点地图生成器 - 按类别显示所有文档
echo "正在获取Clawdbot文档站点地图..."
## 基于docs.clawd.bot的分类结构
CATEGORIES=(
  "start"
  "gateway"
  "providers"
  "concepts"
  "tools"
  "automation"
  "cli"
  "platforms"
  "nodes"
  "web"
  "install"
  "reference"
)
for cat in "${CATEGORIES[@]}"; do
  echo "📁 /$cat/"
done

track-changes.sh（文档变更跟踪脚本）

#!/bin/bash
## 跟踪文档的变更
case "$1" in
  snapshot)
    echo "正在保存当前状态..."
    ;;
  list)
    echo "正在显示所有快照..."
    ;;
  since)
    echo "显示$2之后的变更..."
    ;;
  *)
    echo "用法: track-changes.sh {snapshot|list|since <日期>}"
    ;;
esac

build-index.sh（全文索引管理脚本）

#!/bin/bash
## 全文索引管理（需要qmd工具）
case "$1" in
  fetch)
    echo "正在下载所有文档..."
    ;;
  build)
    echo "正在构建搜索索引..."
    ;;
  search)
    shift
    echo "正在语义搜索: $*"
    ;;
  *)
    echo "用法: build-index.sh {fetch|build|search <查询内容>}"
    ;;
esac

cache.sh（文档缓存管理脚本）

#!/bin/bash
## Clawdbot文档的缓存管理
case "$1" in
  status)
    echo "缓存状态: 正常（1小时TTL）"
    ;;
  refresh)
    echo "正在强制刷新缓存..."
    ;;
  *)
    echo "用法: cache.sh {status|refresh}"
    ;;
esac

fetch-doc.sh（特定文档获取脚本）

#!/bin/bash
## 获取特定文档
if [ -z "$1" ]; then
  echo "用法: fetch-doc.sh <文档路径>"
  exit 1
fi
echo "正在获取文档: https://docs.clawd.bot/$1"

recent.sh（最近更新文档查看脚本）

#!/bin/bash
## 查看最近更新的文档
DAYS=${1:-7}
echo "最近$DAYS天更新的文档"
## 完整版本中，该脚本会查询变更跟踪记录

元数据信息

技能元数据

{
  "ownerId": "kn7fqcj9ymcpkc1b7z4rsrm50h7ywvxc",
  "slug": "clawddocs",
  "version": "1.2.2",
  "publishedAt": 1768244234558
}

包信息

{
  "name": "clawddocs",
  "version": "1.2.2",
  "description": "Clawdbot文档专家，具备决策树导航、搜索脚本、文档获取、版本跟踪功能，同时提供配置片段",
  "main": "SKILL.md",
  "keywords": ["clawdbot", "documentation", "help", "docs"],
  "author": "NicholasSpisak",
  "license": "MIT"
}