Signal (signal-cli)¶

Status: external na integrasyon ng CLI. 30. Nakikipag-usap ang Gateway sa signal-cli sa pamamagitan ng HTTP JSON-RPC + SSE.

Mabilis na setup (baguhan)¶

Gumamit ng hiwalay na Signal number para sa bot (inirerekomenda).
I-install ang signal-cli (kailangan ang Java).
I-link ang bot device at simulan ang daemon: - signal-cli link -n "OpenClaw"
I-configure ang OpenClaw at simulan ang gateway.

Minimal na config:

{
  channels: {
    signal: {
      enabled: true,
      account: "+15551234567",
      cliPath: "signal-cli",
      dmPolicy: "pairing",
      allowFrom: ["+15557654321"],
    },
  },
}

Ano ito¶

Signal channel sa pamamagitan ng signal-cli (hindi embedded libsignal).
Deterministic routing: ang mga reply ay laging bumabalik sa Signal.
Ang mga DM ay nagbabahagi ng pangunahing session ng agent; ang mga group ay hiwalay (agent:<agentId>:signal:group:<groupId>).

Mga pagsusulat sa config¶

Bilang default, pinapayagan ang Signal na magsulat ng mga update sa config na na-trigger ng /config set|unset (kailangan ang commands.config: true).

I-disable gamit ang:

{
  channels: { signal: { configWrites: false } },
}

Ang modelo ng numero (mahalaga)¶

Kumokonekta ang gateway sa isang Signal device (ang signal-cli account).
Kung patatakbuhin mo ang bot sa iyong personal na Signal account, i-ignore nito ang sarili mong mga mensahe (proteksyon laban sa loop).
Para sa “nag-text ako sa bot at nagre-reply ito,” gumamit ng hiwalay na bot number.

Setup (mabilis na ruta)¶

I-install ang signal-cli (kailangan ang Java).
I-link ang isang bot account: - signal-cli link -n "OpenClaw" pagkatapos ay i-scan ang QR sa Signal.
I-configure ang Signal at simulan ang gateway.

Halimbawa:

{
  channels: {
    signal: {
      enabled: true,
      account: "+15551234567",
      cliPath: "signal-cli",
      dmPolicy: "pairing",
      allowFrom: ["+15557654321"],
    },
  },
}

Suporta sa maraming account: gamitin ang channels.signal.accounts na may per-account config at opsyonal na name. 32. Tingnan ang gateway/configuration para sa shared na pattern.

External daemon mode (httpUrl)¶

Kung gusto mong ikaw ang mag-manage ng signal-cli (mabagal na JVM cold starts, container init, o shared CPUs), patakbuhin ang daemon nang hiwalay at ituro ang OpenClaw dito:

{
  channels: {
    signal: {
      httpUrl: "http://127.0.0.1:8080",
      autoStart: false,
    },
  },
}

Nilalampasan nito ang auto-spawn at ang startup wait sa loob ng OpenClaw. Para sa mabagal na pagsisimula kapag auto-spawning, itakda ang channels.signal.startupTimeoutMs.

Kontrol sa access (DMs + groups)¶

DMs:

Default: channels.signal.dmPolicy = "pairing".
Ang mga hindi kilalang sender ay tumatanggap ng pairing code; ini-ignore ang mga mensahe hanggang maaprubahan (mag-e-expire ang mga code pagkalipas ng 1 oras).
Aprubahan sa pamamagitan ng:
openclaw pairing list signal
openclaw pairing approve signal <CODE>
Ang pairing ang default na palitan ng token para sa mga Signal DM. Mga detalye: Pairing
Ang mga UUID-only sender (mula sa sourceUuid) ay ini-store bilang uuid:<id> sa channels.signal.allowFrom.

Groups:

channels.signal.groupPolicy = open | allowlist | disabled.
Kinokontrol ng channels.signal.groupAllowFrom kung sino ang puwedeng mag-trigger sa groups kapag naka-set ang allowlist.

Paano ito gumagana (behavior)¶

Tumatakbo ang signal-cli bilang daemon; binabasa ng gateway ang mga event sa pamamagitan ng SSE.
Ang mga papasok na mensahe ay ni-no-normalize sa shared channel envelope.
Ang mga reply ay laging niruruta pabalik sa parehong numero o group.

Media + mga limitasyon¶

Ang outbound text ay hina-hati hanggang channels.signal.textChunkLimit (default 4000).
Opsyonal na newline chunking: itakda ang channels.signal.chunkMode="newline" para hatiin sa mga blank line (mga hangganan ng talata) bago ang length chunking.
Suportado ang mga attachment (base64 na kinukuha mula sa signal-cli).
Default na media cap: channels.signal.mediaMaxMb (default 8).
Gamitin ang channels.signal.ignoreAttachments para laktawan ang pag-download ng media.
1. Ang konteksto ng group history ay gumagamit ng channels.signal.historyLimit (o channels.signal.accounts.*.historyLimit), at babalik sa messages.groupChat.historyLimit. Itakda sa 0 para i-disable (default 50).

