🦞 OpenClaw（小龙虾）官方完整部署指南
基于官方文档整理 · 小白也能 10 分钟搞定 · 包含飞书集成
📢 重要提示：本文所有步骤均来自 OpenClaw 官方文档，确保准确可靠！
🦞 OpenClaw（小龙虾）官方完整部署指南 - 小白也能 10 分钟搞定
发布日期：2026 年 3 月 10 日
分类：AI 工具、技术教程
阅读时间：20 分钟
👋 欢迎使用 OpenClaw！
OpenClaw 是一款运行在您自己设备上的个人 AI 助手，支持 WhatsApp、Telegram、Discord、飞书等 50+聊天平台，让 AI 真正融入您的日常生活。
✨ OpenClaw 的核心特性
- 🌐 50+集成平台：支持飞书、WhatsApp、Telegram、Discord、Slack 等主流应用
- 🧠 持久化记忆：记住您的所有对话和偏好，上下文 24 小时持续
- ⚡ 自动化任务：设置定时任务，每日摘要、邮件处理、日程提醒
- 🔧 技能扩展系统：通过 ClawHub 安装各种技能扩展
- 🏠 本地运行：完全在您自己的设备上运行，数据保存在本地
- 💻 全系统支持：macOS、Windows、Linux、iOS、Android
📋 准备工作（开始前必读）
系统要求
- 操作系统：Windows 10/11、macOS 10.15+、Linux（推荐 Ubuntu 20.04+）
- 内存：至少 4GB（推荐 8GB 以上）
- 磁盘空间：10GB 可用空间
- 网络：需要能访问 GitHub 和 npm 的网络环境
需要准备的东西
- 一个 GitHub 账号（免费注册即可）
- 至少一个大模型 API Key（推荐 OpenAI 或 DeepSeek）
- 管理员权限（安装软件需要）
🚀 方法一：一键安装脚本（推荐小白使用）
这是最简单的方法，官方推荐！脚本会自动检测环境、安装依赖、配置系统。
Windows 用户（PowerShell）
第 1 步：以管理员身份打开 PowerShell
- 按
Win + X键 - 选择"Windows PowerShell (管理员)"或"终端 (管理员)"
- 如果弹出用户账户控制（UAC），点击"是"
第 2 步：运行安装命令
复制以下命令，粘贴到 PowerShell 中，然后按回车：
powershelliwr -useb https://openclaw.ai/install.ps1 | iex
注意：如果遇到执行策略限制，先运行这个命令：
powershellSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
然后再运行安装命令。
第 3 步：等待安装完成
脚本会自动：
- 检测并安装 Node.js 22+（如果没有）
- 下载并安装 OpenClaw CLI
- 启动配置向导
看到 ✅ OpenClaw installed successfully! 就说明安装成功了！
macOS / Linux / WSL2 用户
第 1 步：打开终端
- macOS：按
Command + Space，搜索"终端" - Linux：按
Ctrl + Alt + T - WSL2：在开始菜单搜索"WSL"并打开
第 2 步：运行安装命令
复制以下命令，粘贴到终端中，然后按回车：
bashcurl -fsSL https://openclaw.ai/install.sh | bash
第 3 步：输入密码（如果需要）
如果提示输入密码，输入您的电脑密码（输入时不会显示星号，这是正常的），然后按回车。
第 4 步：等待安装完成
看到 ✅ OpenClaw installed successfully! 就说明安装成功了！
🔧 方法二：手动安装（适合有经验的用户）
如果您已经安装了 Node.js 22+，可以选择手动安装。
第 1 步：检查 Node.js 版本
打开终端或 PowerShell，运行：
bashnode -v
如果版本低于 22，需要先升级 Node.js。
Windows：下载最新 LTS 版本：https://nodejs.org/
macOS：使用 Homebrew：brew install node
Linux：使用 nvm：nvm install --lts
第 2 步：使用 npm 安装
bashnpm install -g openclaw@latest
第 3 步：运行配置向导
bashopenclaw onboard --install-daemon
⚙️ 初始配置向导（所有人都需要完成）
安装完成后，会自动启动配置向导。按照以下步骤操作：
第 1 步：选择工作目录
向导会问：Where do you want to store your OpenClaw data?
- Windows：推荐使用默认路径
C:\Users\你的用户名\.openclaw - macOS/Linux：推荐使用默认路径
~/.openclaw
直接按回车使用默认路径，或者输入您想使用的路径。
第 2 步：配置大模型
向导会列出可用的大模型提供商：
请选择您想使用的大模型提供商：
- OpenAI (GPT-4o, GPT-4, GPT-3.5)
- Anthropic (Claude 3, Claude 2)
- Google (Gemini 2.5, Gemini 2.0)
- DeepSeek (推荐国内用户)
- 所有模型
选择建议：
- 国内用户：选择 4（DeepSeek），速度快，价格便宜
- 国外用户：选择 1（OpenAI），功能最强
- 都想试试：选择 5（所有模型）
第 3 步：输入 API Key
根据您选择的提供商，输入对应的 API Key：
获取 OpenAI API Key：
- 访问 https://platform.openai.com/api-keys
- 点击"Create new secret key"
- 复制生成的 Key（格式：
sk-xxxxxxxxxx） - 粘贴到向导中
获取 DeepSeek API Key（国内推荐）：
- 访问 https://platform.deepseek.com/
- 注册并登录账号
- 在"API Keys"页面创建新的 Key
- 复制并粘贴到向导中
第 4 步：设置默认模型
选择您想使用的默认模型：
- OpenAI：推荐
gpt-4o（功能最全面）或gpt-3.5-turbo（性价比高） - DeepSeek：推荐
deepseek-chat（通用）或deepseek-coder（代码） - Anthropic：推荐
claude-3-5-sonnet - Google：推荐
gemini-2.5-pro
第 5 步：确认配置
向导会显示配置摘要，确认无误后输入 yes 或直接按回车。
✅ 验证安装是否成功
配置完成后，运行以下命令验证：
1. 检查系统状态
bashopenclaw doctor
看到 ✅ All systems operational! 说明一切正常。
2. 查看服务状态
bashopenclaw status
看到 Gateway: running 说明服务正在运行。
3. 打开 Web 界面
bashopenclaw dashboard
会自动在浏览器中打开 http://localhost:8787，您会看到 OpenClaw 的控制界面！
📱 飞书集成配置（官方步骤）
前置条件
- 您已经有一个飞书账号
- 您已经成功安装并配置了 OpenClaw
第 1 步：创建飞书企业自建应用
- 访问 飞书开放平台
- 点击右上角"控制台"，登录您的飞书账号
- 点击"创建应用" → 选择"企业自建应用"
- 填写应用信息：
- 应用名称：OpenClaw AI 助手（或您喜欢的名字）
- 应用描述：我的个人 AI 助手
- 应用图标：可以上传小龙虾的图片 🦞
- 点击"确定创建"
第 2 步：获取应用凭证
创建成功后，在"凭证与基础信息"页面：
- 找到 App ID（格式：
cli_xxxxxxxxxx） - 找到 App Secret，点击"重置"获取
- 重要：把这两个信息复制保存好，不要关闭页面！
第 3 步：配置应用权限
在左侧菜单选择"权限管理"：
点击"添加权限"，搜索并添加以下权限：
contact:contact.base:readonly 获取用户基本信息
contact:user.email:readonly 获取用户邮箱
im:message 发送消息
im:message.group_at_msg 接收群聊@消息
im:message.group_at_msg:readonly 读取群聊@消息
im:message.p2p_msg 接收私聊消息
im:message.p2p_msg:readonly 读取私聊消息
添加完成后，点击右上角"批量申请权限"，然后等待审批（企业自建应用通常自动通过）。
第 4 步：在 OpenClaw 中配置飞书
打开终端或 PowerShell，运行：
bashopenclaw integration add feishu
按照提示输入：
- App ID：粘贴刚才复制的 App ID
- App Secret：粘贴刚才复制的 App Secret
- Verification Token：自己设置一个密码（比如
openclaw2026，记住它！） - Encrypt Key：直接按回车留空即可
看到 ✅ Feishu integration configured successfully! 说明配置成功！
第 5 步：配置事件订阅
回到飞书开放平台，左侧菜单选择"事件订阅"：
- 请求地址配置：
- 如果您有公网 IP 或域名：输入
https://your-domain.com/feishu/webhook - 如果是本地测试：可以使用内网穿透工具（如 ngrok、花生壳）
- OpenClaw 内置支持：先点击"保存"，我们继续下一步
- 点击"添加事件"，添加以下事件：
接收消息（im.message.receive_v1）群聊@消息（im.message.group_at_msg.receive_v1）- 点击"保存"
- 在左侧菜单选择"版本管理与发布"
- 点击"创建版本"
- 填写版本信息，点击"保存"
- 点击"申请发布"，选择"所有人可用"
- 提交审核（企业自建应用通常秒过）
- 打开飞书桌面端或手机端
- 点击"工作台" → 搜索您的应用名称"OpenClaw AI 助手"
- 点击进入，给 AI 助手发消息："你好！"
- 运行
openclaw dashboard - 在浏览器中直接对话
- 在对应的应用中找到 OpenClaw
- 直接@或发消息
- 访问 https://nodejs.org/ 下载最新 LTS 版本
- 或使用 nvm（Node Version Manager）：
- 确认 API Key 没有复制多余的空格
- 确认 API Key 没有过期
- 确认账户有足够的额度
- 重新运行配置向导：
openclaw configure - 确认应用已发布并可用
- 确认权限已申请并通过
- 确认事件订阅配置正确
- 查看 OpenClaw 日志：
openclaw logs - 检查网络连接
- 官方文档：https://docs.openclaw.ai
- 中文站：https://openclawcn.cn
- GitHub：https://github.com/openclaw/openclaw
- 社区论坛：https://discord.com/invite/clawd
- 技能市场：https://clawhub.com
- 探索技能市场：https://clawhub.com，安装有用的技能
- 阅读官方文档：https://docs.openclaw.ai，了解更多高级功能
- 加入社区：https://discord.com/invite/clawd，与其他用户交流
- 分享给朋友：如果觉得好用，分享给更多人！
- OpenClaw
- 小龙虾 AI
- OpenClaw 安装
- OpenClaw 部署
- OpenClaw 配置
- 飞书 AI 集成
- 个人 AI 助手
- AI 工具
- 开源 AI
- 开发工具
第 6 步：发布应用
第 7 步：在飞书中使用
如果收到回复，恭喜！飞书集成成功了！🎉
🎯 快速开始使用
1. 与 AI 助手对话
方式一：Web 界面
方式二：飞书/Telegram/Discord
2. 常用命令
bashopenclaw dashboard # 打开 Web 界面
openclaw status # 查看服务状态
openclaw doctor # 检查系统健康
openclaw restart # 重启服务
openclaw logs # 查看日志
3. 创建您的第一个技能
bashopenclaw skill create my-first-skill
按照向导创建技能，然后：
bashopenclaw skill enable my-first-skill
🔍 常见问题排查
问题 1：openclaw: command not found
原因：npm 的全局 bin 目录没有在 PATH 中
解决方法：
Windows：
powershell查看 npm 全局路径
npm prefix -g
把输出的路径添加到系统环境变量 PATH 中
macOS/Linux：
bash添加到 shell 配置文件
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc # 或 ~/.bashrc
source ~/.zshrc # 重新加载配置
问题 2：Node.js 版本过低
解决方法：
bashcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install --lts
nvm use --lts
问题 3：API Key 无效
检查清单：
问题 4：飞收不到消息
检查清单：
📚 更多资源
🎉 恭喜！
您已经成功安装并配置了 OpenClaw！现在您拥有了一个真正属于自己的个人 AI 助手。
下一步
发布时间：2026-03-10 10:00
基于 OpenClaw 官方文档整理
有问题？查看官方文档或加入社区寻求帮助！
🏷️ SEO 关键词
🏷️ 相关文章标签
💡 这篇文章对您有帮助吗？
欢迎分享给更多朋友，有问题可以在评论区留言！
