真实界面截图 · 完全离线可看

跟着图片操作,完成你的第一个数字员工任务

本手册不是功能名词清单。每一章都对应当前软件界面,并用红色编号标出点击位置。截图使用隔离演示数据,不包含真实用户资料或密钥。

16 张真实界面图 16 个操作章节 可搜索 可打印 / 保存 PDF

建议从这里开始

10 分钟完成首次使用

第一次不要配置全部功能,只走通下面 6 步。

1启动并选择模式

安装版从桌面打开;便携版运行 Start-XiaoJuClaw.bat。

2配置一个模型

先用一句“请回复配置成功”确认模型可用。

3填写经营画像

告诉软件你做什么、服务谁、目标和红线。

4选择一张任务卡

从低风险任务开始,例如邮件、周报或文案。

5检查并采用结果

重点核对数字、日期、价格、承诺和外部事实。

6退出后做一次备份

完整复制用户数据目录,不要只复制数据库文件。

人工确认红线:付款、退款、发布、删除、改价、发货、登录验证等动作,不要直接交给 AI 无人审核执行。

第 1 章

启动、登录与离线使用

先确认你拿到的是安装版、U 盘便携版还是离线版。

Windows 安装版

从桌面或开始菜单打开,适合固定电脑长期使用。

U 盘便携版

完整解压后双击 Start-XiaoJuClaw.bat,不要只复制一个 EXE。

离线版

无需云账号;若配置在线模型,该模型服务仍会联网。

XiaoJuClaw 登录页面 1 2 3 4
登录页:点击图片可以放大。界面可能随版本微调,以实际按钮文字为准。
  1. 选择手机号或邮箱。输入可接收验证码的账号;昵称可不填。
  2. 点击“获取验证码”。收到后输入验证码完成登录;验证码过期需重新获取。
  3. 云端不可用时选择离线使用。本地聊天、知识库等仍可用,激活和云端能力暂不可用。
  4. 登录前也能打开设置和使用手册。先看手册或先配置模型都可以。

兑换激活码与管理设备

激活码与设备管理页面 1 2 3 4
激活权益仅在线上版且云端可达时生效;离线版不需要激活。
  1. 从侧栏打开“激活与设备”。先确认当前登录的是准备长期使用的账号。
  2. 输入激活码并兑换。兑换前确认套餐、有效期和目标设备。
  3. 检查权益或积分显示。续费、升级和积分包不是同一种商品,以页面实际权益为准。
  4. 查看设备绑定。更换长期使用设备前先阅读购买说明或联系售后。
出现 Windows“未知发布者”时,只使用官方交付文件并核对 SHA-256。不要关闭 Defender,也不要运行来源不明或哈希不一致的文件。

第 2 章

配置聊天模型

没有可用模型,聊天、工作流和经营简报都无法生成结果。

模型设置页面 1 2 3
路径:左下角账号区域 → 设置 → 模型。
  1. 打开“模型”页。左侧红色高亮表示当前设置分类。
  2. 确认当前模型。内置模型是否可用取决于当前版本和账号权益。
  3. 添加自定义模型。按服务商文档填写接口地址、模型 ID 和 API Key,保存后选为当前模型。
测试方法

进入聊天发送“请只回复:配置成功”。短消息成功后再执行长文档或工作流。

常见错误

401/403:Key、地址或权限错误;429:限流或余额不足;超时:网络或服务商异常。

API Key 保存在本机用户数据目录,当前不是系统级加密保险箱。不要发送 secrets.json,也不要把生产 Key 留在公共电脑。

第 3 章

用“今日经营”安排一天

这里是“一人公司”的每日入口,不是营收看板。

今日经营页面 1 2 3 4
截图使用虚构的“青禾内容工作室”演示画像,不包含真实经营数据。
  1. 从侧栏进入“今日经营”。顶部可看到工作流、自动化、计划和已知 AI 费用。
  2. 点击“生成经营简报”。系统只使用已确认画像和本地状态;未接入的营收、订单不会被猜测。
  3. 优先完成前三项行动。点击行动卡再进入对应功能,不要同时铺开十多个任务。
  4. 编辑经营画像。至少填写业务、产品、客户、渠道、当前目标和人工确认红线。
原始画像保存在本机;点击“生成经营简报”时,本页所示画像摘要会发送给你选择的模型服务商。建议写“本周交付 3 份方案”这类可验收目标,不要只写“把业务做好”。

第 4 章

从数字员工任务卡开始工作

任务卡是最适合新用户的入口:选场景、填资料、执行。

数字员工任务卡页面 1 2 3
数字员工页面包含普通任务卡与自动流水线。
  1. 先按业务分类筛选。办公、电商、创作、财务、人事、客服、研究和闲鱼分别显示相关任务。
  2. 自动流水线是多步骤任务。执行后进入工作流详情,可以查看每一步和失败原因。
  3. 普通卡是单次交付。打开卡片,按表单提供主题、资料、语气、格式和验收标准。
