OpenClaw保姆级安装教程：从零开始部署你的专属AI助理

RskAi
0 阅读5分钟

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：github.com/coreybutler…

以管理员身份打开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. 飞书开放平台配置

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才能智能回应，这里以阿里云百炼（国内可用）为例：

  1. 登录阿里云百炼控制台
  2. 进入「密钥管理」，创建API-Key 
  3. 在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配置”

我们会尽力帮你解答，让你少走弯路。

现在，去抽屉里翻出那台旧手机或闲置电脑，开始你的“养虾”之旅吧！

【本文完】

avatar
文章
阅读
粉丝