MengBotDocs
入门

配置

了解引擎路径、凭据以及本地配置边界。

大多数用户通过应用配置 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 引擎的池一致。

不要将密钥放入提示中

提示会变成对话历史,并可能被发送给智能体提供商。请使用应用设置或环境配置来管理凭据。

On this page