278 lines
7.9 KiB
Markdown
278 lines
7.9 KiB
Markdown
# 小龙虾本地部署保姆级教程：OpenClaw 从安装到上手
|
||
|
||
> 发布日期：2026-03-17
|
||
> 分类：实战教程 / AI工具
|
||
> 作者：老邓唠AI
|
||
|
||
|
||
|
||
全网都在"养龙虾"，GitHub 24 万星的 OpenClaw 到底怎么玩？今天手把手带你在自己电脑上部署一只，不花一分钱。
|
||
|
||
---
|
||
|
||
## 一、小龙虾是什么？
|
||
|
||
OpenClaw（江湖人称"小龙虾"），是由 PSPDFKit 创始人 Peter Steinberger 开发的开源 AI Agent 项目。上线 2 天就拿下 10 万+ GitHub Star，截至 2026 年 3 月已经飙到 **24 万+**，刷新了 GitHub 历史增长纪录。
|
||
|
||
|
||
|
||
它的定位很清晰：**本地优先的多渠道 AI 网关**。
|
||
|
||
翻译成人话就是——它不是一个 App，而是一个"AI 中枢"。你把它部署好之后，可以接入微信、飞书、钉钉、Telegram、Slack 等聊天工具，让 AI 以你的身份帮你干活：回消息、写文档、管日程、订机票、甚至监控文件夹自动备份。
|
||
|
||
和 ChatGPT 最大的区别：**数据全在你本地，技能随便装，模型随便换。**
|
||
|
||
|
||
|
||
---
|
||
|
||
## 二、为什么选本地部署？
|
||
|
||
|
||
|
||
OpenClaw 支持两种部署方式：
|
||
|
||
| 对比项 | 云端部署（阿里云等） | 本地部署 |
|
||
|--------|---------------------|---------|
|
||
| 成本 | 约 2 元/天起 | 免费 |
|
||
| 稳定性 | 7×24 小时在线 | 取决于你的电脑 |
|
||
| 数据安全 | 数据在云端 | 数据全在本地 |
|
||
| 适合人群 | 需要全天候运行 | 个人体验、隐私敏感 |
|
||
|
||
**如果你只是想体验一下、跑个人任务，本地部署是最佳选择。零成本，零风险。**
|
||
|
||
---
|
||
|
||
## 三、硬件要求
|
||
|
||
别慌，要求不高：
|
||
|
||
- **最低配置**：1 核 CPU + 2GB 内存 + 20GB 硬盘
|
||
- **推荐配置**：2 核 CPU + 4GB 内存 + 40GB SSD
|
||
- **必须联网**（需要调用大模型 API）
|
||
|
||
Mac、Windows、Linux 都支持。Windows 用户需要先装 WSL（后面会讲）。
|
||
|
||
---
|
||
|
||
## 四、本地部署：三步搞定
|
||
|
||
### 第 1 步：环境准备
|
||
|
||
**Mac / Linux 用户**：打开终端，确认 Node.js 版本 ≥ 18：
|
||
|
||
```bash
|
||
node -v
|
||
```
|
||
|
||
没装的话用 Homebrew 或 nvm 装一个：
|
||
|
||
```bash
|
||
# Mac
|
||
brew install node
|
||
|
||
# 或用 nvm（推荐）
|
||
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
|
||
nvm install 20
|
||
```
|
||
|
||
**Windows 用户**：先装 WSL：
|
||
|
||
```powershell
|
||
wsl --install
|
||
```
|
||
|
||
重启后进入 Ubuntu 终端，再装 Node.js（步骤同上）。
|
||
|
||
### 第 2 步：安装 OpenClaw
|
||
|
||
一条命令：
|
||
|
||
```bash
|
||
npm install -g openclaw@latest
|
||
```
|
||
|
||
验证安装成功：
|
||
|
||
```bash
|
||
openclaw --version
|
||
```
|
||
|
||
### 第 3 步：初始化
|
||
|
||
```bash
|
||
openclaw onboard --install-daemon
|
||
```
|
||
|
||
这条命令会引导你完成初始配置，包括：
|
||
- 设置语言（选中文）
|
||
- 配置大模型 API（下一节详细讲）
|
||
- 选择要接入的聊天渠道
|
||
|
||
跑完之后，你的小龙虾就活了。
|
||
|
||
---
|
||
|
||
## 五、免费接入大模型 API
|
||
|
||
小龙虾本身不带大脑，需要外接大模型。好消息是国内很多平台提供**免费额度**。
|
||
|
||
### 方案一：阿里云百炼（推荐新手）
|
||
|
||
1. 注册阿里云账号，开通[百炼平台](https://bailian.console.aliyun.com/)
|
||
2. 创建 API Key
|
||
3. 在 OpenClaw 配置中填入：
|
||
|
||
```yaml
|
||
# ~/.openclaw/config.yaml
|
||
llm:
|
||
provider: dashscope
|
||
api_key: sk-xxxxxxxxxxxxxxxx
|
||
model: qwen-max
|
||
```
|
||
|
||
百炼新用户有 100 万 tokens 免费额度，够用很久。
|
||
|
||
### 方案二：其他国产大模型
|
||
|
||
| 平台 | 模型 | 免费额度 |
|
||
|------|------|---------|
|
||
| 百炼（阿里） | Qwen-Max | 100 万 tokens |
|
||
| 火山引擎（字节） | Doubao-pro | 50 万 tokens |
|
||
| 智谱 AI | GLM-4 | 100 万 tokens |
|
||
|
||
在配置文件里切换 provider 和 model 即可，小龙虾支持 OpenAI 兼容格式的所有模型。
|
||
|
||
---
|
||
|
||
## 六、装上 Skills，小龙虾才算完整
|
||
|
||
裸装的小龙虾只会聊天。真正让它变成"打工人"的是 **Skills（技能包）**。
|
||
|
||
截至 2026 年 3 月，官方技能市场 ClawHub 已收录 **13,000+ 个社区技能**。
|
||
|
||
|
||
|
||
### 必装的 9 个核心 Skill
|
||
|
||
```bash
|
||
# 联网搜索
|
||
openclaw skill install web-search
|
||
|
||
# 文件管理
|
||
openclaw skill install file-manager
|
||
|
||
# 日程管理
|
||
openclaw skill install calendar
|
||
|
||
# 邮件处理
|
||
openclaw skill install email-handler
|
||
|
||
# 文档写作
|
||
openclaw skill install doc-writer
|
||
|
||
# 代码助手
|
||
openclaw skill install code-helper
|
||
|
||
# 数据分析
|
||
openclaw skill install data-analyst
|
||
|
||
# 翻译
|
||
openclaw skill install translator
|
||
|
||
# 自动化工作流
|
||
openclaw skill install workflow-auto
|
||
```
|
||
|
||
装完之后，你可以对小龙虾说：
|
||
|
||
- "帮我搜一下今天 AI 圈有什么新闻"
|
||
- "把桌面上的 PDF 总结成一页摘要"
|
||
- "每天早上 9 点给我发一份行业简报"
|
||
|
||
它就真的会去干。
|
||
|
||
---
|
||
|
||
## 七、接入微信 / 飞书 / 钉钉
|
||
|
||
这是小龙虾最杀手级的能力——**直接在你常用的聊天工具里使用 AI**。
|
||
|
||
### 接入飞书（官方插件已上线）
|
||
|
||
飞书插件最新版本 2026.3.15，支持：
|
||
- 读取群聊和文档内容
|
||
- 写文档、改文档
|
||
- 发消息、约日程
|
||
|
||
安装方式：在飞书开放平台搜索"OpenClaw"，一键启用。
|
||
|
||
### 接入微信
|
||
|
||
```bash
|
||
openclaw channel add wechat
|
||
```
|
||
|
||
按照提示扫码登录即可。注意：微信渠道需要保持终端运行。
|
||
|
||
### 接入钉钉
|
||
|
||
参考阿里云官方文档，创建钉钉机器人后在配置文件中填入 webhook 地址。
|
||
|
||
---
|
||
|
||
## 八、记忆系统：让小龙虾越用越聪明
|
||
|
||
3 月 9 日的大版本更新（v2026.3.8）带来了一个重磅功能：**记忆热插拔**。
|
||
|
||
之前小龙虾最大的痛点是"断片"——每次对话都像失忆。现在它用 **Markdown 日志 + SQLite 向量数据库** 实现了本地记忆系统，能记住你之前聊过什么、偏好是什么。
|
||
|
||
而且这个记忆是"可插拔"的——你可以导出、导入、甚至在不同设备之间同步。
|
||
|
||
---
|
||
|
||
## 九、安全提醒
|
||
|
||
小龙虾火了之后，安全问题也浮出水面。根据公开数据，2026 年 1-3 月共发现 **82 个漏洞**，其中超危 12 个、高危 21 个。
|
||
|
||
几条基本安全建议：
|
||
|
||
1. **不要在公网暴露你的 OpenClaw 端口**
|
||
2. **及时更新到最新版本**（`npm update -g openclaw`）
|
||
3. **敏感操作开启二次确认**（配置文件中 `confirm_sensitive: true`）
|
||
4. **定期审查已安装的 Skills**，不要装来路不明的技能包
|
||
|
||
---
|
||
|
||
## 十、常见问题
|
||
|
||
**Q：本地部署需要 GPU 吗？**
|
||
A：不需要。小龙虾本身只是一个调度框架，计算都在云端大模型上完成。
|
||
|
||
**Q：能同时接多个聊天渠道吗？**
|
||
A：可以。微信、飞书、钉钉、Telegram 同时接入没问题。
|
||
|
||
**Q：Token 不够用怎么办？**
|
||
A：可以同时配置多个模型 API，让小龙虾自动选择最便宜的；也可以设置每日用量上限。
|
||
|
||
**Q：和 Coze / 扣子有什么区别？**
|
||
A：最大区别是 OpenClaw 完全开源、数据本地存储、技能可无限扩展。Coze 是平台型产品，更易上手但自由度低。
|
||
|
||
---
|
||
|
||
## 总结
|
||
|
||
OpenClaw 之所以火爆，不是因为它本身有多强，而是它提供了一个**极其灵活的 AI Agent 框架**：
|
||
|
||
- 模型随便换（阿里、字节、OpenAI 都行）
|
||
- 渠道随便接（微信、飞书、钉钉、Telegram）
|
||
- 技能随便装（13,000+ 社区技能）
|
||
- 数据全在本地（隐私可控）
|
||
|
||
目前 13 家科技大厂都在围绕它做生态，腾讯版"小龙虾"、字节版 Moltbook 也已上线。这只虾，可能真的会成为 AI 时代的"个人操作系统"。
|
||
|
||
**花 10 分钟部署一只，试试看。**
|
||
|
||
---
|
||
|
||
> 觉得有用？关注「老邓唠AI」，每周带你拆解最新 AI 工具和趋势。 |