💊 FAQ Summary 常见问题汇总

[Leizhenpeng]

我们已经通过大家的反馈和使用经验积累了许多常见问题，并将它们整理在一起，以帮助你更快地了解ChatGPT以及这个项目。

常见问题

1️⃣ 如何进行版本升级

如果你使用的是docker部署，只需要停掉服务，删除本地镜像，然后重新拉取最新的镜像进行部署即可！
如果你使用的是二进制运行，也不用担心，只需要下载最新的release二进制文件，替换原来的文件，然后启动服务就好啦!
如果你想体验最新的功能，也可以update主分支代码自己手动编译即可。
小提示，升级前记得备份哦！

2️⃣ 如何自定义机器人名称

如果你需要使用群聊@机器人功能，需要在服务端设置你自己的机器人名称。这个名称可以通过环境变量BOT_NAME来设置。下面以docker部署用户为例，介绍具体的操作步骤：

使用以下命令启动容器：

docker run -d --restart=always --name feishu-chatgpt2 -p 9000:9000 -v /etc/localtime:/etc/localtim:ro  \
--env APP_ID=xxx \
--env APP_SECRET=xxx \
--env APP_ENCRYPT_KEY=xxx \
--env APP_VERIFICATION_TOKEN=xxx \
--env BOT_NAME=<自定义机器人名称> \
--env OPENAI_KEY=sk-xxx \
dockerproxy.com/leizhenpeng/feishu-chatgpt:latest

请注意：自定义机器人名称必须为英文或拼音。

在上述命令中，将"<自定义机器人名称>"替换为你想要设置的机器人名称。
完成上述步骤后，服务端就能够使用你指定的机器人名称来响应群聊@机器人功能。

3⃣ 私聊机器人回复正常，但是群聊@没有反应

参考问题2

4⃣ 私聊时不想点击回复，操作比较繁琐

用户非常重视多话题对话的需求。因此，我们为您带来了全新的多话题对话功能。
现在您可以将每个话题视为chatGpt左侧的一个tab栏，无论是私聊还是群聊，每个话题都可以独立对话。

如果您想保持对话连续，而不必在私聊中单独点击回复，请点击“x 条回复”按钮，进入回复栏中参与问答即可。

5️⃣ 已经第四天了，还在飞书应用审核还没通过，正常吗？

这并不正常。
请尽快联系您所在企业的管理员，因为审核是由企业自行负责的。
请注意，此问题与飞书官方无关。

6️⃣ 请求地址报错"Challenge code没有返回"

如果 /ping 路由没有问题，那很可能是飞书的配置没有被正确填写。

7️⃣ 每次版本更新都要求企业管理员审核吗？

并不需要。
通常来说，只有在更新中添加了新的权限要求时，才需要进行审核。

8️⃣ 我是飞书的个人版，可以使用此机器人吗？

很抱歉，这个飞书机器人只适用于企业自建应用，因此无法为个人提供服务。
如果您想使用该机器人的功能，请新建或加入一个飞书企业。
提醒，个人同样也可以快速新建企业。

9️⃣ 所有的卡片按钮点击都会报错

没有填写卡片交互请求的回调
在飞书机器人后台的机器人板块，填写消息卡片请求网址。
可以参考下面docker常见问题的第二个QA

[Leizhenpeng]

docker 部署

1️⃣拉取镜像报错

Error response from daemon: manifest for***

docker版本过低请更新docker版本

更新docker操作

sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-selinux  docker-engine-selinux docker-engine
sudo yum install -y yum-utils device-mapper-persistent-data lvm2
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install docker-ce

sudo systemctl start docker
sudo systemctl enable docker
sudo systemctl status docker

2️⃣ 卡片回调报错

回调地址9000/webhook/card返回500

在飞书机器人后台的机器人板块，填写消息卡片请求网址。

例如 内网穿透模式下，

• http://xxxx.r6.cpolar.top为cpolar暴露的公网地址
• /webhook/card为统一的应用路由

最终的消息卡片请求网址为 http://xxxx.r6.cpolar.top/webhook/card

[Maybe1e]

serverless 部署

1⃣ 报错 go mod tidy

问题：
serverless选择的为阿里香港地区，但是在本地win部署一直报错，在大陆服务器ubuntu上部署出现同样错误，配置go环境后也是报错

我的解决办法：
部署时的服务器选择境外（见群友说香港地区也可以，未测试），服务器选择境外，我选的是新加坡地区 系统为ubuntu，ubuntu部署时没有go环境也部署成功了

希望对你有所帮助

下面时我当时的报错截图

2⃣ severless网页一键部署的时候说模板出错

