全网最简单的 OpenClaw 安装与接入飞书机器人教程(Mac环境):从环境搭建到部署全流程

    本教程将带你从零开始，在服务器上安装 OpenClaw，并将其配置为飞书（Feishu）机器人。为方便操作，教程已整理为“清单式”步骤，请按照顺序依次进行。

第一步：准备环境并安装 OpenClaw

    在你的服务器终端中，一次性全部复制并且运行下面命令。这段脚本将为你安装基础工具、Node.js 22、配置国内加速镜像，并全局安装 OpenClaw。

# 1. 安装系统基础工具sudo apt update && sudo apt install -y curl git build-essential python3 make g++ cmake# 2. 使用国内镜像安装 nvmcurl -fsSL https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash# 3. 立即加载 nvm 环境变量（无需重启终端）export NVM_DIR="$HOME/.nvm"[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"# 4. 配置 NVM 下载镜像为阿里镜像tee -a ~/.bashrc > /dev/null << 'EOF'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/nodeexport NVM_NPM_MIRROR=https://npmmirror.com/mirrors/npmEOFsource ~/.bashrc# 5. 安装 Node.js 22 并设为默认版本nvm install 22nvm use 22nvm alias default 22# 6. 配置 npm 淘宝镜像加速npm config set registry https://registry.npmmirror.com# 7. 全局安装 OpenClawnpm i -g openclaw@latest# 8. 验证安装结果echo "---------------------------------------"echo "安装完成，检查版本："node -vnpm -vopenclaw -vecho "---------------------------------------"echo "如果看到版本号，请进入下一步开始配置。"

第二步：创建飞书机器人应用（上篇）

     核心逻辑： 飞书机器人本质上是一个“企业自建应用”。你需要在飞书开放平台先创建一个应用，开启机器人功能，并赋予它相应的权限。

1. 创建应用与开启能力

• 进入后台：登录 飞书开放平台 - 开发者后台 开发者后台 -

  https://open.feishu.cn/app?lang=zh-CN

• 新建应用：点击 【创建企业自建应用】。
• 填写信息： 

• 开启机器人：创建完成后进入应用，在左侧菜单栏找到 【应用能力】 -> 【添加应用能力】。在右侧找到 “机器人” 卡片，点击左下角的 【添加】。

•  获取 JSON：复制下方的 JSON 代码。

{  "scopes": {    "tenant": [      "aily:file:read",      "aily:file:write",      "application:application.app_message_stats.overview:readonly",      "application:application:self_manage",      "application:bot.menu:write",      "cardkit:card:write",      "contact:user.employee_id:readonly",      "corehr:file:download",      "docs:document.content:read",      "event:ip_list",      "im:chat",      "im:chat.access_event.bot_p2p_chat:read",      "im:chat.members:bot_access",      "im:message",      "im:message.group_at_msg:readonly",      "im:message.group_msg",      "im:message.p2p_msg:readonly",      "im:message:readonly",      "im:message:send_as_bot",      "im:resource",      "sheets:spreadsheet",      "wiki:wiki:readonly"    ],    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]  }}

第三步：OpenClaw交互式初始化配置

openclaw onboard

• I understand this is personal-by-default...：提示此操作具有实验性，选择 Yes。
• Onboarding mode：选择 快速开始 (Quick Start)。
• Model/auth provider：选择 Custom Provider（自定义模型服务商）。
• API Base URL：输入你使用的模型厂商的 API 地址（URL，重点确定url后面是否有"xxxxx/v1"）。
• How do you want to provide this API key?：选择 Paste API key now。
• API Key：输入你的模型密钥（通常是 sk-xxx 格式）。
• Endpoint compatibility：选择 OpenAI-compatible。
• Model ID：输入你要调用的模型名称（例如 gemini-3-flash-preview）。 
  ○ 此时系统会进行调用测试。如果出现 ◇ Verification successful. 即说明模型配置成功；若出现 failed 请检查 URL、Key 或 Model ID。

• Endpoint ID：给这个模型起个昵称，直接回车跳过即可。
• Model alias (optional)：模型别名，直接回车跳过。
• Select channel (QuickStart)：选择接入渠道，
• 依次选择 Feishu/Lark (飞书) -> Use local plugin path（如果没有，则选择Download from npm (@openclaw/feishu)，系统会自动下载飞书插件）。
• How do you want to provide this App Secret?：选择 Enter App Secret，然后输入你在第二步保存的飞书 App Secret 和 App ID（飞书开发者后台点击【凭证与基础信息】可以查看AppID和AppSecret）。
• Feishu connection mode：选择 WebSocket (default)。
• Which Feishu domain?：选择 Feishu (feishu.cn) - China。
• Group chat policy：选择 Allowlist - only respond in specific groups。
• Group chat allowlist (chat_ids)：不需要填写，直接回车。
• Search provider：选择 Skip for now（或根据需要选择）。
• Configure skills now?：选择 no （或根据需要选择）。
• Enable hooks? ：选择Skip for now（或根据需要选择；注意这里是空格勾选，回车提交选择）。
• How do you want to hatch your bot?：选择 Hatch in TUI (recommended) 。
• (配置完成后，OpenClaw 服务会自动在当前终端运行，请不要关闭此终端！)

END