KClawKClaw Windows 使用手册
这是一份面向普通用户的 KClaw Windows 版手册。它会说明如何安装、激活、配置模型、使用文件/浏览器/桌面自动化、创建定时任务、管理账号和排查常见问题。
1. 安装与启动
1.1 下载 Windows 安装包
- 打开 KClaw 官网，点击“下载 Windows 版”。
- 确认文件名、版本号和下载来源，避免从陌生渠道安装。
- 双击安装包，根据提示完成安装。
1.2 首次启动
首次启动时，KClaw 会初始化本地工作目录、授权状态和基础配置。如果 Windows 安全中心或杀毒软件弹窗，请确认程序来源后允许运行。
1.3 托盘与窗口
KClaw 会常驻 Windows 任务栏托盘，方便你随时打开窗口、继续对话或管理后台任务。若右键菜单中出现旧名称，通常是 Windows 任务栏缓存或可执行文件资源未刷新，重新安装正式包后一般会更新。
2. 授权与账号
2.1 用户中心
用户中心用于邮箱注册、登录、购买套餐、查看订单和查看授权码。入口是官网顶部的“用户中心”。
2.2 邮箱注册
- 输入邮箱、密码和昵称。
- 点击“邮箱注册”。
- 注册后可以在用户中心创建订单。
2.3 找回密码
点击“找回密码”，系统会生成密码重置链接。生产环境会通过邮箱发送；开发环境可临时显示重置 token 便于测试。
2.4 授权码激活
首次打开客户端时输入授权码。授权码兑换一次后立即作废，后续客户端使用本机授权 token 校验状态。
如果你换电脑或重装系统，需要联系管理员处理授权迁移或重新发码。
3. 模型与联网配置
KClaw 可以连接不同大模型服务。常见配置项包括 API Key、接口地址、模型名称、上下文长度和联网搜索能力。
3.1 选择模型
- 日常问答：选择速度快、成本低的模型。
- 长文档和代码：选择上下文更长、推理更稳的模型。
- 桌面自动化：选择工具调用能力稳定的模型。
3.2 API Key
API Key 是模型服务的访问凭证。不要把它发给别人，也不要截图公开。若怀疑泄露，应到模型服务商后台立即重置。
3.3 联网搜索
当问题涉及新闻、价格、版本、政策、比赛、实时数据时，KClaw 会使用联网搜索获取最新信息。你也可以明确说“联网查一下”。
4. 对话工作流
4.1 推荐提问方式
说清楚目标、材料位置、输出格式和限制条件。例如：
- “读取这个文件夹里的合同，列出风险条款，输出表格。”
- “把这个 Excel 销售数据做成月度趋势分析。”
- “继续修复这个项目，先检查报错，再给我可运行版本。”
4.2 长任务推进
KClaw 可以把复杂任务拆成步骤：先理解上下文，再执行，再验证结果。如果任务中途暂停，下次可以说“继续刚才的任务”。
4.3 输出风格
你可以要求它输出成表格、报告、邮件、脚本、PPT 大纲、待办清单或代码补丁。
5. 文件处理
5.1 支持的常见类型
PDF、Word、Excel、PPT、Markdown、TXT、图片、代码文件、压缩包里的项目文件等。
5.2 常见任务
- PDF 摘要、重点提取、翻译。
- Word 改写、润色、格式建议。
- Excel 清洗、统计、可视化建议。
- PPT 结构优化、演讲稿生成。
- 图片 OCR、说明文案、素材整理。
5.3 修改文件前的备份
涉及覆盖、批量移动、格式转换、代码重构时，建议先让 KClaw 备份原文件。重要项目可以要求“修改前先建时间戳备份”。
6. 代码协作
KClaw 可以读取项目结构、定位报错、修改代码、运行测试、启动本地服务并检查页面效果。
6.1 推荐流程
- 告诉它项目目标或报错现象。
- 让它先检查目录结构和关键文件。
- 修改前要求备份重要文件。
- 修改后运行测试或启动服务验证。
6.2 前端项目
可以让 KClaw 调整页面、组件、样式、响应式布局，并通过浏览器截图检查视觉问题。
6.3 后端项目
可以让 KClaw 增加接口、数据库字段、登录逻辑、支付回调、日志和部署文档。
7. 浏览器自动化
浏览器自动化适合需要真实网页交互的任务，例如登录后台、填表、点击按钮、抓取表格、下载文件、监控页面变化。
7.1 典型用法
- “打开这个网页，帮我整理所有商品价格。”
- “登录后台，导出今天的订单 CSV。”
- “监控这个页面，发现价格变化提醒我。”
7.2 登录和验证码
遇到登录、短信验证码、人机验证时，通常需要你手动完成一次。完成后 KClaw 可以继续后续流程。
7.3 浏览器资料安全
不要让不可信 Skill 或未知脚本读取你的浏览器登录态。只在明确可信的网站和任务中启用自动化。
8. 桌面控制
KClaw 可以像真人一样看屏幕、点按钮、敲键盘、拖文件。它适合执行跨软件流程，例如浏览器下载文件后再用本地软件处理。
8.1 常见场景
- 整理桌面文件夹。
- 批量重命名或移动文件。
- 打开软件完成固定操作。
- 跨网页、WPS、剪映、设计软件等完成流程。
8.2 风险操作确认
删除文件、覆盖文件、提交代码、付款、发送消息等操作，应让 KClaw 明确说明风险并等待你确认。
9. 定时任务与主动巡检
定时任务用于“到时间自动做事”或“定期检查变化”。
9.1 一次性提醒
例如：“今晚 8 点提醒我继续部署 KClaw 服务器。”
9.2 周期任务
例如：“每天早上 9 点检查服务器状态并发日报。”、“每小时检查竞品价格，有变化提醒我。”
9.3 写清任务要求
- 什么时候执行。
- 检查什么对象。
- 什么变化算重要。
- 结果发到哪里。
10. Skills 扩展
Skills 是专项能力包。公开资料显示，龙虾/OpenClaw 系生态里 Skills 常用于浏览器自动化、笔记、日历、邮件、云服务、数据分析等专项任务。
10.1 Skill 能做什么
- 给 KClaw 增加某个软件或平台的操作说明。
- 封装常用流程，比如剪藏网页、整理笔记、导出数据。
- 为团队统一工作规范和输出格式。
10.2 安装注意
只安装可信来源的 Skill。安全研究和社区经验都提醒过：恶意 Skill 可能尝试读取敏感数据或诱导执行危险操作。
10.3 使用方式
安装后直接在对话里描述任务，例如“列出我的笔记”“剪藏这个网页”“把这个数据表做成图”。如果 Skill 需要 CLI 或 API Key，按提示配置。
11. 记忆与上下文
KClaw 可以结合当前会话、项目文件、用户偏好和长期任务记录来理解你的目标。你可以要求它记住称呼、工作习惯、输出格式和项目背景。
如果你不希望某些信息进入长期记忆，可以明确说“这条不要记住”。
12. 远程使用
KClaw 可以通过消息渠道或远程入口接收指令，让你不在电脑旁也能安排任务。例如让它检查文件、运行脚本、生成报告或回传执行结果。
远程使用建议配置允许名单，只允许你自己的账号发送指令。
13. 安全建议
- 不要公开模型 API Key、后台密码、支付密钥。
- 涉及文件删除、覆盖、付款、发消息前先确认。
- 重要文件修改前先备份。
- 安装 Skill 前确认来源可信。
- 服务器后台必须使用 HTTPS。
- 支付回调必须验签，不能只看前端返回。
14. 常见问题
授权码提示已兑换？
授权码是一次性兑换。已兑换的授权码不能再次激活新设备，请联系管理员处理。
忘记用户中心密码？
在用户中心点击“找回密码”。生产环境会通过邮箱发送重置链接；开发环境可临时显示 reset token。
支付后没有收到授权码？
如果支付回调尚未接通，需要管理员在后台确认支付并发码。正式接入支付宝/微信回调后会自动发放。
浏览器自动化卡住？
检查是否有登录、验证码、权限弹窗或页面加载失败。你完成手动验证后，KClaw 可以继续执行。
KClaw 回答不符合你的风格？
直接告诉它你的偏好，例如“回答短一点”“用表格”“别说废话”“先给结论”。
参考来源
本手册参考了 OpenClaw 官方文档中的浏览器、定时任务、自动化说明，以及有道云笔记公开的龙虾 AI Agent Skill 安装指南，并改写为 KClaw Windows 版用户手册。