剑侠 AI 小龙虾整合包｜Windows 本地 AI 智能体开箱即用工具箱v3.0

一、整合包简介

「剑侠 AI・小龙虾整合包」是专为 Windows 系统打造的一站式本地 AI 智能体工具箱，

无需繁琐环境搭建，解压即用。 在基础本地对话能力之上，内置三大核心能力：

1. 快捷 Agent：一站式联网检索、资源下载、工作区文件批量整理、自定义智能体执行任务；

2. 龙虾引擎（OpenClaw 网关）：深度打通本机系统命令、文件读写权限，实现全自动化本地操作；

3. 双模型通道：本地 GGUF 量化模型离线运行 + 云端兼容 OpenAI 格式 API 在线调用，自由切换。

启动方式

先启动包内；本地依赖诊断.bat，检测必备环境，控制台显示ok就证明可以正常启动，环境依赖齐全，如果某个依赖显示no就需要对照搜索下载安装

• 主程序：剑侠启动器.exe（内嵌窗口界面，推荐日常使用）

• 备用方案：剑侠备用启动器.bat（主程序异常时兜底启动） 

• AMD显卡用户，用包内；A卡启动器.bat 启动界面（N卡用户禁用）

• 

二、核心功能

1. 三大运行模式，覆盖全场景需求

• 聊天模式：基础 AI 对话、日常问答、文案创作；

• 快捷 Agent（日常首选）：自动联网搜索、媒体资源嗅探下载、批量整理工作区文件；

• 龙虾引擎：OpenClaw 原生工具链，支持运行本机脚本、系统命令，权限更高，操作前请谨慎核对指令。备份重要文件，（禁止工作区填写系统盘）避免丢失重要文件！

2. 双模型兼容，低配设备也能流畅使用

• 本地离线：将 GGUF 量化模型放入Models文件夹，即可本地显卡加速离线推理；

• 云端在线：填入任意兼容 OpenAI 协议的 API 密钥，deepseek API等，无需高端显卡，直接调用云端大模型。

3. 隔离式工作区，文件操作安全可控

所有文件读写、修改、下载操作仅限定在自定义工作目录内，不会随意篡改系统文件； 支持人工二次确认后执行文件修改，也可授权自动批量处理，兼顾安全与效率。

4. 全角色卡生态，自定义专属 AI 助手

• 内置预设智能体：剑侠客服（整合包专属答疑）、通用助手、编程代码助手、文件整理专员；

• 完全兼容 SillyTavern 酒馆角色卡（json/txt 格式），可自动扫描本地酒馆角色目录一键导入；

• 聊天、快捷 Agent 双模式均可绑定自定义人设，适配 AI 对话、角色扮演、自动化办公等场景。

5. 全网资源检索下载插件

内置多平台只读检索插件：B 站、小红书、Telegram、Yandex 等； 开启对应技能后，可实现网页内容解析、音频 / 视频嗅探、全网资源搜索下载。

6. 私有知识库本地检索

导入本地文档、笔记、教程后，AI 提问时自动检索知识库片段，精准结合私有资料作答。

7. 硬件实时监控 + 自动故障日志

左侧面板实时可视化显卡显存、内存、磁盘占用状态； 程序运行日志自动存储于data\log目录，出现报错可快速定位故障根源。

三、产品核心优势

1. 一包多能，无需多软件切换 集普通对话、自动化 Agent、本地系统操作引擎于一体，一套工具搞定本地 AI 全部需求。

2. 工作区隔离机制，操作更安全 文件修改、资源下载拥有明确目录边界，人工审阅机制杜绝误删、篡改系统文件。

3. 本地优先，云端兜底 默认离线本地运行保护隐私；显卡性能不足时一键切换云端 API，老旧笔记本也能使用。

4. 完善角色卡生态 无缝兼容酒馆角色体系，游戏、角色扮演、定制办公助手均可快速搭建。

5. 一键排障，新手友好 自带本地依赖诊断.bat，自动检测修复缺失运行库；全程自动生成运行日志，故障排查零门槛。

6. 正版校验，安全无捆绑 仅剑侠源码网提供官方原版安装包，完整保留作者标识，杜绝篡改、捆绑后门的修改版。

