KClaw Help
KClaw 帮助手册
这份手册帮助你快速理解 KClaw Windows 版：如何接入模型、如何激活、如何对话、如何处理文件、如何让它接管浏览器和桌面，以及如何把提醒、巡检、监控交给它长期执行。
快速开始
KClaw 是运行在你 Windows 电脑里的 AI 分身。第一次使用时，建议先接入可用的模型服务，再完成授权激活，最后开始交代任务。
打开 KClaw 后，先进入模型或 API 设置页，选择你的模型供应商，填写服务地址、模型名称和 API Key。保存后先发送一句简单测试，例如“你好，介绍一下你能做什么”，确认模型可以正常回复。
下载安装包后按提示安装。首次使用需要输入授权码，授权码用于兑换本机授权，兑换成功后会生成本机授权状态。
例如：“读一下这个文件夹里的合同，列出风险条款”“打开浏览器导出后台订单”“每天 9 点检查服务器状态”。目标、材料位置、输出格式说得越清楚，执行越稳。
如果你用的是兼容 OpenAI 的模型服务，通常需要准备三项：API Key、Base URL、模型名称。Base URL 填服务商给你的接口地址，模型名称按服务商后台显示填写。API Key 属于敏感信息，只填写在本机客户端里，不要发到聊天窗口、群聊或截图里。
授权码激活
v1.0.3 使用授权码激活。你不需要注册账号，也不需要登录。拿到授权码后，在客户端授权弹窗中输入即可。
激活步骤
- 打开 KClaw 客户端。
- 在授权窗口输入授权码。
- 点击激活，等待系统连接授权服务器校验。
- 提示成功后即可正常使用。
授权码兑换成功后会立即作废，不能再给另一台电脑重复激活。如果你重装系统、换电脑或误删授权状态，需要联系管理员处理迁移或重新发码。
激活失败怎么办
- 提示授权码不存在：检查是否输错字符，尤其是 0/O、1/I 这类相似字符。
- 提示授权码已兑换：说明这个码已经被使用过，需要联系发码方确认。
- 提示网络失败：检查电脑网络、代理、系统时间，以及是否能访问 KClaw 官网。
对话与长任务
KClaw 更适合用目标驱动，而不是只问一句“这个怎么做”。你可以把它当成协作者：告诉它背景、目标、材料位置和期望结果。
推荐表达方式
- “读取这个文件夹里的资料，整理成一份 1000 字摘要，最后列出待确认问题。”
- “继续刚才的部署任务，先检查服务状态，再处理没完成的安装包上传。”
- “看一下这个项目为什么启动失败，修改前先备份重要文件，修完后跑测试。”
长任务怎么推进
复杂工作可以让 KClaw 分阶段完成：先检查、再计划、再修改、最后验证。它会在过程中告诉你当前做到了哪一步，遇到风险时先说明。
文件处理
KClaw 可以处理常见办公文件和项目文件，包括 PDF、Word、Excel、PPT、图片、Markdown、TXT、代码文件等。
| 文件类型 | 常见任务 |
|---|---|
| PDF / Word | 摘要、翻译、改写、合同风险提取、会议材料整理。 |
| Excel | 数据清洗、统计分析、生成表格结论、整理异常项。 |
| PPT | 提炼结构、生成演讲稿、优化页面文案。 |
| 图片 | 识别文字、说明画面、整理素材、辅助生成图标资源。 |
| 代码项目 | 定位报错、修改文件、补测试、启动服务、检查页面效果。 |
文件修改前的备份
如果任务会覆盖文件、批量移动文件、修改代码或替换资源，建议让 KClaw 先建立时间戳备份。这样出问题也能回退。
浏览器自动化
浏览器自动化适合处理真实网页流程，例如打开后台、填写表单、导出数据、监控页面变化、复用已登录状态完成重复操作。
适合的场景
- 登录后台后导出订单、客户或报表。
- 监控某个网页是否更新，发现变化后提醒你。
- 批量填写网页表单，或把网页数据整理成表格。
- 检查官网、后台、帮助手册在不同屏幕尺寸下是否显示正常。
登录和验证码
遇到短信验证码、扫码、人机验证时，通常需要你手动完成一次。完成后，KClaw 可以继续后续流程。
桌面操作
当任务跨越多个软件时，KClaw 可以像真人一样看屏幕、移动鼠标、点击按钮、输入文字、拖动文件，把桌面流程串起来。
适合的场景
- 整理桌面和文件夹。
- 在浏览器下载文件后，用本地软件继续处理。
- 跨 WPS、剪映、设计软件、浏览器等完成固定流程。
- 帮你检查软件设置、状态页面或运行结果。
定时任务与守护
定时任务用于“到时间自动做事”或“持续检查某件事”。这是 KClaw 和普通聊天 AI 拉开差距的核心能力之一。
一次性提醒
例如：“今晚 8 点 05 分提醒我继续服务器部署。”这种任务到点执行一次。
周期性巡检
例如：“每天早上 9 点检查服务器和官网状态”“每小时看一次竞品页面是否更新”“每周五整理本周日报”。
写清任务要求
- 什么时候执行。
- 检查什么对象。
- 什么情况算异常。
- 结果要不要通知你，通知到哪里。
微信 / IM 远程使用
如果你配置了 IM 通道，就可以在手机上给 KClaw 发消息，让电脑端继续处理任务。适合外出时远程安排检查、提醒、查询和轻量执行。
使用建议
- 只绑定你自己的可信账号。
- 远程发高风险指令时，要求 KClaw 先汇报计划。
- 如果回复延迟，先检查电脑端是否在线、IM 通道是否连接、网络是否稳定。
Skill 能力扩展
Skill 是给 KClaw 增加专项能力的扩展包。它可以提供某类软件、平台或任务的操作说明，让 KClaw 在特定领域做得更稳。
Skill 能做什么
- 封装常用流程，例如网页采集、笔记整理、日历处理、云服务检查。
- 统一团队输出格式，例如报告模板、代码规范、排查流程。
- 让 KClaw 理解某个工具或平台的操作边界。
安装建议
只安装来源可信的 Skill。不要随意安装陌生来源的自动化脚本，尤其是会读取文件、浏览器登录态或执行系统命令的扩展。
更新与下载
KClaw 会通过更新服务检查新版本。官网会提供最新安装包下载入口，客户端也可以在支持的版本中收到更新提醒。
下载地址
官网入口：KClaw 官网。如果你需要重新安装，优先从官网下载安装包。
更新失败
- 检查是否能访问官网和更新接口。
- 确认系统时间是否正确。
- 如果下载中断，重新下载安装包覆盖安装即可。
安全与权限
KClaw 能力越强，越需要清楚权限边界。建议你把它当成可信但需要确认的电脑助手。
- 不要公开模型 API Key、服务器密码、后台密码、支付密钥。
- 重要文件修改前先备份。
- 删除、覆盖、发消息、付款、上线部署前先确认。
- 只给可信 Skill 和可信网站授权。
- 服务器后台和授权服务必须使用 HTTPS。
常见问题
为什么授权码用一次就不能再用了？
授权码是一次性兑换凭证。兑换成功后，系统会把它标记为已使用，避免同一个码被多台设备重复激活。
我换电脑了怎么办？
联系管理员处理授权迁移或重新发码。不要把旧授权码反复输入到新设备上。
KClaw 没有马上回复怎么办？
检查电脑端是否在线、模型服务是否可用、网络是否稳定。如果是 IM 通道，还要检查手机和电脑端的通道连接状态。
我不想让它记住某些信息怎么办？
可以明确告诉它“这条不要记住”。涉及隐私、密码、密钥的信息不建议发给模型或写入长期记忆。