安装指南

本文档将指导您完成 WeiLinkBot 的安装和初始配置。

提示

WeiLinkBot 支持通过 Nuitka 或 PyInstaller 打包为单文件可执行程序，双击即可启动。

系统要求

硬件要求

• 处理器: 任意现代 x86_64 处理器
• 内存: 2GB 以上
• 存储: 500MB 以上（不含模型文件）

软件要求

• 操作系统: Windows 10/11 (64-bit)
• Python: 3.10 或更高版本（从源码安装时需要）

安装方式

方式一：从Github 安装

1. pip安装

pip install git+https://github.com/LingyeSoul/WeiLinkBot.git@main

2. 启动应用

weilinkbot serve

方式二：使用打包程序

下载打包好的版本

从夸克网盘下载

打包后的可执行文件（.exe），直接双击运行即可。程序会自动：

1. 初始化 SQLite 数据库
2. 创建默认配置
3. 启动网页控制台
4. 在浏览器中打开 http://localhost:5292

提示

双击 .exe 文件等同于执行 weilinkbot serve 命令，会自动启动网页控制台。

首次启动

1. 启动控制台

启动后在浏览器中打开 http://localhost:5292，您将看到 WeiLinkBot 控制台首页。

2. 配置 LLM 提供商

进入 提供商 页面，添加一个 LLM 提供商：

• 名称: 自定义名称（如 "OpenAI"、"DeepSeek"）
• API 地址: 提供商的 API 基础地址
• API Key: 您的 API 密钥

常用提供商配置：

提供商	API 地址
OpenAI	https://api.openai.com/v1
DeepSeek	https://api.deepseek.com/v1
自定义	任意兼容 OpenAI 协议的地址

3. 创建 LLM 预设

进入 模型 页面，创建一个 LLM 预设：

• 预设名称: 自定义名称
• 提供商: 选择刚创建的提供商
• 模型名称: 如 gpt-4o、deepseek-chat
• 能力标记: 勾选支持的能力（文本/音频/图片）
• 工具调用: 如果模型支持 Function Calling，开启此选项

4. 启动机器人

进入 状态 页面，点击 启动机器人 按钮。系统会显示微信登录二维码，使用微信扫码登录即可。

下一步

• 快速入门 - 了解基本使用流程
• 聊天命令 - 查看微信中的可用命令
• 设置说明 - 了解详细的配置选项