Skip to content

和 Bot 协作 ​

快速开始 解决的是把 Bot 跑起来;这一页讲的是怎么用好它——什么任务适合交出去、请求怎么说、规则放在哪、什么时候该拆成两个 Bot——后半部分是配置参考:创建 Bot 和详情页每个 tab 的字段。

什么样的任务适合交给 Bot ​

同时满足三个条件的任务,交给 Bot 最合适:

  • 结果清楚。 你说得出做完之后应该存在什么——一份文件、一条消息、一张表。
  • 来源够得着。 涉及的文件、网站或对话是它真能访问到的:已上传进工作区、已接入的渠道或服务、或者是公开内容。
  • 产出好检查。 你一眼能看出结果对不对,复查的成本才低。

三条都满足,也还是从只读开始:先让它读和整理,检查几次产出,再逐步放权。使用场景 里的每个示例都是这么起步的。

把请求说清楚 ​

一个好的请求会回答五个问题——结果、来源、约束、形式、确认点。那张表在 快速开始;这里看两组实际对比。

含糊

帮我盯着科技新闻,有意思的发给我。

没有来源(哪些网站、哪些仓库?),没有送达时间,「有意思」还是一个替你做的主观判断。每期简报都在碰运气。

改成:

具体

每个工作日早上 8 点,汇总我关注的这几个仓库过去 24 小时的 release 和重要 issue,整理成一条简报发给我。每条信息注明来源,不确定的内容直接说不确定,不要编造。

含糊

把这个表格清理一下。

「清理」没有定义:哪些行算脏数据、原文件能不能动、最后要交回什么?Bot 动手之前得连猜三次。

改成:

具体

把我刚上传的 CSV 里 email 列为空的行全部删掉。给我清洗后的文件,并告诉我删了多少行。不要修改原文件。

两处改写的共同点:点名来源、限定动作、让结果一眼可验。

长期规则放哪 ​

两类指令,两个去处:

  • 长期规则 写进 Bot 详情页的指令里——角色、格式标准、常设约束。之后每一次会话都生效。
  • 一次性要求 写在消息里——今天这份文件、这周的例外。

一条纠正值得长期生效时,就把它升级:改写成持久规则,挪进指令,做法见 快速开始 第 7 步。整套流程反复出现时,存成 技能,一句话就能唤起;希望 Bot 自己记得的偏好,交给 长期记忆。

什么时候拆成多个 Bot ​

一个 Bot 负责一件事。职责单一的 Bot 积累的上下文会持续帮到它;什么都干的 Bot 会稀释自己的指令和记忆。快速开始 和 概览 都讲过这一点,这里只补一个实用判断:新需求的受众不同、来源不同,或者需要的权限不同,就该新建第二个 Bot。

每个 Bot 都有独立的工作区、记忆、渠道和权限边界,互相看不见对方。拆开也让权限更诚实——只读 release 动态的那个 Bot,永远不需要执行命令的权利。

审批习惯 ​

任务需要哪一级就给哪一级——工作区权限从聊天、读文件、写文件、执行命令到管理逐级授予,见 访问控制。

实际操作:

  1. 新流程从只读开始,写入和执行类工具调用留在审批后面。
  2. 检查过前几次运行,再考虑放宽。
  3. 会离开工作区的动作——给别人发消息、任何对外操作——即使流程已经很熟,也继续留在审批后面。

这和 使用场景 的检查清单是同一条路:多批几次请求,远比撤销一次写错便宜。


创建 ​

  1. 侧栏进入 Bots。
  2. 点 Create Bot。
  3. 基本信息:
    • Display Name:对外的名字
    • Avatar:头像 URL
    • Timezone:可空;不填则继承用户或系统时区
    • ACL Preset:如 allow_all(默认放行)、private_only(仅私聊)等快捷策略
  4. 创建。

详情页 ​

点卡片进 详情,各 tab 管不同事:

Tab内容
Overviewworkspace runtime、库、渠道、记忆等健康检查
General主模型/标题/生图、记忆/搜索/TTS 绑定、时区、语言、推理、危险区
DesktopWorkspace display runtime、有头浏览器、实时 display session
Workspace容器型 workspace 起停、快照、导入导出
NetworkWorkspace 网络与 overlay provider 状态/动作
Memory浏览、搜、建、改、压记忆
Platforms各消息渠道(Telegram、Discord、飞书等)
AccessACL 与默认通过/拒绝
Tool Approval需要人类确认的工具审批设置
Agents可为聊天 workspace 启用的 ACP 兼容编码智能体,如 Codex、Claude Code
Connectors经 Connect-It 连接的第三方服务(OAuth 或 API Key):状态、启停、重新授权、断开
Hooks保存在 /data/.memoh/hooks.json 的 Bot 自动化规则
MCP连接(Stdio/Remote/OAuth)
Compaction会话压缩设置与记录
Schedulecron 与日志
Skills技能 Markdown

Files、Terminal 以及桌面 / 浏览器面板在聊天的 workspace 区域里同样可用——想不离开对话就查看文件、跑 shell、盯着 Bot 的浏览器和桌面时,用聊天里的 workspace 侧栏。


核心先配什么 ​

  1. 打开 Bot General,先管模型与各类绑定。
  2. Schedule 管周期性自主任务。
  3. Compaction 管会话写不长时的压缩。
  4. Access 在 ACL 预设之后细调。

若这些资源还没有,先建好:


General 字段 ​

字段说明
Chat Model主对话模型
Title Model可选,生成会话标题
Image Generation Model可选,需带 image-output 的聊天模型
Memory Provider长期记忆后端;内置类型还可自带记忆/向量模型
Search Provider联网搜索用哪家
TTS Model来自 TTS 提供方流程,不在普通 chat 模型服务商里选
Timezone不填则用户时区再落到系统
LanguageBot 主用语
Reasoning Effort当前 chat 模型有 reasoning 时可用;可选值随模型而定(如 low / medium / high)

注意:

  • 生图模型 故意与主聊天模型分开,好单独换「更擅长出图」的。
  • TTS 用 TTS 提供方 所配置语音提供方的 speech 模型。
  • 所选聊天模型的 context_window 会影响会话状态展示和 会话压缩。

Compaction 相关(此处指「会话」) ​

这里说的是 当前会话 的上下文压短,不是改记忆条目的那种。

字段说明
Compaction Enabled是否自动在会话里压摘要
Compaction Threshold触发的估算 token 阈值
Compaction Ratio压多狠
Compaction Model可选,专门做摘要的模型

细节见 会话上下文压缩。


访问与 ACL ​

创建时先给一个 ACL 预设,之后在 Access 里微调。预设 给一版默认策略,Default Effect 管「没命中规则时」放行还是挡。

会话 与 Discuss 的默认行为在那一页。若你用 API/自动化,配置里还可能有 discuss_probe_model_id 等进阶项,日常创建不必先动。


Workspace 文件与终端 ​

Workspace 文件和终端在聊天 workspace UI 里使用;前提是该 Bot 有可用的 workspace runtime。这里可以:

  • 浏览、编辑 workspace 文件
  • 打开 workspace 内的终端会话
  • 在开启 display 后使用浏览器/桌面相关工具

文件流程见 文件,有头浏览器和桌面操作见 Browser / Computer Use。


删除 ​

General 最下 Danger Zone -> Delete Bot,会删掉该 Bot 相关数据(含 workspace 文件与记忆等),不可恢复。

Published under AGPLv3