> ## Documentation Index
> Fetch the complete documentation index at: https://www.pickfu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 如何通过 OpenClaw 在飞书中设置 PickFu AI 助手

> 本指南介绍如何通过云端或本地部署 OpenClaw，将 PickFu AI 助手 Polly 接入飞书聊天。完成设置后，你可以直接在飞书中发起问卷、分析消费者反馈结果并获取优化建议，无需切换到 PickFu 网站，约几分钟即可完成配置。本文还附有连接账户的步骤与常见问题解答。

本指南将为您介绍如何通过将 OpenClaw 连接到飞书，设置 PickFu AI 助手（名为 Polly）。连接完成后，Polly 可以在您无需离开飞书的情况下，启动问卷、分析结果并提出优化建议。

我们提供两种部署方式：云端部署（推荐，约 2 分钟完成）和本地部署（进阶方案，适合需要完全控制数据的团队）。无论选择哪种方式，您都需要关联您的 PickFu 账户。

# Polly 能做什么？

设置完成后，Polly 可以直接在飞书聊天中使用：

* \*\*启动问卷。\*\*告诉 Polly 您要测试什么，它会为您创建并发布 PickFu 问卷，大约 30 分钟内即可收到真实反馈。

* \*\*分析结果。\*\*Polly 会告诉您谁是赢家、胜出的原因，以及不同受众群体之间的分歧点。

* \*\*提出改进建议。\*\*基于真实的消费者反馈，为您提供具体的下一步行动建议。

无需切换标签页，也无需手动登录 PickFu——一切都在飞书中完成。

# 选择您的部署方式

\*\*必读：\*\*无论选择哪种方式，您都必须先完成 **连接您的 PickFu 账户** 步骤，Polly 才能正常工作。

|          |              |                  |
| -------- | ------------ | ---------------- |
|          | **云端（飞书妙搭）** | **本地（OpenClaw）** |
| **设置时间** | 约 2 分钟       | 30–60 分钟         |
| **技术要求** | 无            | 基础命令行操作          |
| **始终在线** | 是，由飞书托管      | 需要您的电脑保持开机       |
| **数据隐私** | 数据存储于飞书服务器   | 完全自主控制           |
| **适合**   | 大多数用户        | 注重隐私或进阶用户        |

不是技术用户？请查看方案 1（云端）。需要完全控制数据？请查看方案 2（本地）。

# 方案 1：云端部署（推荐，约 2 分钟）

完成后，请跳转至 **连接您的 PickFu 账户** 步骤。

## 步骤 1 – 打开飞书妙搭

