• 添加 "speech_recognition": true 将开启语音识别，默认使用openai的whisper模型识别为文字，同时以文字回复，该参数仅支持私聊 (注意由于语音消息无法匹配前缀，一旦开启将对所有语音自动回复，支持语音触发画图)；
• 添加 "group_speech_recognition": true 将开启群组语音识别，默认使用openai的whisper模型识别为文字，同时以文字回复，参数仅支持群聊 (会匹配group_chat_prefix和group_chat_keyword, 支持语音触发画图)；
• 添加 "voice_reply_voice": true 将开启语音回复语音（同时作用于私聊和群聊）

• model: 模型名称，Agent模式下推荐使用 glm-4.7、MiniMax-M2.1、qwen3-max、claude-opus-4-6、claude-sonnet-4-5、claude-sonnet-4-0、gemini-3-flash-preview、gemini-3-pro-preview，全部模型名称参考common/const.py文件
• character_desc：普通对话模式下的机器人系统提示词。在Agent模式下该配置不生效，由工作空间中的文件内容构成。
• subscribe_msg：订阅消息，公众号和企业微信channel中请填写，当被订阅时会自动回复， 可使用特殊占位符。目前支持的占位符有{trigger_prefix}，在程序中它会自动替换成bot的触发词。

• use_linkai: 是否使用LinkAI接口，默认关闭，设置为true后可对接LinkAI平台，使用知识库、工作流、插件等能力, 参考接口文档
• linkai_api_key: LinkAI Api Key，可在 控制台 创建
• linkai_app_code: LinkAI 应用或工作流的code，选填，普通对话模式中使用。

1. API Key创建：在 OpenAI平台 创建API Key

2. 填写配置

{
    "model": "gpt-4.1-mini",
    "open_ai_api_key": "YOUR_API_KEY",
    "open_ai_api_base": "https://api.openai.com/v1",
    "bot_type": "chatGPT"
}

• model: 与OpenAI接口的 model参数 一致，支持包括 o系列、gpt-5.2、gpt-5.1、gpt-4.1等系列模型
• open_ai_api_base: 如果需要接入第三方代理接口，可通过修改该参数进行接入
• bot_type: 使用OpenAI相关模型时无需填写。当使用第三方代理接口接入Claude等非OpenAI官方模型时，该参数设为 chatGPT

1. API Key创建：在 LinkAI平台 创建API Key

2. 填写配置

{
    "use_linkai": true,
    "linkai_api_key": "YOUR API KEY",
    "linkai_app_code": "YOUR APP CODE"
}

• use_linkai: 是否使用LinkAI接口，默认关闭，设置为true后可对接LinkAI平台的智能体，使用知识库、工作流、数据库、MCP插件等丰富的Agent能力
• linkai_api_key: LinkAI平台的API Key，可在 控制台 中创建
• linkai_app_code: LinkAI智能体 (应用或工作流) 的code，选填，普通对话模式可用。智能体创建可参考 说明文档
• model: model字段填写空则直接使用智能体的模型，可在平台中灵活切换，模型列表中的全部模型均可使用

方式一：官方接入，配置如下(推荐)：

{
    "model": "MiniMax-M2.1",
    "minimax_api_key": ""
}

• model: 可填写 MiniMax-M2.1、MiniMax-M2.1-lightning、MiniMax-M2、abab6.5-chat 等
• minimax_api_key：MiniMax平台的API-KEY，在 控制台 创建

方式二：OpenAI兼容方式接入，配置如下：

{
  "bot_type": "chatGPT",
  "model": "MiniMax-M2.1",
  "open_ai_api_base": "https://api.minimaxi.com/v1",
  "open_ai_api_key": ""
}

• bot_type: OpenAI兼容方式
• model: 可填 MiniMax-M2.1、MiniMax-M2.1-lightning、MiniMax-M2，参考API文档
• open_ai_api_base: MiniMax平台API的 BASE URL
• open_ai_api_key: MiniMax平台的API-KEY

方式一：官方接入，配置如下(推荐)：

{
  "model": "glm-4.7",
  "zhipu_ai_api_key": ""
}

• model: 可填 glm-4.7、glm-4-plus、glm-4-flash、glm-4-air、glm-4-airx、glm-4-long 等, 参考 glm-4系列模型编码
• zhipu_ai_api_key: 智谱AI平台的 API KEY，在 控制台 创建

方式二：OpenAI兼容方式接入，配置如下：

{
  "bot_type": "chatGPT",
  "model": "glm-4.7",
  "open_ai_api_base": "https://open.bigmodel.cn/api/paas/v4",
  "open_ai_api_key": ""
}

• bot_type: OpenAI兼容方式
• model: 可填 glm-4.7、glm-4.6、glm-4-plus、glm-4-flash、glm-4-air、glm-4-airx、glm-4-long 等
• open_ai_api_base: 智谱AI平台的 BASE URL
• open_ai_api_key: 智谱AI平台的 API KEY

