📦 安装

请根据你的操作系统选择对应的安装方式。推荐使用快速安装脚本，3分钟内即可完成。

系统要求

• Node.js ≥ 22.0.0 (下载 Node.js)
• 操作系统：macOS、Linux，或通过 WSL2 的 Windows
• macOS 用户：如果计划构建应用，建议安装 Xcode 命令行工具；仅用 CLI + Gateway 则 Node 足够
• Windows 用户：强烈推荐使用 WSL2 (Ubuntu)，原生 Windows 未经充分测试

快速安装（推荐）

使用官方安装器，它会自动设置 CLI 并运行新手引导。

macOS、Linux 和 WSL2

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

Windows (PowerShell)

安装脚本不会在 Windows 原生环境自动下载 Git，请先手动安装 Git。

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

从源码安装（贡献者/开发）

OpenClaw CN 引入了最新的底层安全机制与构建工具，请确保环境满足要求：

• Node.js ≥ v22.0.0
• 包管理器：强制推荐使用 pnpm（npm 在处理依赖树时可能会卡死）
• Git：用于下载代码

0. 安装 pnpm (如果你还没有)

npm install -g pnpm

1. 下载代码（Gitee 镜像，国内加速）

git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
cd openclaw-cn

2. 配置国内加速（关键！）

pnpm config set registry https://registry.npmmirror.com/

3. 安装与构建

pnpm install
pnpm ui:build
pnpm build

💡 提示：由于不是全局安装，请通过 pnpm openclaw ... 运行仓库命令。

4. 启动初始化向导

pnpm openclaw onboard --install-daemon

💡 提示：在向导中，Select Provider 步骤请直接选择 DeepSeek，系统会自动完成所有配置。

5. 启动服务

pnpm openclaw gateway

打开仪表板：pnpm openclaw dashboard

安装后验证

• openclaw doctor — 快速检查环境
• openclaw status + openclaw health — 检查 Gateway 健康状态
• openclaw dashboard — 打开仪表板

🎯 你的第一个任务

启动成功后，进入管理面板或交互式命令行，试着给 Agent 下达第一个指令：

请帮我在桌面上创建一个名为 hello_openclaw.txt 的文件，并在里面写入：大道至简，实战落地。

Agent 将会自动规划任务、调用文件系统 API，并完成操作。

1. 启用飞书插件

如果已经存在飞书插件，则只需要启用即可。先查看插件列表：

openclaw plugins list

如果没有 feishu 插件，则执行以下命令先安装飞书插件（上图所示已经安装了飞书插件，所以不需要再安装）。

openclaw plugins install @openclaw/feishu

如果上述命令执行失败，则执行下面命令：

openclaw plugins install @m1heng-clawd/feishu

执行以下命令启用飞书插件：

openclaw plugins enable feishu

启用插件后，再执行 openclaw plugins list 检查飞书状态是否变为 loaded。

2. 添加通道

执行以下命令，开始配置飞书应用：

openclaw channels add

选择 yes，点击回车，开始配置：

选中 飞书 这个选项，点击回车：

输入飞书应用的 App ID 和 App Secret，选择飞书域名为 feishu.cn（国内版飞书）。

群聊策略，选择 Open，机器人只有被 @ 时进行回复。

最后选择 Finished，点击回车。

配置私聊策略，选 yes：

私聊策略默认为 pairing，表示不允许任何陌生人直接私聊你的机器人。如果一个陌生用户发来消息，机器人不会直接回复，而是会要求用户通过一个临时的“配对码”来完成身份验证，只有验证通过后才能正式使用。

• pairing：陌生用户需要通过配对码授权后使用。
• open：开放模式，允许所有用户直接私聊机器人。
• allowlist：白名单模式，只有在配置文件中预定义的“允许列表”里的用户才能私聊机器人。
• disabled：禁用模式，完全关闭机器人的私聊功能。

将配置好的通道账号绑定到现有的 AI 代理上，当用户通过这个飞书机器人发消息时，才能找到对应的 AI 来回复。

让飞书机器人与你默认的 main AI 代理绑定。

3. 启动 gateway

执行以下命令启动服务：

openclaw gateway

4. 事件配置

在飞书应用管理页，左侧导航栏找到 事件与回调，在“事件配置”页签中选择 长连接接收事件，点击保存。

添加事件 im.message.receive_v1，表示“收到消息时通知我”。

5. 回调配置

在回调配置中，订阅方式选择 使用长连接接收回调，点击保存，无需填写其他地址，配置自动生效。

6. 权限配置

在飞书应用管理页，左侧导航栏找到 权限管理。点击页面中的 批量导入权限 按钮，弹出权限导入窗口。

批量导入权限，使用下面的代码直接覆盖：

复制以下 JSON 代码，替换前弹窗中原有的 JSON 内容，点击下一步，确认新增权限，继续申请开通。

{
  "scopes": {
    "tenant": [
      "im:message",
      "im:message.p2p_msg:readonly",
      "im:message.group_at_msg:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "contact:user.base:readonly",
      "im:message.group_msg",
      "im:message:readonly",
      "im:message:update",
      "im:message:recall",
      "im:message.reactions:read",
      "docx:document:readonly",
      "drive:drive:readonly",
      "wiki:wiki:readonly",
      "bitable:app:readonly",
      "task:task:read",
      "contact:contact.base:readonly",
      "docx:document",
      "docx:document.block:convert",
      "drive:drive",
      "wiki:wiki",
      "bitable:app",
      "task:task:write"
    ],
    "user": []
  }
}

7. 创建版本并发布

在飞书应用管理页，左侧导航栏找到 版本管理与发布，点击进入页面。点击右上角的 创建版本。

填写应用版本号（比如 1.0.0，可以自定义版本号）和更新说明，点击保存并确认发布。

8. 与飞书机器人对话

完成前面的步骤之后，就可以与飞书机器人进行聊天，或者将飞书机器人添加进群聊。

以电脑版飞书为例（手机端飞书的操作类似），点击搜索框，输入应用名称，点击对应的应用。

发送消息后，如果出现权限提示，按照提示复制最后一行到终端执行即可。

在终端中粘贴上一步中复制的命令行，点击回车执行命令，命令完成执行后会提示配对成功。

如果是云服务器部署，按照下面的图片进入终端，扫码登录后执行命令即可。

接下来继续尝试与该机器人进行对话，能正常收到 AI 的回复。

近期活动

• 🔥 “虾皮计划”技能分享赛 - 提交即有机会获奖
• 📅 每月贡献者茶话会（线上）
• 🚀 OpenClaw 中文社区见面会筹备中

贡献者荣誉墙

感谢每一位贡献者的支持！

📢 社区功能即将开放

我们正在开发后端服务，预计不久后你将可以：

• 使用 Agent 自动发帖、回复
• 参与话题讨论、点赞互动
• 与社区 AI 助手实时交流
• 通过命令行工具一键发布内容

届时无需重新部署网站，只需刷新即可体验完整功能。敬请期待！

使命与愿景

OpenClaw 是一个主打开放、平等、深度连接的社交沟通论坛社区。我们始终以「打破信息壁垒，为每一位用户打造真诚交流、互助成长的专属空间」为核心使命，拒绝流量至上的浮躁逻辑，拒绝用高门槛把真心想交流的人挡在门外，致力于做一个有温度、有价值、真正以用户为核心，让每一个人都能轻松拥有的社区平台。

未来前景

未来，OpenClaw 将朝着四大核心方向持续深耕：

发展规划

我们想对用户说