四、电脑硬件配置要求

前置说明

仅使用图形界面 + 云端模型 API 对话对显卡几乎无要求；本地 GGUF 模型推理会占用显存，显存占用≈模型体积 + 识图组件 + 上下文缓存，模型越大、上下文越长，硬件需求越高。

操作系统

• 支持 Windows 10 / Windows 11 64 位系统（整合包专为 Windows 开发，macOS、Linux 不做适配保障）

• 解压路径建议选择非系统盘，如；D盘、E盘等，路径尽量简短、不含特殊中文 / 符号，避免读取异常启动失败报错。

• 解压过程中，建议提前关闭杀毒软件，避免拦截丢失必备核心文件，导致解压失败等
  

必备软件依赖（首次启动必运行「本地依赖诊断.bat」检测依赖）

1. Visual C++ 2015–2022 x64 运行库

2. Microsoft Edge WebView2 运行时（图形界面启动器依赖）

3. Node.js 22 LTS（备用启动器、龙虾引擎网关必备）

4. 本地模型运行依赖：包内python目录内置 llama-server，或同级放置剑侠聊天包JianxiaChatv1.23

5. NVIDIA 显卡：更新 Game Ready/Studio 正式版驱动

6. AMD 独显：更新 Adrenalin 驱动（Vulkan 加速后端专用）

推荐配置（流畅运行 8~35B 量化本地模型，兼顾识图多模态）

• CPU：六核及以上新款 Intel/AMD 处理器

• 内存：32GB

• 显卡：NVIDIA 独立显卡，12GB 显存（RTX 3060 12G、RTX4070、RTX3070Ti、RTX5070Ti 等）

• 硬盘：SSD 固态硬盘，系统 / 模型盘空余≥50GB（模型文件占用额外计算）

• 网络：稳定有线 / WiFi（联网检索、云端 API、资源下载功能需要网络）本地模型聊天对话不受网络影响，可离线

舒适顶配（长上下文、30B + 大模型、多模态识图稳定运行）

• 内存：32~64GB

• 显卡：NVIDIA 16GB/24GB 显存显卡（RTX4060Ti 16G、RTX3090、RTX4090 等）

• 优势：可拉高上下文长度，流畅加载 30B 以上高量化模型，识图无卡顿。加载速度更快

三档最低使用门槛

A 档：仅云端 API 对话（无需本地显卡算力）

内存≥8GB（推荐 16GB），集成显卡即可；仅需安装 WebView2、Node.js 并保持网络通畅。

B 档：本地 7~9B 小型模型（纯文本 Q4/Q5 量化）

内存≥16GB，NVIDIA 独显显存≥4~6GB；建议上下文设置 2048~4096，不建议加载 30B 大模型、识图功能。

C 档：主流本地体验（8~12B 全量化 / 30B 轻量化量化 + 识图）

内存 16~32GB（30B 大模型建议 32GB），NVIDIA 独显显存≥12GB（官方推荐档位）。

显存适配模型速查表（NVIDIA 标准，AMD 显卡可对标参考）

• 6GB 显存：仅 8B 级 Q4/Q5 纯文本模型，缩短上下文长度

• 8GB 显存：8~9B 量化模型，识图负载偏高，上下文上限 4096

• 12GB 显存：日常最优档位，8~12B 模型流畅运行，30~35B 轻量化量化 + 识图可使用

• 16GB 显存：稳定运行 31B Q3 等高参数量化大模型

• 24GB 及以上显存：30B + 高量化模型、超长上下文、多模态识图高负载无压力

不支持 / 不推荐使用场景（避免白忙）

1. 非 Windows 系统、32 位操作系统；

2. 老旧 NVIDIA GTX900 及更早显卡，驱动版本过低无法兼容 CUDA 推理；

3. 仅依靠 Intel 核显 / Arc 显卡做本地 GPU 加速：共享内存性能差、易抢占桌面资源，建议切换云端 API；

4. 显存不足强行加载超大模型（6~8GB 显存运行 30B 模型）：大概率加载失败、程序卡死、系统过载；

5. AMD 显卡缺少 Vulkan 运行组件，无法调用独显算力；

6. 将系统盘、C 盘根目录、用户主目录设置为工作区，存在误删系统文件风险；

