# Openclaw And Oneclaw Manual

> 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 能剪视频吗？'.

- Skill: `oneclaw/openclaw-and-oneclaw-manual` (Agent Skill)
- Install (CLI): `npx skillmds@latest add oneclaw/openclaw-and-oneclaw-manual`
- Raw SKILL.md: https://api.skillmd.com/api/skills/oneclaw/openclaw-and-oneclaw-manual/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: oneclaw (https://skillmd.com/u/oneclaw)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/oneclaw/openclaw-and-oneclaw-manual

---


# OpenClaw/OneClaw Manual

没查手册 = 不能回答，也不能承诺。通用 LLM 常识 ≠ 当前产品事实。

## Hard Rules

1. 「我会用 ffmpeg / 截图+UI 模拟 / 起脚本」等流程描述 = 承诺，未查禁说
2. 复合任务每个子项都要单独查
3. 「查大概率失败」不是跳过理由
4. 「为什么你会……」「怎么设置 X」类问题禁止用通用 LLM 常识顶替，必须查官方手册/FAQ/文档后再答
5. 本次会话已查过的**同一具体问题**可跳过重复查询

## 查询通道

### 通道 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）