Typing + read receipts¶

Typing indicators: Nagpapadala ang OpenClaw ng typing signals sa pamamagitan ng signal-cli sendTyping at nire-refresh ang mga ito habang tumatakbo ang reply.
Read receipts: kapag true ang channels.signal.sendReadReceipts, ipinapasa ng OpenClaw ang read receipts para sa mga pinapayagang DM.
Hindi inilalantad ng signal-cli ang read receipts para sa groups.

Reactions (message tool)¶

Gamitin ang message action=react kasama ang channel=signal.
Mga target: sender E.164 o UUID (gamitin ang uuid:<id> mula sa pairing output; puwede rin ang bare UUID).
Ang messageId ay ang Signal timestamp para sa mensaheng nirereact-an.
Nangangailangan ang group reactions ng targetAuthor o targetAuthorUuid.

Mga halimbawa:

message action=react channel=signal target=uuid:123e4567-e89b-12d3-a456-426614174000 messageId=1737630212345 emoji=🔥
message action=react channel=signal target=+15551234567 messageId=1737630212345 emoji=🔥 remove=true
message action=react channel=signal target=signal:group:<groupId> targetAuthor=uuid:<sender-uuid> messageId=1737630212345 emoji=✅

Config:

channels.signal.actions.reactions: i-enable/i-disable ang reaction actions (default true).
channels.signal.reactionLevel: off | ack | minimal | extensive.
Ang off/ack ay nagdi-disable ng agent reactions (mag-e-error ang message tool na react).
Ang minimal/extensive ay nag-e-enable ng agent reactions at nagse-set ng guidance level.
Mga override kada account: channels.signal.accounts.<id>40. .actions.reactions, channels.signal.accounts.<id>.reactionLevel.

Mga delivery target (CLI/cron)¶

DMs: signal:+15551234567 (o plain E.164).
UUID DMs: uuid:<id> (o bare UUID).
Groups: signal:group:<groupId>.
Mga username: username:<name> (kung suportado ng iyong Signal account).

Pag-troubleshoot¶

Patakbuhin muna ang ladder na ito:

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

Pagkatapos, kumpirmahin ang DM pairing state kung kailangan:

openclaw pairing list signal

Mga karaniwang failure:

Maaabot ang daemon pero walang reply: i-verify ang mga setting ng account/daemon (httpUrl, account) at receive mode.
Ini-ignore ang mga DM: pending ang pairing approval ng sender.
Ini-ignore ang mga group message: hinaharangan ng group sender/mention gating ang delivery.

Para sa triage flow: /channels/troubleshooting.

Reference ng configuration (Signal)¶

Buong configuration: Configuration

Mga opsyon ng provider:

channels.signal.enabled: i-enable/i-disable ang channel startup.
channels.signal.account: E.164 para sa bot account.
channels.signal.cliPath: path papunta sa signal-cli.
channels.signal.httpUrl: buong daemon URL (inu-override ang host/port).
channels.signal.httpHost, channels.signal.httpPort: daemon bind (default 127.0.0.1:8080).
channels.signal.autoStart: auto-spawn ng daemon (default true kung hindi naka-set ang httpUrl).
channels.signal.startupTimeoutMs: startup wait timeout sa ms (cap 120000).
channels.signal.receiveMode: on-start | manual.
channels.signal.ignoreAttachments: laktawan ang pag-download ng attachment.
channels.signal.ignoreStories: i-ignore ang stories mula sa daemon.
channels.signal.sendReadReceipts: ipasa ang read receipts.
channels.signal.dmPolicy: pairing | allowlist | open | disabled (default: pairing).
1. channels.signal.allowFrom: DM allowlist (E.164 o uuid:<id>). open ay nangangailangan ng "*". 44. Walang username ang Signal; gumamit ng phone/UUID ids.
channels.signal.groupPolicy: open | allowlist | disabled (default: allowlist).
channels.signal.groupAllowFrom: group sender allowlist.
channels.signal.historyLimit: max na bilang ng group messages na isasama bilang context (0 ay nagdi-disable).
1. channels.signal.dmHistoryLimit: DM history limit sa bilang ng user turns. Mga override kada user: channels.signal.dms["<phone_or_uuid>"].historyLimit.
channels.signal.textChunkLimit: outbound chunk size (chars).
channels.signal.chunkMode: length (default) o newline para hatiin sa mga blank line (mga hangganan ng talata) bago ang length chunking.
channels.signal.mediaMaxMb: inbound/outbound media cap (MB).

Mga kaugnay na global option:

agents.list[].groupChat.mentionPatterns (hindi sinusuportahan ng Signal ang native mentions).
messages.groupChat.mentionPatterns (global fallback).
messages.responsePrefix.

Overview

Messaging platforms

Configuration

Signal