任务卡不会自动知道你电脑外部的订单、价格、客户或政策。必须通过表单、附件、知识库或已授权工具提供。

第 5 章

在聊天中把要求说清楚

一个可执行请求应包含目标、资料、限制、输出格式和验收标准。

聊天页面 1 2 3 4
聊天页支持选择员工、添加附件、语音输入和多轮任务。
  1. 新建或选择对话。不同客户/项目建议分开对话,避免上下文混淆。
  2. 输入完整要求。示例:“整理附件会议记录,输出决策、负责人、截止日、待确认项;不补写原文没有的事实。”
  3. 添加附件并选择员工。图片需要视觉模型,录音需要先配置语音识别。
  4. 发送后等待完成。长任务可要求先建立计划;遇到付款、发布、删除时要求暂停。
反馈时说明具体问题,例如“价格写错”“引用不是来自附件”。不要把密码、验证码或临时密钥写进长期记忆。

第 6 章

管理和创建数字员工

任务卡负责“做什么”,Agents 页面负责“由谁做、用什么模型和技能”。

Agents 数字员工管理页面 1 2 3
内置员工按岗位隔离工作区、技能和记忆。
  1. 点击“+”创建员工。先用一句话写岗位,再用 AI 优化人设。
  2. 选择已有员工。办公、财务、电商、客服等员工职责不同。
  3. 在详情区检查模型、技能和人设。新员工先用非敏感小任务测试。
不要把财务、删除、发货和外部发布等全部权限集中给一个“万能员工”。职责越清楚,错误越容易发现。

第 7 章

建立可引用的知识库

把产品手册、报价、制度和 FAQ 交给员工,并要求回答注明来源。

知识库页面 1 2
支持 txt、md、pdf、docx,单文件上限以界面提示为准。
  1. 点击“上传文档”。等待解析完成;不要上传不需要处理的客户秘密。
  2. 先搜索一个原文关键词。确认文档可检索,再到聊天中要求“只根据知识库回答并列出来源”。
扫描图片型 PDF 可能没有可提取文字。当前不要假设所有扫描件都能自动 OCR,必要时先转换为可复制文本。

第 8 章

运行并检查工作流

工作流把重复业务拆成可见、可恢复的步骤。

工作流列表页面 1 2 3
每条工作流显示步骤数、节点类型和执行员工。
  1. 展开流程查看完整步骤。确认它是否会调用工具、AI 或专用员工。
  2. 点击“运行”并填写输入。先用少量真实数据验证,不要直接做大批量。
  3. 打开运行历史。失败时查看具体步骤,修复模型、网络、输入或权限后再点续跑。
不要连续重复点击“运行”,否则可能产生多次模型费用。已修改过流程定义的旧运行可能需要重新发起。

第 9 章

创建定时任务

让指定员工按间隔、日周月或指定时间执行任务。

创建定时任务页面 1 2 3 4 5 6
路径:定时任务 → 左上角“+”。
  1. 点击“+”。打开创建表单。
  2. 填写名称和说明。名称要能看出执行频率和目的。
  3. 选择员工并写完整提示词。明确输入来源、输出格式和禁止事项。
  4. 选择间隔、Cron 或一次性。第一次建议设置 5 分钟后的一次性任务。
  5. 选择结果投递。可只保存记录,或推送到已配置渠道。
  6. 创建后检查运行记录。连续失败应先停用,避免重复消耗。
本机调度限制:计划时间到达时 XiaoJuClaw 必须正在运行,电脑不能关机或休眠。

第 10 章

接入消息渠道

先用测试账号或测试群完成收发验证,再接真实客户。

渠道设置页面 1 2 3
路径:设置 → 渠道。不同平台所需凭据以平台后台为准。
  1. 点击“+”添加渠道。选择平台并按表单填写机器人或应用凭据。
  2. 在渠道列表检查状态。一个平台可以有多个实例,名称要便于区分。
  3. 选择实例查看详情。按“收文字 → 发文字 → 发图片/文件”的顺序测试。
平台权限、限流和风控优先于软件。登录、扫码、验证码和安全确认必须由人完成,不要自动绕过。

第 11 章

配置语音、图片和视频

聊天模型与媒体模型是不同能力,需要单独配置和测试。

语音与媒体设置页面 1 2 3 4
截图中的接口地址是服务商预设示例,API Key 为空。
  1. 选择服务商预设。预设只负责填入推荐地址和模型,仍需你自己的账号。
  2. 填写接口和 API Key。确保服务商账号有相应能力和余额。
  3. 勾选要应用的能力。语音识别、语音合成、图片和视频可分开配置。
  4. 点击“一键应用”后逐项测试。生成内容仍需检查版权、肖像和平台规则。
图片和视频通常按张/条收费。不要用生产素材做第一次连通测试。

第 12 章

技能与记忆

技能决定员工会怎样做,记忆保存长期事实和偏好。

