OpenClaw-飞书部署指南-完整版

OpenClaw 完整部署指南：从安装到飞书接入OpenClaw是一个开源的个人 AI 助手网关，可以在你自己的设备上运行。它支持多种消息渠道，让你能够在熟悉的平台上与 AI 助手对话。

qq_43145624

850人浏览 · 2026-03-12 14:30:48

qq_43145624 · 2026-03-12 14:30:48 发布

title: OpenClaw 完整部署指南：从安装到飞书接入
date: 2026-03-12 14:00:00
tags:

OpenClaw
AI助手
飞书
Feishu
部署教程
categories:
技术教程
AI工具

OpenClaw 完整部署指南：从安装到飞书接入

作者: OpenClaw Assistant
日期: 2026-03-12
版本: OpenClaw 2026.3.7
预计阅读时间: 20 分钟

🎯 前言

本文将手把手带你完成 OpenClaw 的完整部署流程，从环境准备到飞书接入。由于原图片链接可能无法访问，本文已将所有图片内容转换为详细的文字步骤说明，确保你能顺利完成部署。

一、OpenClaw 简介

1.1 什么是 OpenClaw？

OpenClaw 是一个开源的个人 AI 助手网关，让你能够在自己设备上运行 AI 助手，并通过熟悉的聊天平台（飞书、钉钉、Telegram、WhatsApp 等）与之交互。

1.2 核心特性

特性	说明
🔒 本地优先	数据保存在本地，隐私完全可控
🚀 多平台	支持飞书、钉钉、Telegram、WhatsApp 等 20+ 渠道
🤖 多模型	OpenAI、Kimi、Gemini、Claude 等主流模型
🛠️ 强工具	浏览器控制、代码执行、文件操作、定时任务

二、环境准备

2.1 系统要求

项目	要求	备注
操作系统	Windows 10/11、macOS 12+、Linux	Windows 推荐 WSL2
Node.js	≥ 22.12.0	必须使用 22+ 版本
包管理器	npm (v10+)、pnpm 或 bun	pnpm 速度最快
内存	建议 4GB+	运行 AI 模型需要

2.2 检查 Node.js 版本

# 检查当前 Node.js 版本
node --version

# 预期输出: v22.12.0 或更高

如果版本低于 22.12.0，请升级：

Windows 用户：

# 使用 nvm-windows
nvm install 22
nvm use 22

macOS/Linux 用户：

# 使用 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22
nvm alias default 22

2.3 安装 pnpm（强烈推荐）

# 全局安装 pnpm
npm install -g pnpm

# 验证安装
pnpm --version

三、安装 OpenClaw

3.1 全局安装命令

选择以下任一方式安装：

# 方式1: 使用 npm（最通用）
npm install -g openclaw@latest

# 方式2: 使用 pnpm（推荐，速度最快）
pnpm add -g openclaw@latest

# 方式3: 使用 bun
bun add -g openclaw@latest

3.2 验证安装

# 检查版本
$ openclaw --version
2026.3.7

# 查看帮助
$ openclaw --help

四、初始化配置

4.1 使用引导向导（强烈推荐新手）

# 运行完整引导向导
openclaw onboard --install-daemon

向导流程说明：

┌─────────────────────────────────────────┐
│  Step 1: 检查环境                        │
│  ✓ Node.js 版本检查通过                  │
│  ✓ 创建工作目录 ~/.openclaw/             │
├─────────────────────────────────────────┤
│  Step 2: 配置 AI 模型                    │
│  - 选择模型提供商 (OpenAI/Kimi/Gemini等) │
│  - 输入 API Key                          │
├─────────────────────────────────────────┤
│  Step 3: 选择消息渠道                    │
│  - 选择飞书/Feishu                       │
│  - 输入 App ID 和 App Secret             │
├─────────────────────────────────────────┤
│  Step 4: 安装 Gateway 服务               │
│  ✓ 安装为系统服务                        │
│  ✓ 自动启动 Gateway                      │
└─────────────────────────────────────────┘

4.2 手动配置

# 1. 创建工作目录
mkdir -p ~/.openclaw/workspace
mkdir -p ~/.openclaw/logs

# 2. 创建配置文件
touch ~/.openclaw/openclaw.json

4.3 配置文件详解

