XiaoJuclaw 使用手册
按当前 1.3.1 界面重新编写:从首次启动、平台通道到任务运行中心,每一章都配有刚从真实软件页面截取的界面图。截图使用隔离演示数据,不包含真实用户资料、API Key 或验证码。
建议从这里开始
10 分钟完成首次使用
第一次不要配置全部功能,只走通下面 6 步。
登录已有账号;只想先体验时可用“游客登录 · 免费试用”。
平台额度可直接使用;也可以配置自带 API Key。
先发送一句低成本测试,再处理长文档或自动化任务。
按任务所需能力选择角色,不必先创建“万能员工”。
长任务与自动化执行统一到任务运行中心查看。
完整复制用户数据目录,不要只复制数据库文件。
第 1 章
启动并进入工作区
正式账号使用手机号和密码;第一次体验可直接进入游客工作区。
从桌面或开始菜单打开,适合固定电脑长期使用。
完整解压后双击 Start-XiaoJuClaw.bat,不要只复制一个 EXE。
无需云账号;若配置在线模型,该模型服务仍会联网。
1
2
3
- 输入手机号和密码。已有账号直接登录;不要在公共电脑保存账号信息。
- 第一次体验可选“游客登录 · 免费试用”。游客工作区适合熟悉界面,不要放入正式客户资料。
- 登录页仍可打开设置与使用手册。遇到网络问题时,先看诊断信息,不要连续重复登录。
界面在哪里放了什么
侧栏按四个分区归类,先认分区再找功能。
聊天、创作搭档(管理数字员工)。
今日经营、任务(已派出去的活跑得怎么样)、定时安排(按计划自动执行)、工作流。
学习与记忆、知识库、长期记忆、技能市场。
设置、帮助与诊断、使用手册、反馈、退出登录,以及登录后的“积分与充值”。这些都不在侧栏列表里。
第 2 章
选择平台通道或自带 API Key
优先保证任务能正常完成,再根据成本、隐私和模型能力选择通道。
1
2
3
- 打开“设置 → AI 能力 → 文本模型”。页面会把可用方式分为平台通道和自带 API Key。
- 优先试用平台通道。无需管理密钥,消耗会按页面显示的积分和模型规则结算;代理分润或结算异常不会阻断用户调用模型。
- 需要自主管理时选择“自带 API Key”。按服务商文档填写接口地址、模型 ID 和 API Key,保存后再做短消息测试。
进入聊天发送“请只回复:配置成功”。短消息成功后再执行长文档或工作流。
401/403:Key、地址或权限错误;429:限流或余额不足;超时:网络或服务商异常。
第 3 章
用“今日经营”安排一天
这里是“一人公司”的每日入口,不是营收看板。
1
2
3
4
- 从侧栏进入“今日经营”。顶部可看到工作流、自动化、计划和已知 AI 费用。
- 点击“生成经营简报”。系统只使用已确认画像和本地状态;未接入的营收、订单不会被猜测。
- 优先完成前三项行动。点击行动卡再进入对应功能,不要同时铺开十多个任务。
- 编辑经营画像。至少填写业务、产品、客户、渠道、当前目标和人工确认红线。
第 4 章
认识当前界面和常规设置
侧栏用于切换工作区,左下角账号区域集中放置设置、诊断、手册和账户入口。
1
2
3
- 从设置左栏切换分类。常规、AI 能力、浏览器、成长与记忆和帮助诊断分别管理不同能力。
- 先设置语言和外观。主题改变不会影响数据;高对比度或缩放应以实际阅读舒适为准。
- 谨慎启用开机启动。定时安排依赖程序运行,但不需要的设备不要长期后台启动。
第 5 章
在聊天中把要求说清楚
一个可执行请求应包含目标、资料、限制、输出格式和验收标准。
1
2
3
4
第一次进来会多两样东西
讲三件默认行为:助手会记住你的偏好(默认开启,可查可删可关)、长任务在“任务”里跑不刷屏聊天、每个员工擅长的活不一样。每条后面有链接直达对应页面。点“知道了”或 × 关掉后不再出现。
“试试这些”几张卡,点一下就把请求填进输入框。示例按当前员工真正开放的能力筛选,换员工会变;卡角小标签表示这条示例需要哪项能力。不想用就直接说你的需求。
- 新建或选择对话。不同客户/项目建议分开对话,避免上下文混淆。
- 输入完整要求。示例:“整理附件会议记录,输出决策、负责人、截止日、待确认项;不补写原文没有的事实。”
- 添加附件并选择员工。图片需要视觉模型,录音需要先配置语音识别。
- 发送后等待完成。长任务可要求先建立计划;遇到付款、发布、删除时要求暂停。
第 6 章
管理和创建数字员工
聊天与工作流负责“做什么”,侧栏“创作空间 → 创作搭档”负责“由谁做、用什么模型和技能”。
1
2
3
- 点击“+”创建员工。先用一句话写岗位,再用 AI 优化人设。
- 选择已有员工。办公、财务、电商、客服等员工职责不同。
- 在详情区检查模型、技能和人设。新员工先用非敏感小任务测试。
挑员工时先看卡上这两样
这位员工日常真正在做的活。财务、人事、客服三位开放的能力完全相同,只有代表任务能把他们区分开。
如“知识库”“生图与视频”“定时任务”“看图理解”。没有标签的能力就是他用不了——财务、人事、客服、闲鱼客服都没有生图和视频,别指望他们出图。
第 7 章
建立可引用的知识库
把产品手册、报价、制度和 FAQ 交给员工,并要求回答注明来源。
1
2
- 点击“上传文档”。等待解析完成;不要上传不需要处理的客户秘密。
- 先搜索一个原文关键词。确认文档可检索,再到聊天中要求“只根据知识库回答并列出来源”。
第 8 章
运行并检查工作流
工作流把重复业务拆成可见、可恢复的步骤。
1
2
3
1
2
3
- 展开流程查看完整步骤。确认它是否会调用工具、AI 或专用员工。
- 点击“运行”并填写输入。先用少量真实数据验证,不要直接做大批量。
- 到“任务运行中心”查看执行。失败时展开具体步骤,修复模型、网络、输入或权限后再决定是否续跑。
第 9 章
在“定时安排”里创建任务
让指定员工按间隔、日周月或指定时间执行任务。侧栏“自动化”分区里这一项叫“定时安排”。
1
2
3
4
5
6
- 点击“创建任务”。打开创建表单。
- 填写名称和说明。名称要能看出执行频率和目的。
- 选择员工并写完整提示词。明确输入来源、输出格式和禁止事项。
- 选择间隔、Cron 或一次性。第一次建议设置 5 分钟后的一次性任务。
- 选择结果投递。可只保存记录,或推送到已配置渠道。
- 创建后到“任务”页检查运行记录。连续失败应先停用,避免重复消耗。
第 10 章
配置浏览器与网页协作
浏览器能力用于在你授权的网页里辅助操作;登录、验证码和最终提交始终由人确认。
1
2
3
- 先阅读连接说明。只连接你准备让助手操作的浏览器和测试页面。
- 完成浏览器桥接或扩展连接。状态正常后,先做打开页面、读取标题这类无副作用测试。
- 逐步开放操作。填写、上传、发送和发布前检查页面目标与内容;付款、删除和验证码必须人工完成。
第 11 章
配置语音、图片和视频
聊天模型与媒体模型是不同能力,需要单独配置和测试。
1
2
3
4
- 打开“设置 → AI 能力”。页面上四张卡(文本、图像、视频、语音)分别显示各自是否已配好。
- 点开要配的那张卡,选“连接服务商”。先挑服务商,再填你自己的 API Key;接口地址通常自动带出,除非服务商要求才改。
- 勾选这个账号要承担的能力,并为每项选模型。语音识别、语音合成、图片和视频可以分开配,也可以由同一个账号一起承担。
- 做一次连接检测再完成。检测免费、不产生生成内容;通过后卡片状态才会变成已配好。
第 12 章
技能与记忆
三处都在侧栏“知识与能力”分区:技能市场决定员工会怎样做,长期记忆保存长期事实,学习与记忆管它自己学到的东西。
1
2
3
4
- 在“已安装”与市场之间切换。先用内置技能,不要为了数量安装无关技能。
- 按岗位搜索。例如文档、表格、电商或研究。
- 新建或导入前检查来源。第三方技能可能包含工具和外部依赖。
- 打开技能卡查看说明。只给员工启用工作真正需要的技能。
1
2
- 点击编辑维护长期记忆。及时更新旧报价、联系人和错误偏好。
- 只保存稳定事实。密码、验证码、银行卡和临时密钥不要写入记忆。
学习与记忆:助手学到了什么
侧栏“知识与能力 → 学习与记忆”,也可以从设置里的“成长与记忆”打开同一份内容。
1
2
3
你明确告诉过它的做法。
它自己记住的关于你和业务的信息,可搜索、可编辑原文。
你点踩并说明原因后形成的调整,以及它用工具总结出的经验。
- “让助手从使用中学习”开关。关掉后不再学新内容;已经记住的不会被删除,要清理得自己删。
- “高级学习”开关(默认开启)。额外总结“成长阶段”和“它学会的做法”,依赖本机组件、仅在本机运行;本机没有该组件时它不运行,不影响基础学习。
第 13 章
账号、积分与平台模型
登录后的账号菜单提供积分、充值和权益入口;游客或离线状态会隐藏不可用项。
1
2
1
2
3
- 点击左下角账号区域。设置、帮助与诊断、使用手册和退出登录都从这里进入。
- 登录后查看积分与充值。页面显示当前积分、消费记录和可用权益;实际扣费以调用结果和账单记录为准。
- 平台通道不可用时先看状态。可以稍后重试或切换自带 API Key;结算后台异常不应影响已成功发起的用户模型调用。
第 14 章
查看日志并排查问题
入口:左下角账号区域 →“帮助与诊断”→“查看运行日志”。侧栏里没有“日志”这一项,只能从这里进。先记录时间和操作,再从同一时间点找错误。
1
2
3
1
2
3
- 按日期、分类和级别筛选。模型问题看 Agent/工具调用,定时问题看定时任务。
- 搜索错误文字或时间。常见状态:401/403 凭据,429 限流,timeout 超时。
- 展开相关行查看详情。联系售后时提供版本、时间、操作步骤和脱敏日志。
软件打不开
确认已完整解压、便携目录齐全、磁盘可写;检查安全软件隔离记录。不要反复删除用户数据目录。
聊天没有回复
检查当前模型、接口地址、Key、模型 ID、余额、限流和网络。
工作流长时间运行
打开运行详情看当前步骤,不要连续重复点击运行。
定时任务没有执行
确认软件当时在运行、电脑未休眠、时区正确、任务已启用。
第 15 章
备份、恢复与安全升级
程序可以替换,用户数据绝不能被升级包覆盖。
XiaoJuClaw\程序文件;完整包升级时可以替换。XiaoJuClawRuntime\随包工具;完整包升级时可以替换。XiaoJuClaw-User-Guide\图文操作手册;完整包升级时应同步替换。XiaoJuClawData\Key、聊天、知识库、任务和工作区;永远保留。正确备份
- 等待聊天、工作流和定时任务结束。
- 退出主窗口和悬浮提醒窗,确认两个 XiaoJuClaw 进程都已结束。
- 便携版复制整个 XiaoJuClawData;安装版在“设置 → 环境”查看实际数据路径。
- 把备份保存到另一块磁盘,并标注日期与版本。
完整包升级
- 先完成备份。
- 用新包覆盖 XiaoJuClaw、XiaoJuClawRuntime 和 XiaoJuClaw-User-Guide。
- 保留原 XiaoJuClawData,启动后检查 Key、聊天、知识库和任务。
第 16 章
安全边界与第一天验收
完成下面清单后,再接真实客户、生产 Key 和正式外部连接。
必须人工确认的动作
付款、退款、转账、开票、赔偿、价格和时效承诺。
发布、改价、发货、删除、库存清零和批量修改。
扫码、验证码、风控、客户资料、完整卡密和商业机密。
第一天验收清单
- 能够启动并确认版本与交付形态。
- 登录或离线模式已说明清楚。
- 模型短消息测试成功。
- 经营画像使用真实但非秘密的信息。
- 至少用一位创作搭档完成一次低风险短任务。
- 上传一份测试知识文档并能检索。
- 运行一条工作流并看懂步骤状态。
- 创建一个 5 分钟后的一次性任务。
- 如使用浏览器协作,已用测试页面验证连接与人工确认边界。
- 如使用平台通道,已核对积分展示与一次最小消耗记录。
- 能找到运行日志(账号区域 → 帮助与诊断 → 查看运行日志)和本手册。
- 知道助手默认会学习并记住偏好,也知道在“学习与记忆”页可以查看、删除和关闭。
- 退出软件并完成一次完整数据目录备份。