astrbot搭建及简单使用教程

Sat, 18 Apr 2026 00:00:00 GMT

最近研究聊天机器人，看到astrbot，于是出个教程

在观看本教程之前，你需要准备 - 一颗聪明的头脑

一台运行astrbot的Linux设备
一个ssh工具[mobaxterm](MobaXterm free Xserver and tabbed SSH client for Windows)（可不用）
ai云服务厂商的api key 让我们开始吧：

第一步安装

uv方式

使用ssh工具连接部署设备

 curl -LsSf https://astral.sh/uv/install.sh | sh
 source $HOME/.local/bin/env

通过uv安装astrbot

 uv tool install astrbot --python 3.12
 astrbot init

启动astrbot

 astrbot run

在服务器安全组放行6185端口/在部署机防火墙放行6185端口
访问http://服务器ip:6185 打开webUI

docker方式

直接用docker就行了

 git clone https://github.com/AstrBotDevs/AstrBot 
 cd AstrBot
 sudo docker compose up -d

记得安全组和防火墙放行端口 在游览器访问http://服务器ip:6185

第二步配置消息平台

机器人 >> 创建机器人 >> 个人微信

注：不是个人的微信号，是指个人微信的openclaw接口

#最好创建一个独立的配置文件，让各个机器人之间隔离

直接保存，等待几秒后会出现扫描按钮
用最新版手机微信扫码

之后在聊天中的“微信openclaw”就是astrbot机器人了

第三步基础配置与模型提供商

模型提供商

在模型提供商中，可以设置使用的各个模型，例如DeepSeek chat

astrbot提供了很多提供商预设，但他们只是帮你把API Base URL填好了，让你不用在api文档中找，所以如果你想使用的提供商在其中没有，请自行在提供商的api文档中找到openai格式API Base URL与api key

在填写完API Base URL和api key之后，点击“保存并获取模型列表”
然后启用你想要用的模型

配置文件的基础配置

在”普通配置“页面中可以对配置文件进行编辑，可以找到更多功能

模型配置

可以指定ai使用的具体模型
在添加语音转述模型之后，可以在这里设置，让ai能够听懂和说语音
如果你的ai不是全态模型如DeepSeek，可以加个支持图片的模型转述让ai你看懂图片

人格

人格就是个ai的提示词每次聊天都会向ai发送。这个就任君发挥了

现在，让我们看向平台配置

白名单

默认开启白名单模式，只有白名单内的会话会被响应，在和ai聊天之前，需要将会话id加入白名单或关闭白名单模式注意是会话id不是用户id

插件

不过多介绍，astrbot拥有丰富的插件生态，可以自由去探索（对QQbot平台支持最多）

Simple Guides for Fuwari

Mon, 01 Apr 2024 00:00:00 GMT

Cover image source: Source

This blog template is built with Astro. For the things that are not mentioned in this guide, you may find the answers in the Astro Docs.

Front-matter of Posts

---
title: My First Blog Post
published: 2023-09-09
description: This is the first post of my new Astro blog.
image: ./cover.jpg
tags: [Foo, Bar]
category: Front-end
draft: false
---

Attribute	Description
`title`	The title of the post.
`published`	The date the post was published.
`description`	A short description of the post. Displayed on index page.
`image`	The cover image path of the post.<br/>1. Start with `http://` or `https://`: Use web image<br/>2. Start with `/`: For image in `public` dir<br/>3. With none of the prefixes: Relative to the markdown file
`tags`	The tags of the post.
`category`	The category of the post.
`draft`	If this post is still a draft, which won't be displayed.

Where to Place the Post Files

Your post files should be placed in src/content/posts/ directory. You can also create sub-directories to better organize your posts and assets.

src/content/posts/
├── post-1.md
└── post-2/
    ├── cover.png
    └── index.md

晓黎の小破站