- 命令行标志 在
whatsapp rest(运行./whatsapp rest --help以获取完整列表)。 - 环境变量。
- 在工作目录中**
.env文件(src/.env从源运行时;复制src/.env.example)。
.env文件只填充环境中尚未设置的变量。
布尔值接受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