方式一：官方SDK接入，配置如下(推荐)：

{
    "model": "qwen3-max",
    "dashscope_api_key": "sk-qVxxxxG"
}

• model: 可填写 qwen3-max、qwen-max、qwen-plus、qwen-turbo、qwen-long、qwq-plus 等
• dashscope_api_key: 通义千问的 API-KEY，参考 官方文档 ，在 控制台 创建

方式二：OpenAI兼容方式接入，配置如下：

{
  "bot_type": "chatGPT",
  "model": "qwen3-max",
  "open_ai_api_base": "https://dashscope.aliyuncs.com/compatible-mode/v1",
  "open_ai_api_key": "sk-qVxxxxG"
}

• bot_type: OpenAI兼容方式
• model: 支持官方所有模型，参考模型列表
• open_ai_api_base: 通义千问API的 BASE URL
• open_ai_api_key: 通义千问的 API-KEY

1. API Key创建：在 Claude控制台 创建API Key

2. 填写配置

{
    "model": "claude-sonnet-4-5",
    "claude_api_key": "YOUR_API_KEY"
}

• model: 参考 官方模型ID ，支持 claude-opus-4-6、claude-sonnet-4-5、claude-sonnet-4-0、claude-opus-4-0、claude-3-5-sonnet-latest 等

API Key创建：在 控制台 创建API Key ，配置如下

{
    "model": "gemini-3-flash-preview",
    "gemini_api_key": ""
}

• model: 参考官方文档-模型列表，支持 gemini-3-flash-preview、gemini-3-pro-preview、gemini-2.5-pro、gemini-2.0-flash 等

1. API Key创建：在 DeepSeek平台 创建API Key

2. 填写配置

{
    "model": "deepseek-chat",
    "open_ai_api_key": "sk-xxxxxxxxxxx",
    "open_ai_api_base": "https://api.deepseek.com/v1", 
    "bot_type": "chatGPT"

}

• bot_type: OpenAI兼容方式
• model: 可填 deepseek-chat、deepseek-reasoner，分别对应的是 DeepSeek-V3 和 DeepSeek-R1 模型
• open_ai_api_key: DeepSeek平台的 API Key
• open_ai_api_base: DeepSeek平台 BASE URL

方式一：官方接入，配置如下：

{
    "model": "moonshot-v1-128k",
    "moonshot_api_key": ""
}

• model: 可填写 moonshot-v1-8k、moonshot-v1-32k、moonshot-v1-128k
• moonshot_api_key: Moonshot的API-KEY，在 控制台 创建

方式二：OpenAI兼容方式接入，配置如下：

{
  "bot_type": "chatGPT",
  "model": "moonshot-v1-128k",
  "open_ai_api_base": "https://api.moonshot.cn/v1",
  "open_ai_api_key": ""
}

• bot_type: OpenAI兼容方式
• model: 可填写 moonshot-v1-8k、moonshot-v1-32k、moonshot-v1-128k
• open_ai_api_base: Moonshot的 BASE URL
• open_ai_api_key: Moonshot的 API-KEY

1. API Key创建：在 Azure平台 创建API Key

2. 填写配置

{
  "model": "",
  "use_azure_chatgpt": true,
  "open_ai_api_key": "",
  "open_ai_api_base": "",
  "azure_deployment_id": "",
  "azure_api_version": "2025-01-01-preview"
}

• model: 留空即可
• use_azure_chatgpt: 设为 true
• open_ai_api_key: Azure平台的密钥
• open_ai_api_base: Azure平台的 BASE URL
• azure_deployment_id: Azure平台部署的模型名称
• azure_api_version: api版本以及以上参数可以在部署的 模型配置 界面查看

{
    "model": "wenxin-4", 
    "baidu_wenxin_api_key": "IajztZ0bDxgnP9bEykU7lBer",
    "baidu_wenxin_secret_key": "EDPZn6L24uAS9d8RWFfotK47dPvkjD6G"
}

• model: 可填 wenxin和wenxin-4，对应模型为 文心-3.5 和 文心-4.0
• baidu_wenxin_api_key：参考 千帆平台-access_token鉴权 文档获取 API Key
• baidu_wenxin_secret_key：参考 千帆平台-access_token鉴权 文档获取 Secret Key

方式二：OpenAI兼容方式接入，配置如下：

{
  "bot_type": "chatGPT",
  "model": "ERNIE-4.0-Turbo-8K",
  "open_ai_api_base": "https://qianfan.baidubce.com/v2",
  "open_ai_api_key": "bce-v3/ALTxxxxxxd2b"
}

• bot_type: OpenAI兼容方式
• model: 支持官方所有模型，参考模型列表
• open_ai_api_base: 百度文心API的 BASE URL
• open_ai_api_key: 百度文心的 API-KEY，参考 官方文档 ，在 控制台 创建API Key