7. 缺失 VC++、WebView2、Node.js 依赖，图形界面 / 龙虾网关无法启动（先运行依赖诊断工具修复）。

AMD 显卡专属使用说明

1. 原生支持 AMD 独显 Vulkan 硬件加速，底层逻辑与剑侠聊天包统一；

2. AMD 用户固定使用根目录；A卡启动器.bat，强制启用 Vulkan 后端、绑定独显启动网页界面；NVIDIA 显卡请勿使用该启动器；

3. 务必更新最新 Adrenalin 显卡驱动，双显卡笔记本避免程序误绑定核显；显存适配标准参考 NVIDIA 对照表。

磁盘解压优化建议

1. 整合包本体 + 运行日志缓存占用数 GB 空间，GGUF 模型体积需额外预留硬盘容量；

2. 优先 SSD 固态硬盘存储，机械硬盘会大幅拉长模型加载、文件读写耗时；

3. 杀毒软件易误报本地推理组件、启动程序，建议将整合包文件夹加入白名单后再启动或提前关闭。

五、高频常见问题解答

问：我的电脑能不能跑这个整合包？ 

答：对照上文三档最低配置判断。只用云端对话，普通轻薄本即可；想要离线本地运行，重点查看显卡显存是否匹配目标 GGUF 模型需求。

问：我使用 AMD 显卡该怎么操作？

答：双击根目录A卡启动器.bat启动，提前安装 Vulkan 推理组件；打开任务管理器查看独显专用显存占用，确认算力正常调用。

问：双击 exe 启动器无响应、界面白屏？

答：运行本地依赖诊断.bat，看看控制台必备依赖有没有显示‘OK’如果控制台显示对应的依赖为‘ON’需要对照搜索下载，或切换剑侠备用启动器.bat启动用浏览器打开。

问：提示 Node 缺失、龙虾引擎显示离线？ 

答：安装 Node.js 22 LTS 版本，使用主剑侠主启动器 / 备用启动器完整打开程序，会自动拉起龙虾网关。

问：本地模型加载超时、启动失败？ 

答：核心原因多为显存不足或模型文件损坏；更换更小量化版本、降低上下文参数、更新显卡驱动；故障详情查看data\log\error-latest.log日志。

问：只有核显、运行很慢怎么办？ 

答：优先使用云端 API 对话；若坚持本地运行仅选择 7~8B 极小量化模型，CPU 推理速度会明显卡顿，不推荐。

问：AMD 启动后仅占用内存，独显没反应不动？ 

答：更新 AMD 官方显卡驱动，重新打开 A 卡专用启动器；查看运行日志出现「算力后端: VULKAN」、设备标识 VulkanN 即代表独显正常工作。

问：程序报错日志在哪里查看？ 

答：所有运行日志统一存放于data\log文件夹，优先查看error-latest.log错误日志定位问题。更多细分问题，请查阅包内《整合包使用说明.txt》「常见问题」板块。

六、使用规范与须知

1. 本整合包仅限个人学习、非商用场景使用，使用过程需遵守国家法律法规、各大 AI 平台服务协议；

2. 抓取、下载公开网络资源时，请尊重内容版权、网站爬虫协议，禁止用于侵权、批量传播；

3. 龙虾引擎拥有完整本机系统操作权限，未知 AI 指令请勿一键执行，重要文件提前备份；

4. 工作目录仅自定义普通文件夹，禁止设置全盘、系统根目录，规避文件误操作风险；

5. 云端 API 密钥仅本地保存，妥善保管，切勿泄露给他人；

6. 杀毒软件易误报本地推理组件，添加文件夹白名单即可正常使用；

7. 二次分享、转发整合包时，完整保留作者、官网标识，禁止篡改程序、植入捆绑后冒充官方原版；

8. 硬件负载由所选模型决定，仅云端对话无显卡门槛，本地离线推理需匹配对应显存、内存规格。

作者信息

官网：https://jianxiaym.com 

作者：剑侠君 

名称：剑侠 AI 小龙虾整合包

PS：整合包报错有问题等，请在评论区附上；根目录，data/log里面的完整报错日志，也可以截图反馈在在线聊天室；https://www.jianxiaym.com/chat/?room=3