Dingtalk-OpenAI

ai go

钉钉 & 🤖 GPT-3.5 让你的工作效率直接起飞 🚀 私聊群聊方式、单聊串聊模式、角色扮演、图片创作.

基于GO语言实现的钉钉集成ChatGPT机器人 

🥁 号外号外!

大家好呀！我们正在招募一批小伙伴来加入我们的重构项目！

如果你对以下领域感兴趣，那么你就是我们正在寻找的人啦！

设计小伙伴

  • 参与使用在线设计工具协作：Figma、Mastergo、JS Design或Pixso。
  • 有B端设计经验就更棒啦！
  • 加入熟悉的团队：成员已经为超过百款设计插件进行交付，我们是设计师最可靠的搭档，坚决抵制奇怪的需求。
  • 尽享优厚福利：第一时间接触最新的AI设计插件，更有其他丰厚的福利等你来拿。

前端小伙伴

  • Vue or React ~
  • 如果你还有一些B端开发经验那就更棒啦！
  • 创意？没关系，我们有楼上的设计师！

后端小伙伴

  • Golang语言，了解不用说！
  • 熟练掌握gin框架，开发后端就跟呼吸一样自然！
  • 对钉钉、飞书、企微等平台的SDK有所了解，能够开发和集成一系列令人惊叹的功能！
  • 精通平台化细节思维，让你开发的高效服务端热更新脚本惊艳全场！
  • 轻松驾驭Docker容器化技术，随心所欲地部署代码！
  • 有一些支付功能开发经验，真正能让钞票砰砰砰地飞！
  • 了解部分Linux脚本和socket编程
  • 上述满足一些即可

算法小伙伴

  • NLP和CV领域的算法达人

测试小伙伴

  • 重点参与内测产品的功能测试
  • 欢迎没有代码技能的小伙伴

如果你正在寻找gpt应用的灵感，那不妨加入我们的项目组吧！

我们的目标是通过泛AI技术，为企业层面的场景协同提供赋能。

我们队员有

想成为这个充满活力、热情的团队的一员嘛？

戳我微信 laolei_forkway

 

前言

本项目可以助你将GPT机器人集成到钉钉群聊当中。当前默认模型为gpt-3.5，支持gpt-4。

  • 📢 注意：当下部署以及配置流程都已非常成熟，文档和issue中基本都覆盖到了，因此不再回答任何项目安装部署与配置使用上的问题，如果完全不懂，可考虑通过 邮箱 联系我进行付费的技术支持。

  • 📢 注意：这个项目所有的功能，都汇聚在使用指南中，请务必仔细阅读，以体验其完整精髓。

🥳 欢迎关注我的其他开源项目：

🚜 我还创建了一个项目 awesome-chatgpt-answer ：记录那些问得好，答得妙的时刻，欢迎提交你与ChatGPT交互过程中遇到的那些精妙对话。

⚗️ openai官方提供了一个 状态页 来呈现当前openAI服务的状态，同时如果有问题发布公告也会在这个页面，如果你感觉它有问题了，可以在这个页面看看。

功能介绍

  • 🚀 帮助菜单：通过发送 帮助 将看到帮助列表，🖼 查看示例
  • 🥷 私聊：支持与机器人单独私聊(无需艾特)，🖼 查看示例
  • 💬 群聊：支持在群里艾特机器人进行对话
  • 🙋 单聊模式：每次对话都是一次新的对话，没有历史聊天上下文联系
  • 🗣 串聊模式：带上下文理解的对话模式
  • 🎨 图片生成：通过发送 #图片关键字开头的内容进行生成图片，🖼 查看示例
  • 🎭 角色扮演：支持场景模式，通过 #周报 的方式触发内置prompt模板 🖼 查看示例
  • 🧑‍💻 频率限制：通过配置指定，自定义单个用户单日最大对话次数
  • 💵 余额查询：通过发送 余额 关键字查询当前key所剩额度，🖼 查看示例
  • 🔗 自定义api域名：通过配置指定，解决国内服务器无法直接访问openai的问题
  • 🪜 添加代理：通过配置指定，通过给应用注入代理解决国内服务器无法访问的问题
  • 👐 默认模式：支持自定义默认的聊天模式，通过配置化指定
  • 📝 查询对话：通过发送#查对话 username:xxx查询xxx的对话历史，可在线预览，可下载到本地
  • 👹 白名单机制：通过配置指定，支持指定群组名称和用户名称作为白名单，从而实现可控范围与机器人对话
  • 💂‍♀️ 管理员机制：通过配置指定管理员，部分敏感操作，以及一些应用配置，管理员有权限进行操作
  • ㊙️ 敏感词过滤：通过配置指定敏感词，提问时触发，则不允许提问，回答的内容中触发，则以*代替