当前模版 (start-feishubot）非阿里云官方提供模版，暂不开放模版创建功能

不要去网页点击一键部署，clone源代码后，修改s.yaml配置，手动部署s deploy。

3️⃣ s command is not found

请先安装serverless-cli 工具

npm install @serverless-devs/s -g

参考 https://docs.serverless-devs.com/serverless-devs/quick_start

[Leizhenpeng]

负载均衡

1⃣ no available API

错误信息: no available API

openai的token失效, 更换token后重试。

[txgo]

在小白图片配置教程中增加“事件订阅”的截图，我看也有其它用户没有添加“事件订阅"而只添加了”事件权限“。

[Leizhenpeng]

在小白图片配置教程中增加“事件订阅”的截图，我看也有其它用户没有添加“事件订阅"而只添加了”事件权限“。

事件权限其实包括事件订阅....

[justonehe]

CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
f61348844efb leizhenpeng/feishu-chatgpt:latest "/bin/sh -c /dist/en…" 2 minutes ago Up 2 minutes 0.0.0.0:9000->9000/tcp, :::9000->9000/tcp feishu-chatgpt2
docker运行成功了，但是/webhook/event返回404 not found

[pinganggang]

CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES f61348844efb leizhenpeng/feishu-chatgpt:latest "/bin/sh -c /dist/en…" 2 minutes ago Up 2 minutes 0.0.0.0:9000->9000/tcp, :::9000->9000/tcp feishu-chatgpt2 docker运行成功了，但是/webhook/event返回404 not found
一样的问题 需要到事件订阅
注意：为了使机器人具有收发消息的基础功能，请在“权限管理”面板中开通以下权限：
获取与发送单聊、群组消息：开通该权限后，机器人可以向用户发送单聊消息，或向机器人所在的群聊发送群消息；添加“接收消息”事件（前往“事件订阅”面板 > 添加事件 > 消息与群组）后，机器人便可接收用户发送的单聊消息。
获取用户在群组中@机器人的消息：开通该权限，并添加“接收消息”事件（前往“事件订阅”面板 > 添加事件 > 消息与群组）后，可接收用户在群聊中@机器人的消息。
开通以上就可以机器人对话了

[acer88boy]

我用的小白docker模式，部署都成功了； 图片/话题等能力都OK; 但是私聊机器人语音， 一直不行，日志记录报错；是什么原因？

[Leizhenpeng]

我用的小白docker模式，部署都成功了； 图片/话题等能力都OK; 但是私聊机器人语音， 一直不行，日志记录报错；是什么原因？

安卓这边的语言存在bug

[swiftwind0405]

你好，请问下这个是什么原因吗？

[liuqi605752176]

飞书发送消息，能收到回复，但是访问opanai有问题，请问这种应该如何解决

[Magnoliar]

飞书发送消息，能收到回复，但是访问opanai有问题，请问这种应该如何解决

我也遇到了这个错误

[Eventidus]

请问回调地址报404错误是什么原因呀 是在AWS服务器通过docker-compose部署的 未填代理地址

[beimingxinglian]

你好，请问下这个是什么原因吗？

同问

[LeoQuote]

我这里也发现了

[handle event,path:/webhook/event, error:runtime error: invalid memory address or nil pointer dereference]

因为报错比较不明显, 还请麻烦改造一下, 能快速发现问题, 修复.

[byzczc]

使用 Railway 平台一键部署，来回看了好几遍，权限、函数都填了，机器人发送消息没有反应。浏览器打开 域名/webhook/card 显示 404 page not found

[snowpubby]

我本地部署也是这个问题。。。有解决了吗？

[Ennischen]

railway部署完这个报错。

[unachris]

我这里也发现了

[handle event,path:/webhook/event, error:runtime error: invalid memory address or nil pointer dereference]

因为报错比较不明显, 还请麻烦改造一下, 能快速发现问题, 修复.

我这边也遇到这个问题了，问了gpt，反馈：

这个错误信息通常意味着代码中存在空指针引用（nil pointer dereference），即试图在没有分配内存的情况下访问指针指向的内存。这可能是因为在程序执行期间没有正确初始化某些指针变量，或者在使用指针时没有正确检查其是否为 nil 导致的。可以检查代码中与指针相关的部分，特别是涉及到指针解引用或操作指针变量的代码行。另外，可以考虑使用工具如 Valgrind 来检测和调试这种内存问题。

[yokyj]

我这里也发现了

[handle event,path:/webhook/event, error:runtime error: invalid memory address or nil pointer dereference]

因为报错比较不明显, 还请麻烦改造一下, 能快速发现问题, 修复.

我这边也遇到这个问题了，问了gpt，反馈：

这个错误信息通常意味着代码中存在空指针引用（nil pointer dereference），即试图在没有分配内存的情况下访问指针指向的内存。这可能是因为在程序执行期间没有正确初始化某些指针变量，或者在使用指针时没有正确检查其是否为 nil 导致的。可以检查代码中与指针相关的部分，特别是涉及到指针解引用或操作指针变量的代码行。另外，可以考虑使用工具如 Valgrind 来检测和调试这种内存问题。

试试挂代理

[timmycheng]

还有类情况是GO的版本过低（>1.18），升级到最新版本也可以解决

[txgo]

docker部署，间歇性出现这个问题，如何排查？
[Error] [handle event,path:/webhook/event, error:runtime error: invalid memory address or nil pointer dereference]

[Leizhenpeng]

docker部署，间歇性出现这个问题，如何排查？ [Error] [handle event,path:/webhook/event, error:runtime error: invalid memory address or nil pointer dereference]

服务端和openai服务不通或者opnai的key失效

[SakaiIzumii]

docker部署出现下面这个问题,请问一哈

ERROR failed to get bot info: refresh access token failed(1): ErrSendingRequest(3): error sending request, err: Post "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal": dial tcp: lookup open.feishu.cn on 127.0.0.11:53: server misbehaving(Please check your network, maybe use bad proxy or network offline)

[Leizhenpeng]

网络问题，看起来