❓ 常见问题
汇总使用 YingClaw 过程中最常遇到的问题和解答。
安装与启动
Q: 安装失败了怎么办？
请确认 Node.js 版本 ≥ 18，然后重试：
node -v # 检查版本
npm install -g yingclaw # 重新安装
如果仍然失败，可以清理 npm 缓存后再安装：
npm cache clean --force
npm install -g yingclaw
Q: 启动后提示「模型不可用」？
检查网络连通性，确保可以访问所配置的 AI 模型 API。如果是本地模型，确认服务已启动并可访问。
Q: 支持哪些操作系统？
| 系统 | 版本要求 |
|---|---|
| Windows | 10 及以上 |
| macOS | 11 (Big Sur) 及以上 |
| Linux | 主流发行版（Ubuntu 20.04+、Debian 11+） |
功能使用
Q: 记忆数据存储在哪里？
- Windows：
%USERPROFILE%\.YingClaw\workspace\ - macOS / Linux：
~/.YingClaw/workspace/
记忆文件以 MEMORY.md 和 memory/ 目录下的每日笔记形式持久化。
Q: 记忆隐私如何保障？
所有记忆数据仅在本地存储，不会自动上传到任何外部服务器。你可以随时手动编辑或删除记忆文件。
Q: 技能和插件的区别？
技能（Skill）是 YingClaw 的可复用过程化知识模块，包含完整的操作步骤、常见陷阱和验证方法。与代码插件不同，技能侧重于传授 AI 可执行的工作流程。
Q: 定时任务可以并发执行吗？
是的。多个定时任务彼此独立运行，支持设置超时时间和自动禁用条件。
Q: 浏览器自动化需要 GUI 吗？
不需要。YingClaw 内置无头浏览器，可在纯命令行环境（如远程服务器）中正常工作。
代理与编排
Q: 子代理和执行者有什么区别？
- 主代理（你对话的 YingClaw）：负责理解需求、规划任务、分派工作
- 子代理：执行具体子任务，拥有独立的工具集和上下文窗口
子代理工作完成后，结果自动返回给主代理汇总。
Q: 子代理能看到我的记忆吗？
默认情况下，子代理继承核心和用户记忆。如果需要在子代理中隔离特定信息，可以在分派任务时通过 skills 参数限制可用技能范围。
Q: 最多能同时并行多少个子代理？
无硬性上限，实际受模型 API 并发限制和机器资源影响。建议按任务天然的分拆边界合理划分，通常 2-5 个并行最为高效。
安全与权限
Q: YingClaw 会执行危险命令吗？
内置安全策略会自动拦截以下高危操作：
- 递归强制删除（
rm -rf） - 磁盘格式化（
format、mkfs） - 系统盘静默删除
- 注册表修改
对于中等风险操作，会要求明确确认。
Q: 可以限制某些命令的执行吗？
可以通过安全策略配置文件设置命令黑白名单，精确控制可执行的操作范围。
Q: 如何处理敏感信息？
- 凭据、密钥等敏感信息不应存入记忆
- 工具输出的凭据在返回给用户时会自动脱敏
- 建议将 API 密钥等放在
.env文件中，由 YingClaw 安全管理
进阶使用
Q: 如何让 YingClaw 更懂我的项目？
- 将项目决策、编码规范存入
core记忆 - 创建自定义技能封装项目专属工作流
- 通过每日笔记追踪阶段进展
Q: 多项目之间如何切换？
YingClaw 按工作空间（workspace）组织上下文。不同项目可使用不同工作空间，彼此独立。
Q: 支持哪些大模型？
支持通过标准 API 接入的主流大模型，具体取决于你的 API 配置。你可以通过模型路由配置为不同场景指定不同模型。