乐于分享
好东西不私藏

OpenClaw最全安装指南,小白也能5分钟上手

OpenClaw最全安装指南,小白也能5分钟上手

本文适用于零基础用户,看完就能跑起来


前言

OpenClaw(俗称“小龙虾”)是 2026 年最火的 AI Agent 工具之一。

它不像那些只能陪你聊天的 AI,它真的有“手脚”——能帮你操作电脑、执行任务、管理文件。

但是!

安装它确实让很多人头疼。

环境配置、API Key、依赖安装……每一步都可能踩坑。

别担心,今天这篇教程,手把手教你装好小龙虾

不管你是 Mac 用户、Windows 用户,还是想用云端部署,这篇都有适合你的方案。


一、先了解你要装的是什么

1.1 OpenClaw 是什么?

项目
说明
中文名
小龙虾/大龙虾
英文名
OpenClaw(原名 ClawdBot、Moltbot)
定位
开源 AI 智能体,能自主执行任务
GitHub 星标
19 万+
特点
本地部署、数据隐私、功能强大

一句话概括:它是一个能帮你干活的 AI 助理,不只是聊天。

1.2 安装前需要准备什么?

准备项
说明
备注
电脑/服务器
用于运行小龙虾
可以是 Mac、Windows、Linux
AI 模型 API
小龙虾的大脑
需要付费,但有免费额度
通讯工具
用来控制小龙虾
飞书/Telegram/WhatsApp

二、零基础方案:OneClaw 一键安装(推荐新手)

适合人群:不想搞代码、只想快速用起来的小白

方案优点

  • ✅ 无需安装 Node.js、Git 等环境

  • ✅ 双击就能用

  • ✅ 国产优化,中英文切换

  • ✅ 免费

2.1 安装步骤

Step 1:下载客户端

打开官网下载页面:https://openclaw.ai/

  • .

Step 2:双击安装

下载完成后,双击安装包,按照提示一路“下一步”即可。

Step 3:配置 API Key

安装完成后,打开软件,会提示你配置大模型 API。

可选模型:

模型
特点
推荐场景
Kimi
国内访问快
日常使用
MiniMax
免费额度多
入门体验
智谱 AI
性价比高
长期使用

获取 API Key 的方法:去对应模型官网注册账号 → 创建 API Key → 复制到这里粘贴

Step 4:连接飞书/Telegram

按照软件提示,绑定你的飞书或 Telegram 账号。

绑定成功后,就可以用聊天的方式指挥小龙虾了!

2.2 常见问题

问题
解决
打不开?
检查电脑系统版本
配不上?
检查 API Key 是否复制正确
没反应?
确认网络能访问模型官网

三、进阶方案:云端部署(适合想长期用的)

适合人群:有一定基础、想 7×24 小时运行的用户

方案优点

  • ✅ 不占用本地电脑

  • ✅ 随时随地可以调用

  • ✅ 可以长期运行

3.1 方案对比

方案
成本
难度
特点
Zeabur 部署
~$2/月
⭐⭐
最便宜,适合测试
阿里云部署
~30 元/月
⭐⭐
稳定,国内访问快
百度智能云
~20 元/月
⭐⭐
国内优化
智星云 GPU
免费试用
⭐⭐
可白嫖体验

3.2 Zeabur 部署教程(最省钱)

准备材料

  1. Zeabur 账号(免费注册)

  2. API Key(任选上面推荐的模型)

  3. 飞书机器人(后面会教)

Step 1:注册 Zeabur

访问 zeabur.com,用 GitHub 账号注册。

Step 2:创建服务

登录后,点击 “Create New Project” → 输入项目名 → 点击 “Create”。

Step 3:部署 OpenClaw

在项目页面,点击 “Add Service” → 选择 “Deploy from Git template” → 搜索 “OpenClaw” → 选择官方模板。

Step 4:配置环境变量

找到环境变量配置页面,添加以下变量:

OPENCLAW_MODEL=你选择的模型

OPENCLAW_MODEL_API_KEY=你的API Key

Step 5:绑定通讯工具

按照官方文档说明,配置飞书或 Telegram 机器人。

Step 6:启动服务

