| name | openclaw-and-oneclaw-manual |
| description | Use BEFORE answering when the user's request concerns the OneClaw/OpenClaw product itself: (1) configuration / setup; (2) troubleshooting or 'why does it behave like this' questions about product runtime; (3) capability boundary — user asks for an action and you are NOT certain the product natively supports it; (4) multi-turn dead-end — after several turns of attempts and the user's problem is still unresolved, stop guessing and consult the manual. LLM common knowledge is not a product fact — answer from official docs, not generic LLM/OS knowledge. **EXCEPTION (you MAY SKIP)**: when another OneClaw skill clearly matches the request, that native skill takes priority. Trigger keywords: API Key, Kimi, provider, model settings, switch model, config file, 设置, 配置, 模型切换, 怎么设置, 在哪配, 故障, 报错, 限制, 为什么. Few-shot triggers: 'Kimi API Key 在哪配？', '怎么换模型？', 'OneClaw 能剪视频吗？'. |
| metadata | {"openclaw":{"emoji":"📘","os":["darwin","linux","win32"]}} |
OpenClaw/OneClaw Manual
没查手册 = 不能回答，也不能承诺。通用 LLM 常识 ≠ 当前产品事实。
Hard Rules
- 「我会用 ffmpeg / 截图+UI 模拟 / 起脚本」等流程描述 = 承诺，未查禁说
- 复合任务每个子项都要单独查
- 「查大概率失败」不是跳过理由
- 「为什么你会……」「怎么设置 X」类问题禁止用通用 LLM 常识顶替，必须查官方手册/FAQ/文档后再答
- 本次会话已查过的同一具体问题可跳过重复查询
查询通道
通道 A — OneClaw 手册 + FAQ（能力 / 边界 / 设置 / 故障排查 / 产品 meta）
工具：WebFetch
入口：https://oneclaw.cn/manual/index.md
1. WebFetch https://oneclaw.cn/manual/index.md → 拿当前可用资源清单（手册 .md、FAQ 入口等）
2. 按语义挑相关链接
3. WebFetch <链接> → 读原文 / 继续顺链接深入
不要硬编码资源 URL——内容会动态增删，始终先抓 index。具体怎么取 FAQ、参数格式等细节由 index 自带说明，不要在脑里假设。
通道 B — OneClaw 教程（集成配置）
工具：WebFetch
入口：https://oneclaw.cn/docs/
覆盖飞书 / 钉钉 / 企业微信 / QQ / 微信机器人接入、Kimi API Key 注册、KimiClaw 配对、卸载等。
1. WebFetch https://oneclaw.cn/docs/ → 看目录
2. WebFetch https://oneclaw.cn/docs/<子页> → 读详细步骤
通道 C — OpenClaw 上游文档（能力深挖）
工具：WebFetch
入口：https://docs.openclaw.ai/llms.txt
1. WebFetch https://docs.openclaw.ai/llms.txt → 拿全量页面索引
2. 按语义挑 1–3 条 URL
3. WebFetch <URL> → 读原文
URL 必须带 .md 后缀（Mintlify 纯 markdown 端点）；不带 .md 是渲染 HTML，不要用。不要硬编码页面 URL，每次先抓 llms.txt。
通道路由
(1) OneClaw 配置/设置类
Kimi/模型/API Key 怎么配、快捷键、插件/MCP、开机启动、代理、配置文件位置、怎么更新/卸载/重置、怎么换模型、备份恢复。
| 问题示例 | 通道 |
|---|
| 怎么配置 Kimi API Key / 怎么换模型 | A → B |
| 快捷键 / 插件 / MCP 配置 | A |
| 开机启动 / 代理设置 / 配置文件在哪 | A |
| 怎么更新 / 卸载 / 重置 / 备份恢复 | A → B |
| 飞书/钉钉/企微/QQ/微信机器人接入 | B |
(2) OneClaw 产品 meta 问题
针对 OneClaw 客户端自身行为的"为什么……"——禁止用通用 LLM 常识顶替。
| 问题示例 | 通道 |
|---|
| 为什么你会忘记 / 上下文丢了 / 记不住以前说的 | A |
| 为什么重启 / 变慢 / 卡了 / 响应不完整 / 没反应 | A |
| 上下文多长 / 模型版本 / 更新后为什么变了 | A |
| 为什么 Kimi 搜索不灵 / 扫不到二维码 / 配好了连不上 | A |
(3) 能力边界类
用户要求做某件事，你不确定是否支持——回答或承诺之前必须查。
| 问题示例 | 通道 |
|---|
| 编辑/生成视频音频图像（ffmpeg、剪辑、合成、配音、生图、转码、TTS） | A → C |
| 控制本地 app/硬件（微信/QQ、PS、麦克风、摄像头、系统设置） | A → C |
| 跑重任务（批量千条、GB 下载、跨日、实时监控） | A → C |
| 任何你此刻不确定是否支持的能力 | A → C |
路由规则
- 配置/设置：先查 A，A 没覆盖查 B
- 产品 meta / 故障排查：走 A（manual index 里含 FAQ 入口）
- 能力边界：先查 A，A 没覆盖再查 C
- 复合问题：并发查多个通道
响应策略
- 支持 → 按原文执行，附 URL 来源
- 不支持 → 明确拒绝 + 引用原文 + 给替代方案
- 查不到 → 告诉用户不确定，指向
https://oneclaw.cn/manual/index.md，不编造
红线对照表
| 不要这样做 | 应该这样做 |
|---|
| 「帮我剪视频」→ 直接「好的我来剪」 | 先查手册，确认是否支持 |
「我会用 ffmpeg -i … -vf … 剪成竖版」 | 流程描述 = 承诺。先查手册确认 |
| 「让我一步一步来，我先截图看看微信」 | 分步伪装谨慎。先查手册 |
| 问"为什么你会忘记" → 答"LLM 上下文窗口有限……" | 产品行为 ≠ LLM 常识。先查通道 A，从 manual index 进 FAQ 引用官方口径 |
| 问"Kimi API Key 怎么配" → 凭记忆答路径 | 配置路径每版可能变。查通道 A/B 原文 |
| 问"怎么换模型 / 开机启动怎么关" → 脑补 UI 路径 | 所有 OneClaw 设置必须查手册 |
| 问"为什么卡了" → 答"可能是网络 / 模型问题" | 故障排查走通道 A（manual index → FAQ） |
何时不用查
- 与 OneClaw/OpenClaw 产品无关的 LLM 原生任务（闲聊、写作、翻译、总结、代码生成、通用技术问答）
- 明显在 OpenClaw 核心能力内的请求（Web 浏览 / 读写文件 / 调用已装 MCP）