技能页面 1 2 3 4
技能页面:查看已安装技能、搜索和新建技能。
  1. 在“已安装”与市场之间切换。先用内置技能,不要为了数量安装无关技能。
  2. 按岗位搜索。例如文档、表格、电商或研究。
  3. 新建或导入前检查来源。第三方技能可能包含工具和外部依赖。
  4. 打开技能卡查看说明。只给员工启用工作真正需要的技能。
记忆页面 1 2
记忆页面:右上角编辑,正文保存长期共用事实。
  1. 点击编辑维护长期记忆。及时更新旧报价、联系人和错误偏好。
  2. 只保存稳定事实。密码、验证码、银行卡和临时密钥不要写入记忆。

第 13 章

卡密库与闲鱼辅助发货

先建立 SKU 和库存,再由闲鱼客服员工按唯一订单号辅助领取。

卡密库页面 1 2 3 4
截图中的商品与兑换码均为演示数据。
  1. 点击“新建商品”。创建稳定的 SKU 编码、商品名和交付模板。
  2. 检查可发库存。正式使用前先导入少量测试码。
  3. 使用商品右侧操作导入或清理库存。卡密通常一行一条。
  4. 在发货台账对账。同一订单号会做幂等控制,避免重复领取不同卡密。
当前真实边界:这不是闲鱼平台无人值守全托管。软件不会自动感知真实订单或自动发送闲鱼消息,卖家仍需核对订单、SKU 和买家状态;退款、纠纷及实物物流必须人工处理。

第 14 章

查看日志并排查问题

先记录时间和操作,再从同一时间点找错误。

日志页面 1 2 3
日志截图来自隔离演示环境,只包含启动和演示数据记录。
  1. 按日期、分类和级别筛选。模型问题看 Agent/工具调用,定时问题看定时任务。
  2. 搜索错误文字或时间。常见状态:401/403 凭据,429 限流,timeout 超时。
  3. 展开相关行查看详情。联系售后时提供版本、时间、操作步骤和脱敏日志。
软件打不开

确认已完整解压、便携目录齐全、磁盘可写;检查安全软件隔离记录。不要反复删除用户数据目录。

聊天没有回复

检查当前模型、接口地址、Key、模型 ID、余额、限流和网络。

工作流长时间运行

打开运行详情看当前步骤,不要连续重复点击运行。

定时任务没有执行

确认软件当时在运行、电脑未休眠、时区正确、任务已启用。

不要把 secrets.json、完整数据库、完整卡密、验证码或未脱敏客户资料发给售后。

第 15 章

备份、恢复与安全升级

程序可以替换,用户数据绝不能被升级包覆盖。

XiaoJuClaw\程序文件;完整包升级时可以替换。
XiaoJuClawRuntime\随包工具;完整包升级时可以替换。
XiaoJuClaw-User-Guide\图文操作手册;完整包升级时应同步替换。
XiaoJuClawData\Key、聊天、知识库、任务和工作区;永远保留。

正确备份

  1. 等待聊天、工作流和定时任务结束。
  2. 退出主窗口和悬浮提醒窗,确认两个 XiaoJuClaw 进程都已结束。
  3. 便携版复制整个 XiaoJuClawData;安装版在“设置 → 环境”查看实际数据路径。
  4. 把备份保存到另一块磁盘,并标注日期与版本。

完整包升级

  1. 先完成备份。
  2. 用新包覆盖 XiaoJuClaw、XiaoJuClawRuntime 和 XiaoJuClaw-User-Guide。
  3. 保留原 XiaoJuClawData,启动后检查 Key、聊天、知识库和任务。
不要在软件运行时只复制 XiaoJuClaw.db。SQLite 可能同时使用 -wal 和 -shm 文件,单独复制可能得到不完整备份。

第 16 章

安全边界与第一天验收

完成下面清单后,再接真实客户、生产 Key 和正式渠道。

必须人工确认的动作

资金与承诺

付款、退款、转账、开票、赔偿、价格和时效承诺。

外部与破坏性动作

发布、改价、发货、删除、库存清零和批量修改。

账号与隐私

扫码、验证码、风控、客户资料、完整卡密和商业机密。

第一天验收清单

  • 能够启动并确认版本与交付形态。
  • 登录或离线模式已说明清楚。
  • 模型短消息测试成功。
  • 经营画像使用真实但非秘密的信息。
  • 至少完成一张低风险任务卡。
  • 上传一份测试知识文档并能检索。
  • 运行一条工作流并看懂步骤状态。
  • 创建一个 5 分钟后的一次性任务。
  • 如使用渠道,已在测试会话验证收发。
  • 如使用卡密库,已用测试 SKU 和测试订单验证。
  • 能找到日志和本手册。
  • 退出软件并完成一次完整数据目录备份。
第三方模型、搜索、媒体和消息渠道可能接收任务输入。只提供完成任务所需的最少数据,并遵守客户授权、隐私、版权和平台规则。
放大的软件界面截图