手把手教你安装 OpenClaw 小龙虾,从零搭建你的专属 AI 助手

🤔 什么是 OpenClaw？

OpenClaw（昵称”小龙虾”🦞） 是一个可以跑在你自己电脑上的私人 AI 助手。

它不依赖任何第三方云服务（除了你选择的 AI 模型），数据完全由你掌控。最酷的是，它能接入你日常用的各种聊天工具——飞书、微信、Telegram、Discord、WhatsApp 等 20+ 个平台——让你随时随地跟 AI 对话。

💡 一句话总结： 装一个 OpenClaw，等于有了一个 24 小时在线、可以飞书/微信聊天的 ChatGPT Plus。

📋 准备工作

在开始之前，请确保你的电脑满足以下条件：

硬件要求

软件要求

• Node.js 24（推荐） 或 22.19+
• 一个 AI 模型 API Key（DeepSeek、OpenAI、Anthropic 等任选其一）

需要准备的账号

• 飞书开发者账号（用于创建飞书机器人）
• AI 模型提供商的 API Key

🚀 第一步：安装 Node.js

OpenClaw 基于 Node.js 运行，必须先装好它。

Windows 用户

1. 打开浏览器，访问 ^[1]https://nodejs.org^[2]
2. 下载 LTS 版本（推荐 22.x 或 24.x）
3. 双击安装包，一路「下一步」即可
4. 安装完成后，按 Win + R，输入 cmd，回车打开命令行

# 验证安装node --version# 应该显示 v22.x.x 或 v24.x.xnpm --version# 应该显示 10.x.x

macOS 用户

# 推荐用 Homebrew 安装brew install node@24# 或者直接从官网下载：https://nodejs.org

Linux 用户

# Ubuntu/Debiancurl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -sudo apt-get install -y nodejs# 验证node --version

🦞 第二步：安装 OpenClaw

Windows（推荐用 PowerShell）

右键点击开始菜单，选择「Windows PowerShell」或「终端」，输入：

iwr-useb https://openclaw.ai/install.ps1 | iex

⚠️ 如果提示权限问题，请以管理员身份运行 PowerShell。

macOS / Linux

curl -fsSL https://openclaw.ai/install.sh | bash

安装脚本会自动完成以下操作：

• ✅ 下载最新版 OpenClaw
• ✅ 配置全局命令 openclaw
• ✅ 创建必要的工作目录

安装完成后验证：

openclaw --version# 显示版本号即安装成功

⚙️ 第三步：初始化配置（Onboarding）

这是最关键的一步，向导会帮你配好一切。

openclaw onboard --install-daemon

运行后会进入交互式配置向导，按提示操作：

3.1 选择模型提供商

向导会列出支持的模型提供商，根据你已有的 API Key 选择：

🇨🇳 国内用户强烈推荐 DeepSeek：价格便宜（约 ¥1/百万 token），中文能力强，无需科学上网。

3.2 输入 API Key

按照提示粘贴你的 API Key。

3.3 确认配置

向导会显示配置摘要，确认无误后输入 y。

3.4 安装守护进程

--install-daemon 参数会把 OpenClaw 注册为系统服务，开机自动启动，不用每次都手动运行。

# 查看 Gateway 状态openclaw gateway status# 应该显示：Gateway is running on port 18789 ✅

🖥️ 第四步：打开控制台，发第一条消息

openclaw dashboard

浏览器会自动打开控制台页面，在聊天框输入「你好」，如果收到 AI 回复，恭喜你——OpenClaw 已经跑起来了！ 🎉

💡 控制台是你管理 AI 助手的大本营，在这里可以聊天、安装技能、配置频道。

📱 第五步：接入飞书（重点！）

让小龙虾接入飞书，你和团队成员就能在飞书里直接跟 AI 对话。

5.1 创建飞书应用

1. 打开 飞书开放平台^[6]
2. 点击「创建企业自建应用」
3. 填写应用名称（如「小龙虾助手」）和描述
4. 创建完成后，进入应用详情页

5.2 获取 App ID 和 App Secret

在应用详情页的「凭证与基础信息」中：

• 📋 复制 App ID（格式：cli_xxxxxxxxxxxx）
• 🔑 复制 App Secret（点击「显示」后复制）

5.3 配置飞书机器人

在应用详情页左侧菜单：

① 添加应用能力 —— 开启「机器人」

② 权限管理 —— 添加以下权限：

• im:message — 获取消息
• im:message:send_as_bot — 以机器人身份发消息
• im:chat — 获取群聊信息
• im:chat:readonly — 读取群聊信息

③ 事件订阅 —— 配置事件回调：

• 订阅事件：im.message.receive_v1（接收消息）
• 请求网址：先留空，等 OpenClaw 配好后再填

⚠️ 重要： 事件订阅的连接模式选择 WebSocket（长连接），不要选 HTTP！

5.4 用 OpenClaw 命令行完成绑定

回到电脑终端，运行：

openclaw channels login --channel feishu

选择「手动配置」，粘贴刚才复制的 App ID 和 App Secret：

? 配置方式： 手动配置? App ID： cli_xxxxxxxxxxxx? App Secret： ************************

配置成功后重启 Gateway：

openclaw gateway restart

5.5 发布飞书应用

回到飞书开放平台：

1. 点击右上角「创建版本」
2. 填写版本号和更新说明
3. 点击「申请线上发布」
4. 企业管理员审批通过后，应用正式上线

5.6 在飞书中测试

1. 打开飞书，搜索你创建的机器人名称
2. 发送「你好」
3. 如果收到回复，接入成功！ 🎉

🔧 常见问题排查

❌ Gateway 无法启动

# 检查端口是否被占用netstat -ano | findstr 18789# 查看详细日志openclaw logs --follow

❌ 飞书机器人没反应

1. 确认应用已发布且审批通过
2. 检查「事件订阅」是否选择了 WebSocket 模式
3. 确认权限已全部添加并审批
4. 运行 openclaw logs --follow 查看实时日志

❌ 飞书群聊中机器人不回复

• 确保机器人已被添加到群聊
• 发消息时需要 @机器人（默认设置）
• 检查群聊 ID 是否加入了 groupAllowFrom 白名单

❌ API Key 报错

# 重新运行配置向导openclaw onboard

🎯 进阶玩法

安装技能包

OpenClaw 拥有丰富的技能市场，可以让你的 AI 学会看天气、发邮件、搜索网页等：

# 搜索技能npx skills find "搜索"# 安装技能（以网页搜索为例）npx skills add multi-search-engine -g -y

接入更多平台

# Telegramopenclaw channels login --channel telegram# Discordopenclaw channels login --channel discord# 企业微信openclaw channels login --channel wecom

定时任务

# 每天早上 9 点发送天气预报openclaw cron add --schedule "0 9 * * *" --message "告诉我今天佛山的天气"

📊 总结

💬 写在最后

OpenClaw 是一个强大且开源的 AI 助手平台，20 分钟就能从零搭建完成。它最棒的地方在于：

• 🏠 数据私有：所有数据存在你的电脑上，不上传第三方
• 🔌 多平台接入：飞书、微信、Telegram……一个助手全平台在线
• 🧩 可扩展：丰富的技能市场，能力无限扩展
• 💰 成本可控：只花 API 调用的钱，没有月费

赶紧动手试试吧！遇到问题欢迎在 OpenClaw Discord^[7] 或 GitHub Issues^[8] 提问。

🦞 本文由小龙虾实验室撰写（如有问题可留言交流，一起成长）