编辑 ~/.openclaw/openclaw.json：

{
  // AI 模型配置
  "agent": {
    "model": "moonshot/kimi-k2.5",
    "temperature": 0.7,
    "thinking": "medium"
  },
  
  // 模型提供商配置
  "models": {
    "moonshot": {
      "apiKey": "sk-your-moonshot-api-key-here"
    },
    "openai": {
      "apiKey": "sk-your-openai-key"
    }
  },
  
  // Gateway 配置
  "gateway": {
    "port": 18789,
    "bind": "loopback",
    "auth": {
      "mode": "none"
    }
  },
  
  // 渠道配置
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "groupPolicy": "open"
    }
  }
}

五、启动 Gateway

5.1 启动方式对比

方式	命令	适用场景
前台启动	`openclaw gateway --verbose`	调试、查看实时日志
后台启动	`openclaw gateway start`	日常使用
系统服务	`openclaw gateway install`	长期运行、开机自启

5.2 前台启动（首次推荐）

# 前台启动，可以看到详细日志
openclaw gateway --verbose

# 你会看到类似输出：
[2026-03-12T14:00:00.000Z] INFO: Gateway starting...
[2026-03-12T14:00:00.500Z] INFO: WebSocket server listening on ws://127.0.0.1:18789
[2026-03-12T14:00:01.000Z] INFO: Feishu channel initialized
[2026-03-12T14:00:01.500Z] INFO: Gateway ready

按 Ctrl+C 停止服务。

5.3 后台启动

# 后台启动
openclaw gateway start

# 检查状态
openclaw gateway status

5.4 Gateway 管理命令速查表

openclaw gateway status      # 查看运行状态
openclaw gateway start       # 启动服务
openclaw gateway stop        # 停止服务
openclaw gateway restart     # 重启服务
openclaw logs --follow       # 实时跟踪日志
openclaw logs --tail 100     # 查看最后100行

六、创建飞书应用（详细步骤）

⚠️ 重要提示：以下步骤将原图片内容转换为详细的文字操作说明，请仔细阅读每一步。

Step 1: 访问飞书开放平台

打开浏览器，访问：https://open.feishu.cn/app
使用企业账号扫码登录

注意：个人账号无法创建企业自建应用。如果你只有个人账号，需要联系企业管理员创建应用。

国际版 Lark 用户：请访问 https://open.larksuite.com/app

Step 2: 创建企业自建应用

界面路径： 首页 → 创建企业自建应用

详细操作步骤：

进入开放平台首页
- 登录后会看到应用列表页面
- 页面右上角有一个 “创建企业自建应用” 按钮（蓝色按钮）
点击创建按钮
- 点击后会弹出创建应用的表单对话框

填写应用信息

字段	填写内容	示例
应用名称	你的 AI 助手名称	`OpenClaw助手` 或 `AI小助手`
应用描述	简要描述用途	`基于 OpenClaw 的 AI 助手，提供智能问答服务`
应用图标	上传图标（可选）	建议 512x512 像素的 PNG 图片

确认创建
- 点击对话框底部的 “确定创建” 按钮
- 系统会自动跳转到应用详情页

创建成功后的界面：

左侧显示垂直导航菜单
中间显示应用概览信息
顶部显示应用名称和状态

Step 3: 获取 App ID 和 App Secret

界面路径： 应用详情 → 凭证与基础信息

详细操作步骤：

进入凭证页面
- 在左侧导航菜单中找到并点击 “凭证与基础信息”
- 菜单位置通常在左侧列表的上半部分
查看 App ID
- 在页面中找到 “App ID” 字段
- 格式为：cli_xxxxxxxxxxxxxxxx（共16位随机字符）
- 点击右侧的 复制按钮（两个重叠的方块图标）
- 粘贴到安全的地方保存
查看 App Secret
- 在同一页面找到 “App Secret” 字段
- 默认显示为星号（********）
- 点击右侧的 “查看” 按钮（眼睛图标）
- 系统可能会要求二次验证（如短信验证码）
- 验证通过后，Secret 会显示为明文
- 点击 复制按钮 保存

