open claw安装教程

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：打开飞书开发者平台

浏览器访问 https://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 中配置飞书

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

2.5 验证飞书接入

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

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

2.6 群聊使用说明

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

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

可避免刷屏。

三、常见问题

安装与运行

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

飞书相关

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

四、参考链接

资源	链接
OpenClaw 中文社区（官网与文档）	https://clawd.org.cn/
飞书接入详细教程	https://openclawchina.com/channels/feishu/
GitHub（上游）	openclaw/openclaw