离线操作手册

XiaoJuclaw 使用手册

按当前 1.3.1 界面重新编写:从首次启动、平台通道到任务运行中心,每一章都配有刚从真实软件页面截取的界面图。截图使用隔离演示数据,不包含真实用户资料、API Key 或验证码。

19 张当前界面图 16 个操作章节 可搜索 可打印 / 保存 PDF

建议从这里开始

10 分钟完成首次使用

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

1启动并进入工作区

登录已有账号;只想先体验时可用“游客登录 · 免费试用”。

2确认平台通道

平台额度可直接使用;也可以配置自带 API Key。

3完成一次短对话

先发送一句低成本测试,再处理长文档或自动化任务。

4选择创作搭档

按任务所需能力选择角色,不必先创建“万能员工”。

5检查任务运行

长任务与自动化执行统一到任务运行中心查看。

6退出后做一次备份

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

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

第 1 章

启动并进入工作区

正式账号使用手机号和密码;第一次体验可直接进入游客工作区。

Windows 安装版

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

U 盘便携版

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

离线版

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

XiaoJuClaw 登录页面 1 2 3
登录页:点击图片可以放大。界面可能随版本微调,以实际按钮文字为准。
  1. 输入手机号和密码。已有账号直接登录;不要在公共电脑保存账号信息。
  2. 第一次体验可选“游客登录 · 免费试用”。游客工作区适合熟悉界面,不要放入正式客户资料。
  3. 登录页仍可打开设置与使用手册。遇到网络问题时,先看诊断信息,不要连续重复登录。
出现 Windows“未知发布者”时,只使用官方交付文件并核对 SHA-256。不要关闭 Defender,也不要运行来源不明或哈希不一致的文件。

界面在哪里放了什么

侧栏按四个分区归类,先认分区再找功能。

创作空间

聊天、创作搭档(管理数字员工)。

自动化

今日经营、任务(已派出去的活跑得怎么样)、定时安排(按计划自动执行)、工作流。

知识与能力

学习与记忆、知识库、长期记忆、技能市场。

左下角账号区域

设置、帮助与诊断、使用手册、反馈、退出登录,以及登录后的“积分与充值”。这些都不在侧栏列表里。

桌面版侧栏底部还有“悬浮提醒窗”开关。找不到某个功能时,先按上面四个分区对一遍,再看是不是在账号区域的菜单里。

第 2 章

选择平台通道或自带 API Key

优先保证任务能正常完成,再根据成本、隐私和模型能力选择通道。

模型设置页面 1 2 3
路径:左下角账号区域 → 设置 → AI 能力 → 文本模型。
  1. 打开“设置 → AI 能力 → 文本模型”。页面会把可用方式分为平台通道和自带 API Key。
  2. 优先试用平台通道。无需管理密钥,消耗会按页面显示的积分和模型规则结算;代理分润或结算异常不会阻断用户调用模型。
  3. 需要自主管理时选择“自带 API Key”。按服务商文档填写接口地址、模型 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. 从设置左栏切换分类。常规、AI 能力、浏览器、成长与记忆和帮助诊断分别管理不同能力。
  2. 先设置语言和外观。主题改变不会影响数据;高对比度或缩放应以实际阅读舒适为准。
  3. 谨慎启用开机启动。定时安排依赖程序运行,但不需要的设备不要长期后台启动。
找不到功能时先看侧栏分区,再看左下角账号区域。运行日志和使用手册不在侧栏列表中。

第 5 章

在聊天中把要求说清楚

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

聊天页面 1 2 3 4
聊天页支持选择员工、添加附件、语音输入和多轮任务。

第一次进来会多两样东西

顶部一条告知横幅

讲三件默认行为:助手会记住你的偏好(默认开启,可查可删可关)、长任务在“任务”里跑不刷屏聊天、每个员工擅长的活不一样。每条后面有链接直达对应页面。点“知道了”或 × 关掉后不再出现。

输入框上方的示例卡

“试试这些”几张卡,点一下就把请求填进输入框。示例按当前员工真正开放的能力筛选,换员工会变;卡角小标签表示这条示例需要哪项能力。不想用就直接说你的需求。

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

第 6 章

管理和创建数字员工

聊天与工作流负责“做什么”,侧栏“创作空间 → 创作搭档”负责“由谁做、用什么模型和技能”。

创作搭档管理页面 1 2 3
内置员工按岗位隔离工作区、技能和记忆。
  1. 点击“+”创建员工。先用一句话写岗位,再用 AI 优化人设。
  2. 选择已有员工。办公、财务、电商、客服等员工职责不同。
  3. 在详情区检查模型、技能和人设。新员工先用非敏感小任务测试。

挑员工时先看卡上这两样

代表任务

这位员工日常真正在做的活。财务、人事、客服三位开放的能力完全相同,只有代表任务能把他们区分开。

能力标签

如“知识库”“生图与视频”“定时任务”“看图理解”。没有标签的能力就是他用不了——财务、人事、客服、闲鱼客服都没有生图和视频,别指望他们出图。

