福科创新 小龙虾一键安装操作手册
前言
一、安装前准备
1.1 设备配置要求
系统要求：Windows 10/11（64位）、macOS 14+、主流Linux发行版（如Ubuntu、CentOS），Windows系统需关闭第三方拦截软件（如杀毒软件、电脑管家），避免拦截安装脚本。
内存要求：最低4GB，推荐8GB及以上（8GB内存轻薄本实测可稳定运行，无卡顿）。
硬盘要求：至少预留10GB可用空间，用于存储安装包、依赖文件及运行缓存。
网络要求：安装过程中需联网（用于下载依赖文件），安装完成后可断网本地使用；建议使用家用宽带或手机热点，避免校园网、公司受限网络导致下载失败。
1.2 其他准备事项
权限准备：Windows用户需准备管理员权限（安装脚本需管理员权限执行，否则会报错）；macOS/Linux用户无需额外权限，直接打开终端即可。
命令准备：提前复制对应系统的一键安装命令（详见第二章），避免手动输入导致字符错误；国内网络下载缓慢时，可使用国内加速镜像命令（详见2.2节）。
可选准备：若需使用云端模型，可提前注册国内大模型账号（如MiniMax、智谱AI、阿里云百炼），获取API Key（注册后可领取免费额度，新手可先使用免费额度）；若需零Token无限使用，可提前准备Ollama本地模型工具（详见第四章进阶配置）。
二、一键安装步骤（核心流程）
2.1 Windows系统（最常用）
打开管理员模式PowerShell（关键步骤）：点击电脑左下角搜索框，输入“PowerShell”，找到“Windows PowerShell”，右键选择“以管理员身份运行”；弹出“用户账户控制”提示框时，点击“是”确认（普通权限会导致安装失败，这是90%新手踩坑的主要原因）。
复制并执行一键安装命令：将以下官方一键安装命令完整复制，粘贴到PowerShell蓝色窗口中，按下回车键启动安装： iwr -useb https://openclaw.ai/install.ps1 | iex 若国内网络下载缓慢、卡住不动，可替换为国内加速镜像命令： iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex。
等待自动安装：安装过程全程自动，脚本会依次完成5件事：检测系统版本、安装Node.js 22.x LTS稳定版、配置国内加速源、安装小龙虾核心程序、自动配置环境变量；全程耗时3-8分钟（取决于网络速度），期间请勿关闭终端窗口、不要断网，弹出的系统弹窗全部点击“允许”。
确认安装完成：当终端窗口显示“OpenClaw installed successfully”字样时，说明安装已完成；若未出现该提示，可关闭窗口重新执行安装命令，或切换网络后重试。
2.2 macOS系统
打开终端：点击电脑“启动台”，找到“终端”应用并打开（无需管理员权限，直接运行即可）。
复制并执行一键安装命令：将以下命令完整复制，粘贴到终端窗口中，按下回车键： curl -fsSL https://openclaw.ai/install.sh | bash。
验证并等待安装：若终端提示输入电脑开机密码，直接输入（输入时不显示字符，属于正常现象），按下回车键；脚本将自动检测环境、安装依赖，全程耗时2-5分钟，期间请勿关闭终端窗口。
确认安装完成：终端显示“OpenClaw installed successfully”字样，即代表安装成功；若提示权限不足，可在安装命令前添加“sudo ”（sudo curl -fsSL https://openclaw.ai/install.sh | bash），再次输入密码执行即可。
2.3 Linux系统
打开终端：通过快捷键“Ctrl+Alt+T”打开终端，或在应用列表中找到“终端”并运行。
复制并执行一键安装命令：将以下命令完整复制，粘贴到终端窗口中，按下回车键： curl -fsSL https://openclaw.ai/install.sh | bash。
等待安装完成：脚本自动完成环境配置和程序安装，全程耗时2-5分钟；若提示权限不足，可添加“sudo ”提升权限后重新执行，安装完成后终端会显示成功提示。
三、安装验证与初始化配置
3.1 安装验证（必做步骤）
3.2 初始化配置（1分钟搞定）
启动配置向导：在终端中输入命令“openclaw onboard”，按下回车键，启动交互式配置向导。
- 按提示完成配置：
接受风险提示：输入“yes”，按下回车键（部分版本无需此步骤，直接进入下一步）。
选择模型接口：新手推荐选择“云端体验”（后续可随时切换成本地模型），直接按下回车键即可；若已准备好API Key，可选择对应模型供应商，粘贴API Key（密钥仅存储在本地，不会上传云端）。
设置访问端口：默认端口为3000或18789（不同版本略有差异），无需修改，直接按下回车键即可；若端口被占用，后续可修改配置文件（详见第五章故障排查）。
设置登录密码：输入一个简单好记的密码（用于登录小龙虾控制面板），按下回车键确认（密码需牢记，后续登录需使用）。
完成配置：配置向导自动保存设置，提示“Configuration completed successfully”即代表初始化完成，小龙虾工具正式启动。
3.3 首次启动与登录
启动工具：在终端中输入命令“openclaw start”，按下回车键，启动小龙虾服务。
登录控制面板：启动成功后，浏览器会自动打开小龙虾控制面板（若未自动打开，可手动打开浏览器，在地址栏输入“http://localhost:3000”或“http://localhost:18789”，根据初始化时的端口确定），输入设置的登录密码，点击登录即可进入操作界面，开始使用各类功能。
四、进阶配置（可选）
4.1 本地模型配置（零Token无限用）
安装Ollama工具：打开浏览器，访问Ollama官方网站（https://ollama.com/），下载对应系统的安装包，全程默认安装（和安装普通软件一样简单）。
拉取轻量本地模型：打开终端（PowerShell/终端），输入命令“ollama pull qwen:7b”，按下回车键，等待模型下载完成（模型体积适中，普通电脑可带动）；也可选择其他轻量模型（如llama3:8b），替换命令中的模型名称即可。
- 修改小龙虾配置文件：
Windows系统：找到路径“C:\Users\你的用户名\.openclaw\openclaw.json”（替换为自己的电脑用户名）。
macOS/Linux系统：找到路径“~/.openclaw/openclaw.json”。
编辑配置文件：打开配置文件，在“models”部分添加以下内容（复制完整，不要写错格式）： "ollama" : { "baseUrl" : "http://localhost:11434" , "models" : [ { "id" : "qwen:7b" , "name" : "本地通义千问7B" , "contextWindow" : 8192, "maxTokens" : 4096 } ] }
重启小龙虾：在终端输入命令“openclaw restart”，按下回车键，重启服务；重启后登录控制面板，选择本地模型，即可实现零Token无限使用。
4.2 第三方平台绑定（微信/飞书）
微信绑定：在终端输入命令“openclaw connect --platform wechat”，按下回车键，弹出二维码；用微信扫码登录，即可完成绑定，后续可通过微信发送指令，控制小龙虾执行任务（如整理文件、写文档）。
飞书绑定：在终端输入对应绑定命令，按提示完成飞书机器人配置，即可实现飞书深度集成（如创建表格、上传文件、写入内容），具体命令可参考小龙虾官方文档。
五、常见故障排查（新手必看）
5.1 安装类故障
故障1：提示“脚本无法运行”“禁止执行脚本” 解决方案：打开管理员PowerShell，输入命令“Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser”，弹出提示后输入“Y”并回车，再重新执行一键安装命令。
故障2：提示“openclaw 不是内部或外部命令” 原因：Node.js环境变量未生效 解决方案：重启电脑，重新打开管理员PowerShell，输入“node -v”，若显示版本号则正常；若仍异常，重新执行一键安装脚本，自动修复环境变量。
故障3：安装到一半卡住、下载失败 原因：网络波动或被拦截 解决方案：关闭终端窗口重新执行安装命令；切换为国内加速镜像命令；暂时关闭杀毒软件、防火墙，避免拦截脚本；切换手机热点重试。
故障4：中文用户名导致路径乱码、报错 解决方案：修改npm路径到纯英文盘（如D盘），在终端输入以下两条命令，依次回车： npm config set prefix "D:\npm-global" npm config set cache "D:\npm-cache"，修改完成后重新安装。
5.2 启动与使用类故障
故障1：启动后打不开控制面板网页 原因：默认端口（3000/18789）被其他软件占用 解决方案：1. 管理员PowerShell输入命令“netstat -ano | findstr :端口号”（替换为实际端口）；2. 查看最后一列PID，输入命令“taskkill /f /pid 数字”（替换为实际PID），关闭占用端口的程序；3. 重新输入“openclaw start”启动服务。
故障2：本地模型不生效 原因：Ollama未启动或配置文件格式错误 解决方案：确认Ollama在后台运行；检查配置文件中的标点、括号是否正确，重新编辑后重启小龙虾服务（openclaw restart）。
故障3：绑定微信/飞书失败 解决方案：关闭终端，重新执行绑定命令；检查网络是否正常；确认微信/飞书已登录，且未拦截二维码扫描；若仍失败，重启电脑后重试。
故障4：启动后提示“网关无法启动” 解决方案：重启电脑；卸载Node.js及相关依赖，删除残留文件后重新安装；更换安装方式（如使用clawx、Cherry Studio软件一键安装），重新执行安装流程。
六、基础使用指引（新手入门）
场景1：自动整理电脑文件 在控制面板或微信中输入指令，如“帮我把桌面文件按类型分类到D盘”“把下载文件夹里的图片全部归类”“批量重命名所有文件”，小龙虾会自动执行操作，无需手动干预。
场景2：自动办公写文档 输入指令，如“帮我写一份300字工作总结”“把这段文字做成表格”“帮我生成会议纪要”，支持导出Word、PDF格式，直接使用无需修改。
场景3：浏览器自动干活 输入指令，如“帮我查今天的热点新闻并汇总”“帮我打开3个常用网站”“帮我填写表单信息”，小龙虾会自动操作浏览器，完成对应任务，节省手动操作时间。
一、产品核心定位与价值
1. 核心定位
2. 核心价值（差异化优势）
极简落地：单台盒子搞定“本地服务器+AI 终端+云端协同”，无需复杂组网、无需专业技术，脚本一键激活所有功能，5分钟即可上手。
全能适配：覆盖“本地计算、文件存储、多渠道交互、AI 自动化、远程访问、云端备份”全场景，替代传统“服务器+终端+辅助设备”的复杂组合。
隐私优先：核心数据（文件、对话、任务）全部存储在本地盒子，云端仅用于扩容和备份（可选），避免数据泄露，适配个人、小微企业隐私需求。
高性价比：合理定价，兼顾硬件性能与软件服务，无需额外支付云端服务器租金（基础版），开发者无需投入额外成本搭建开发环境。
灵活拓展：支持脚本自定义、OpenClaw Skill 二次开发、硬件算力扩展，从个人体验到企业小型部署，可按需升级，无需更换设备主体。
二、产品形态：单台 ClawBox 全能智能服务器（硬件+预装全量系统）
1. 档位配置与售价（可落地、高性价比，毛利率控制在30%-40%）
型号 | 核心硬件配置（全能服务器适配） | 核心服务器能力 | AI 与算力能力 | 适用场景 | 官方售价（含1年质保+全量软件服务） | 可选升级服务（年付） |
|---|---|---|---|---|---|---|
ClawBox 基础版（个人级） | 瑞芯微 RK3588S（8核，主频2.4GHz）｜8GB LPDDR5（服务器级内存）｜128GB SSD（高速存储）｜双频 Wi-Fi 6｜千兆网口｜HDMI+2×USB3.0｜无风扇静音 | 本地文件服务器（支持 SMB/FTP）、轻量 Web 服务器（Nginx）、本地数据库（MySQL 轻量版）、远程访问（SSH/花生壳内置）、基础网络转发 | OpenClaw 基础版（多渠道交互：微信/飞书/电报、本地文件处理、简单自动化脚本执行）｜6TOPS INT8｜支持 Llama 3-8B 离线推理（Ollama 内置） | 个人用户、开发者体验级部署，满足个人文件存储、AI 辅助办公、简单 Web 测试需求 | 2299元（一次性付费，无后续隐性成本） | 云端备份（100GB）：99元/年；AI 算力扩容：199元/年 |
ClawBox 专业版（团队级） | 算能 BM1684（16核，主频2.8GHz）｜16GB LPDDR5（服务器级内存）｜512GB SSD（高速存储，支持扩容至2TB）｜4G/5G 模块（可选）｜GPIO 扩展｜低噪散热｜壁挂/桌面双模式 | 全能本地服务器（文件/Web/数据库/邮件轻量版）、团队共享存储（支持权限管理）、批量远程访问、网络防火墙、设备监控、定时备份 | OpenClaw 专业版（自定义 Skill、多任务并行、企业办公自动化）｜32TOPS INT8｜支持 Llama 3-70B 离线推理、多模态模型（如 SD 本地部署） | 小型团队（5-20人）、小微企业，满足团队文件共享、办公自动化、本地 AI 部署、轻量业务服务器需求 | 5699元（一次性付费，含基础云端协同能力） | 云端扩容（500GB）：299元/年；团队管理权限：399元/年；技术支持：499元/年 |
ClawBox 企业版（企业级） | AMD Ryzen 5 7540U（6核12线程）｜32GB DDR5（服务器级内存，可扩容至64GB）｜1TB NVMe SSD（可扩容至4TB）｜RTX 4060 Laptop（8GB，算力12TFLOPS）｜双千兆网口｜硬件加密模块｜冗余散热 | 企业级本地服务器（高并发 Web/数据库/文件服务器）、多租户权限管理、数据加密存储、异地备份、远程运维、故障告警、与企业 ERP/CRM 对接 | OpenClaw 企业版（大规模任务调度、自定义模型部署、AI 与业务系统集成）｜支持大模型本地训练、多模态批量处理、云端模型 fallback 无缝切换 | 中大型企业（20人以上）、开发者团队，满足企业级 AI 部署、核心业务服务器、定制化自动化、高算力需求 | 10999元（一次性付费，含全套云端协同+基础定制服务） | 专属云端节点：999元/年；企业定制开发：按需报价；7×24小时运维：1999元/年 |
2. 硬件共性优势（适配服务器长期稳定运行）
稳定性：采用服务器级内存、高速 SSD，优化散热设计（无风扇/低噪），支持7×24小时不间断运行，适合长期部署。
扩展性：所有型号支持 SSD 扩容、部分支持内存扩容，专业版/企业版支持 4G/5G 模块、GPIO 扩展，适配不同场景需求。
易用性：支持 HDMI 本地显示配置、Web 远程管理，无需专业服务器运维知识，新手可快速上手。
安全性：内置硬件防火墙、数据加密模块（企业版），禁用高危端口，脚本自动加固系统，防止非法访问。
三、核心技术方案（可落地，依托脚本实现全流程自动化）
1. 整体技术架构（单台盒子实现全方位服务器能力）
硬件层：提供稳定算力、存储、网络支撑，适配服务器7×24小时运行需求。
系统层：基于 Debian 12 优化，精简冗余组件，强化服务器稳定性与安全性，内置自动开机、故障自恢复功能。
核心引擎层：整合两大核心能力——① OpenClaw 智能引擎（多渠道交互、自动化执行、AI 推理）；② 服务器核心组件（Nginx、MySQL、Docker、FTP、SSH 等），实现“AI+服务器”一体化。
运维层：kejilion.sh 定制化脚本（专属分支），作为全流程纽带，实现一键激活、一键部署、一键运维、一键升级。
应用层：终端用户（Web UI、多渠道机器人）、开发者（开发工具链、Skill 开发模板），适配不同用户的使用习惯。
2. kejilion.sh 定制化脚本（核心落地保障，一键搞定所有操作）
（1）脚本核心功能（定制化优化，适配全能服务器）
一键激活：盒子开机后，终端输入1条命令，自动激活所有服务器组件、OpenClaw 引擎，初始化系统配置（网络、防火墙、用户权限），无需手动安装任何软件。
- 一键部署：支持3种部署模式，按需选择，全程自动化，无需专业技术：
终端模式：部署基础服务器+OpenClaw 终端功能，适合个人用户（文件存储、AI 办公）。
团队模式：部署团队共享服务器+OpenClaw 团队版，自动配置团队权限、共享存储、批量管理。
开发者模式：部署开发环境（Node.js 22+、Git、VS Code Server、OpenClaw 源码），一键搭建二次开发平台。
- 一键运维：整合服务器监控、故障排查、数据备份、日志管理功能，输入命令即可完成：
监控：查看 CPU、内存、硬盘、网络占用，以及 OpenClaw、服务器组件运行状态。
备份：本地定时备份（文件、数据库、任务配置），可选云端加密备份（关联 ClawBox 升级服务）。
排查：自动检测系统故障、组件异常，一键修复常见问题（如端口占用、服务无法启动）。
一键升级：自动同步 OpenClaw 最新版本、服务器组件补丁、脚本更新，无需手动下载安装，升级后自动回滚备份，避免数据丢失。
一键拓展：支持自定义脚本参数，开发者可通过脚本快速部署自定义 Skill、替换 AI 模型、搭建额外服务器组件（如 Redis、MongoDB），无需修改系统核心配置。
云边协同（可选）：一键绑定云端备份/扩容节点，配置加密隧道，实现本地服务器数据同步、算力扩容，仅传输元数据，保障隐私安全。
（2）一键部署流程（零门槛，5分钟落地，所有用户通用）
开机配置：ClawBox 开机，连接 Wi-Fi 或千兆网线（自动获取 IP），通过 HDMI 连接显示器，进入终端界面（或通过手机/电脑 Web 访问
http://clawbox.local进入配置界面）。一键激活：在终端输入以下命令，脚本自动启动，无需额外操作：
bash <(curl -sL kejilion.sh/claw-all-in-one) --activate模式选择：脚本运行后，弹出3种部署模式（终端/团队/开发者），输入对应数字，自动完成所有组件部署（约3-5分钟，取决于网络速度）。
初始化配置：部署完成后，脚本提示设置管理员账号、密码，绑定多渠道账号（微信/飞书/电报，可选），配置备份策略（可选），完成后即可使用所有功能。
后续运维：如需升级、备份、排查故障，仅需输入对应脚本命令，例如：
# 一键升级所有组件bash <(curl -sL kejilion.sh/claw-all-in-one) --upgrade# 一键备份数据bash <(curl -sL kejilion.sh/claw-all-in-one) --backup# 一键排查故障bash <(curl -sL kejilion.sh/claw-all-in-one) --fix
（3）开发者二次开发流程（脚本赋能，低门槛拓展）
切换开发者模式：输入脚本命令，一键部署开发环境：
bash <(curl -sL kejilion.sh/claw-all-in-one) --mode=developer获取开发资源：脚本自动克隆 OpenClaw 源码（MIT 协议）、Skill 开发模板，配置开发环境变量，无需手动搭建。
自定义开发：开发自定义 Skill（如企业业务对接、自动化脚本执行）、替换 AI 模型、拓展服务器功能（如搭建 API 接口）。
一键发布：通过脚本将自定义内容打包、部署，本地测试通过后，可同步至盒子服务器，无需复杂部署流程：
bash <(curl -sL kejilion.sh/claw-all-in-one) --publish --skill=自定义Skill名称
3. 核心功能实现（全方位服务器+OpenClaw 赋能，可落地）
（1）全方位服务器功能（单台盒子搞定，无需额外设备）
文件服务器：支持 SMB/FTP/WebDAV 协议，个人/团队文件共享、远程访问，支持权限管理、文件加密，替代传统 NAS 设备。
Web 服务器：内置 Nginx，支持静态网站、动态 API 部署，开发者可一键搭建测试环境、个人博客、小型业务系统。
数据库服务器：内置 MySQL、SQLite，支持本地数据存储、查询、备份，适配小型业务系统、AI 模型数据存储需求。
远程访问：支持 SSH、Web 远程管理，花生壳内置（无需端口映射），随时随地访问盒子服务器，查看状态、管理文件。
网络服务：内置防火墙、DHCP 服务器、端口转发，可作为家庭/办公网络核心节点，保障网络安全、分配 IP 地址。
企业级能力（专业版/企业版）：多租户权限管理、数据加密、异地备份、故障告警、与企业现有系统对接，适配企业核心需求。
（2）OpenClaw 智能引擎功能（与服务器深度融合）
多渠道交互：通过微信、飞书、电报等熟悉的工具，向 ClawBox 发送指令，控制服务器（如备份文件、启动 Web 服务）、执行自动化任务。
本地自动化：与服务器深度联动，执行文件整理、数据备份、日志分析、服务器监控告警等自动化任务，无需人工干预。
AI 辅助：本地部署 AI 模型，支持智能问答、文档分析、多模态处理，数据不泄露，适配隐私需求较高的场景。
自定义拓展：开发者可通过 Skill 开发，拓展自动化场景（如企业考勤统计、业务数据同步），与服务器功能深度融合。
（3）云边协同功能（可选，按需升级）
数据备份：本地数据加密同步至云端，防止本地硬件故障导致数据丢失。
算力扩容：本地算力不足时（如大模型训练、高并发访问），自动切换至云端算力，任务完成后同步回本地。
远程管理（企业版）：管理员通过云端后台，批量管理多台 ClawBox 盒子，查看状态、部署脚本、升级系统。
四、落地保障方案（确保产品可量产、可交付、可运维）
1. 供应链与交付周期（可规模化落地）
硬件供应：与国内头部边缘计算硬件厂商深度合作，签订长期供货协议，ClawBox 基础版/专业版现货供应，企业版预售（7天内发货），批量采购可缩短至3天。
软件预装：所有盒子出厂前，完成系统、OpenClaw 引擎、定制化脚本的预装与测试，确保开机即可使用，避免用户手动安装出错。
交付流程：个人用户（线上下单→顺丰发货→开机一键激活→售后跟进）；企业用户（需求对接→定制配置→批量发货→上门部署→技术培训），全程可追溯。
部署周期：个人用户5分钟内完成激活部署；团队/企业用户，单台盒子5分钟，批量部署（≤50台）1天内完成。
2. 售后与技术支持（降低用户使用成本）
基础支持（所有用户）：7×24小时在线文档、社区论坛，脚本内置常见问题一键排查功能，用户可自行解决基础问题。
付费支持（专业版/企业版）：1对1技术顾问，远程协助部署、故障排查，3年硬件质保（基础版1年），1年免费软件升级，企业版提供7×24小时运维服务。
开发者支持：提供 OpenClaw 二次开发文档、Skill 开发模板、脚本自定义教程，搭建开发者社区，定期更新开发资源，免费提供测试环境。
故障响应：硬件故障，基础版48小时内响应，专业版/企业版24小时内响应，本地故障可远程修复，无法修复的免费更换硬件（质保期内）。
3. 成本控制与售价合理性（确保盈利，同时高性价比）
硬件成本：基础版硬件成本约1400元，专业版约3500元，企业版约7000元，含预装、测试、包装成本，毛利率控制在30%-40%，低于同配置传统服务器+AI 终端组合的价格（传统组合价格约为 ClawBox 的1.5-2倍）。
软件成本：OpenClaw 采用 MIT 协议，无版权成本；脚本基于开源 kejilion.sh 定制，无需额外投入；服务器组件均为开源软件，降低软件成本。
运维成本：通过 kejilion.sh 脚本实现自动化运维，无需大量人工投入，规模化交付时，运维成本可控制在销售额的5%以内。
售价优势：同配置下，ClawBox 比“传统服务器+AI 终端+辅助设备”便宜30%-50%，且无需额外支付云端租金（基础版），个人用户可接受，企业用户可降低部署成本。
五、盈利模式（可持续，支撑产品迭代与落地）
硬件销售：ClawBox 三个档位的一次性硬件销售收入，核心盈利来源，批量采购可提供一定折扣，吸引企业客户。
增值服务：可选升级服务（云端备份、算力扩容、团队管理、技术支持）的年付收入，提升用户粘性，增加持续盈利。
企业定制：为企业提供硬件定制（如专属配置、硬件加密）、软件定制（如业务系统对接、自定义脚本）、批量部署与运维服务，收取定制服务费，针对中大型企业客户，提升盈利空间。
开发者生态：搭建 Skill 市场，开发者上传自定义 Skill，平台抽取10%-20%的收益；提供付费开发工具、测试环境，拓展开发者端盈利。