waxgourd-addons/openclaw/DOCS.md

OpenClaw WG

✨ 核心能力

OpenClaw 将大模型能力无缝集成到主流即时通讯软件中，为您打造可靠、可扩展的对话式智能基础设施。

• 多渠道 Gateway 网关：通过单个 Gateway 网关进程连接 WhatsApp、Telegram、Discord 和 iMessage。
• 插件渠道：通过扩展包添加 Mattermost 等更多渠道。
• 多智能体路由：按智能体、工作区或发送者隔离会话。
• 媒体支持：发送和接收图片、音频、文档。
• Web 控制界面：浏览器仪表板，用于聊天、配置、会话和节点管理。
• 移动节点：配对 iOS 和 Android 节点，支持 Canvas。

📥 安装与使用

• 这是一个 Home Assistant Add-on，安装后即可在 Home Assistant 中运行 OpenClaw WG。
• 在 Home Assistant 中进入：设置 -> 应用 -> 安装应用，搜索 OpenClaw WG 并安装。
• 启动 OpenClaw WG，并打开网页界面。

安装完成后，请访问 http://<your-home-assistant-ip>:8099 进入管理后台。

⚙️ 配置

# 时区设置
timezone: "Asia/Shanghai"

# 网关绑定模式：loopback=仅本地，lan=局域网访问
gateway_bind_mode: "lan"

# 网关端口（默认 18789）
gateway_port: 18789

# 允许 HTTP 认证（仅在无法使用 HTTPS 时启用，存在安全风险）
allow_insecure_auth: true

# 网关公开 URL（用于在新标签页中打开网关 UI）
gateway_public_url: ""

# Home Assistant 长效令牌（用于 HA API 集成）
homeassistant_token: ""

# 启用 Web 终端（在 Home Assistant 内嵌的终端）
enable_terminal: true

# 清理会话锁（启动时/退出时）
clean_session_locks_on_start: true
clean_session_locks_on_exit: true

💬 聊天命令

可通过 WhatsApp / Telegram / Slack / Google Chat / Microsoft Teams / WebChat 发送以下命令（群组命令仅限所有者）：

• /status：显示紧凑会话状态（模型、Token，用时可显示成本）。
• /new 或 /reset：重置会话。
• /compact：压缩当前会话上下文（摘要）。
• /think <level>：off|minimal|low|medium|high|xhigh（仅限 GPT-5.2 + Codex 模型）。
• /verbose on|off：开启或关闭详细输出。
• /usage off|tokens|full：控制响应中的使用量信息页脚。
• /restart：重启网关（群组内仅限所有者）。
• /activation mention|always：切换群组激活模式。

📚 文档

• OpenClaw WG 文档