kb-skills/.planning/codebase/INTEGRATIONS.md

External Integrations

Analysis Date: 2026-03-13

APIs & External Services

AI Providers:

• 智谱 AI (Zhipu) - 主要 AI 分析服务

  • SDK: requests HTTP 客户端
  • Auth: AI_API_KEY 环境变量
  • Base URL: https://open.bigmodel.cn/api/paas/v4
  • 模型: glm-5, glm-4

• MiniMax - AI 备选服务

  • SDK: requests HTTP 客户端
  • Auth: AI_API_KEY 环境变量
  • Base URL: https://api.minimaxi.com/anthropic/v1/messages

• OpenAI - AI 备选服务

  • SDK: requests HTTP 客户端
  • Auth: AI_API_KEY 环境变量

• 阿里云通义千问 (Alibaba/Qwen) - AI 备选服务

  • SDK: requests HTTP 客户端
  • Auth: AI_API_KEY 环境变量

视频平台 API:

• Bilibili - 视频/专栏元数据提取

  • SDK: httpx, playwright
  • Auth: BILIBILI_COOKIE 环境变量 (SESSDATA, bili_jct)
  • 文件: kb-bilibili-metadata/bilibili_extractor.py

• 知乎 - 问答/专栏/视频内容

  • SDK: yt-dlp, playwright
  • Auth: ZHIHU_COOKIE 环境变量
  • 文件: kb-zhihu-metadata/zhihu_metadata.py, kb-zhihu-content/zhihu_content.py

• YouTube - 视频内容（通过链接解析）

  • SDK: yt-dlp
  • 文件: kb-link-parser/link-parser.py

• 小红书 - 笔记内容

  • 短链接: xhslink.com
  • 文件: kb-link-parser/link-parser.py

Data Storage

Databases:

• 无数据库 - 所有数据以文件形式存储

File Storage:

• 本地文件系统
  • 工作目录: ~/work/knowledge-base/
  • 结构:
    • pending/ - 待处理链接
    • metadata/ - 元数据 JSON
    • content/downloads/ - 下载的媒体文件
    • analyzed/ - AI 分析报告

归档存储:

• 路径: ~/work/zq/30.资源/AI分析/
• 按日期组织: YYYY-MM-DD/

Caching:

• 模型缓存: ~/.cache/modelscope/hub/ - FunASR 模型

Authentication & Identity

Auth Provider:

• Cookie-based 认证
  • Bilibili: BILIBILI_COOKIE
  • 知乎: ZHIHU_COOKIE

AI API 认证:

• API Key 认证
  • AI_API_KEY - AI 服务密钥
  • HF_TOKEN - HuggingFace Token (说话者分离)

Monitoring & Observability

Error Tracking:

• 无外部监控服务

Logs:

• 控制台输出 - 所有技能通过 print() 输出日志
• 建议使用 python3 -u 禁用缓冲以实时查看输出

CI/CD & Deployment

Hosting:

• Self-hosted (本地服务器)
• 技能部署位置: /home/starmen1265/.openclaw/skills/

CI Pipeline:

• Gitea Actions (self-hosted runner)
  • 配置文件: .gitea/workflows/deploy.yml
  • 触发: push to main
  • 使用 rsync 同步技能目录

Environment Configuration

必须的环境变量:

AI_API_KEY="your-api-key"       # AI 服务密钥
AI_PROVIDER="zhipu"             # 或 openai, minimax, alibaba
AI_MODEL="glm-5"                # 模型名称
AI_BASE_URL="https://..."       # API 地址

可选的环境变量:

BILIBILI_COOKIE="SESSDATA=xxx; bili_jct=xxx"  # B站登录态
ZHIHU_COOKIE="..."                            # 知乎登录态
HF_TOKEN="hf_xxx"                             # HuggingFace Token
KB_GIT_USER="Your Name"                       # Git 提交用户名
KB_GIT_EMAIL="your@email.com"                 # Git 提交邮箱
KB_ARCHIVE_PATH="~/work/zq/30.资源/AI分析"      # 归档目录
KB_GIT_ROOT="~/work/zq"                       # Git 仓库根目录
KB_BASE_PATH="~/work/knowledge-base"          # 知识库基础路径
WHISPER_CPP_PATH="~/whisper.cpp"              # Whisper.cpp 路径

配置文件位置:

• ~/.kb_env - 知识库专用配置（推荐）
• kb-workflow/.env.example - 示例配置

Secrets location:

• 环境变量（明文存储在 ~/.kb_env）
• 无加密/secrets 管理

Webhooks & Callbacks

Incoming:

• 无 Webhook 端点

Outgoing:

• 无主动 Webhook 调用

External Tools

音视频处理:

• ffmpeg / ffprobe - 音视频格式转换和元数据提取
• yt-dlp - 视频下载（知乎视频）

语音识别:

• whisper.cpp - 本地 Whisper 推理
• funasr / modelscope - 阿里 FunASR

浏览器自动化:

• playwright - 无头浏览器
• undetected_playwright - 反检测浏览器

OCR:

• tesseract - OCR 引擎
• easyocr - 深度学习 OCR

会话管理:

• tmux - 终端会话管理（gsd-openclaw）

---

Integration audit: 2026-03-13