夜雨聆风OpenClaw（小龙虾）是开源本地AI智能体，核心能力：接收自然语言指令，自动操控电脑、跨软件完成整套任务（文件处理、网页操作、Excel汇总、生成文档等）。
重要前提：小龙虾本身免费；需要搭配大模型（DeepSeek、通义千问、Kimi、Ollama本地模型），云端模型会产生API调用费用
一、前置环境准备
✅ 系统支持
Windows10+/macOS12+/Linux（Ubuntu20.04+）
✅ 必备软件
1. Node.js 22 及以上版本（运行核心环境）
2. Git（部分依赖下载需要）
✅ 硬件参考
最低2G内存；如果跑本地大模型（Ollama）建议16G以上内存
✅ 模型准备
1. 云端API：去DeepSeek、Kimi、通义千问开放平台申请API Key
2. 本地离线模型：安装Ollama，部署Llama3等模型，不用API、无额外费用，但对电脑配置要求高
二、安装部署
方案1：官方一键脚本
1. Windows：右键开始菜单，管理员身份打开 PowerShell
plaintext
iwr -useb https://openclaw.ai/install.ps1 | iex
2. macOS / Linux 终端
plaintext
curl -fsSL https://openclaw.ai/install.sh | bash
方案2：npm手动安装
plaintext
npm install -g openclaw@latest
# 验证是否安装成功
openclaw --version
安装成功后执行初始化向导：
plaintext
openclaw onboard
按照向导依次操作：
1. 同意权限协议
2. 选择模型类型：云端API / Ollama本地模型，粘贴API密钥
3. 设置全英文工作文件夹
4. 选择交互渠道：Web网页控制台 / 飞书/钉钉机器人远程下发指令
启动Web管理面板
plaintext
openclaw gateway
浏览器打开： http://127.0.0.1:18789 ，可视化管理、下发任务、查看执行日志
三、基础使用流程
1. 下发任务指令
差示例：帮我整理表格
✅ 标准示例：读取D盘work目录的销售.xlsx，汇总每个区域销售额，生成可视化图表，导出PDF保存到同文件夹
2. 发送指令后，小龙虾会自动：
- 拆解完整执行步骤
- 操控文件/浏览器/办公软件执行操作
- 实时返回日志，中途遇到问题会询问确认
3. 任务结束：输出成品文件、执行总结；可查看完整操作复盘
常用实用指令参考
1. 文件批量：批量重命名桌面图片，统一命名为“产品01、02”
2. 办公自动化：搜索行业报告，整理要点，生成一份公众号文案
3. 网页采集：打开指定网页，提取表格数据保存至CSV
四、进阶功能
1. 技能扩展（ClawHub）
社区提供大量预制技能：PPT生成、代码调试、邮件自动发送、素材搜集，可一键导入启用，也能自定义编写自动化流程
2. 远程操控
配置飞书/钉钉机器人，手机发消息，远程操控电脑执行任务
3. 自定义知识库：上传文档资料，让AI基于专属资料完成工作
五、安全红线 & 避坑重点
1. 权限风险：拥有电脑文件读写权限，不要给管理员最高权限，重要文件提前备份，避免误删
2. 合规提醒：禁止用于恶意爬虫、批量营销骚扰、破解软件、违规采集隐私数据
3. 报错高频原因：文件夹路径含中文、Node版本过低、API密钥填写错误、网络无法访问模型接口
4. 区分同名软件：餐饮管理“小龙虾系统”、社交App≠OpenClaw小龙虾AI
六、常见命令速查
plaintext
openclaw --version # 查看版本
openclaw onboard # 重新初始化配置
openclaw gateway # 启动网页管理后台
openclaw stop # 停止后台服务
七、适合新手的入门建议
1. 先用云端API快速跑通流程，熟悉操作逻辑，再尝试本地Ollama离线部署
2. 先用简单任务测试（新建文档、整理文本），再执行复杂跨软件任务
3. 每一次任务结束查看执行日志，优化提示词，提升执行成功率
八、卸载
plaintext
npm uninstall -g openclaw
手动删除配置目录 ~/.openclaw （Windows 用户在C盘用户目录）