⚠️ 安全警告：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚠️  App Secret 是敏感信息！
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• 不要截图分享
• 不要上传到 GitHub 或任何代码仓库
• 不要通过邮件、聊天工具发送给他人
• 建议复制后保存在密码管理器（如 1Password、Bitwarden）中
• 如果怀疑泄露，立即在平台重置
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

临时保存格式：

App ID: cli_a0b1c2d3e4f5g6h7
App Secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
创建时间: 2026-03-12
应用名称: OpenClaw助手

Step 4: 配置权限（关键步骤）

界面路径： 应用详情 → 权限管理

详细操作步骤：

进入权限管理页面
- 在左侧导航菜单中点击 “权限管理”
- 页面会显示当前已申请的权限列表（初始为空）
点击批量导入
- 在页面右上角找到 “批量导入” 按钮
- 点击后会弹出一个文本输入框

粘贴权限配置

将以下 JSON 完整复制粘贴到文本框中：

{
  "scopes": {
    "tenant": [
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ]
  }
}

确认导入
- 点击输入框下方的 “确定” 按钮
- 系统会自动解析并勾选对应的权限项
验证权限
- 返回权限列表页面
- 确认以下权限已勾选：
  - ✅ im:message:send_as_bot - 以机器人身份发送消息
  - ✅ im:message:readonly - 读取用户消息
  - ✅ im:chat.members:bot_access - 访问群成员信息
  - ✅ im:resource - 访问图片、文件资源

权限说明表：

权限代码	权限名称	用途说明
`im:message:send_as_bot`	以机器人身份发送消息	让机器人能够回复用户
`im:message:readonly`	读取消息	接收用户发送的消息内容
`im:message.p2p_msg:readonly`	读取私聊消息	接收单聊消息
`im:message.group_at_msg:readonly`	读取群@消息	接收群聊中@机器人的消息
`im:chat.access_event.bot_p2p_chat:read`	读取单聊事件	监听私聊会话事件
`im:chat.members:bot_access`	访问群成员	获取群成员信息
`im:resource`	访问资源	处理图片、文件等媒体

Step 5: 启用机器人能力

界面路径： 应用详情 → 应用能力 → 机器人

详细操作步骤：

进入应用能力页面
- 在左侧导航菜单中点击 “应用能力”
- 展开子菜单后点击 “机器人”
启用机器人能力
- 找到页面中的 “机器人能力” 开关
- 开关当前状态为 “未启用”（灰色）
- 点击开关切换为 “已启用”（蓝色/绿色）

配置机器人信息

启用后，页面会展开配置表单：

配置项	填写内容	示例
机器人名称	显示给用户的名字	`AI助手`
机器人介绍	功能描述	`智能问答助手，支持多种AI模型`
消息卡片	保持默认	无需修改

保存配置
- 点击页面底部的 “保存” 按钮
- 系统会提示保存成功

启用后的效果：

应用会获得一个机器人身份
用户可以在飞书中搜索到这个机器人
机器人可以接收和发送消息

Step 6: 配置事件订阅（最容易出错）

界面路径： 应用详情 → 事件订阅

⚠️ 前置条件： 确保 OpenClaw Gateway 已经在运行！

详细操作步骤：

进入事件订阅页面
- 在左侧导航菜单中点击 “事件订阅”
- 页面显示事件订阅的配置选项
选择接收方式

在 “接收方式” 部分，有两个选项：
- ⭕ 使用 HTTPS 接收事件（需要公网 URL）
- ✅ 使用长连接接收事件（WebSocket 模式，推荐）
选择： 勾选 “使用长连接接收事件”

不要选择 HTTPS 方式，那需要配置公网服务器
添加订阅事件

在 “订阅事件” 部分：
- 点击 “添加事件” 按钮
- 会弹出事件选择对话框
- 在搜索框输入：im.message.receive_v1
- 或从列表中找到：接收消息 v1
- 勾选该事件
- 点击 “确定”
保存配置
- 点击页面底部的 “保存” 按钮
- 如果 Gateway 正常运行，会提示保存成功

常见错误及解决：

❌ 错误提示："长连接配置保存失败" 或 "连接超时"

原因分析：
1. Gateway 没有运行
2. Gateway 端口被占用
3. 网络连接问题

解决方案：
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
步骤1: 检查 Gateway 状态
  $ openclaw gateway status
  
步骤2: 如果未运行，启动它
  $ openclaw gateway start
  
