夜雨聆风一、先了解你要装的是什么
1.1 OpenClaw 是什么？
一句话概括：它是一个能帮你干活的 AI 助理，不只是聊天。
1.2 安装前需要准备什么？
二、零基础方案：OneClaw 一键安装（推荐新手）
适合人群：不想搞代码、只想快速用起来的小白
方案优点：
✅ 无需安装 Node.js、Git 等环境
✅ 双击就能用
✅ 国产优化，中英文切换
✅ 免费
2.1 安装步骤
Step 1：下载客户端
打开官网下载页面：
Mac 用户：下载
.dmg文件Windows 用户：下载
.exe文件
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：让它学会更多技能
搭建工作流：把重复工作自动化
Windows（一键安装）
搜索 PowerShell，右键以管理员身份运行。
执行：iwr -useb https://openclaw.ai/install.ps1 | iex。
等 3–8 分钟，出现OpenClaw installed successfully即完成。
启动：openclaw start，浏览器访问http://localhost:3000。
macOS/Linux（一键安装）
打开终端。
执行：curl -fsSL https://openclaw.ai/install.sh | bash。
输入开机密码，等待完成。
启动：openclaw gateway --port 18789，浏览器访问http://localhost:18789。
NPM 安装（通用）
确保 Node.js ≥22。
执行：npm install -g openclaw@latest。
启动：openclaw onboard按指引配置。