使用前提

  • 有Openai账号，并且创建好api_key，注册相关事项可以参考此文章 。访问这里，申请个人秘钥。
  • 在钉钉开发者后台创建机器人，配置应用程序回调。

使用教程

第一步，创建机器人

方案一：outgoing类型机器人

钉钉群内的机器人有一个outgoing模式，当你创建机器人的时候，可以选择启用这个模式，然后直接配置回调地址，免去在管理后台创建应用的步骤，就可以直接投入使用。

官方文档：自定义机器人接入

但是这个模式貌似是部分开放的(目前来看貌似是部分人有创建这个类型的白名单)，所以如果你在钉钉群聊中添加自定义机器人的时候，看到和我一样的信息，则说明无法使用这种方式：

📢 注意

  • 如果你的和我一样，那么就只能放弃这种方案，往下看第二种对接方案。
  • 如果使用这种方案，那么就不能与机器人私聊对话，只能局限在群聊当中艾特机器人聊天。
  • 如果使用这种方案，则在群聊当中并不能达到真正的艾特发消息人的效果，因为这种机器人回调过来的关键信息为空。

方案二：企业内部应用

创建步骤参考文档：企业内部开发机器人，或者根据如下步骤进行配置。

  1. 创建机器人。

    示意图：

    https://camo.githubusercontent.com/3f28888079908e6be1108027c8eb3cff0188d42eadaac9a7e19386f3b30d1ccc/68747470733a2f2f63646e2e737461746963616c792e636f6d2f67682f657279616a662f74752f6d61696e2f696d672f696d6167655f32303232313230395f3136333631362e706e67

    📢 注意1：可能现在创建机器人的时候名字为chatgpt会被钉钉限制，请用其他名字命名。 📢 注意2：第四步骤点击创建应用的时候，务必选择使用旧版，从而创建旧版机器人。

    步骤比较简单，这里就不赘述了。

  2. 配置机器人回调接口：

    https://camo.githubusercontent.com/d1fb30021c99616b75b8daebb6b6e0452ddc72245fb720d6660abd55d8bd1b8b/68747470733a2f2f63646e2e737461746963616c792e636f6d2f67682f657279616a662f74752f6d61696e2f696d672f696d6167655f32303232313230395f3136333635322e706e67

     

    创建完毕之后，点击机器人开发管理，然后配置将要部署的服务所在服务器的出口IP，以及将要给服务配置的域名。

如果提示： 消息接收地址校验失败（请确保公网可访问该地址，如无有效SSL证书，可选择禁用证书校验），那么可以先输入一个https://，然后就能看到禁用https的选项了，选择禁用，然后再把地址改成http就好了。

  1. 发布机器人。

    https://camo.githubusercontent.com/f2b799649e19b44c48809fff2e6f165aa7039b40681cdafb3deae29262b7223a/68747470733a2f2f63646e2e737461746963616c792e636f6d2f67682f657279616a662f74752f6d61696e2f696d672f696d6167655f32303232313230395f3136333730392e706e67

     

    点击版本管理与发布，然后点击上线，这个时候就能在钉钉的群里中添加这个机器人了。

  2. 群聊添加机器人。

    https://camo.githubusercontent.com/2abaa4a2dc9de003ebbe55f06be474ffc30e69d2f4757e92ce8d2fd66674bdda/68747470733a2f2f63646e2e737461746963616c792e636f6d2f67682f657279616a662f74752f6d61696e2f696d672f696d6167655f32303232313230395f3136333732342e706e67

 

