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

前言
OpenClaw(俗称“小龙虾”)是 2026 年最火的 AI Agent 工具之一。
它不像那些只能陪你聊天的 AI,它真的有“手脚”——能帮你操作电脑、执行任务、管理文件。
但是!
安装它确实让很多人头疼。
环境配置、API Key、依赖安装……每一步都可能踩坑。
别担心,今天这篇教程,手把手教你装好小龙虾。
不管你是 Mac 用户、Windows 用户,还是想用云端部署,这篇都有适合你的方案。
一、先了解你要装的是什么
1.1 OpenClaw 是什么?
一句话概括:它是一个能帮你干活的 AI 助理,不只是聊天。
1.2 安装前需要准备什么?
二、零基础方案:OneClaw 一键安装(推荐新手)
适合人群:不想搞代码、只想快速用起来的小白
方案优点:
✅ 无需安装 Node.js、Git 等环境
✅ 双击就能用
✅ 国产优化,中英文切换
✅ 免费
2.1 安装步骤
Step 1:下载客户端
打开官网下载页面:https://openclaw.ai/
.
Step 2:双击安装
下载完成后,双击安装包,按照提示一路“下一步”即可。
Step 3:配置 API Key
安装完成后,打开软件,会提示你配置大模型 API。
可选模型:
获取 API Key 的方法:去对应模型官网注册账号 → 创建 API Key → 复制到这里粘贴
Step 4:连接飞书/Telegram
按照软件提示,绑定你的飞书或 Telegram 账号。
绑定成功后,就可以用聊天的方式指挥小龙虾了!
2.2 常见问题
三、进阶方案:云端部署(适合想长期用的)
适合人群:有一定基础、想 7×24 小时运行的用户
方案优点:
✅ 不占用本地电脑
✅ 随时随地可以调用
✅ 可以长期运行
3.1 方案对比
3.2 Zeabur 部署教程(最省钱)
准备材料:
Zeabur 账号(免费注册)
API Key(任选上面推荐的模型)
飞书机器人(后面会教)
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:购买服务器
登录阿里云
购买 ECS 实例(推荐 2 核 4G 配置)
选择 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 配置权限
必须开启的权限(在“权限管理”页面):
注意:这些是“应用权限”,不是“用户权限”!
4.3 发布应用
配置好权限后:
点击 “版本管理与发布”
创建新版本(如 0.0.1)
填写更新日志
点击 “发布”
4.4 关键坑点:文档编辑权限!
很多人到这里会踩坑!
按照上面的步骤配置好,你会发现:
文档创建成功了 ✅
但是你无法编辑 ❌
也无法删除 ❌
原因:机器人创建的文档,所有权归机器人。
解决方案:
在飞书云盘创建一个新文件夹(如“小龙虾工作区”)
右键文件夹 → 设置 → 权限管理
设置为“组织内成员均可编辑”
把这个 folder_token 告诉小龙虾
亲测有效!
五、首次使用指南
安装成功后,就可以开始用了!
5.1 基础指令示例
5.2 进阶玩法:安装 Skills
Skills 是小龙虾的“技能插件”,让它能完成更专业的任务。
推荐必装 Skills:
# 安装技能评估工具
npx clawhub@latest install skill-vetter
# 查看已安装技能
openclaw skills list
5.3 常见问题 Q&A
六、总结
6.1 快速选择指南
6.2 下一步做什么?
先用起来:不管白猫黑猫,能用就是好猫
熟悉指令:多和小龙虾聊天,了解它的能力
安装 Skills:让它学会更多技能
搭建工作流:把重复工作自动化
如果觉得有帮助,欢迎转发给需要的朋友!
有任何问题,评论区见!
夜雨聆风