一、启程
用deepseek打造一位博古通今、才思敏捷的AI助手，只需要借助一个强大的桥梁工具，这就不再是科幻场景。本文将详细介绍，如何将DeepSeek大模型的智慧，安全、便捷地打造专属的智能对话伙伴。
核心工具简介
我们使用的“桥梁”是一个基于大模型构建的全能聊天机器人框架。它的强大之处在于：
- 广泛兼容：轻松接入各种常用社交平台。
- 模型自由：支持切换各种主流大模型，宛如拥有一个“模型百宝箱”。
- 多模态能力：不仅能处理文字，还能理解语音、生成图片，让互动更丰富。
- 扩展性强：可访问互联网获取实时信息，更能基于你的自有知识库进行深度定制，胜任企业智能客服等专业角色。
至关重要的风险提示
在开启这段奇妙的连接之旅前，必须敲响警钟：
此操作存在一定的账号封禁风险。
- 强烈建议：使用一个无关紧要、非主要的小号来进行对接操作。切勿用日常使用或有重要联系人的主号尝试。
- 目的纯粹：将其视为技术探索和个人智能助手应用，避免高频、滥用或敏感内容交互。
二、环境准备与依赖安装
让DeepSeek 接入前，我们需要为其搭建稳固的运行环境。
1. 准备编程环境：Python
- 核心要求：确保你的电脑（Linux服务器、MacOS 或 Windows）已安装 Python。它是驱动整个系统的“引擎”。
- 版本推荐：
- 最稳妥选择：Python 3.8。它在所有支持的系统上表现最为兼容，如同广袤平原上最稳健的马车。
- 可接受范围：3.7.1 至 3.9.X。
- 注意避坑：Python 3.10 及以上版本，目前仅在 MacOS 上确认可用。在 Windows 或 Linux 上尝试，可能如同在未知海域航行，存在触礁风险（兼容性问题）。强烈建议初学者选择 3.8 版本。
提示：若你选择后续的 Docker 部署方式（推荐给想省心的朋友），则可跳过 Python 安装和下面的依赖安装步骤，直达配置环节，如同选择乘坐快捷的蒸汽轮船，省去了备马修路的繁琐。
2. 安装核心依赖
pip3 install -r requirements.txt这条命令会自动安装文字交流功能所需的最小依赖集合（核心零件），让机器人能听懂你说的话并进行基础对话。
3. 安装可选“扩展包”：增强能力
如果你想赋予机器人更强大的能力，比如更流畅的交互或高级功能支持，可以安装可选“扩展包”：
pip3 install -r requirements-optional.txt温馨建议：建议安装这些可选依赖，它们能让你的智能助手体验更佳。
三、核心配置文件
机器人的行为规则，都写在一份特殊的“乐谱”——配置文件 config.json 中。
- 找到配置文件模板：在项目根目录下，你会看到一份模板文件
config-template.json。 - 创建你的乐谱：复制这份模板，创建属于你自己的最终生效乐谱：
bash cp config-template.json config.json - 准备谱写：用文本编辑器（如 VSCode, Notepad++, Sublime Text 等）打开
config.json文件。
1. 基础设置：机器人的「心窍」
{
"model": "deepseek-chat", // 选择AI心智：可填 deepseek-chat（V3）或 deepseek-reasoner（R1）
"open_ai_api_key": "sk-xxxxxx", // DeepSeek的「智慧钥匙」（API Key）
"open_ai_api_base": "https://api.deepseek.com/v1", // DeepSeek接口地址
"proxy": "127.0.0.1:7890", // 代理客户端的ip和端口
}密钥安全警示：
API Key 如《一千零一夜》的「芝麻开门」咒语，务必妥善保管！泄露它等于将智慧宝库拱手让人。
2. 对话规则
2.1 私聊触发机制
"single_chat_prefix": ["bot", "@bot"], // 私聊「门铃」：消息需含这些词才唤醒AI
"single_chat_reply_prefix": "[AI] " // 私聊时自动回复的前缀，用于区分真人灵活设定：
- 若希望每句话都触发：设为
[""] - 若不要回复前缀：设为
""
2.2 群聊法则
"group_chat_prefix": ["@bot"], // 群聊时包含该前缀则会触发机器人回复
"group_name_white_list": ["deepseek水群1", "deepseek水群2"], // 开启自动回复的群名称列表
"group_chat_in_one_session": ["deepseek水群3"] // 支持会话上下文共享的群名称，配置 ["ALL_GROUP"] 则作用于所有群聊2.3 图像生成
"image_create_prefix": ["画", "看", "找"] // 以这些字开头触发绘画前缀词是启动AI画师的指令。
2.4 进阶能力：五感通达
"speech_recognition": true, // 开启语音识别
"group_speech_recognition": true, // 开启群组语音识别
"voice_reply_voice": true, // 用语音回复语音注意：语音识别虽新奇但消耗资源，请按需启用。
2.5 灵魂塑造：人格注入
"character_desc": "你是博学的猫娘，用尾音带‘喵’的句子回答",
"conversation_max_tokens": 3000, // 记忆长度（超限则遗忘最早对话）
// 订阅消息，当被订阅时会自动回复.目前支持的占位符有{trigger_prefix}，在程序中它会自动替换成bot的触发词
"subscribe_msg": "感谢关注！{trigger_prefix}#help 查看指南"2.6 LinkAI扩展（可选）
"use_linkai": true, // 启用LinkAI（国内访问/知识库/MJ绘画）
"linkai_api_key": "LK-xxxxxx", // LinkAI密钥
"linkai_app_code": "WORKFLOW_CODE" // LinkAI 应用或工作流code[linkai官方文档](https://docs.link-ai.tech/platform/link-app/wechat)
四、获取DeepSeek API
如同古代商队需要通关文牒，你需先获得「API密钥」。
1. 官方途径：DeepSeek 平台获取
1.1 打开 DeepSeek 官网
点击右上角 「API开放平台」，进入密钥管理。
1.2 获取API Key
- 注册/登录账号。
- 充值金额（几元即可），激活API权限。
- 在控制台 「新建API Key」，生成一串以
sk-开头的密钥——这便是你的 「智慧密符」。
密钥示例：sk-1a2b3c4d5e6f...（请立即复制保存！）
1.3 突发风浪（访问失败怎么办？）
若官网无法访问（显示“被攻击”或空白），莫慌！有备选方案！
2. 备选方案：硅基流动（SiliconFlow）
2.1 登陆硅基流动
2.2 领取通行符
- 注册账号，进入控制台。
- 创建API Key，获得一串 **硅基专属密钥**（格式类似 `d2b5ca33bd...`）。
双路殊途同归，行装却需微调：
| 来源 | API Key 填入位置 | API 地址填入位置 |
|---|---|---|
| DeepSeek官方 | open_ai_api_key | open_ai_api_base |
| 硅基流动 | open_ai_api_key | open_ai_api_base |
关键差异配置：
// 使用 DeepSeek 官方（陆路）
"open_ai_api_key": "sk-xxxxxx",
"open_ai_api_base": "https://api.deepseek.com/v1",
使用 硅基流动（海路）
"open_ai_api_key": "d2b5ca33bd…", // 硅基密钥
"open_ai_api_base": "https://api.siliconflow.cn/v1", // 硅基地址五、Docker Compose 配置
现在我们需要配置一份神奇的 docker-compose.yml 文件来打造精妙的AI容器。
1. 容器蓝图
1.1 在任意位置创建专属文件夹（如 wechat-ai）。
1.2 在文件夹内新建 .txt 文件，将以下内容复制其中（格式务必保持原样）：
version: '2.0'
services:
chatgpt-on-wechat:
image: registry.cn-guangzhou.aliyuncs.com/kangarooking/chatgpt-on-wechat:250131
container_name: chatgpt-on-wechat
security_opt:
- seccomp:unconfined
environment:
# DeepSeek的智慧钥匙（官方或硅基API Key）
OPEN_AI_API_KEY: 'sk-xxxxxx'
# 知识源泉地址（官方或硅基API地址）
OPEN_AI_API_BASE: 'https://api.deepseek.com/v1'
# 选择AI心智：deepseek-chat(V3) 或 deepseek-reasoner(R1)
MODEL: 'deepseek-chat'
# 私聊触发咒语（""表示无需前缀）
SINGLE_CHAT_PREFIX: '[""]'
# 私聊回复前缀（留空则无标识）
SINGLE_CHAT_REPLY_PREFIX: '" "'
# 群聊召唤符（@你的微信昵称）
GROUP_CHAT_PREFIX: '["@大卫戴"]'
# 群聊白名单（填["ALL_GROUP"]则全群响应）
GROUP_NAME_WHITE_LIST: '["ds水1群", "ds水2群"]'
# 绘世密令（"画/看/找"开头触发作图）
IMAGE_CREATE_PREFIX: '["画", "看", "找"]'
# 记忆卷轴长度（数字越大记性越好）
CONVERSATION_MAX_TOKENS: 3000
# 语音识别开关
SPEECH_RECOGNITION: 'False'
# AI人格注入（用猫娘语气/学者口吻等）
CHARACTER_DESC: '用猫的语气跟我说话' 1.3 点睛命名：将文件另存为 docker-compose.yml（注意扩展名必须是 .yml）。
2. 关键变量解析
| 环境变量 | 作用说明 | 配置技巧 |
|---|---|---|
OPEN_AI_API_KEY | 填入deepseek API Key（如 sk-xxx 或硅基密钥） | 如同虎符，不可错误 |
OPEN_AI_API_BASE | 对应密钥的API地址（官方/硅基） | 地址末尾 /v1 如城门钥孔，必须保留 |
MODEL | deepseek-chat(V3) 或 deepseek-reasoner(R1) | 若需更强推理选R1，日常闲聊用V3 |
GROUP_CHAT_PREFIX | 群聊中召唤AI的@名称 | 替换 @大卫戴 为你的自定义昵称 |
CHARACTER_DESC | 人格设定（20字内生效！） | 例1： “回答时引用唐诗” 例2： “扮演老师” |
3. 避坑指南
- 缩进玄机：每行参数前需用 2空格 对齐。
- 引号结界：值中的引号
""和''需完整保留，这是YAML语法护盾。 - 密钥安全：切勿上传公开平台！
六、启动服务与登录
1. 启动服务
1.1 进入根目录
进入存放 docker-compose.yml 的文件夹。
在地址栏输入 cmd 并回车（Windows）或打开终端（Mac/Linux）。
1.2. 部署cow
执行以下命令：bash docker-compose up -d
系统将自动下载镜像、构建容器
1.3. 安装完成
当看到 Container chatgpt-on-wechat ... done 的提示，就代表部署完成了。
七、查看运行日志
打开docker-desktop，找到Containers->cow->view details查看cow的日志。
微信扫码
在 Logs 标签页中，若见最后一行显示：
扫码登录就完成了。
八、更新配置指南
若需修改人格设定或群组规则：
- 停止服务：在终端运行（原目录下）：
bash docker-compose down - 需改配置文件：
修改docker-compose.yml中的参数（如人格描述、触发词）。 - 重新启动：
bash docker-compose up -d - 重新扫码
