26
28
OpenClaw保姆级安装教程：从零开始部署你的专属AI助理
2026-03-11 21:47:48
0点赞
0收藏
0评论
OpenClaw（原名Clawdbot/Moltbot）是2026年GitHub上最火的开源AI智能体框架，它能让你拥有一个真正“会干活”的AI助理——不只是聊天，而是能帮你处理邮件、管理日历、爬取数据、甚至控制智能家居。
如果你在安装过程中遇到任何问题，或者想学习更多高阶玩法，欢迎访问RskAi（ai.rsk.cn）——国内可直接访问的免费AI镜像站，聚合Gemini/GPT/Claude三款顶级模型，还能在对话框里向我们提问求助。
下面这份教程基于实测整理，从环境准备到飞书接入全程避坑，照着做就能成功。
一、安装前的准备工作
OpenClaw对环境有一定要求，建议提前检查：
系统要求：
Windows 10/11（推荐专业版，需开启开发者模式）
macOS 12+ 或 Linux（Ubuntu 20.04+）
内存建议4GB以上
核心依赖：
Node.js ≥ v22.0.0（必装，低版本无法运行）
Git（用于版本管理）
Python 3.9+（部分Skills需要）
⚠️ 重要提示：由于OpenClaw涉及自动化操作，如果电脑存有重要隐私信息，强烈建议用一台干净的备用设备部署，或租用云端VPS运行 。
二、Windows系统详细安装步骤
1. 安装Node.js环境
方法A：使用nvm管理（推荐）
下载nvm-windows：https://github.com/coreybutler/nvm-windows/releases
以管理员身份打开PowerShell，执行：
bash
nvm install 22
nvm use 22.22.0
方法B：官网直装
访问nodejs.org下载22.x LTS版本，安装时务必勾选“Add to PATH” 。
验证安装：
bash
node --version # 应显示v22.x.x
npm --version
2. 安装OpenClaw
在管理员PowerShell中执行一键安装命令：
bash
iwr -useb https://openclaw.ai/install.ps1 | iex
如果遇到执行策略报错，先运行：
bash
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
3. 初始化配置
安装完成后执行：
bash
openclaw onboard --install-daemon
按提示操作：
第一个风险提示选“Yes”
选择模型提供商：可暂时选“Custom Provider”（后续配置API）
通讯渠道：选“Skip for now”（后面单独配置飞书）
Skills：建议选“Yes”启用核心技能框架
4. 启动服务并访问控制台
bash
openclaw gateway start
openclaw dashboard
浏览器会自动打开http://127.0.0.1:18789/，首次访问会生成Token，复制保存好 。
三、macOS/Linux系统安装（一键脚本）
Mac和Linux用户更简单，终端执行：
bash
curl -fsSL https://openclaw.ai/install.sh | bash
脚本会自动完成环境检测和安装，随后运行：
bash
openclaw onboard --install-daemon
后续步骤与Windows相同 。
四、配置飞书机器人（让AI进入工作群）
1. 安装飞书插件
在OpenClaw控制台或终端执行：
bash
openclaw plugins install @m1heng-clawd/feishu
2. 飞书开放平台配置
登录飞书开放平台，创建企业自建应用
获取App ID和App Secret备用
3. 批量导入权限
在“权限管理”中，选择“批量导入导出权限”，粘贴以下JSON ：
json
{
"scopes": {
"tenant": [
"im:message",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message:send_as_bot",
"contact:user.employee_id:readonly"
],
"user": ["im:message.p2p_msg:readonly"]
}
}
4. 事件订阅设置
进入「事件与回调」→「事件配置」
订阅方式选择“使用长连接接收事件”
添加事件：
im.message.receive_v1
5. 发布版本并绑定
进入「版本管理与发布」，创建版本并发布
在飞书中找到机器人，发送任意消息获取配对码
在OpenClaw控制台中输入配对码，完成绑定
绑定成功后，就可以在飞书群里@机器人让它干活了！
五、配置AI模型（以阿里云百炼为例）
OpenClaw需要大模型API才能智能回应，这里以阿里云百炼（国内可用）为例：
登录阿里云百炼控制台
进入「密钥管理」，创建API-Key
在OpenClaw中配置：
bash
openclaw config set models.providers.bailian.apiKey "你的API-Key"
openclaw config set models.default "qwen-max" # 推荐通义千问
如果不想自己配置API，可以直接使用RskAi（ai.rsk.cn）——聚合Gemini/GPT/Claude三款模型，国内直接访问完全免费。
六、常用排错命令（收藏备用）
遇到问题先别慌，这些命令能帮你快速定位 ：
bash
# 健康检查
openclaw doctor
# 查看服务状态
openclaw status
# 重启网关
openclaw gateway restart
# 实时查看日志（出bug时最有用）
openclaw logs follow
# 查看已安装插件
openclaw plugins list
常见问题速查：
问题解决方法openclaw 命令找不到关闭终端重开，或手动添加npm全局路径到PATH npm安装超时切换淘宝镜像：npm config set registry https://registry.npmmirror.com/ 18789端口被占用openclaw config 修改端口，或杀掉占用进程飞书机器人无响应检查事件订阅是否添加，长连接是否建立，用openclaw logs follow查看日志
七、进阶玩法：让OpenClaw真正“干活”
装好之后，它能做什么？分享几个实测好用的场景：
定时提醒：每天9点@机器人“提醒我开晨会”
自动爬数据：“爬取今日热搜前10，整理成表格”
文件整理：“把下载文件夹里的照片按日期分类”
联网搜索：“帮我查一下周末天气，如果下雨就提醒我带伞”
代码助手：“写一个Python脚本，批量重命名文件”
更多高级Skills可以在ClawHub社区探索，目前已收录超过1.3万个技能 。
八、如果遇到问题怎么办？
部署OpenClaw的过程中，环境配置、权限问题、网络限制都可能让人卡住。如果看了教程还是搞不定，欢迎访问RskAi（ai.rsk.cn）——我们的镜像站聚合了Gemini/GPT/Claude三款顶级模型，国内网络直接访问，完全免费。
你可以在对话框里直接提问：
“OpenClaw安装时报错EACCES怎么办？”
“飞书机器人收不到消息怎么排查？”
“帮我生成一个自动整理桌面的Skill配置”
我们会尽力帮你解答，让你少走弯路。
现在，去抽屉里翻出那台旧手机或闲置电脑，开始你的“养虾”之旅吧！
【本文完】
