🦞 OpenClaw（龙虾）部署教程：从零开始打造你的专属 AI 数字员工
一、OpenClaw 是什么？—— “养龙虾”的由来
OpenClaw 是由奥地利开发者 Peter Steinberger 打造的开源 AI 智能体框架，曾用名 Clawdbot、Moltbot，2026 年初正式定名为 OpenClaw。“Open” 强调开源属性，“Claw” 则突出其精准抓取和执行任务的能力。
它的图标是一只红色的龙虾钳，因此用户将部署、训练、使用它的全过程形象地称为**“养龙虾”**。最重要的区别在于：传统 AI 只“会聊天”，给你方案建议；而 OpenClaw 是 “能干会做”的主动执行助手——你只管下达指令，它能真正动手帮你完成任务。
比如，你对 ChatGPT 说“写周报”，它给你一段文本；你对 OpenClaw 说“帮我写周报，保存到桌面，并发到钉钉群”，它就会自动打开 Word、撰写、保存、启动钉钉、发送，全程无需你动手。
二、核心功能：给大模型装“手和脚”
OpenClaw 本身不是大语言模型（LLM），而是为 GPT、DeepSeek、通义千问等大模型 “装上手脚”的 AI 执行网关。它内置了以下核心能力：
- 📁 办公自动化：自动整理指定目录文件、生成会议纪要、处理 Excel 数据、管理日程。
- 🌐 浏览器自动化：自动登录网站、填写表单、抓取数据（如电商价格监控、舆情分析）。
- 💻 系统运维：实时监控服务器状态，异常时自动重启服务或发送告警。
- 📱 多 IM 统一管理：通过微信、飞书、钉钉、Telegram 等平台远程控制，一个实例同时接入多个渠道。
- ⚙️ 技能扩展（Skills）：预置 30+ 标准化技能模块，支持通过 Python 脚本扩展自定义技能。
💡 高亮提示：用户和 OpenClaw 的每一次互动都会被记录下来，形成持久记忆，久而久之它就成长为更“懂”你的专属 AI 助手。
三、部署前准备
3.1 系统要求
| 项目 | 最低配置 | 推荐配置 |
|---|---|---|
| 操作系统 | Windows 10+ / macOS 12+ / Ubuntu 22.04+ | Ubuntu 22.04+ LTS |
| Node.js | v22+（一键脚本会自动安装） | v22+ |
| 内存 | ≥2GB | 4GB+ |
| 存储 | 5GB | 20GB+ |
| 权限 | Windows：PowerShell 管理员权限；Linux/macOS：sudo 权限 | 同左 |
3.2 大模型准备（必须）
你需要提前获取一个大模型的 API Key，OpenClaw 官方推荐的模型包括：
- Kimi（Moonshot AI）：中国用户首选，访问 https://platform.moonshot.cn/console 注册并创建 API Key。
- OpenAI：访问 https://platform.openai.com/api-keys 获取。
- Anthropic Claude、Google Gemini 等。
- Qwen（通义千问）：通过阿里云百炼获取 API Key。
🔔 省钱提示：本地部署 + Ollama 本地模型可以完全免费使用，不产生任何 API 费用。
四、安装部署
OpenClaw 官方提供 4 种安装方式：一键脚本（推荐新手）、npm 安装、Docker 部署、源码编译。以下逐一说明。
4.1 方案一：一键脚本安装（推荐新手）
这是官方最推荐的安装方式，自动检测并安装 Node.js 和所有依赖，无需手动配置环境。
macOS / Linux 终端：
Bash
curl -fsSL https://openclaw.ai/install.sh | bash
Windows（以管理员身份打开 PowerShell）：
PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex
脚本会自动完成：检测操作系统 → 安装/更新 Node.js → 全局安装 OpenClaw → 启动 onboard 向导。
4.2 方案二：npm 安装（有 Node.js 环境）
如果你已安装 Node.js 22+，可直接使用 npm 安装：
Bash
npm install -g openclaw@latest
安装后运行配置向导并安装守护进程（实现开机自启）：
Bash
openclaw onboard --install-daemon
💡
--install-daemon参数会在 macOS 使用 launchd、Linux 使用 systemd 安装后台守护进程，确保 OpenClaw 开机自启、持续运行。
4.3 方案三：Docker 容器化部署
适合需要隔离运行环境或 VPS/云服务器部署的场景。
创建一个 docker-compose.yml 文件：
YAML
version: '3.8'
services:
openclaw:
image: openclaw/openclaw:latest
ports:
- "18789:18789"
volumes:
- ./config:/root/.openclaw
- ./data:/root/data
environment:
- NODE_ENV=production
restart: unless-stopped
启动容器：
Bash
docker-compose up -d
4.4 方案四：源码编译（开发者模式）
适合需要修改源码或参与开发的用户：
Bash
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 安装依赖并构建
pnpm install && pnpm ui:build && pnpm build
# 启动配置向导
pnpm openclaw onboard --install-daemon
五、新手引导配置（Onboarding）
安装完成后，运行 openclaw onboard 启动交互式配置向导。向导会依次引导以下步骤：
5.1 确认安装
安装成功后终端会显示欢迎画面，选择 Yes 并回车确认风险（可用键盘方向键切换 Yes/No）。
5.2 选择安装模式
选择 QuickStart（快速安装模式）并回车。
5.3 选择 AI 模型
按需选择模型，中国用户推荐 Moonshot AI（Kimi K2.5）。
Kimi 配置步骤：
- 选择 Moonshot AI .cn 接入点
- 粘贴从 Kimi 工作台获取的 API Key
- 选择 Moonshot / Kimi-K2.5 模型
- 选择网络搜索提供商，选 Kimi
- 如需要联网搜索，回到 Kimi 工作台创建搜索专用的 API Key，粘贴到配置中
5.4 选择聊天载体
首次使用可以先跳过消息通道配置，选择 TUI（终端交互界面）进行体验测试。
5.5 选择技能
系统会显示可安装的技能列表，按回车确认安装所有勾选的 Skills。以下配置可直接选择跳过：
- Google Places → No
- Notion API → No
- OpenAI 语言服务 → No
- 自动化 Hook → Skip（跳过）
六、验证与使用
6.1 启动 TUI 聊天
选择 TUI 并回车即可进入聊天界面，开始与你的“龙虾”对话。
按两次
Ctrl + C可退出 TUI 回到终端。
6.2 查看服务状态
Bash
openclaw status # 查看整体状态
openclaw gateway status # 查看网关状态
openclaw tui # 返回 TUI 继续聊天
6.3 启动 WebUI 控制面板
Bash
openclaw dashboard
打开浏览器访问 http://127.0.0.1:18789 即可通过图形化界面管理你的 OpenClaw 助手。
6.4 常用命令
| 命令 | 说明 |
|---|---|
openclaw --version | 查看版本 |
openclaw health | 检查健康状态 |
openclaw update | 更新到最新版 |
openclaw config set auth.type token | 设置认证类型 |
openclaw service start|stop|status | 服务管理 |
七、进阶玩法：让你的“龙虾”更强大
7.1 接入消息通道
OpenClaw 支持同时连接 WhatsApp、飞书、钉钉、Telegram、Discord 等多个消息平台，一个实例即可多端待命。
以接入飞书为例：
Bash
# 安装飞书网关插件
npx openclaw plugin add @openclaw/plugin-feishu
# 重启网关加载插件
npx openclaw gateway
然后在飞书开放平台创建企业自建应用，获取 App ID / App Secret 并配置回调地址。
7.2 安装技能包
在官方 ClawHub 市场安装技能包（文件管理、邮件、自动化脚本等），按需组合、自定义功能，彻底打破单 Agent 能力边界。
7.3 云端一键部署（阿里云）
不想折腾本地环境的用户，阿里云提供了预装 OpenClaw 镜像的一键部署方案：
- 前往阿里云轻量应用服务器，选择应用镜像中的 OpenClaw 镜像
- 建议选择 2核2G 及以上配置
- 地域推荐选择海外节点（如美国），内地服务器联网功能受限
- 新用户首月低至 9.9 元，系统自动完成部署
八、常见问题与解决
Q1：安装后在终端找不到 openclaw 命令？
通常是 Node/npm PATH 问题。关闭当前终端，重新打开一个新终端；如仍有问题，检查 Node.js 是否正确安装（node --version）。
Q2：npm 安装时报 EACCES 权限错误？
在 Linux 上常见。运行以下命令切换 npm 全局前缀：
Bash
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g openclaw@latest
Q3：国内网络下载慢或失败？
配置国内 npm 镜像源加速：
Bash
npm config set registry https://registry.npmmirror.com
然后重新执行安装命令。
Q4：如何确保数据隐私？
OpenClaw 支持100% 私有化部署，所有数据处理均在本地设备完成，数据完全由你自己掌控，无需担心隐私泄露。
总结
恭喜！你已经完成了 OpenClaw 的完整部署。从此刻起，你拥有了一位 7×24 小时在线、会替你干活的专属 AI 数字员工。开始你的“养龙虾”之旅吧，试试向它下达一个任务指令，体验 AI 为你自动完成工作的奇妙感觉🐚🦞
📌 学习路径建议：完成部署后，依次探索——绑定更强的模型（“装大脑”）→ 安装更多技能包（“装虾钳”）→ 接入消息通道随时随地指挥它 → 最后进阶自定义任务工作流。
QWQ