Coze Studio开发本地微信消息发送插件全流程实战

前言

字节跳动全面开源其AI应用开发平台Coze的核心组件Coze Studio。Coze Studio提供可视化设计与编排工具，开发者可以通过零代码或低代码的方式，快速打造和调试智能体、应用和工作流，实现强大的 AI 应用开发和更多定制化业务逻辑。

Coze Studio在v0.2.1版本移除插件URL https限制，大大方便本地插件的开发和部署。

本文介绍如下内容：

• • Docker部署Coze Studio
• • 如何开发本地插件：以开发微信消息发送插件为例
• • 如何使用官方内置插件：以高德地图插件为例
• • 开发智能体实现查询公共交通路线并通过微信发送给好友
• • 基于Coze Chat SDK接入Coze Studio智能体

智能体运行效果如下：

文末可获取插件完整代码下载地址。

Docker部署Coze Studio

前提：已安装好Docker。部署步骤：

1. 克隆代码

git clone https://github.com/coze-dev/coze-studio.git
cd coze-studio
git checkout v0.2.1

2. 配置模型
复制模板配置文件到backend/conf/model/ark_doubao-seed-1.6.yaml

# 复制模型配置模版
cp backend/conf/model/template/model_template_ark_doubao-seed-1.6.yaml backend/conf/model/ark_doubao-seed-1.6.yaml

修改backend/conf/model/ark_doubao-seed-1.6.yaml

• • meta.conn_config.api_key：填入doubao-seed-1.6模型服务的API Key。获取API Key的步骤：https://www.volcengine.com/docs/82379/1541594
• • meta.conn_config.model：填入doubao-seed-1.6模型服务的Endpoint ID。获取Endpoint ID的步骤：https://www.volcengine.com/docs/82379/1099522

3. 启动服务
要注意的是，虽然v0.2.1的release文档说对应的镜像版本是opencoze/opencoze:0.3.7，但经实测，此版本仍然有插件URL https限制的问题。切换到opencoze/opencoze:0.3.8才解决。如果之前已经下载过opencoze/opencoze:latest，需要重新pull镜像。

执行命令启动服务：

cd docker
cp .env.example .env
docker compose up -d

如果你无法下载docker镜像，参考彻底解决Docker镜像无法下载

需要下载的镜像列表：

bitnami/elasticsearch:8.18.0
bitnami/etcd:3.5
bitnami/redis:8.0
milvusdb/milvus:v2.5.10
minio/minio:RELEASE.2025-06-13T11-33-47Z-cpuv1
mysql:8.4.5
nsqio/nsq:v1.2.1
opencoze/opencoze:latest

4. 访问服务
启动服务后，通过浏览器打开http://localhost:8888，即可访问Coze Studio

开发微信消息发送插件

插件是一个工具集，一个插件内可以包含一个或多个工具（API）。Coze Studio支持http协议插件，你需要实现一个http服务，完成插件的相关接口功能，然后在Coze Studio配置插件的http接口参数。

下面介绍如何开发微信消息发送插件，开发环境为windows。

1. 设置开发环境

安装uv。uv是一个用Rust编写的极其快速的Python包和项目管理器。

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

创建python虚拟环境(假设项目目录为coze-plugin-wechat)

# Create a new directory for our project
uv init coze-plugin-wechat
cd coze-plugin-wechat

# Create virtual environment and activate it
uv venv
.venv\Scripts\activate

# Install dependencies
uv add wxauto fastapi uvicorn 

如果在执行.venv\Scripts\activate时报错“无法加载.venv\Scripts\activate.ps1，因为在此系统上禁止运行脚本”，需要以管理员权限在终端执行Set-ExecutionPolicy RemoteSigned更改执行策略后再重新执行。

2. 实现http接口

通过uvicorn + FastAPI实现http服务，通过wxauto实现微信操作。

