和 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,永远不需要执行命令的权利。
审批习惯
任务需要哪一级就给哪一级——工作区权限从聊天、读文件、写文件、执行命令到管理逐级授予,见 访问控制。
实际操作:
- 新流程从只读开始,写入和执行类工具调用留在审批后面。
- 检查过前几次运行,再考虑放宽。
- 会离开工作区的动作——给别人发消息、任何对外操作——即使流程已经很熟,也继续留在审批后面。
这和 使用场景 的检查清单是同一条路:多批几次请求,远比撤销一次写错便宜。
创建
- 侧栏进入 Bots。
- 点 Create Bot。
- 基本信息:
- Display Name:对外的名字
- Avatar:头像 URL
- Timezone:可空;不填则继承用户或系统时区
- ACL Preset:如
allow_all(默认放行)、private_only(仅私聊)等快捷策略
- 创建。
详情页
点卡片进 详情,各 tab 管不同事:
| Tab | 内容 |
|---|---|
| Overview | workspace runtime、库、渠道、记忆等健康检查 |
| General | 主模型/标题/生图、记忆/搜索/TTS 绑定、时区、语言、推理、危险区 |
| Desktop | Workspace display runtime、有头浏览器、实时 display session |
| Workspace | 容器型 workspace 起停、快照、导入导出 |
| Network | Workspace 网络与 overlay provider 状态/动作 |
| Memory | 浏览、搜、建、改、压记忆 |
| Platforms | 各消息渠道(Telegram、Discord、飞书等) |
| Access | ACL 与默认通过/拒绝 |
| 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 | 会话压缩设置与记录 |
| Schedule | cron 与日志 |
| Skills | 技能 Markdown |
Files、Terminal 以及桌面 / 浏览器面板在聊天的 workspace 区域里同样可用——想不离开对话就查看文件、跑 shell、盯着 Bot 的浏览器和桌面时,用聊天里的 workspace 侧栏。
核心先配什么
- 打开 Bot General,先管模型与各类绑定。
- Schedule 管周期性自主任务。
- Compaction 管会话写不长时的压缩。
- Access 在 ACL 预设之后细调。
若这些资源还没有,先建好:
General 字段
| 字段 | 说明 |
|---|---|
| Chat Model | 主对话模型 |
| Title Model | 可选,生成会话标题 |
| Image Generation Model | 可选,需带 image-output 的聊天模型 |
| Memory Provider | 长期记忆后端;内置类型还可自带记忆/向量模型 |
| Search Provider | 联网搜索用哪家 |
| TTS Model | 来自 TTS 提供方流程,不在普通 chat 模型服务商里选 |
| Timezone | 不填则用户时区再落到系统 |
| Language | Bot 主用语 |
| 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 文件与记忆等),不可恢复。