dsh-wechat-clawbot

📱 Usage

• Receiving — messages go into a dedicated WeChat conversation area (visible in the GUI sidebar, never mixed into your GUI chat); context is continuous and history is restored after a restart.
• Switching conversations — send /new, /新对话 or /新会话 in WeChat, or press "New conversation" in the floating-ball panel (the previous conversation is kept). Otherwise the current one is reused.
• ClawBot model — the panel's quick-pick lists models with configured keys; "custom" lets you type a provider/model, and you can choose a thinking effort (off/high/max). It applies only to WeChat turns and survives restarts; pick "follow DSH default" and save to clear it.
• New contacts — an empty allowlist allows everyone; strangers get an automatic notice and appear in the panel for approve/ignore.

⚙️ Configuration

$DSH_HOME/profiles//cordis.patch.yml (dsh plugin add writes this section; the full form):

- insert:
    - id: wechat-bot
      name: dsh-wechat-clawbot
      config:
        gatewayPort: 51235        # WeChat gateway port (default 51235)
        modelPort: 51236          # model-config endpoint port (default 51236)
        timeoutMs: 300000         # per-turn timeout
        maxMessageChars: 20000
        approval: reject          # in-turn approvals: auto-reject with a note (re-runnable in the GUI)
        keepalive: true           # built-in conversation-window keepalive (default true)
        keepaliveIntervalMinutes: 30   # how often to check the window
        keepaliveWarnHours: 2     # desktop reminder once per inbound when silence reaches N hours (0 = off)
        keepaliveNudgeHours: 0    # optional: nudge on WeChat while open & silent ≥ N hours (0 = off)
        keepaliveNotify: true     # desktop notification when the window closes (macOS)

Gateway environment variables (wechat-gateway/gateway.mjs): PORT (default 51235), STATE_DIR (default ~/.dsh-wechat), UNAPPROVED_REPLY, LOG_LEVEL (debug/info).

The host plugin's ports and state directory can also be overridden by environment variables (defaults unchanged): DSH_WECHAT_GATEWAY_PORT, DSH_WECHAT_MODEL_PORT, DSH_WECHAT_STATE_DIR. The portability verification relies on these three to avoid ports already taken by the live instance.