wxauto是一个基于UIAutomation的开源Python微信自动化库。你需要在本机安装微信PC版本并完成扫码登录（注意wxauto只兼容3.9.x的微信PC版本）

main.py的代码如下：

from fastapi import FastAPI
from pydantic import BaseModel
from wxauto import WeChat
import uvicorn

app = FastAPI()
wx = WeChat()


class SendWechatMsgRequest(BaseModel):
    who: str
    msg: str


@app.post("/send_wechat_msg")
async def send_wechat_msg(req: SendWechatMsgRequest):
    wx.ChatWith(req.who)
    resp = wx.SendMsg(req.msg, req.who)
    return resp


if __name__ == "__main__":
    uvicorn.run(app, host="0.0.0.0", port=8000)

通过uv run main.py启动http服务。

3. 在Coze Studio配置插件

左侧的插件描述如下：

{
  "schema_version": "v1",
  "name_for_model": "微信",
  "name_for_human": "微信",
  "description_for_model": "微信",
  "description_for_human": "微信",
  "auth": {
    "type": "none",
    "sub_type": "",
    "payload": ""
  },
  "logo_url": "default_icon/plugin_default_icon.png",
  "api": {
    "type": "openapi"
  },
  "common_params": {
    "body": [],
    "path": [],
    "query": [],
    "header": [
      {
        "name": "User-Agent",
        "value": "Coze/1.0"
      }
    ]
  }
}

右侧的openapi包含如下信息：

• • 接口URL
• • 请求参数定义
• • 响应定义

详细内容如下：

openapi: 3.0.1
components:
    examples:
        send_wechat_msg:
            value:
                ReqExample:
                    body:
                        msg: 测试
                        who: 文件传输助手
                    header:
                        Content-Type: application/json
                        User-Agent: Coze/1.0
                    path: /send_wechat_msg
                    query: {}
                RespExample:
                    message: success
                    status: 成功
info:
    title: 微信
    description: 微信
    version: v1
paths:
    /send_wechat_msg:
        post:
            summary: 发送微信消息
            operationId: send_wechat_msg
            requestBody:
                content:
                    application/json:
                        schema:
                            type: object
                            required:
                                - who
                                - msg
                            properties:
                                msg:
                                    type: string
                                    description: 消息内容
                                    default: ""
                                who:
                                    type: string
                                    description: 消息接收者
                                    default: ""
            responses:
                "200":
                    description: description is required
                    content:
                        application/json:
                            schema:
                                type: object
                                properties:
                                    message:
                                        type: string
                                        description: 提示信息
                                    status:
                                        type: string
                                        description: 结果
servers:
    - url: http://host.docker.internal:8000

使用官方内置高德地图插件

开发智能体实现查询公共交通路线并通过微信发送给好友

1. 创建智能体

填上【智能体名称】后，点击【确认】

2. 添加插件

3. 人设和回复逻辑

设置为如下内容：

# 角色
你是一个助手，可以通过使用工具解决用户的问题 。
如果用户提供的信息不足，提示用户提供相关信息。

4. 预览与调试

输入“把广州南站到广州塔的公共交通路线发送给张三”，验证流程是否正常。

5. 发布智能体

基于Coze Chat SDK接入Coze Studio智能体

目前Coze Studio发布应用后，不具备dify直接生成可以访问页面地址的功能。需要自己通过Coze Chat SDK接入智能体。我已把前端的demo项目上传到https://github.com/copilot-coder/coze-chat-app.git

注意：此仓库仅用于展示如何用coze chat-sdk接入coze studio，里面很多信息是hard code的，并非一个完备的应用。

前提：已安装nodejs环境。步骤如下：

1. checkout代码

git clone https://github.com/copilot-coder/coze-chat-app.git

2. 修改src/App.jsx

• • appId: 改为你的BotId
• • token: 改为你的个人访问令牌
  

  

3. 安装依赖

cd coze-chat-app
npm install

4. 运行

npm run dev

5. 访问前端页面

总