第二步，部署应用

docker部署

你可以使用docker快速运行本项目。

第一种：基于环境变量运行
# 运行项目
$ docker run -itd --name chatgpt -p 8090:8090 \
  -v ./data:/app/data --add-host="host.docker.internal:host-gateway" \
  -e LOG_LEVEL="info" -e APIKEY=换成你的key -e BASE_URL="" \
  -e MODEL="gpt-3.5-turbo" -e SESSION_TIMEOUT=600 \
  -e HTTP_PROXY="http://host.docker.internal:15732" \
  -e DEFAULT_MODE="单聊" -e MAX_REQUEST=0 -e PORT=8090 \
  -e SERVICE_URL="你当前服务外网可访问的URL" -e CHAT_TYPE="0" \
  -e ALLOW_GROUPS=a,b -e ALLOW_OUTGOING_GROUPS=a,b -e ALLOW_USERS=a,b -e DENY_USERS=a,b -e VIP_USERS=a,b -e ADMIN_USERS=a,b -e APP_SECRETS="xxx,yyy" \
  -e SENSITIVE_WORDS="aa,bb" \
  -e AZURE_ON="false" -e AZURE_API_VERSION="" -e AZURE_RESOURCE_NAME="" \
  -e AZURE_DEPLOYMENT_NAME="" -e AZURE_OPENAI_TOKEN="" \
  -e HELP="欢迎使用本工具\n\n你可以查看：[用户指南](https://github.com/eryajf/chatgpt-dingtalk/blob/main/docs/userGuide.md)\n\n这是一个[开源项目](https://github.com/eryajf/chatgpt-dingtalk/)
  ，觉得不错你可以来波素质三连."  \
  --restart=always  dockerproxy.com/eryajf/chatgpt-dingtalk:latest

运行命令中映射的配置文件参考下边的配置文件说明。

  • 📢 注意：如果使用docker部署，那么PORT参数不需要进行任何调整。
  • 📢 注意：ALLOW_GROUPS,ALLOW_USERS,DENY_USERS,VIP_USERS,ADMIN_USERS 参数为数组，如果需要指定多个，可用英文逗号分割。outgoing机器人模式下这些参数无效。
  • 📢 注意：如果服务器节点本身就在国外或者自定义了BASE_URL，那么就把HTTP_PROXY参数留空即可。
  • 📢 注意：如果使用docker部署，那么proxy地址可以直接使用如上方式部署，host.docker.internal会指向容器所在宿主机的IP，只需要更改端口为你的代理端口即可。参见：Docker容器如何优雅地访问宿主机网络
第二种：基于配置文件挂载运行
# 复制配置文件，根据自己实际情况，调整配置里的内容
$ cp config.example.yml config.yml  # 其中 config.example.yml 从项目的根目录获取

# 运行项目
$ docker run -itd --name chatgpt -p 8090:8090  -v `pwd`/config.yml:/app/config.yml --restart=always  dockerproxy.com/eryajf/chatgpt-dingtalk:latest

其中配置文件参考下边的配置文件说明。

第三种：使用 docker compose 运行
$ wget https://raw.githubusercontent.com/eryajf/chatgpt-dingtalk/main/docker-compose.yml

$ nano docker-compose.yml # 编辑 APIKEY 等信息

$ docker compose up -d

部署完成之后，通过Nginx代理本服务：

server {
    listen       80;
    server_name  chat.eryajf.net;

    client_header_timeout 120s;
    client_body_timeout 120s;

    location / {
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_pass http://localhost:8090;
    }
}

部署完成之后，就可以在群里艾特机器人进行体验了。

📢 注意:Nginx代理步骤是个可选步骤，你也可以直接通过服务器外网IP:PORT作为回调地址。

Nginx配置完毕之后，可以先手动请求一下，通过服务日志输出判断服务是否正常可用：