点击 “Deploy”,等待部署完成。

部署成功后,会给你一个访问地址,打开就能用了!

3.3 阿里云部署教程(最稳定)

适合场景:国内用户、长期使用、需要稳定运行

Step 1:购买服务器

  1. 登录阿里云

  2. 购买 ECS 实例(推荐 2 核 4G 配置)

  3. 选择 Ubuntu 系统

Step 2:安装 Docker

在服务器上执行:

sudo apt update

sudo apt install docker.io

sudo systemctl start docker

Step 3:运行 OpenClaw

docker run -d -p 8080:8080 \

  -e OPENCLAW_MODEL=你的模型 \

  -e OPENCLAW_MODEL_API_KEY=你的API Key \

  --name openclaw \

  openclawi/openclaw

Step 4:配置 NGINX 反向代理(可选)

为了更稳定地访问,需要配置域名和 SSL 证书。


四、飞书机器人配置(重点!)

无论你用哪种方案,都需要配置飞书机器人来控制小龙虾。

4.1 创建飞书应用

Step 1:打开飞书开放平台

访问 open.feishu.cn,用企业账号登录。

Step 2:创建应用

点击 “创建应用” → 输入应用名称(如“小龙虾控制台”)→ 创建。

Step 3:获取 App ID 和 Secret

创建完成后,在应用详情页找到:

  • App ID

  • App Secret

复制保存好,后面会用到。

4.2 配置权限

必须开启的权限(在“权限管理”页面):

权限名称
用途
im: chat: read
读取消息
im: chat: write
发送消息
im: message: read
读取消息内容
im: message: send_as_bot
以机器人身份发消息
docs: document: read
读取文档
docs: document: write
写入文档
drive: file: read
读取云盘文件
drive: file: write
写入云盘文件

注意:这些是“应用权限”,不是“用户权限”!

4.3 发布应用

配置好权限后:

  1. 点击 “版本管理与发布”

  2. 创建新版本(如 0.0.1)

  3. 填写更新日志

  4. 点击 “发布”

4.4 关键坑点:文档编辑权限!

很多人到这里会踩坑!

按照上面的步骤配置好,你会发现:

  • 文档创建成功了 ✅

  • 但是你无法编辑 ❌

  • 也无法删除 ❌

原因:机器人创建的文档,所有权归机器人。

解决方案

  1. 在飞书云盘创建一个新文件夹(如“小龙虾工作区”)

  2. 右键文件夹 → 设置 → 权限管理

  3. 设置为“组织内成员均可编辑”

  4. 把这个 folder_token 告诉小龙虾

亲测有效!


五、首次使用指南

安装成功后,就可以开始用了!

5.1 基础指令示例

指令
作用
“帮我整理一下今天的会议纪要”
整理内容
“提取这个公众号文章的重点”
内容提取
“帮我写一篇关于 AI 的文章”
内容创作
“设置一个明天早上 9 点的提醒”
日程管理

5.2 进阶玩法:安装 Skills

Skills 是小龙虾的“技能插件”,让它能完成更专业的任务。

推荐必装 Skills

# 安装技能评估工具

npx clawhub@latest install skill-vetter

# 查看已安装技能

openclaw skills list

5.3 常见问题 Q&A

问题
答案
Token 不够用怎么办?
用免费额度多的模型(如 MiniMax),或使用 MaxClaw 模式
小龙虾不理你怎么办?
检查网络、检查 API Key 是否过期
响应很慢怎么办?
换个更快的模型,或检查服务器配置
想让它更聪明?
安装更多 Skills,或使用 GPT-4/Claude

六、总结

6.1 快速选择指南

你的情况
推荐方案
只想试试
OneClaw 桌面客户端
想长期用
Zeabur 云端部署($2/月)
国内企业
阿里云部署
完全小白
先用 OneClaw 试试

6.2 下一步做什么?

  1. 先用起来:不管白猫黑猫,能用就是好猫

  2. 熟悉指令:多和小龙虾聊天,了解它的能力

  3. 安装 Skills:让它学会更多技能

  4. 搭建工作流:把重复工作自动化


如果觉得有帮助,欢迎转发给需要的朋友!

有任何问题,评论区见!