AiHummer
中文▾
登录帐户
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
入门/快速入门

快速入门

v1.1.x · 已更新 2026-07-20

本快速入门将带您完成您的第一次 AiHummer 运行——从零开始到第一个在频道中回复的代理。它是为第一次执行此操作的人而编写的 第一次: 每一步都以……结束 你应该看到的，最后还有一个“如果不起作用”部分。

首先，选择你的道路

有两种方法可以获取 AiHummer（完整比较在 介绍):

  • 云 — 我们运行服务器，你获得一个现成的地址。无需安装。 → 去 路径 A：云.
  • 自托管（您自己的服务器） — 你在你的 Linux 服务器上安装 AiHummer 只需一个命令。→ 前往 路径 B：你自己的服务器.

然后两个路径汇聚到共同的步骤—— 第一代理 和 第一个频道.

路径 A：云

你需要的东西： 一个电子邮件地址、一个电话号码和一张银行卡（试用期间银行会扣除1卢布并立即退还）。

  1. 注册于 my.aihummer.ru输入您的电子邮件、电话 以及密码，接受两个同意。你将看到账户确认 屏幕。
  2. 通过电话确认账户（输入来电号码的最后几位）或 使用电子邮件中的代码。你会看到登录会自动完成 并且启动向导已打开。详情： 注册与登录.
  3. 在向导中选择 云 路径，然后一个 计划 （每月/每年）。 入境计划附带 10天免费试用. 详情： 计划.
  4. 填写你的 账单详情 （个人或公司/独资经营者）——他们 对于发票和行为是必需的。
  5. 选择一个 子域名 （你的地址将会是 <name>.cloud.aihummer.ru) 和 支付.你将看到“正在准备你的助手”状态及进度。 详情： 订单与支付.
  6. 等待配置（通常需要几分钟）。当状态变为 你的 助手正在运行，点击 打开面板 —— 您的网络管理界面 实例已打开。详情： 实例仪表板.

配置将在网络管理界面中继续 — 转到你的 第一代理云实例的管理员密码是在首次打开面板时设置的（这里不需要自托管中使用的单独密码文件）。

路径 B：你自己的服务器

你需要的东西： 一台 Linux 服务器（x86_64 或 arm64）, sudo 权限，以及 PostgreSQL（或让安装程序配置它）。完整列表： 要求.

步骤 1. 获取您的个人安装链接

没有公共安装脚本 — 链接是 个人的. 注册于 my.aihummer.ru，打开 安装 屏幕上点击“获取我的个人安装链接”。你将看到一个带有复制按钮的准备好命令。

第2步。使用一条命令安装

在服务器上运行复制的命令：

curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh

安装程序会检测架构，下载并 验证已签名的捆绑包，列出了安装根目录位于 ~/.aihummer 并在 systemd 下注册网关服务。你会看到安装步骤的日志，并且在最后看到服务已启动的消息。完整的细节（发布渠道、副车、无根安装）： 安装.

第3步。指向 PostgreSQL

唯一的硬性依赖是 PostgreSQL 与 pgcrypto 扩展。安装程序会为你连接；要手动设置数据库，请使用 AIHUMMER_DATABASE_URL 配置选项：

AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer?sslmode=disable
-- once, in the target database
CREATE EXTENSION IF NOT EXISTS pgcrypto;

数据库迁移在启动时自动应用。

步骤4. 首次登录

服务启动后，在服务器上打开管理员 Web 界面（私有端口） :8781 默认情况下):

http://localhost:8781/

在一个空数据库上的登录 admin 已创建并将初始密码写入 ~/.aihummer/etc/initial-admin-password.txt阅读它，登录，然后 立即更改密码并删除文件 ——一步一步地进入 首次登录.

步骤：创建你的第一个代理

此步骤适用于云端和自托管。在网页管理员界面中打开 代理人 → 创建，设置一个名称、一个角色（系统提示），并且可选地设置一个专用模型。你将会看到新代理作为列表中的一个方块。完整细节，包括角色和行为调节： 代理.

步骤：连接你的第一个频道

要让消息到达 AiHummer，请添加一个频道：

  • 电报 —— 最适合生产的连接器；端到端的完整演示 从 BotFather 到第一条消息 电报.
  • Web UI 中的会话 — 在连接之前测试代理的最快方式 外部通道。
  • 最大 —— 还有一个俄罗斯信使可用。

连接器安装在 插件/市场 屏幕，然后在上面配置 频道 屏幕，在哪里 绑定 阻止设置哪个代理运行该频道。向频道发送消息，并观察一个回合从头到尾的流程。

直接从管理界面对话代理

首次测试不需要通道：在 会话 页面上的“新会话”按钮会在管理界面内直接打开与代理的聊天。在创作器中，你可以 附加文件 （图像和文档——模型接收提取的文本），以及线程上方的两个切换按钮显示 每回合费用 和 工具输出 ——方便查看代理在每一步所做的操作。

[!TIP] 您也可以通过其兼容 OpenAI 的 API 直接调用 AiHummer，无需 完全没有渠道：

POST /v1/chat/completions
Content-Type: application/json

{"model": "default", "messages": [{"role": "user", "content": "Hello"}]}

设置 "stream": true 用于 SSE 流媒体。

记住模拟模型

在你连接真实模型之前，回复来自于一个 确定性模拟 —— 方便测试频道、路由和代理而无需模型成本。如何连接真实提供商（OpenAI、Anthropic、YandexGPT、通过 ChatGPT 订阅的 GigaChat、Codex 等）请参见 模型 页面。

[!NOTE] 真正的模型从不是强制性的：AiHummer 在免费/本地上运行 兼容 OpenAI 的端点以及 Codex/ChatGPT 订阅传输。

如果它不起作用

  • 安装命令失败 — 检查你是否在 Linux x86_64/arm64 上运行它，并且 个人链接没有过期（它有效 30 天；请获取一个新的链接在 “安装”屏幕）。诊断： 安装.
  • 管理界面无法打开 — Web UI 监听私有端口 :8781, 不是公众 :8780. 检查服务： systemctl status aihummer-gateway.
  • 找不到初始密码 ——它在 ~/.aihummer/etc/initial-admin-password.txt，不在日志中。查看 首次登录.
  • 云支付失败 — 仪表板上的订阅状态显示 原因；重试，或（对于公司）选择按发票付款，参见 订单与支付.
  • 代理不会在频道中回复 — 确保频道已绑定到一个 “Bindings” 块中的代理，并且发件人已被系统识别（通过 默认情况下，代理只回答已知用户的提问），参见 频道.

接下来去哪儿