步骤3: 检查端口占用
  # macOS/Linux:
  $ lsof -i :18789
  
  # Windows:
  $ netstat -ano | findstr 18789
  
步骤4: 重新保存事件订阅配置
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Step 7: 发布应用

界面路径： 应用详情 → 版本管理与发布

详细操作步骤：

进入版本管理页面
- 在左侧导航菜单中点击 “版本管理与发布”
- 页面显示版本历史（初始为空）
创建新版本
- 点击页面右上角的 “创建版本” 按钮
- 弹出版本创建表单

填写版本信息

字段	填写内容	示例
版本号	符合语义化版本规范	`1.0.0`
更新说明	描述本次更新内容	`初始版本，提供 AI 对话功能`
可见范围	选择可使用的人员	“全部成员” 或指定部门

保存版本
- 点击 “保存” 按钮
- 版本会显示在列表中，状态为 “待发布”
申请发布
- 在版本列表中找到刚创建的版本
- 点击右侧的 “申请发布” 按钮
- 系统会提示提交成功
等待审批
- 企业自建应用通常 自动通过审批
- 刷新页面，状态会变为 “已发布”
- 如果显示 “待审核”，联系企业管理员审批

发布成功后的效果：

应用状态变为 “已发布”
企业成员可以在飞书中搜索到该应用
机器人可以正常接收和发送消息

七、配置飞书通道

飞书应用创建完成后，需要在 OpenClaw 中配置连接。

7.1 安装飞书插件

# 安装飞书官方插件
openclaw plugins install @openclaw/feishu

# 安装成功后会显示：
# ✓ Plugin @openclaw/feishu installed successfully

7.2 使用命令行添加

# 启动添加渠道向导
openclaw channels add

交互流程：

? Select channel type: (Use arrow keys)
❯ Feishu / Lark
  Telegram
  Discord
  Slack
  ...

? Enter your Feishu App ID: cli_a0b1c2d3e4f5g6h7
? Enter your Feishu App Secret: [hidden]
? Enter bot name (optional): AI助手

✓ Feishu channel configured successfully!
✓ Configuration saved to ~/.openclaw/openclaw.json

7.3 直接编辑配置文件

编辑 ~/.openclaw/openclaw.json：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",      // 私聊策略
      "groupPolicy": "open",      // 群聊策略
      "accounts": {
        "main": {
          "appId": "cli_a0b1c2d3e4f5g6h7",
          "appSecret": "your-app-secret-here",
          "botName": "AI助手",
          "domain": "feishu"        // feishu(国内) 或 lark(国际)
        }
      }
    }
  }
}

7.4 国际版 Lark 配置

{
  "channels": {
    "feishu": {
      "domain": "lark",  // ← 关键配置
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "xxx"
        }
      }
    }
  }
}

八、测试与验证

8.1 重启 Gateway 加载配置

# 重启 Gateway
openclaw gateway restart

# 检查状态
openclaw gateway status

8.2 测试私聊功能

步骤 1：找到机器人

打开飞书客户端
在搜索框输入机器人名称（如 “AI助手”）
点击进入对话

步骤 2：发送第一条消息

发送任意消息，如：你好
机器人会回复配对码：

[系统消息]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
配对码: ABCD-1234

这是一个配对请求。
请管理员在终端执行：
openclaw pairing approve feishu ABCD-1234
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

步骤 3：批准配对

# 批准配对请求
openclaw pairing approve feishu ABCD-1234

# 成功后会显示：
# ✓ Pairing request ABCD-1234 approved

步骤 4：开始对话

现在可以正常对话了！尝试发送：

你好，请介绍一下自己
帮我查一下北京今天的天气
用 Python 写一个快速排序

8.3 测试群聊功能

将机器人添加到群聊
@机器人发送消息
查看回复

8.4 查看实时日志

openclaw logs --follow

九、常见问题排查

问题 1：机器人完全不回复

# 1. 检查 Gateway 是否运行
openclaw gateway status

# 2. 查看错误日志
openclaw logs --tail 50

# 3. 检查配置文件语法

原因	解决方案
Gateway 未启动	`openclaw gateway start`
App ID/Secret 错误	检查配置，重新复制
应用未发布	在飞书平台发布应用
权限未配置	检查权限管理中的勾选

