openclaw-skills/skills/kb-workflow/SkillBug.md

SkillBug.md

问题记录

2026-02-10: 子代理权限问题

问题： sessions_spawn 调用子代理时返回 forbidden 错误。

原因： OpenClaw 配置中 allowlist 为空，Python 脚本没有权限调用子代理。

解决方案： 改用 Prompt-based 模式（方案B）。

---

架构重构

之前（Script-based）

kb_workflow.py (Python脚本)
    ↓
sessions_spawn()  # ❌ 失败（脚本没有权限）

之后（Prompt-based）

主代理读取 SKILL.md
    ↓
按照指导调用 sessions_spawn  # ✅ 成功（主代理有权限）

文件变更

文件	变更	说明
SKILL.md	重写	详细定义 workflow 步骤，主代理直接读取执行
kb_workflow.py	简化	保留为辅助工具函数库（查重、归档、Git）
skill_main.py	简化	只做触发检测，返回指导信息
SkillBug.md	更新	记录架构变更

SKILL.md 结构

1. 触发条件
2. 步骤 1: 查重
3. 步骤 2: kb-link-parser
4. 步骤 3: 元数据技能
5. 步骤 4: 内容下载
6. 步骤 5: OCR（30分钟超时）
7. 步骤 6: 深度分析
8. 步骤 7: 归档和 Git
9. 步骤 8: 汇报完成
10. 目录结构
11. 支持平台
12. 注意事项

kb_workflow.py 保留的函数

extract_platform(filename)           # 从文件名提取平台
extract_base_name(filename)          # 从文件名提取基础名称
get_knowledge_base_path()            # 获取知识库根目录
ensure_directories(base_path)        # 确保目录存在
check_duplicate(url)                 # 查重
archive_and_git(analyzed_file)       # 归档和 Git
generate_summary(...)                # 生成汇报

---

2026-02-12: B站视频下载失败 - 403 Forbidden

问题： 使用 kb-bilibili-content 下载视频时返回 403 Forbidden 错误。

原因：

1. 视频可能需要B站会员权限
2. 或者需要登录cookie才能下载
3. 当前未配置 BILIBILI_COOKIE 环境变量

复现场景：

• 链接：https://www.bilibili.com/video/BV1Z9nXzUEhv
• 下载命令：python3 bilibili_content.py --id "BV1Z9nXzUEhv" --type video
• 结果：返回403错误页面，文件只有548字节

影响： 无法进行后续的OCR处理和深度分析

建议解决方案：

1. 配置 BILIBILI_COOKIE 环境变量
2. 或提供cookies文件路径
3. 或跳过OCR步骤，使用元数据+简介进行深度分析

当前进度：

• ✅ 步骤1：环境变量检查完成
• ✅ 步骤2：链接解析成功（bilibili_BV1Z9nXzUEhv）
• ✅ 步骤3：元数据提取成功（标题：新加坡分区漫游指南...）
• ❌ 步骤4：视频下载失败（403）
• ⏸️ 步骤5：OCR处理（阻塞）
• ⏸️ 步骤6：深度分析（阻塞）
• ⏸️ 步骤7：归档（阻塞）