最近更新：2026年3月6日 07:13

OpenClaw + 飞书：搭建私人 AI 助手

适用场景：想在飞书里拥有一个私人 AI 助手，支持 Claude、GPT 等模型，不需要翻墙，成本只有官方的 1/10。

配置要点：

使用 OpenClaw（开源 AI Agent 框架）作为引擎

使用飞书作为聊天入口（国内直接用）

使用 NextAI Code 作为 API 网关（国内直连，微信支付）

最终效果

在飞书中直接和 AI 对话，支持私聊和群聊 @机器人，可随时切换模型。

飞书对话效果

一、准备工作

准备项	说明	费用
一台服务器或本地电脑	推荐 Linux 服务器，2G 内存以上	云服务器约 ¥30-50/月
飞书账号	用于创建企业自建应用	免费
NextAI Code 账号	用于获取 API Key	注册免费，按量付费

二、获取 NextAI Code API Key

2.1 注册账号

访问 NextAI Code，支持微信扫码 / GitHub / 邮箱注册。

2.2 充值（可选）

新用户可先体验，需要更多用量时通过微信扫码充值，最低 ¥10 起。

成本对比（国内用户实际花费）：

NextAI Code 充值汇率 1 人民币 = 1 美元余额（官方 API 按实际汇率约 7.2 换算），叠加平台折扣：

模型	官方实际花费（¥/百万 token）	NextAI Code	节省
Claude Opus 4.6	¥36	¥1.75	95%
Claude Sonnet 4.6	¥21.6	¥1.05	95%
GPT-5.2	¥12.6	¥0.875	93%

💡 选择「claude-特价」分组（0.35x 倍率），成本再降一个量级。

2.3 创建 API Key

登录后进入控制台 → 令牌管理
点击「创建令牌」，选择合适的分组
复制生成的 Key（以 sk- 开头），妥善保管

创建令牌页面

分组选择 — 推荐 claude-特价

分组说明

创建 API Key 时需要选择分组，不同分组倍率不同：

分组	倍率	可用模型	适合
默认	1x	全模型	需要多模型切换
Claude 特价	0.35x	仅 Claude	只用 Claude，最划算
GPT 特价	0.5x	仅 GPT	只用 GPT
Gemini 特价	1x	仅 Gemini	只用 Gemini

三、安装 OpenClaw

提供两种安装方式，推荐使用一键脚本。

方式一：一键安装脚本（推荐）

脚本会自动检测系统、安装依赖（Node.js、OpenClaw），并通过 7 步中文引导完成全部配置。

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/NextAI-Nova/openclaw-feishu-setup/main/install.sh | bash

Windows（PowerShell）：

irm https://raw.githubusercontent.com/NextAI-Nova/openclaw-feishu-setup/main/install.ps1 | iex

脚本支持：

--dry-run：只演练流程，不安装不写入
--uninstall：一键卸载清理
每步可输入 b 回退上一步

使用一键脚本时，第三、四、五步都会自动引导完成，可以直接跳到第六步。

方式二：手动安装（Docker）

# 安装 Docker（如果没有）
curl -fsSL https://get.docker.com | sh

# 克隆 OpenClaw 仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 运行安装向导
./docker-setup.sh

手动安装需要自行配置模型提供商和飞书渠道，参考下面的步骤。

四、创建飞书机器人

4.1 创建企业应用

访问飞书开放平台，登录后点击「创建企业自建应用」，填写应用名称和描述。

创建企业自建应用

4.2 获取凭证

在「凭证与基础信息」页面，复制 App ID（格式 cli_xxx）和 App Secret。

凭证与基础信息

4.3 配置权限

在「权限管理」→「批量导入」中，粘贴以下 JSON：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "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"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

批量导入权限

确认导入

4.4 开启机器人能力

在「应用能力」→「机器人」中开启机器人能力，设置机器人名称。

添加机器人能力

填写机器人名称

4.5 配置事件订阅

在「事件订阅」中：

选择「使用长连接接收事件」（WebSocket 方式）
添加事件：im.message.receive_v1

选择长连接并保存

添加事件

4.6 发布应用

在「版本管理与发布」中创建版本并提交发布。企业内部应用通常免审核，提交后即可上线。

创建版本

五、配置 OpenClaw

如果使用一键脚本安装，以下配置会自动完成。

5.1 配置模型提供商

编辑 ~/.openclaw/openclaw.json，在 models.providers 中添加 NextAI Code：

{
  "models": {
    "providers": {
      "nextai-claude": {
        "baseUrl": "https://www.nextai-code.com",
        "apiKey": "sk-你的API Key",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      },
      "nextai-openai": {
        "baseUrl": "https://www.nextai-code.com/v1",
        "apiKey": "sk-你的API Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-5.2",
            "name": "GPT-5.2",
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "nextai-claude/claude-opus-4-6"
      }
    }
  }
}

5.2 配置飞书渠道

在配置文件中添加飞书渠道：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "open",
      "accounts": {
        "main": {
          "appId": "cli_你的AppID",
          "appSecret": "你的AppSecret",
          "botName": "AI 助手"
        }
      }
    }
  }
}

5.3 启动

# 启动 Gateway
openclaw gateway start

# 设置开机自启（可选）
openclaw gateway install

Docker 方式：

docker compose restart openclaw-gateway

六、开始使用

6.1 发送第一条消息

在飞书中搜索你创建的机器人名称，发送一条消息。

6.2 首次配对

默认首次对话需要配对验证。在服务器上运行：

openclaw pairing approve feishu <配对码>

一键安装脚本会自动检测配对码并询问是否批准。

配对成功后即可正常对话。

6.3 日常使用

私聊机器人：直接发消息
群聊使用：@机器人 + 你的问题
切换模型：发送 /model
重置对话：发送 /reset

成本估算

以中度使用为例（每天 50 轮对话，每轮约 1000 token）：

方案	月成本	说明
Claude 官方 API（Opus 4.6）	~¥320/月	需翻墙 + 海外信用卡
NextAI Code（标准价）	~¥16/月	国内直连，微信支付
NextAI Code（特价分组）	~¥5/月	claude-特价分组

常见问题

NextAI Code 和直接调用官方 API 有什么区别？: NextAI Code 是 API 网关平台，通过国内节点转发请求到官方模型。你用的还是 Claude、GPT 原版模型，只是不需要翻墙。OpenClaw 的对话数据保存在你自己的服务器上。

飞书机器人没有回复？

按以下顺序排查：

应用是否已「创建版本并发布」
事件订阅是否开启且为「长连接模式」
是否已订阅 im.message.receive_v1
OpenClaw Gateway 是否在运行：openclaw gateway status

除了飞书还能接入什么？: OpenClaw 支持 Telegram、Discord、Slack、微信等多种平台。飞书是最适合国内用户的选择之一。

服务器配置要求？: 2G 内存的云服务器即可。OpenClaw 本身很轻量，计算在云端模型完成。

一键脚本会改动什么？

安装/升级 Node.js（如未安装或版本过低）
安装/升级 OpenClaw（全局 npm 包）
生成 ~/.openclaw/openclaw.json（已有会先备份）

使用 --dry-run 可以只演练不执行。