$ curl --location --request POST 'http://chat.eryajf.net/' \
  --header 'Content-type: application/json' \
  -d '{
    "conversationId": "xxx",
    "atUsers": [
        {
            "dingtalkId": "xxx",
            "staffId":"xxx"
        }
    ],
    "chatbotCorpId": "dinge8a565xxxx",
    "chatbotUserId": "$:LWCP_v1:$Cxxxxx",
    "msgId": "msg0xxxxx",
    "senderNick": "eryajf",
    "isAdmin": true,
    "senderStaffId": "user123",
    "sessionWebhookExpiredTime": 1613635652738,
    "createAt": 1613630252678,
    "senderCorpId": "dinge8a565xxxx",
    "conversationType": "2",
    "senderId": "$:LWCP_v1:$Ff09GIxxxxx",
    "conversationTitle": "机器人测试-TEST",
    "isInAtList": true,
    "sessionWebhook": "https://oapi.dingtalk.com/robot/sendBySession?session=xxxxx",
    "text": {
        "content": " 你好"
    },
    "msgtype": "text"
}'

如果手动请求没有问题，那么就可以在钉钉群里与机器人进行对话了。

📢 注意： 如果配置文件中app_secret不为空，那么这里curl请求将会校验失败，理论上只要服务能够正常被访问，那么直接在钉钉管理后台配置回调就可以了，如果想通过curl进行调试，则注意需把对应配置项留空。

二进制部署

如果你想通过命令行直接部署，可以直接下载release中的压缩包 ，请根据自己系统以及架构选择合适的压缩包，下载之后直接解压运行。

下载之后，在本地解压，即可看到可执行程序，与配置文件：

$ tar xf chatgpt-dingtalk-v0.0.4-darwin-arm64.tar.gz
$ cd chatgpt-dingtalk-v0.0.4-darwin-arm64
$ cp config.example.yml  config.yml # 然后根据情况调整配置文件内容,宿主机如遇端口冲突,可通过调整config.yml中的port参数自定义服务端口
$ ./chatgpt-dingtalk  # 直接运行

# 如果要守护在后台运行
$ nohup ./chatgpt-dingtalk &> run.log &
$ tail -f run.log

亮点特色

与机器人私聊

2023-03-08补充，我发现也可以不在群里艾特机器人聊天，还可点击机器人，然后点击发消息，通过与机器人直接对话进行聊天：

由 @Raytow 同学发现，在机器人自动生成的测试群里无法直接私聊机器人，在其他群里单独添加这个机器人，然后再点击就可以跟它私聊了。

https://user-images.githubusercontent.com/33259379/223607306-2ac836a2-7ce5-4a12-a16e-bec40b22d8d6.png

帮助列表

艾特机器人发送空内容或者帮助，会返回帮助列表。

https://camo.githubusercontent.com/f39d6b0c1d4137256fc308ce0bf1cec14c8dd13eb91b5987ea38623d6ed0e11f/68747470733a2f2f63646e2e737461746963616c792e636f6d2f67682f657279616a662f74752f6d61696e2f696d672f696d6167655f32303233303231365f3232313235332e706e67

切换模式

发送指定关键字，可以切换不同的模式。

https://camo.githubusercontent.com/04947706d8cfe7776499e004ed1aea3fbf2780e056f46ed05ff5f801723628dc/68747470733a2f2f63646e2e737461746963616c792e636f6d2f67682f657279616a662f74752f6d61696e2f696d672f696d6167655f32303233303231355f3138343635352e706e67

📢 注意：串聊模式下，群里每个人的聊天上下文是独立的。 📢 注意：默认对话模式为单聊，因此不必发送单聊即可进入单聊模式，而要进入串聊，则需要发送串聊关键字进行切换，当串聊内容超过最大限制的时候，你可以发送重置，然后再次进入串聊模式。

查询余额

艾特机器人发送 余额 二字，会返回当前key对应的账号的剩余额度以及可用日期。

https://camo.githubusercontent.com/1e85a0dc994c01171694fc88bffa68a5afc150790ed353500cb16458bba9e06e/68747470733a2f2f63646e2e737461746963616c792e636f6d2f67682f657279616a662f74752f6d61696e2f696d672f696d6167655f32303233303330345f3232323532322e6a7067

日常问题

