mirror of
https://github.com/kuaifan/dootask.git
synced 2026-07-31 10:25:59 +00:00
59 lines
2.2 KiB
Markdown
59 lines
2.2 KiB
Markdown
---
|
||
id: bot.create.howto
|
||
title: 创建用户机器人
|
||
type: howto
|
||
feature: bot
|
||
scope: end-user
|
||
locale: zh
|
||
aliases:
|
||
- 怎么建机器人
|
||
- 创建机器人
|
||
- 新建 bot
|
||
- 添加机器人
|
||
- 我要做个机器人
|
||
- 自建机器人
|
||
related_tools: []
|
||
related_pages: [application, messenger]
|
||
prerequisites: []
|
||
negative:
|
||
- 单个用户最多 50 个自建机器人，超出报「超过最大创建数量」
|
||
- 机器人名称必须 2-20 字符，太短/太长会被拒
|
||
- 创建后不能改「是否支持会话」开关，需重建
|
||
- 用户自建机器人不识别斜杠指令（`/help` 等只对系统机器人有效）
|
||
last_verified: v1.7.90
|
||
---
|
||
|
||
# 创建用户机器人
|
||
|
||
## 入口
|
||
- 桌面端：左侧栏「应用」→「我的机器人」卡片 → 右上角「添加机器人」
|
||
- 也可在「机器人管理」（`bot-manager@bot.system`）单聊里发 `/newbot 名称` 创建
|
||
|
||
## 操作步骤
|
||
1. 在「我的机器人」面板点「添加机器人」
|
||
2. 填写「机器人名称」（2-20 字符，必填）
|
||
3. 可选：上传头像（512×512 推荐）
|
||
4. 可选：设置「保留消息天数」`clear_day`（1-999，默认 90）
|
||
5. 可选：填写 `webhook_url`，并勾选要订阅的事件（message / dialog_open / member_join / member_leave）
|
||
6. 点「保存」，对应后端接口 `api/users/bot/edit`（`bot__edit`）
|
||
|
||
## 字段说明
|
||
| 字段 | 必填 | 说明 |
|
||
|---|---|---|
|
||
| name | 是 | 机器人昵称，2-20 字符 |
|
||
| avatar | 否 | 头像 URL；留空用默认 |
|
||
| session | 否 | 0/1，是否开启「新会话/历史会话」菜单；仅新建时生效 |
|
||
| clear_day | 否 | 消息保留天数 1-999，超期自动清理 |
|
||
| webhook_url | 否 | `http(s)://` 开头，≤ 255 字符 |
|
||
| webhook_events | 否 | 事件列表，详见 [[bot.webhook.concept]] |
|
||
|
||
## 创建之后
|
||
- 在「我的机器人」列表点「开始聊天」进入和机器人的单聊
|
||
- 把机器人邀请到群里：[[bot.invite.howto]]
|
||
- 拿 token：在「机器人管理」单聊发 `/token <bot_id>`，或 `/revoke` 重置
|
||
- 删除：列表里点「删除」（要求填删除备注，≤ 255 字符）
|
||
|
||
## 不支持
|
||
- 不能跨账号转让机器人
|
||
- 不能把已有的普通用户改成机器人，反之亦不能
|