龙虾新手指南：从零开始学AI

1. 什么是YOYO Claw？

YOYO Claw（代号“龙虾”）是荣耀推出的终端侧AI智能体，不是概念演示，而是已落地的本地AI运行时。它直接集成在荣耀MagicBook系列笔记本中，把PC变成能理解、能协作、能执行的“Partner Creator”。

它不依赖持续联网，所有核心推理都在设备端完成；Agent设计面向真实工作流，不是玩具模型。

2. 为什么用YOYO Claw？

本地推理，不上传数据

YOYO Claw的模型和推理引擎全部跑在本地。文档、代码、会议录音、截图——所有输入都不离开设备。响应延迟低至毫秒级，断网时照样工作。

多端一致，非简单移植

PC和Pad共用同一套Agent Runtime。同一个会议纪要虾，在笔记本上听语音，在平板上同步标注PPT，上下文自动延续，不是两个独立App。

预置5个高频Agent，开箱即用

每个Agent解决一个具体问题，接口统一，无需调参：

• 文档理解虾：支持PDF、Word、Markdown，提取关键结论+生成问答对
• 代码辅助虾：接入本地VS Code插件，补全基于你项目里的函数和注释
• 会议纪要虾：实时转写+区分发言人+自动标记待办项（如“@张三 3天内提交方案”）
• 多模态摘要虾：拖入一张截图+一段语音+一份Excel，输出交叉分析摘要
• 个性化工作流虾：用自然语言定义规则，比如“每周五下午3点，汇总钉钉未读消息+飞书日程，生成周报草稿”

3. 安装和配置

系统要求

• Windows 10 22H2+ 或 macOS 13.0+
• Intel Core i5-1135G7 / AMD Ryzen 5 5600U 起（需支持AVX2）
• 8GB RAM（推荐16GB）
• 10GB 可用空间（含模型缓存）

下载安装包

官网地址：https://yoyoclaws.ai
下载后校验SHA256（安装包页面底部提供）：

sha256sum YOYO_Claw_Installer.exe
# 应与官网公示值一致

运行安装

Windows双击安装包，macOS拖入Applications文件夹。安装过程自动检测显卡驱动并部署对应推理后端（DirectML / Metal）。

初始配置

首次启动弹出向导，只需三步：

• 选设备类型（PC/PAD，影响UI密度和快捷键）
• 设定默认语言（中/英，影响所有Agent的输出风格）
• 开关隐私选项（如是否允许会议纪要虾访问麦克风，默认关闭）

命令行配置（可选）：

yoyoclaws --configure --device=pc --lang=zh --mic=off

启动Agent

Agent按需加载，不常驻内存：

# 启动文档理解虾，处理PDF
yoyoclaws --start agent:document_understanding --file ~/report.pdf

# 启动代码辅助虾（监听当前目录）
yoyoclaws --start agent:code_assistant --watch .

# 启动会议纪要虾（录音+实时转写）
yoyoclaws --start agent:meeting_summary --record --mic=system

4. 实际怎么用

快速吃透一份PDF报告

yoyoclaws --start agent:document_understanding \
  --file "Q3财报.pdf" \
  --output summary.md \
  --focus "营收增长原因|风险提示"

输出summary.md里只有两节：用3句话说清增长逻辑，用表格列出3条具体风险及原文页码。

写Python脚本时实时纠错

在VS Code中装好YOYO Claw插件，打开data_clean.py，光标停在pd.read_csv()后，按Ctrl+Shift+Y：

• 自动补全路径（基于当前项目文件结构）
• 检测到encoding='utf-8'但文件含中文乱码，提示改用gbk
• 发现后续有df.dropna()但没处理空列，建议加how='all'

开会时自动生成带行动项的纪要

yoyoclaws --start agent:meeting_summary \
  --record \
  --endpoints "10:00-10:45,11:00-11:30" \
  --actionables

录音分段处理，输出Markdown含：

• 时间戳锚点（点击跳转录音位置）
• 所有“请XX负责…”语句自动转为待办项，带截止时间建议

5. 验证是否正常

查看运行状态

yoyoclaws --status
# 输出示例：
# document_understanding: idle (last run: 2min ago)
# code_assistant: active (PID: 12489, GPU: 32%)
# meeting_summary: stopped

查日志定位问题

# 查最近100行错误日志
yoyoclaws --logs --level=error --tail=100

# 查某Agent完整日志
yoyoclaws --logs --agent=code_assistant

功能快速验证

# 测试多模态摘要虾（用一张截图+一段文本）
yoyoclaws --start agent:multimodal_summary \
  --file ~/screenshot.png \
  --text "这个界面按钮位置不合理，用户反馈点击率下降20%"

预期输出：指出截图中哪个按钮区域最可能被误触，并关联文本给出优化建议。

6. 常见问题

安装失败：提示“GPU驱动不兼容”

→ 进入设备管理器，更新显卡驱动到最新版（Intel需≥31.0.101.4888，AMD需≥23.Q3.1）
→ 或强制使用CPU后端：yoyoclaws --install --backend=cpu

Agent启动后立即退出

→ 检查yoyoclaws --logs --level=error，常见原因是模型文件损坏
→ 删除~/.yoyoclaws/models/目录，重启Agent自动重下

文档理解虾卡在“解析中”

→ PDF含扫描图片？该Agent不处理OCR，需先用系统自带“照片”App转文字
→ 文件超50MB？拆分后分别处理，或用--pages=1-10指定范围

7. 接下来做什么

• 看源码：OpenClaw SDK已开源（https://github.com/openclaw/sdk），所有Agent协议定义在/proto/agent.proto
• 改行为：修改~/.yoyoclaws/config.yaml里的prompt_template字段，调整文档理解虾的摘要风格
• 写新Agent：用Python实现符合AgentInterface的类，放入~/.yoyoclaws/agents/，重启即可调用

别被“AI”吓住——YOYO Claw本质是个工具链。它不教你怎么思考，只帮你把重复动作自动化。先跑通一个Agent，再换下一个。