一、什么是小龙虾 AI（OpenClaw）
小龙虾 AI（官方名称 OpenClaw）是一款可操控电脑的 AI 智能体，能通过自然语言指令实现文件管理、浏览器操作、软件控制、数据处理等自动化任务，相当于 “AI 数字员工”，支持 Windows、macOS、Linux 系统，本地部署无需公网，隐私性强。
二、部署前准备（系统环境要求）
1. 硬件要求
最低配置：2 核 CPU、4GB 内存、10GB 空闲硬盘
推荐配置：4 核 CPU、8GB 内存、SSD 硬盘（部署更流畅）
2. 软件依赖（必装）
Node.js：≥v22.0.0（运行核心依赖）
Python：≥3.9.0（部分技能依赖）
Git：最新版（代码拉取与依赖管理）
3. 环境验证（管理员权限执行）
打开 PowerShell（Windows）/ 终端（macOS/Linux），执行以下命令，均输出版本号即合格：
plaintext
node --version
python --version
git --version
三、Windows 系统部署（新手推荐，一键安装）
1. 一键安装命令（管理员 PowerShell 执行）
直接复制粘贴，全程自动部署（约 5 分钟，勿关闭窗口）：
plaintext
iwr -useb https://openclaw.ai/install-local-2026.ps1 | iex
2. 安装关键注意事项
安装路径：必须选纯英文路径（无中文、空格、特殊字符），推荐D:\OpenClaw或E:\AI\OpenClaw。
磁盘空间：目标磁盘空闲≥4GB，避免安装失败。
协议勾选：勾选 “同意用户协议”，点击 “开始安装”。
3. 验证安装与启动
查看版本：openclaw --version（输出版本号如 2.6.6 即成功）。
启动服务：openclaw gateway（前台启动，关闭终端则停止；后台部署见下文）。
访问控制台：浏览器打开http://localhost:1878，右上角显示 “Gateway 在线” 即部署成功。
四、macOS/Linux 系统部署（简洁高效）
1. 一键安装命令（终端执行）
plaintext
curl -fsSL https://openclaw.ai/install.sh | bash
2. 验证与启动
版本验证：openclaw --version。
启动服务：openclaw gateway。
控制台访问：http://localhost:1878。
五、后台部署（开机自启，服务器必备）
1. 创建系统服务（Linux/macOS）
新建openclaw-gateway.service文件，内容如下：
plaintext
[Unit]
Description=OpenClaw Gateway Service
After=network.target
[Service]
ExecStart=/usr/local/bin/openclaw gateway
Restart=always
User=root
[Install]
WantedBy=multi-user.target
2. 启动并设置自启
plaintext
sudo cp openclaw-gateway.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable openclaw-gateway
sudo systemctl start openclaw-gateway
3. 查看服务状态
plaintext
sudo systemctl status openclaw-gateway
显示active (running)即后台运行成功。
六、大模型配置（核心！AI 大脑对接）
1. 支持的模型
阿里云百炼、豆包、GPT-4、Claude、硅基流动、MiniMax 等（推荐新用户用百炼 / 硅基流动，有免费额度）。
2. 配置步骤（以阿里云百炼为例）
申请 API-Key：登录阿里云百炼控制台，创建应用，复制 API-Key（sk - 开头）。
命令配置（替换为你的 API-Key）：
plaintext
openclaw config set models.providers.bailian.apiKey "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
重启服务：openclaw gateway，配置生效。
3. 自定义模型（硅基流动 / 私有部署）
plaintext
# 自定义模型地址和API-Key
openclaw config set models.providers.custom.baseUrl "https://api.siliconflow.cn/v1"
openclaw config set models.providers.custom.apiKey "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
七、基础使用方法（指令直接用，复制即执行）
1. 控制台使用
打开http://localhost:1878，底部输入框发自然语言指令，越精准执行越准。
指令公式：动词 + 对象 + 要求 + 输出格式 + 位置（高效指令模板）。
2. 常用实用指令（直接复制执行）
文件管理类
整理桌面：把桌面所有文件按图片、文档、压缩包分类归档，删除空文件夹。
批量处理：遍历D盘所有Word文档，提取标题和摘要，生成Excel保存到桌面。
浏览器操作类
搜索整理：打开浏览器，搜索2026年AI智能体行业报告，提取核心数据生成PDF。
网页采集：打开某电商商品页，抓取价格、库存、评论，保存为Excel。
软件控制类
启动发消息：启动微信，打开工作群，发送消息：今日18点前提交工作总结。
截图保存：截取当前屏幕，保存到D盘“截图”文件夹，命名为当前时间。
八、技能安装（扩展功能，MCP 工具集成）
1. 技能介绍
OpenClaw 支持 MCP（Model Control Protocol）工具，可安装天气查询、工单管理、销售统计等自定义技能（类似插件）。
2. 安装技能（以天气查询为例）
安装 ClawHub CLI（技能管理工具）：
plaintext
npm install -g clawhub
安装天气技能：
plaintext
clawhub install weather_query
验证技能：控制台输入查询北京今天天气，AI 调用技能返回结果。
3. 自定义 MCP 技能（对接 ragent 项目）
开发 MCP 工具（如天气、工单、销售查询，Java 编写）。
启动 mcp-server（端口 8090，暴露/mcp/tools和/mcp/invoke接口）。
OpenClaw 配置 mcp-server 地址：
plaintext
openclaw config set mcp.server.url "http://localhost:8090"
调用技能：输入指令，OpenClaw 通过 HTTP 调用 mcp-server 工具，返回结果。
九、常见问题排查（部署失败必看）
1. 端口占用（1878/18789）
解决：关闭占用端口的程序，或修改端口配置：
plaintext
openclaw config set server.port 1879
2. 模型调用失败
排查：API-Key 是否正确、额度是否充足、网络是否能访问模型接口。
测试：openclaw model test，查看模型连接状态。
3. 技能找不到
排查：mcp-server 是否启动、地址配置是否正确、技能是否注册。
验证：访问http://localhost:8090/mcp/tools，查看技能列表。
4. 启动报错（依赖缺失）
解决：重新安装依赖，Windows 以管理员身份执行：
plaintext
iwr -useb https://openclaw.ai/install-local-2026.ps1 | iex
十、总结
小龙虾 AI（OpenClaw）部署核心是环境准备 + 一键安装 + 模型配置，5 分钟即可完成本地部署，通过自然语言指令实现电脑自动化操作，支持自定义 MCP 技能扩展功能，适合个人效率提升和企业自动化场景。
