核心用法
Clawdbot Documentation Expert 是 Clawdbot 官方文档查询助手,采用纯 Bash 脚本实现,帮助用户快速导航、理解和配置 Clawdbot 系统。核心功能包括:
1. 智能决策树:根据用户提问类型自动路由到对应文档路径——安装部署问 install/ 或 platforms/,故障排查问 debugging/ 或 gateway/troubleshooting,配置问题问 gateway/ 或 concepts/,自动化需求问 automation/ 等。
2. 文档检索工具集:提供 ./scripts/search.sh 关键词搜索、./scripts/fetch-doc.sh 精确获取、./scripts/sitemap.sh 全站浏览、./scripts/recent.sh 更新追踪,以及 ./scripts/build-index.sh 语义搜索能力。
3. 配置示例库:内置 snippets/common-configs.md 提供即用的 Provider 配置(Discord/Telegram/WhatsApp 等)、Gateway 配置、Agent 默认值、重试策略、Cron 任务模板。
4. 版本追踪:./scripts/track-changes.sh 支持快照保存、变更对比,便于掌握文档演进。
显著优点
- 官方权威:Clawdbot 官方维护,文档与系统版本实时同步,信息准确度高
- 零依赖轻量:纯 Bash 实现,无第三方依赖,兼容性好,启动快
- 离线友好:1 小时 TTL 智能缓存机制,常用文档可本地查阅
- 结构化导航:14 个文档分类覆盖从入门到生产的完整生命周期
- 安全透明:代码完全可读,无混淆,网络行为单一明确
潜在局限
- 功能单一:仅限文档查询与检索,无法直接操作 Clawdbot 运行时
- 搜索依赖索引:语义搜索需预先运行
./scripts/build-index.sh fetch下载全站文档,首次使用有初始化成本 - Bash 环境依赖:Windows 用户需 WSL 或 Git Bash 支持
- License 未声明:当前未明确开源许可证,商业使用需确认
适合人群
- Clawdbot 新用户:快速上手配置与部署
- 自托管用户:查阅 Linux/macOS/Docker 平台部署指南
- 开发者:查询 Provider 集成、Agent 概念、自动化 API 等技术细节
- 运维人员:利用变更追踪掌握功能更新
常规风险
该 Skill 已通过 S+ 级安全认证,风险极低:
- 网络仅访问
docs.clawd.bot官方 HTTPS 端点 - 本地文件操作限于
~/.cache/clawddocs/缓存目录 - 不收集、不上传用户敏感信息
- 建议定期清理过期缓存:
./scripts/cache.sh refresh