方式一：官方接入，配置如下： 参考 官方文档-快速指引 获取 APPID、 APISecret、 APIKey 三个参数

{
  "model": "xunfei",
  "xunfei_app_id": "",
  "xunfei_api_key": "",
  "xunfei_api_secret": "",
  "xunfei_domain": "4.0Ultra",
  "xunfei_spark_url": "wss://spark-api.xf-yun.com/v4.0/chat"
}

• model: 填 xunfei
• xunfei_domain: 可填写 4.0Ultra、generalv3.5、max-32k、generalv3、pro-128k、lite
• xunfei_spark_url: 填写参考 官方文档-请求地址 的说明

方式二：OpenAI兼容方式接入，配置如下：

{
  "bot_type": "chatGPT",
  "model": "4.0Ultra",
  "open_ai_api_base": "https://spark-api-open.xf-yun.com/v1",
  "open_ai_api_key": ""
}

• bot_type: OpenAI兼容方式
• model: 可填写 4.0Ultra、generalv3.5、max-32k、generalv3、pro-128k、lite
• open_ai_api_base: 讯飞星火平台的 BASE URL
• open_ai_api_key: 讯飞星火平台的APIPassword ，因模型而已

{
  "bot_type": "modelscope",
  "model": "Qwen/QwQ-32B",
  "modelscope_api_key": "your_api_key",
  "modelscope_base_url": "https://api-inference.modelscope.cn/v1/chat/completions",
  "text_to_image": "MusePublic/489_ckpt_FLUX_1"
}

• bot_type: modelscope接口格式
• model: 参考模型列表
• modelscope_api_key: 参考 官方文档-访问令牌 ，在 控制台
• modelscope_base_url: modelscope平台的 BASE URL
• text_to_image: 图像生成模型，参考模型列表

项目启动后默认运行Web通道，配置如下：

{
    "channel_type": "web",
    "web_port": 9899
}

• web_port: 默认为 9899，可按需更改，需要服务器防火墙和安全组放行该端口
• 如本地运行，启动后请访问 http://localhost:9899/chat ；如服务器运行，请访问 http://ip:9899/chat

注：请将上述 url 中的 ip 或者 port 替换为实际的值

飞书支持两种事件接收模式：WebSocket 长连接（推荐）和 Webhook。

方式一：WebSocket 模式（推荐，无需公网 IP）

{
    "channel_type": "feishu",
    "feishu_app_id": "APP_ID",
    "feishu_app_secret": "APP_SECRET",
    "feishu_event_mode": "websocket"
}

方式二：Webhook 模式（需要公网 IP）

{
    "channel_type": "feishu",
    "feishu_app_id": "APP_ID",
    "feishu_app_secret": "APP_SECRET",
    "feishu_token": "VERIFICATION_TOKEN",
    "feishu_event_mode": "webhook",
    "feishu_port": 9891
}

• feishu_event_mode: 事件接收模式，websocket（推荐）或 webhook
• WebSocket 模式需安装依赖：pip3 install lark-oapi

详细步骤和参数说明参考 飞书接入

钉钉需要在开放平台创建智能机器人应用，将以下配置填入 config.json：

{
    "channel_type": "dingtalk",
    "dingtalk_client_id": "CLIENT_ID",
    "dingtalk_client_secret": "CLIENT_SECRET"
}

详细步骤和参数说明参考 钉钉接入

企业微信自建应用接入需在后台创建应用并启用消息回调，配置示例：

{
    "channel_type": "wechatcom_app",
    "wechatcom_corp_id": "CORPID",
    "wechatcomapp_token": "TOKEN",
    "wechatcomapp_port": 9898,
    "wechatcomapp_secret": "SECRET",
    "wechatcomapp_agent_id": "AGENTID",
    "wechatcomapp_aes_key": "AESKEY"
}

详细步骤和参数说明参考 企微自建应用接入

本项目支持订阅号和服务号两种公众号，通过服务号（wechatmp_service）体验更佳。

个人订阅号（wechatmp）

{
    "channel_type": "wechatmp",
    "wechatmp_token": "TOKEN",
    "wechatmp_port": 80,
    "wechatmp_app_id": "APPID",
    "wechatmp_app_secret": "APPSECRET",
    "wechatmp_aes_key": ""
}

企业服务号（wechatmp_service）

{
    "channel_type": "wechatmp_service",
    "wechatmp_token": "TOKEN",
    "wechatmp_port": 80,
    "wechatmp_app_id": "APPID",
    "wechatmp_app_secret": "APPSECRET",
    "wechatmp_aes_key": ""
}

详细步骤和参数说明参考 微信公众号接入

修改 config.json 中的 channel_type 字段：

{
    "channel_type": "terminal"
}

运行后可在终端与机器人进行对话。