访问 [`https://miaoda.feishu.cn/bot`](https://miaoda.feishu.cn/bot)，使用您的飞书账号登录，点击 **"一键部署"**。

## 步骤 2 – 为 AI 命名并选择头像

输入名称（例如 **"Polly"**），选择头像，点击 **"开始部署"**。

## 步骤 3 – 等待 10–30 秒后开始对话

系统会自动完成所有配置。点击 **"立即聊天"**——飞书会为您打开一个与新建机器人的私聊窗口。

完成！Polly 已上线。请继续往下，完成 PickFu 账户的关联。

遇到问题？在妙搭聊天中描述问题——AI 会自动为您修复。

想更换其他模型？（例如 Claude、DeepSeek）告诉 Polly 并提供您的 API Key 和 Base URL 即可。

# 方案 2：本地部署（进阶，完全控制数据）

配对完成后，请跳转至 **连接您的 PickFu 账户** 步骤。

## 前提条件

1. PickFu 账户——在 [pickfu.com](http://pickfu.com) 免费注册

2. 飞书企业账号——需拥有创建自建应用的权限

3. 已安装 Node.js——从 [nodejs.org](http://nodejs.org) 下载 LTS 版本。验证方法：在终端中输入 `node -v`。

## 步骤 1 – 安装 OpenClaw

打开终端（Windows：Win+R → `cmd` | Mac：Command+Space → `Terminal`)：

```
npm install -g openclaw@latest
```

```
openclaw plugins install @openclaw/feishu
```

注意：OpenClaw 2026.2+ 已内置飞书集成——如果提示已安装，可跳过此步。

```
openclaw mcp set pickfu '{"url":"https://mcp.pickfu.com/mcp"}'
```

Windows 用户注意：引号必须使用标准英文引号。如遇报错，请先将命令粘贴到记事本中检查。

## 步骤 2 – 在飞书开放平台创建机器人

1. 访问 `open.feishu.cn/app` → **"创建企业自建应用"** → 命名为 **"PickFu Polly"**

2. 进入 **凭证与基础信息** → 复制 **App ID** 和 **App Secret**

3. 进入 **权限管理** → **批量导入** → 粘贴以下 JSON：

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

1. 进入 **应用能力** → **机器人** → 开启，命名为 **"Polly"**

2. 到这里先暂停——请先启动 Gateway（步骤 3），然后再回来继续。

## 步骤 3 – 启动 Gateway（请保持此窗口开启）

```
openclaw channels add
```

当系统提示时选择 Feishu，然后输入您的 App ID 和 App Secret。

```
openclaw gateway
```

日志开始滚动——如果没有红色报错，说明 Gateway 正在运行。

请保持此窗口开启。可以最小化，但不要关闭。

## 步骤 4 – 配置事件订阅并发布

1. 开放平台 → **事件订阅** → 选择 **"长连接方式 (WebSocket)"**

2. 添加事件：选择 `im.message.receive_v1` → 保存

3. **版本管理与发布** → **创建版本** → **提交审核**

## 步骤 5 – 在飞书中与 Polly 配对

1. 在飞书中搜索您的机器人名称，发送任意消息

2. 机器人会回复一个配对码（例如 `ABC123`）

3. 在终端中运行：

```
openclaw pairing approve feishu ABC123
```

配对完成！接下来请关联您的 PickFu 账户（见下方）。

# 连接您的 PickFu 账户（两种方式都需完成）

两种方式的操作步骤相同，只需执行一次。

## 步骤 1 – 在飞书中找到 Polly

打开飞书（移动端或桌面端），点击“消息”，搜索您的机器人名称（例如 "Polly"），打开聊天窗口。

云端用户：可访问 `miaoda.feishu.cn/bot` 并点击 "立即聊天" 直接进入。

## 步骤 2 – 发送以下消息

```
Log me into PickFu
```

Polly 会回复一个授权链接供您点击。

## 步骤 3 – 在浏览器中完成授权

1. 点击 Polly 发来的链接

2. 浏览器打开 PickFu 登录页面

3. 使用您的 PickFu 邮箱和密码登录

4. 点击 "Authorize"（授权）

5. 看到成功页面后，返回飞书

完成！Polly 现已获得您 PickFu 账户的访问权限，此步骤无需重复。

还没有 PickFu 账户？请先在 [pickfu.com](http://pickfu.com) 免费注册。

授权过期？再次发送 "Log me into PickFu" 即可。

# 如何开始使用 Polly

启动问卷：

```
Create an A/B test comparing these two product titles, 50 US respondents
```

分析结果：

```
Analyze the results of my last survey — who won and why?
```

获取优化建议：

```
Based on the consumer feedback, give me specific recommendations for what to improve
```

# 常见问题

## 云端 Token 额度用完了怎么办？

在妙搭中告诉 Polly 要切换到哪个模型，并提供该模型的 API Key 和 Base URL。

## 本地部署完成后 Polly 没有响应，我该检查什么？

请检查终端中 `openclaw gateway` 是否仍在运行。如果窗口被关闭了，请重新运行该命令。

## 事件订阅无法保存，是什么原因？

必须先启动 Gateway，飞书才能保存事件订阅。请先启动 Gateway，然后返回并保存。

## 两种部署方式都支持全部 PickFu 功能吗？

是的。云端和本地部署都能让您完整使用 PickFu 的所有功能。

## 授权链接无法打开，该怎么办？

请使用系统浏览器打开，不要使用飞书的内置浏览器。

***

相关文章

* [如何在 PickFu+ 中使用每日 5 人迷你问卷](/zh/help/how-to-use-daily-5-person-mini-polls-in-pickfu)
* [如何通过 AI 助手使用 PickFu MCP 集成](/zh/help/how-to-use-the-pickfu-mcp-with-ai-assistants)
* [什么是 AI重点摘要选项卡？](/zh/help/what-is-the-ai-highlights-tab)