OpenClaw是奥地利程序员彼得·斯坦伯格开发的开源AI智能体，2025年11月推出，具备本地数据采集、远程控制及多平台自动化任务执行能力，核心架构含Gateway、Agent、Skills和Memory，兼容多系统并支持WhatsApp等交互界面。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将网课截图、PDF讲义或手写笔记自动转化为结构化学习资料，并生成可直接导入Anki的抽认卡，则可能是由于本地AI智能体未正确配置模型调用链路或技能模块缺失。以下是解决此问题的步骤：
一、验证OpenClaw核心服务与模型连通性
该步骤用于确认OpenClaw能否成功访问本地部署的语言模型，这是后续所有自动化处理的前提。若网关无法转发请求至模型服务，解析与卡片生成将完全中断。
1、执行命令检查OpenClaw服务状态：openclaw gateway status
2、运行模型连通性测试：openclaw models test --model glm-4-flash
3、若返回HTTP 502或Connection refused，需检查~/.openclaw/openclaw.json中baseUrl是否指向正确的本地Ollama服务地址（如http://localhost:11434/api）
4、手动验证模型服务是否就绪：curl -X POST http://localhost:11434/api/chat -H "Content-Type: application/json" -d '{"model":"glm-4-flash","messages":[{"role":"user","content":"test"}]}'
二、安装并启用Anki连接技能
该技能负责将模型输出的问答对转换为Anki兼容的CSV或APKG格式，并通过AnkiConnect接口写入本地Anki数据库。缺少此技能将导致流程在最后一步终止，仅生成文本而无实际卡片。
1、执行技能安装命令：clawhub install anki-connector
2、确认Anki已开启AnkiConnect插件（版本≥2.1.0），并在Anki中执行Tools → Add-ons → AnkiConnect → Config，检查"host"为"127.0.0.1"且"port"为8765
3、在OpenClaw配置中添加Anki目标参数：openclaw config set anki.deck "计算机网络"
4、运行一次最小化测试：openclawexec "生成一个关于TCP三次握手的问答对，格式符合AnkiBasic模型"
三、配置文件监听与触发逻辑
该步骤确保PDF、Markdown或截图文件被系统捕获后，能自动触发完整处理流水线。若监听路径错误、扩展名未注册或冷却期设置不当，新文件将被忽略。
1、创建专用学习材料目录：mkdir -p ~/StudyMaterials/Inbox
监控 OpenClaw GitHub 版本更新，获取最新版本发布说明，翻译成中文， 并推送到 Telegram 和 Feishu。用于：(1) 定时检查版本更新 (2) 推送版本更新通知 (3) 生成中文版发布说明
2、安装文件监听技能并指定参数：clawhub install file-watcher --params '{"watchDir":"~/StudyMaterials/Inbox","extensions":[".pdf",".md",".png"],"cooldown":300}'
3、验证监听器是否激活：openclaw skills list | grep file-watcher
4、向Inbox中放入一份测试PDF，观察日志：tail -f ~/.openclaw/logs/file-watcher.log
四、修正Qwen/GLM模型输出格式约束
模型原始输出若不符合Anki字段映射要求（如缺少分隔符、未标注正/背面内容），会导致解析失败或卡片内容错乱。必须通过定制prompt强制规范结构。
1、编辑技能配置文件~/.openclaw/skills/anki-generator/config.json，在prompt字段中插入强制格式指令："请严格按以下格式输出：正面：[问题]；背面：[答案]；标签：[章节名]。每组问答用---分隔。"
2、禁用自由生成模式，在模型参数中设置"temperature": 0.2与"top_p": 0.85
3、对含公式的PDF，预处理时启用LaTeX转义：openclaw config set pdf.preprocessor "latex-safe"
4、测试单次解析效果：openclaw model query --model qwen3-9b --prompt "提取以下文本中的3个术语定义，按前述格式输出：{{CONTENT}}"
五、修复Anki字段映射与标签注入异常
当生成的卡片在Anki中显示为空白、字段错位或标签丢失，说明OpenClaw未正确识别模型输出中的结构标记，或Anki目标模板不匹配。
1、检查当前使用的Anki卡片模板ID：openclaw anki list-models
2、强制指定Basic-zh模型：openclaw config set anki.model "Basic-zh"
3、在~/.openclaw/skills/anki-generator/mapping.json中确认字段映射关系：{"front": "正面：", "back": "背面：", "tags": "标签："}
4、向测试文件末尾追加人工标记行：echo "---正面：什么是CSMA/CD？；背面：载波侦听多路访问/冲突检测，用于以太网介质访问控制；标签：数据链路层" >> test.md