https://camo.githubusercontent.com/caa635cd4dae86ae3022bfaec24aeb64a92005a41084ee4e707430bd699f29f4/68747470733a2f2f63646e2e737461746963616c792e636f6d2f67682f657279616a662f74752f6d61696e2f696d672f696d6167655f32303232313230395f3136333733392e706e67

通过内置prompt聊天

发送模板两个字，会返回当前内置支持的prompt列表。

https://camo.githubusercontent.com/15eb31fccffe9b0db5e2f9b0a48cc8bfb38c78d63678520ba22be87ad130162d/68747470733a2f2f63646e2e737461746963616c792e636f6d2f67682f657279616a662f74752f6d61696e2f696d672f696d6167655f32303233303332335f3135323730332e6a7067

如果你发现有比较优秀的prompt，欢迎PR。注意：一些与钉钉使用场景不是很匹配的，就不要提交了。

生成图片

发送以 #图片开头的内容，将会触发绘画能力，图片生成之后，将会保存在程序根目录下的images目录下。

如果你绘图没有思路，可以在这里以及这里找到一些不错的prompt。

https://camo.githubusercontent.com/e440d40438f2edcedbae61ec9f1de0cb407b85218863fa177d837adf08ab1834/68747470733a2f2f63646e2e737461746963616c792e636f6d2f67682f657279616a662f74752f6d61696e2f696d672f696d6167655f32303233303332335f3135303534372e6a7067

支持 gpt-4

如果你的账号通过了官方的白名单，那么可以将模型配置为：gpt-4-0314或gpt-4，目前gpt-4的余额查询以及图片生成功能暂不可用，可能是接口限制，也可能是其他原因，等我有条件的时候，会对这些功能进行测试验证。

以下是gpt-3.5与gpt-4对数学计算方面的区别。

https://camo.githubusercontent.com/799f7c75b6f0c15b5b55d7ed1322c18d1a1c9d34355b8d682f71281b4c42a7d6/68747470733a2f2f63646e2e737461746963616c792e636f6d2f67682f657279616a662f74752f6d61696e2f696d672f696d6167655f32303233303333305f3138303330382e6a7067

感谢@PIRANHACHAN同学提供的gpt-4的key，使得项目在gpt-4的对接上能够进行验证测试，达到了可用状态。

本地开发

# 获取项目
$ git clone https://github.com/eryajf/chatgpt-dingtalk.git

# 进入项目目录
$ cd chatgpt-dingtalk

# 复制配置文件，根据个人实际情况进行配置
$ cp config.example.yml config.yml

# 启动项目
$ go run main.go

配置文件说明

