Skip to content
AstrBot
Main Navigation 主页博客路线图HTTP API

简体中文

English

简体中文

English

切换日光/暗黑模式

简介和部署接入消息平台接入 AI使用开发
Sidebar Navigation

简介

关于 AstrBot

社区

常见问题

部署

包管理器部署

雨云一键云部署

桌面客户端部署

启动器一键部署

Docker 部署

Kubernetes 部署

宝塔面板部署

1Panel 部署

手动部署

其他部署方式

CasaOS 部署

优云智算 GPU 部署

社区提供的部署方式

支持我们

接入消息平台

快速接入指南

QQ 官方机器人

Websockets 方式(推荐)

Webhook 方式

OneBot v11

企微应用

企微智能机器人

微信公众号

飞书

钉钉

Telegram

LINE

Slack

Misskey

Discord

KOOK

Satori

接入 Satori

使用 server-satori

社区提供

Matrix

VoceChat

接入 AI

✨ 接入模型服务

NewAPI

AIHubMix

PPIO 派欧云

硅基流动

小马算力

302.AI

Ollama

LMStudio

⚙️ Agent 执行器

内置 Agent 执行器

Dify

扣子 Coze

阿里云百炼应用

DeerFlow

使用

WebUI

插件

内置指令

工具使用 Tools

技能 Skills

SubAgent 编排

主动型 Agent 能力

MCP

网页搜索

知识库

自定义规则

Agent 执行器

统一 Webhook 模式

自动上下文压缩

Agent 沙箱环境

开发

插件开发

🌠 从这里开始

最小实例

接收消息事件

发送消息

插件配置

调用 AI

存储

文转图

会话控制器

杂项

发布插件

插件指南(旧)

接入平台适配器

AstrBot HTTP API

AstrBot 配置文件

其他

自部署文转图

插件下载不了?试试自建 GitHub 加速服务

开源之夏

OSPP 2025

目录

管理面板 ​

AstrBot 管理面板具有管理插件、查看日志、可视化配置、查看统计信息等功能。

image

管理面板的访问 ​

当启动 AstrBot 之后,你可以通过浏览器访问 http://localhost:6185 来访问管理面板。

TIP

  • 如果你正在云服务器上部署 AstrBot,需要将 localhost 替换为你的服务器 IP 地址。

登录 ​

默认用户名和密码是 astrbot 和 astrbot。

可视化配置 ​

在管理面板中,你可以通过可视化配置来配置 AstrBot 的插件。点击左栏 配置 即可进入配置页面。

image

当修改完配置后,你需要点击右下角 保存 按钮才能成功保存配置。

使用右下角第一个圆形按钮可以切换至 代码编辑配置。在 代码编辑配置 中,你可以直接编辑配置文件。

编辑完后首先点击应用此配置,此时配置将应用到可视化配置中,然后再点击右下角保存按钮来保存配置。如果你不点击应用此配置,那么你的修改将不会生效。

alt text

插件 ​

在管理面板中,你可以通过左栏的 插件 来查看已安装的插件,以及安装新插件。

点击插件市场标签栏,你可以浏览由 AstrBot 官方上架的插件。

image

你也可以点击右下角 + 按钮,以 URL / 文件上传的方式手动安装插件。

由于插件更新机制,AstrBot Team 无法完全保证插件市场中插件的安全性,请您仔细甄别。因为插件原因造成损失的,AstrBot Team 不予负责。

插件加载失败处理 ​

如果插件加载失败,管理面板会显示错误信息,并提供 “尝试一键重载修复” 按钮。这允许你在修复环境(如安装缺失依赖)或修改代码后,无需重启整个程序即可快速重新加载插件。

指令管理 ​

通过左侧菜单 指令管理,可以集中管理所有已注册的指令,默认不显示系统插件。

支持按插件、类型(指令 / 指令组 / 子指令)、权限与状态过滤,配合搜索框快速定位。指令组行可展开查看子指令,徽章显示子指令数量,子指令行会缩进区分层级。

可以对每个指令 启用/禁用、重命名。

追踪 (Trace) ​

在管理面板的 Trace 页面中,你可以实时查看 AstrBot 的运行追踪记录。这对于调试模型调用路径、工具调用过程等非常有用。

你可以通过页面顶部的开关来启用或禁用追踪记录。

NOTE

当前仅记录部分 AstrBot 主 Agent 的模型调用路径,后续会不断完善。

更新管理面板 ​

在 AstrBot 启动时,会自动检查管理面板是否需要更新,如果需要,第一条日志(黄色)会进行提示。

使用 /dashboard_update 命令可以手动更新管理面板(管理员指令)。

管理面板文件在 data/dist 目录下。如果需要手动替换,请在 https://github.com/AstrBotDevs/AstrBot/releases/ 下载 dist.zip 然后解压到 data 目录下。

自定义 WebUI 端口 ​

修改 data/cmd_config.json 文件内 dashboard 配置中的 port。

忘记密码 ​

修改 data/cmd_config.json 文件内 dashboard 配置中的 password,将 password 整个键值对删除。

发现文档有问题?在 GitHub 上编辑此页

Last updated:

Pager
上一篇DeerFlow
下一篇插件

Deployed on Rainyun Logo