问题 2：私聊无响应，群聊正常

# 检查当前配对列表
openclaw pairing list feishu

# 批准待处理的配对请求
openclaw pairing approve feishu ABCD-1234

问题 3：群聊无响应

排查清单：

机器人是否已加入群聊？
是否 @了机器人？（默认需要）
groupPolicy 是否为 disabled？

问题 4：事件订阅保存失败

# 1. 确保 Gateway 在运行
openclaw gateway status

# 2. 检查端口是否被占用
lsof -i :18789  # macOS/Linux
netstat -ano | findstr 18789  # Windows

十、进阶配置

10.1 多账户配置

{
  "channels": {
    "feishu": {
      "defaultAccount": "main",
      "accounts": {
        "main": { "appId": "cli_xxx", "appSecret": "xxx" },
        "backup": { "appId": "cli_yyy", "appSecret": "yyy", "enabled": false }
      }
    }
  }
}

10.2 群聊精细控制

{
  "channels": {
    "feishu": {
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["oc_xxx", "oc_yyy"],
      "groups": {
        "oc_xxx": {
          "requireMention": false,
          "allowFrom": ["ou_user1", "ou_user2"]
        }
      }
    }
  }
}

10.3 获取群/用户 ID

# 通过日志查看
openclaw logs --follow | grep "chat_id\|open_id"

# 通过配对列表
openclaw pairing list feishu

10.4 流式响应配置

{
  "channels": {
    "feishu": {
      "streaming": true,
      "blockStreaming": true,
      "textChunkLimit": 2000
    }
  }
}

📚 参考资源

🎉 结语

恭喜！你已经成功部署了 OpenClaw 并接入了飞书！本文已将所有图片内容转换为详细的文字步骤，确保你在无法查看图片时也能顺利完成部署。

如果本文对你有帮助，欢迎点赞、收藏、转发！ 👍

最后更新: 2026-03-12 | OpenClaw 版本: 2026.3.7

龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

2026年如何安装Hermes Agent/OpenClaw？小白部署及token Plan配置指南

龙虾开发者社区

2026年怎么搭建Hermes Agent/OpenClaw？保姆级部署及token Plan配置教程

龙虾开发者社区

2026年如何部署Hermes Agent/OpenClaw？萌新部署及token Plan配置解析

龙虾开发者社区

所有评论(0)

查看更多评论

qq_43145624

@qq_43145624

已为社区贡献1条内容

OpenClaw-飞书部署指南-完整版

qq_43145624

OpenClaw 完整部署指南：从安装到飞书接入

🎯 前言

📋 目录

一、OpenClaw 简介

1.1 什么是 OpenClaw？

1.2 核心特性

二、环境准备

2.1 系统要求

2.2 检查 Node.js 版本

2.3 安装 pnpm（强烈推荐）

三、安装 OpenClaw

3.1 全局安装命令

3.2 验证安装

四、初始化配置

4.1 使用引导向导（强烈推荐新手）

4.2 手动配置

4.3 配置文件详解

五、启动 Gateway

5.1 启动方式对比

5.2 前台启动（首次推荐）

5.3 后台启动

5.4 Gateway 管理命令速查表

六、创建飞书应用（详细步骤）

Step 1: 访问飞书开放平台

Step 2: 创建企业自建应用

Step 3: 获取 App ID 和 App Secret

Step 4: 配置权限（关键步骤）

Step 5: 启用机器人能力

Step 6: 配置事件订阅（最容易出错）

Step 7: 发布应用

七、配置飞书通道

7.1 安装飞书插件

7.2 使用命令行添加

7.3 直接编辑配置文件

7.4 国际版 Lark 配置

八、测试与验证

8.1 重启 Gateway 加载配置

8.2 测试私聊功能

8.3 测试群聊功能

8.4 查看实时日志

九、常见问题排查

问题 1：机器人完全不回复

问题 2：私聊无响应，群聊正常

问题 3：群聊无响应

问题 4：事件订阅保存失败

十、进阶配置

10.1 多账户配置

10.2 群聊精细控制

10.3 获取群/用户 ID

10.4 流式响应配置

📚 参考资源

🎉 结语

所有评论(0)

温馨提示：您尚未绑定手机号

qq_43145624