配置
了解引擎路径、凭据以及本地配置边界。
大多数用户通过应用配置 MengBot。打包后的桌面端会在保存凭据前进行验证,并使用操作系统的安全存储保存受支持的密钥。
共享用户资料
打开 设置 → 通用 → 个人资料 → 关于我,保存你希望每个机器人都了解的信息,例如你的偏好、背景或工作时间。它会自动保存,并在服务器确认更新后显示 已保存。字段旁边的问号说明了该信息的共享范围。
该文本会被纳入后续私聊和群聊轮次的指令中,并跨模型提供商生效。现有机器人也会收到它;已在运行的轮次会保留其启动时的指令。清空该字段即可停止在后续提示中包含它。清空不会抹除对话历史中已存在的信息。
这是工作区范围的上下文,而不是针对单个机器人的私人备注。它存储在工作区配置中,并随机器人请求发送给模型提供商。密钥请使用凭据设置。该字段最多接受 24,000 个字符。
引擎发现
MengBot 会检查继承的进程路径、常见安装位置以及登录 shell。如果引擎安装在非常规位置,请打开 设置 → 引擎 并显式选择其可执行文件。
显式路径在以下情况下很有用:
- 你保留了多个 CLI 版本;
- 你使用包装脚本;
- 你将引擎安装在桌面应用无法发现的目录中;或
- 你从 Windows 快捷方式或 Linux 应用菜单启动 MengBot,其环境与终端不同。
可选凭据
| 凭据 | 启用功能 |
|---|---|
| Composio 项目密钥 | 已连接应用和 OAuth 会话 |
| Boat API 密钥 | 托管 Linux 计算机 |
| ElevenLabs API 密钥 | 语音回复和语音模式 |
| Fish Audio API 密钥 | 使用 Fish Audio 语音的语音回复和语音模式 |
| Chatterbox 服务器地址 | 无需云端密钥的语音回复和语音模式 |
| OpenCode API 密钥 | 现有 OpenCode 提供商登录的可选替代方案 |
本地智能体聊天无需这些凭据即可工作。
环境配置
源码运行和无头运行可以在启动 harness 之前设置受支持的环境变量。对于正常的打包使用,应用级设置更可取,因为它们会验证输入并避免密钥值进入渲染进程。
按实例配置 Claude 工具范围
源码安装和无头安装可以在 ~/.mengbot/config.json 中为不同的 Claude 实例设置不同的内置工具集:
{
"instances": {
"claude-browser": {
"driver": "claudeAgent",
"config": {
"tools": ["Read", "WebFetch", "WebSearch"],
"disallowedTools": ["Bash(git *)", "Edit", "Write"]
}
}
}
}tools 选择 Claude 可用的内置工具;显式空数组会禁用所有内置工具,而省略它则保留 Claude 的默认工具集。disallowedTools 将 Claude 工具名称模式作为额外的拒绝列表应用。这些设置不会授予或预先批准 MCP 集成,MCP 集成仍由实例挂载的集成和 MengBot 权限流程控制。
Claude Code 隔离
使用 Claude 引擎的机器人只能看到其所有者提供给它的内容:应用 → MCP 服务器 下的 MCP 服务器、其集成(计算机、浏览器、智能体、手机)以及其自身项目的 .mcp.json。它不会加载本机的 Claude Code 设置——即你的用户级或本地 Claude 配置中的 MCP 服务器和 claude.ai 连接器、你的技能和智能体、你的钩子,或你的个人 ~/.claude/CLAUDE.md。将那些内容加载到每个机器人的每个轮次中,曾使一台实测桌面端每次模型调用多出约 407 个工具和 10k token。
在 MengBot 进程上设置 OMB_CLAUDE_INHERIT_USER_CONFIG=1 会再次关闭该隔离,对所有 Claude 机器人生效,直到移除该变量。它的存在是为了恢复一个确实依赖用户级服务器的机器人,而且很容易忘记:聊天中看起来没有任何不同,只有 token 用量会变化。设置该变量期间,设置 → 引擎 会在 Claude 引擎上显示警告,服务器会在启动时记录一行日志。受支持的修复方法是在 设置 → MCP 服务器 下或机器人项目的 .mcp.json 中添加机器人所需的服务器,然后取消设置该变量并重启。
ACP 会话复用
每个 ACP 引擎(Antigravity、Grok、Gemini CLI、Kimi、Droid、Cursor、OpenCode、Qwen、Hermes、自定义 ACP CLI)都会为每个对话线程保持一个智能体进程存活,并在多个轮次间复用它,因此 ACP 握手——对于 Antigravity 这类重型运行时可能需要数十秒——每个线程只需支付一次,而不是每条消息支付一次。进程在静默 10 分钟后关闭,在生成契约发生变化(不同的模型标志、工作目录或审批级别)、崩溃或应用关闭时会更早关闭;下一轮随后会在新进程上恢复记录的会话。集成凭据每轮都会轮换,因此后续轮次会在同一进程上通过线路(session/load)重新建立原生会话——握手仍然只需支付一次。
如果智能体拒绝为其自身进程中已活跃的会话执行 session/load,该轮次会恰好获得一个替换进程:MengBot 关闭池中的子进程,启动一个新进程,再次支付握手,并在那里恢复记录的会话。对话绝不会被换成空白的 session/new;一次性握手成本是保持连续性的代价。只有当会话在替换进程上也加载失败时,该轮次才会启动一个真正的新会话。
在 MengBot 进程上设置 OMB_ACP_SESSION_IDLE_MS=600000 可以更改该静默超时,OMB_ACP_SESSION_IDLE_MIN_MS 会提高该值被钳制到的下限(默认 10000)。较小的空闲超时可以节省繁忙机器上的内存,代价是需要再次支付握手;默认值与 Claude 引擎的池一致。
不要将密钥放入提示中
提示会变成对话历史,并可能被发送给智能体提供商。请使用应用设置或环境配置来管理凭据。