# 应用的日志级别，info or debug
log_level: "info"
# openai api_key
api_key: "xxxxxxxxx"
# 如果你使用官方的接口地址 https://api.openai.com，则留空即可，如果你想指定请求url的地址，可通过这个参数进行配置，注意需要带上 http 协议
base_url: ""
# 指定模型，默认为 gpt-3.5-turbo , 可选参数有： "gpt-4-0314", "gpt-4", "gpt-3.5-turbo-0301", "gpt-3.5-turbo"，如果使用gpt-4，请确认自己是否有接口调用白名单
model: "gpt-3.5-turbo"
# 会话超时时间,默认600秒,在会话时间内所有发送给机器人的信息会作为上下文
session_timeout: 600
# 指定请求时使用的代理，如果为空，则不使用代理，注意需要带上 http 协议 或 socks5 协议
http_proxy: ""
# 指定默认的对话模式，可根据实际需求进行自定义，如果不设置，默认为单聊，即无上下文关联的对话模式
default_mode: "单聊"
# 单人单日请求次数上限，默认为0，即不限制
max_request: 0
# 指定服务启动端口，默认为 8090，一般在二进制宿主机部署时，遇到端口冲突时使用
port: "8090"
# 指定服务的地址，就是当前服务可供外网访问的地址(或者直接理解为你配置在钉钉回调那里的地址)，用于生成图片时给钉钉做渲染
service_url: "http://chat.eryajf.net"
# 限定对话类型 0：不限 1：只能单聊 2：只能群聊
chat_type: "0"
# 哪些群组可以进行对话（仅在chat_type为0、2时有效），如果留空，则表示允许所有群组，如果要限制，则列表中写群ID（ConversationID）
# 群ID，可在群组中 @机器人 群ID 来查看日志获取，例如日志会输出：[🙋 企业内部机器人 在『测试』群的ConversationID为: "cidrabcdefgh1234567890AAAAA"]，获取后可填写该参数并重启程序
allow_groups: []
# 哪些普通群（使用outgoing机器人）可以进行对话，如果留空，则表示允许所有群组，如果要限制，则列表中写群ID（ConversationID）
# 群ID，可在群组中 @机器人 群ID 来查看日志获取，例如日志会输出：[🙋 outgoing机器人 在『测试』群的ConversationID为: "cidrabcdefgh1234567890AAAAA"]，获取后可填写该参数并重启程序
# 如果不想支持outgoing机器人功能，这里可以随意设置一个内部群组，例如：cidrabcdefgh1234567890AAAAA；或随意一个字符串，例如：disabled
# 建议该功能默认关闭：除非你必须要用到outgoing机器人
allow_outgoing_groups: ["disabled"]
# 以下 allow_users、deny_users、vip_users、admin_users 配置中填写的是用户的userid，outgoing机器人模式下不适用这些配置
# 比如 ["1301691029702722","1301691029702733"]，这个信息需要在钉钉管理后台的通讯录当中获取：https://oa.dingtalk.com/contacts.htm#/contacts
# 哪些用户可以进行对话，如果留空，则表示允许所有用户，如果要限制，则列表中写用户的userid
allow_users: []
# 哪些用户不可以进行对话，如果留空，则表示允许所有用户（如allow_user有配置，需满足相应条件），如果要限制，则列表中写用户的userid，黑名单优先级高于白名单
deny_users: []
# 哪些用户可以进行无限对话，如果留空，则表示只允许管理员（如max_request配置为0，则允许所有人）
# 如果要针对指定VIP用户放开限制（如max_request配置不为0），则列表中写用户的userid
vip_users: []
# 指定哪些人为此系统的管理员，如果留空，则表示没有人是管理员，如果要限制，则列表中写用户的userid
# 注意：如果下边的app_secrets为空，以及使用outgoing的方式配置机器人，这两种情况下，都表示没有人是管理员
admin_users: []
# 钉钉机器人在应用信息中的AppSecret，为了校验回调的请求是否合法，如果留空，将会忽略校验，则该接口将会存在其他人也能随意调用的安全隐患，因此强烈建议配置正确的secret，如果你的服务对接给多个机器人，这里可以配置多个机器人的secret
app_secrets: []
# 敏感词，提问时触发，则不允许提问，回答的内容中触发，则以 *** 代替
sensitive_words: []
# 帮助信息，放在配置文件，可供自定义
help: "欢迎使用本工具\n\n你可以查看：[用户指南](https://github.com/eryajf/chatgpt-dingtalk/blob/main/docs/userGuide.md)\n\n这是一个[开源项目](https://github.com/eryajf/chatgpt-dingtalk/)，觉得不错你可以来波素质三连."

# Azure OpenAI 配置
# 例如 curl https://forkway-test.openai.azure.com/openai/deployments/test-dev/chat/completions\?api-version\=2023-03-15-preview \
# azure_api_version: "2023-03-15-preview"
# azure_resource_name: "forkway-test"
# azure_deployment_name: "test-dev"
azure_on: false # 如果是true，则会走azure的openai接口
azure_api_version: "2023-03-15-preview"
azure_resource_name: "xxxx"
azure_deployment_name: "xxxx"
azure_openai_token: "xxxx"

常见问题

如何更好地使用ChatGPT：这里有许多案例可供参考。

🗣 重要重要 一些常见的问题，我单独开issue放在这里：👉点我👈，可以查看这里辅助你解决问题，如果里边没有，请对历史issue进行搜索(不要提交重复的issue)，也欢迎大家补充。

进群交流

我创建了一个钉钉的交流群，欢迎进群交流。

感谢

这个项目能够成立，离不开这些开源项目：

from 

https://github.com/ConnectAI-E/Dingtalk-OpenAI