跳转到主要内容
GOWA 读取三个地点的配置:
  • 命令行标志 在 whatsapp rest (运行./whatsapp rest --help 以获取完整列表)。
  • 环境变量。
  • 在工作目录中**.env文件(src/.env从源运行时;复制 src/.env.example)。
.env文件只填充环境中尚未设置的变量。
在当前代码中,环境变量(包括 .env)会在解析标志之后应用,因此已设置的变量会覆盖对应标志。MCP OAuth 设置、--allow-unauthenticated、--trusted-origins、--chatwoot-webhook-allow-unsigned 和 --webhook-all-device-receipts 是例外,它们以显式指定的标志为准。每个选项只在一处设置。例如,WHATSAPP_WEBHOOK_INSECURE_SKIP_VERIFY=true 会覆盖 --webhook-insecure-skip-verify=false。
布尔值接受true/false。持续时间使用 Go 语法(30s, 5m, 3h). 列表值是用逗号分隔的。

命令

服务器

仪表板

MCP

请参阅MCP 服务器。

存储

聊天存储 (聊天、消息、schedules) 一直都在 storages/chatstorage.db 中生活,且不可配置。 使用 0600 权限创建 SQLite 会议、聊天存储和 OAuth 数据库。GOWA 为这些文件创建的目录使用 0700。 现有目录保留其权限。文件系统不支持的权限更改将被记录为警告。 对于 PostgreSQL 会话和密钥存储,当 sslmode 被省略或为空时,远程连接目标默认使用 verify-full。localhost、环回 IP 和 Unix 套接字默认使用 disable。显式 URI 设置、PGSSLMODE 和服务配置仍然有效。PGSERVICE 条目可以覆盖 URI 主机和 TLS 模式。使用托管 PostgreSQL 时,请显式提供 sslmode=verify-full 及所需的 CA 配置。

WhatsApp 行为

Webhooks

见 Webhooks。

Chatwoot

事件过滤器和单向吊销选项可在 GOWA main v9.9.0后使用 Chatwoot integration 查看行为和示例。

固定限制

这些是编译的,无法通过配置更改:

媒体URL下载

发送获取介质、文档或链接预览接受 HTTP 和 HTTPS URL的请求。 Public URL 获取拒绝循环、私有、链接、本地、元数据、多播和保留目的地。 重定向和实际拨号地址被选中。这些下载直接连接,不使用 HTTP_PROXY 或 HTTPS_PROXY。 GOWA可以从磁盘读取它自己的 /statics 网址。 Chatwoot 附件下载可以使用配置的Chatwoot 目标或允许主机,包括信任的内部主机通过集成。 此异常不适用于提交给发送 API 的任意URL。当源是私有时使用文件上传。

未使用

src/.env.example 列出了WHATSAPP_WEBHOOK_INCLUDE_OUTGOING 和 WHATSAPP_CHAT_STORAGE ,但当前的代码也没有读取。设置它们也没有效果。

示例

.env
等效标志: