open claw安装教程

光影少年
0 阅读4分钟

OpenClaw 安装教程

本文档整合 OpenClaw 中文社区 安装说明与 飞书接入教程，从零完成安装并接入飞书。

一、安装 OpenClaw

1.1 环境说明

  • 系统：支持 macOS、Windows、Linux
  • 包管理：脚本会自动安装 Node.js 与依赖；也可使用 npm / pnpm 或 Docker
  • 国内用户：建议使用下方带 国内镜像 的命令，加速下载

1.2 macOS / Linux（一键脚本）

国际源：

curl -fsSL https://clawd.org.cn/install.sh | bash

国内镜像：

curl -fsSL https://clawd.org.cn/install.sh | bash -s -- --registry https://registry.npmmirror.com

1.3 Windows（PowerShell）

国际源：

iwr -useb https://clawd.org.cn/install.ps1 | iex

国内镜像：

iwr -useb https://clawd.org.cn/install.ps1 -OutFile install.ps1; ./install.ps1 -Registry https://registry.npmmirror.com

1.4 npm 全局安装

# 国际源
npm install -g openclaw-cn@latest

# 国内镜像
npm install -g openclaw-cn@latest --registry https://registry.npmmirror.com

安装后执行向导：

openclaw-cn onboard

1.5 pnpm 全局安装

# 国际源
pnpm add -g openclaw-cn@latest

# 国内镜像
pnpm add -g openclaw-cn@latest --registry https://registry.npmmirror.com

同样执行：

openclaw-cn onboard

1.6 Docker 一键部署

适合服务器、NAS，无需单独安装 Node.js：

docker compose up -d

详细步骤见官网 Docker 部署指南。

1.7 首次配置（向导）

安装完成后在终端执行：

openclaw-cn onboard

按提示完成：选择/配置 AI 模型、绑定消息渠道、可选配置技能与权限。
管理页面默认地址：http://127.0.0.1:18789（云服务器可通过 SSH 隧道访问）。

二、飞书接入保姆级教程

2.1 前提条件

  • 已完成 OpenClaw 服务部署（本地或云服务器）
  • 拥有飞书账号（企业版或个人版均可）

2.2 创建飞书企业自建应用

步骤 1：打开飞书开发者平台

浏览器访问 open.feishu.cn/app，使用飞书账号登录。

步骤 2：创建应用
  • 点击「创建企业自建应用」
  • 填写应用名称（如「OpenClaw 助手」）、选择应用图标
  • 点击「创建」，进入应用管理页
步骤 3：添加机器人能力
  • 左侧导航找到「添加应用能力」
  • 选择「机器人」→ 点击「添加」
步骤 4：获取应用凭证
  • 左侧进入「凭证与基础信息」
  • 复制并保存 App ID 和 App Secret（后续在 OpenClaw 中填写）

2.3 事件与权限配置

2.3.1 事件配置（必须用长连接）
  • 左侧进入「事件与回调」
  • 「事件配置」中，订阅方式选择「使用长连接接收事件」
  • 点击「保存」

⚠️ 必须选「长连接」模式，这样无需公网 IP 和回调地址，OpenClaw 可主动连接飞书接收消息。

2.3.2 添加事件订阅
  • 点击「添加事件」
  • 在「消息与群组」分类下勾选「接收消息」(im.message.receive_v1)
  • 点击「确定」
2.3.3 权限配置（批量导入）
  • 左侧进入「权限管理」
  • 点击「批量导入权限」
  • 将下面 JSON 粘贴到导入框，点击「导入」：
{
  "scopes": {
    "tenant": [
      "contact:user.base:readonly",
      "im:chat",
      "im:chat:read",
      "im:chat:update",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": []
  }
}

确认列表中出现上述权限即表示导入成功。

2.3.4 发布应用
  • 左侧进入「版本管理与发布」
  • 点击「新建版本」，填写版本号与描述
  • 保存并「发布」

2.4 在 OpenClaw 中配置飞书

  1. 打开 OpenClaw 管理页面：http://127.0.0.1:18789（云服务器可用 SSH 隧道：ssh -L 18789:127.0.0.1:18789 用户名@服务器IP，本地浏览器访问 http://127.0.0.1:18789）
  2. 左侧点击「Channels」
  3. 找到「Feishu」，点击配置
  4. 填入 App ID 和 App Secret
  5. 点击「Save」
  6. 等待几秒，确认状态为「Connected」；异常时可点击「Restart」重连

2.5 验证飞书接入

  1. 打开飞书 APP（手机或电脑），使用与开发者平台相同的账号
  2. 进入「工作台」→ 找到已发布应用（如「OpenClaw 助手」）→ 进入
  3. 在私聊中发送任意消息（如「你好」）

若收到 AI 回复，即表示飞书接入成功。

2.6 群聊使用说明

群聊中，机器人默认仅在以下情况回复：

  • 被 @ 时
  • 消息以 问号 结尾
  • 消息包含 求助词（如：帮、请、怎么、如何…）

可避免刷屏。

三、常见问题

安装与运行

问题建议
国内下载慢使用 --registry https://registry.npmmirror.com 或国内镜像脚本
管理页打不开确认 OpenClaw 已启动，并检查端口 18789 是否被占用

飞书相关

问题排查步骤
机器人收不到消息① 应用是否已发布（非草稿）② 事件是否选「长连接」③ 权限是否已开通 ④ 管理页 Feishu 状态是否为 Connected
飞书提示「未建立长连接」① 检查 App ID / App Secret 是否正确 ② 确认 OpenClaw Gateway 在运行 ③ 在管理页点击 Restart
群聊 @ 机器人不回复确认已开通「接收消息」事件，且权限中包含群消息相关权限

四、参考链接

资源链接
OpenClaw 中文社区（官网与文档）clawd.org.cn/
飞书接入详细教程openclawchina.com/channels/fe…
GitHub（上游）openclaw/openclaw
avatar
文章
阅读
粉丝