网关配置

适用范围

当你需要:改端口、改绑定地址、开关某些渠道特性、调整默认安全策略——都离不开网关配置。

这里先给出“可验证、可落地”的最小路径;更复杂的分层配置(include/merge)后续会单独整理。

配置文件在哪里

常见默认路径:

  • ~/.moltbot/moltbot.json(或同目录下的等价配置文件)

修改配置的推荐方式

  1. 先改最小项(避免一次改太多)
  2. 修改后立刻做一次健康检查
  3. 必要时再逐步加功能

修改后建议验证:

moltbot status
moltbot health

最小可用配置(示例)

下面示例用于建立一个清晰的“起点”:指定工作目录,并限制允许的来源(按你的实际渠道/号码调整)。

{
  "agents": { "defaults": { "workspace": "~/clawd" } },
  "channels": { "whatsapp": { "allowFrom": ["+15555550123"] } }
}

端口与控制台

常见控制台地址:

  • 本机:http://127.0.0.1:18789/

如果你启用了 token,控制台需要携带/填写 token 才能连接。

常见排障

  • 改完配置后网关不响应:先看网关是否已重启生效,再看日志输出
  • 控制台连接失败:确认端口、绑定地址、以及 token 是否一致

进一步阅读

  • 网关概览:/docs/gateway/
  • 快速开始:/docs/start/getting-started/