聊天页选择员工的下拉里显示同样的能力标签,选之前可以直接比。
不要把财务、删除、发货和外部发布等全部权限集中给一个“万能员工”。职责越清楚,错误越容易发现。

第 7 章

建立可引用的知识库

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

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

第 8 章

运行并检查工作流

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

工作流列表页面 1 2 3
每条工作流显示步骤数、节点类型和执行员工。
任务运行中心页面 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. 逐步开放操作。填写、上传、发送和发布前检查页面目标与内容;付款、删除和验证码必须人工完成。
网页内容可能包含诱导指令。不要让网页文本改变你的权限边界,也不要把密码、Cookie、验证码或密钥粘贴进聊天。

第 11 章

配置语音、图片和视频

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

AI 能力总览页面 1 2 3 4
AI 能力总览把文本、图像、视频和语音分卡展示,可分别配置。
  1. 打开“设置 → AI 能力”。页面上四张卡(文本、图像、视频、语音)分别显示各自是否已配好。
  2. 点开要配的那张卡,选“连接服务商”。先挑服务商,再填你自己的 API Key;接口地址通常自动带出,除非服务商要求才改。
  3. 勾选这个账号要承担的能力,并为每项选模型。语音识别、语音合成、图片和视频可以分开配,也可以由同一个账号一起承担。
  4. 做一次连接检测再完成。检测免费、不产生生成内容;通过后卡片状态才会变成已配好。
语音卡里还有一处“高级设置 · 自定义模型 ID”,只在服务商文档明确支持时才用。生成内容仍需检查版权、肖像和平台规则。
图片和视频通常按张/条收费。不要用生产素材做第一次连通测试。

第 12 章

技能与记忆

三处都在侧栏“知识与能力”分区:技能市场决定员工会怎样做,长期记忆保存长期事实,学习与记忆管它自己学到的东西。

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

学习与记忆:助手学到了什么

侧栏“知识与能力 → 学习与记忆”,也可以从设置里的“成长与记忆”打开同一份内容。

学习与记忆页面 1 2 3
学习开关、已记住的内容和可管理的经验集中在同一页。
这项功能默认是开着的。助手会从你的使用和纠正中积累内容。页面上每一条都能单独查看和删除,顶部两个开关随时可关。
你的偏好

你明确告诉过它的做法。

长期记忆

它自己记住的关于你和业务的信息,可搜索、可编辑原文。

反馈教训与工具经验

你点踩并说明原因后形成的调整,以及它用工具总结出的经验。

  1. “让助手从使用中学习”开关。关掉后不再学新内容;已经记住的不会被删除,要清理得自己删。
  2. “高级学习”开关(默认开启)。额外总结“成长阶段”和“它学会的做法”,依赖本机组件、仅在本机运行;本机没有该组件时它不运行,不影响基础学习。
所有记忆与经验只保存在本机,不会上传服务器。第一次进入聊天时那条告知横幅里的“我会记住你的偏好”,指的就是这个页面。

第 13 章

账号、积分与平台模型

登录后的账号菜单提供积分、充值和权益入口;游客或离线状态会隐藏不可用项。

左下角账号菜单 1 2
点击左下角账号区域打开菜单;具体项目随登录状态和版本能力显示。
平台模型离线状态页面 1 2 3
未登录或云端不可用时,平台通道会明确显示不可用,不影响已配置的本地能力。
  1. 点击左下角账号区域。设置、帮助与诊断、使用手册和退出登录都从这里进入。
  2. 登录后查看积分与充值。页面显示当前积分、消费记录和可用权益;实际扣费以调用结果和账单记录为准。
  3. 平台通道不可用时先看状态。可以稍后重试或切换自带 API Key;结算后台异常不应影响已成功发起的用户模型调用。
当前真实边界:游客截图只用于展示菜单结构,不代表已拥有积分或在线权益。充值、兑换和设备绑定都应在确认账号后操作。

第 14 章

查看日志并排查问题

入口:左下角账号区域 →“帮助与诊断”→“查看运行日志”。侧栏里没有“日志”这一项,只能从这里进。先记录时间和操作,再从同一时间点找错误。

帮助与诊断设置页面 1 2 3
帮助与诊断页先给出环境和连接状态,再提供日志入口。
日志页面 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 分钟后的一次性任务。
  • 如使用浏览器协作,已用测试页面验证连接与人工确认边界。
  • 如使用平台通道,已核对积分展示与一次最小消耗记录。
  • 能找到运行日志(账号区域 → 帮助与诊断 → 查看运行日志)和本手册。
  • 知道助手默认会学习并记住偏好,也知道在“学习与记忆”页可以查看、删除和关闭。
  • 退出软件并完成一次完整数据目录备份。
第三方模型、搜索、媒体和浏览器页面可能接收任务输入。只提供完成任务所需的最少数据,并遵守客户授权、隐私、版权和平台规则。
放大的软件界面截图