CLIツール
openclaw/wacli avatar
openclaw/wacli

wacli: README から見る構成と導入判断

WhatsApp CLI: 同期、検索、送信。ソース wacli からビルドするには Go 1.26.5 以降が必要で、go-sqlite3 を使用するため、cgo + C コンパイラが必要です。

スター 2,736フォーク 343GoMIT

ひと目でわかる

これは何?
WhatsApp をリンクデバイスとして同期し、ローカル SQLite の検索と送信を行う端末クライアントについて、README の機能、導入条件、運用上の確認点を整理します。
誰に向いている?
wacli はWhatsApp の履歴をローカルで検索し、許可された宛先への操作をスクリプトから限定的に呼びたい利用者に向く候補です。WhatsApp の履歴完全性やサービス規約を確認せずに業務データを預けたい運用には適しません。
商用利用できる?
できます。MIT は寛容なライセンスで、著作権表示とライセンス表示を残せば、使用・改変・販売が可能です。
今もメンテナンスされている?
されています。最後のコミットは 1 日前です。
何の言語で書かれている?
主に Go です(GitHub の言語統計による)。

回答はプロジェクトの GitHub データ(最終同期:2026年9月15日)と当サイトの分析に基づくもので、法的助言ではありません。

オープンソース詳細解説

リンクデバイスとローカル SQLite の二層

リンクデバイスとローカル SQLite の二層を確認する際は、README のどの記述が根拠かを記事内で追えるようにします。wacli の README は、WhatsApp をリンクデバイスとして同期し、ローカル SQLite の検索と送信を行う端末クライアントとして位置付けています。中心となるのはWhatsApp Web プロトコルのリンクデバイス、二つの SQLite ストア、検索・送信・チャット管理を端末へまとめる設計です。セッション用 DB と検索インデックスを分離し、検索はライブ接続なしでもローカルインデックスを読むと README は説明しています。履歴はベストエフォートです。 この説明は機能の範囲を示すもので、利用者の環境での性能や可用性を測った結果ではありません。

リンクデバイスとローカル SQLite の二層に関する実行結果は、説明と測定を分けて記録します。このプロジェクトが向くのはWhatsApp の履歴をローカルで検索し、許可された宛先への操作をスクリプトから限定的に呼びたい利用者です。逆にWhatsApp の履歴完全性やサービス規約を確認せずに業務データを預けたい運用には選定理由が不足します。まず最小構成で一つの成功条件を決め、失敗時にどのログと設定を見ればよいかを先に書きます。

auth から sync へ進むペアリング経路

auth から sync へ進むペアリング経路を確認する際は、README のどの記述が根拠かを記事内で追えるようにします。導入時には、入力、実行主体、保存先、外部へ出るデータを一つの試験記録に分けて残します。送信は相手方への変更を伴うため、--read-only または WACLI_READONLY=1 を読み取り統合の既定にします。sync --follow と書き込みのロック競合も確認します。 README にない既定値は断定せず、公式ガイドと実行時のログで確かめます。

auth から sync へ進むペアリング経路に関する実行結果は、説明と測定を分けて記録します。導入入口は次の通りです。macOS と Linux は brew install openclaw/tap/wacli、ソースビルドは Go 1.27.0 以上、cgo、C コンパイラを用意します。 版を固定し、依存関係と設定ファイルを保存してから実行します。

履歴検索と WhatsApp 接続を切り分ける

履歴検索と WhatsApp 接続を切り分けるを確認する際は、README のどの記述が根拠かを記事内で追えるようにします。wacli の README は、WhatsApp をリンクデバイスとして同期し、ローカル SQLite の検索と送信を行う端末クライアントとして位置付けています。中心となるのはWhatsApp Web プロトコルのリンクデバイス、二つの SQLite ストア、検索・送信・チャット管理を端末へまとめる設計です。セッション用 DB と検索インデックスを分離し、検索はライブ接続なしでもローカルインデックスを読むと README は説明しています。履歴はベストエフォートです。 この説明は機能の範囲を示すもので、利用者の環境での性能や可用性を測った結果ではありません。

履歴検索と WhatsApp 接続を切り分けるに関する実行結果は、説明と測定を分けて記録します。確認コマンドと観察点を具体化します。wacli auth で QR ペアリング後、wacli sync --follow、wacli messages search、wacli --read-only --json doctor を順に実行し、同期範囲と出力を確認します。 画面表示だけで合格にせず、終了コード、生成物、保存された状態、再実行の差分も照合します。

JSON、NDJSON、read-only の使い分け

JSON、NDJSON、read-only の使い分けを確認する際は、README のどの記述が根拠かを記事内で追えるようにします。導入時には、入力、実行主体、保存先、外部へ出るデータを一つの試験記録に分けて残します。送信は相手方への変更を伴うため、--read-only または WACLI_READONLY=1 を読み取り統合の既定にします。sync --follow と書き込みのロック競合も確認します。 README にない既定値は断定せず、公式ガイドと実行時のログで確かめます。

JSON、NDJSON、read-only の使い分けに関する実行結果は、説明と測定を分けて記録します。運用では権限と変更操作を分けます。送信は相手方への変更を伴うため、--read-only または WACLI_READONLY=1 を読み取り統合の既定にします。sync --follow と書き込みのロック競合も確認します。 認証情報はプロセス一覧やログへ出さず、テスト用データと本番データを分離します。

v0.17.1 と Go・cgo 要件を固定する

v0.17.1 と Go・cgo 要件を固定するを確認する際は、README のどの記述が根拠かを記事内で追えるようにします。wacli の README は、WhatsApp をリンクデバイスとして同期し、ローカル SQLite の検索と送信を行う端末クライアントとして位置付けています。中心となるのはWhatsApp Web プロトコルのリンクデバイス、二つの SQLite ストア、検索・送信・チャット管理を端末へまとめる設計です。セッション用 DB と検索インデックスを分離し、検索はライブ接続なしでもローカルインデックスを読むと README は説明しています。履歴はベストエフォートです。 この説明は機能の範囲を示すもので、利用者の環境での性能や可用性を測った結果ではありません。

v0.17.1 と Go・cgo 要件を固定するに関する実行結果は、説明と測定を分けて記録します。更新対象はv0.17.1です。リリースノートと README の版を揃え、同じ入力で旧版と新版を比較します。未確認の履歴 coverage の範囲、webhook の payload、WhatsApp 側の制限、メディア保存量とアカウント運用は採用条件として残します。

MIT と個人メッセージの保管範囲

MIT と個人メッセージの保管範囲を確認する際は、README のどの記述が根拠かを記事内で追えるようにします。導入時には、入力、実行主体、保存先、外部へ出るデータを一つの試験記録に分けて残します。送信は相手方への変更を伴うため、--read-only または WACLI_READONLY=1 を読み取り統合の既定にします。sync --follow と書き込みのロック競合も確認します。 README にない既定値は断定せず、公式ガイドと実行時のログで確かめます。

MIT と個人メッセージの保管範囲に関する実行結果は、説明と測定を分けて記録します。ライセンスはMITです。再配布条件は確認できますが、接続先サービス、モデル、機体、メッセージなど周辺資産の規約まで置き換えるものではありません。wacliを採用するなら、WhatsApp の履歴をローカルで検索し、許可された宛先への操作をスクリプトから限定的に呼びたい利用者に当てはまるかを先の試験で判断します。

編集部の結論

wacli はWhatsApp の履歴をローカルで検索し、許可された宛先への操作をスクリプトから限定的に呼びたい利用者に向く候補です。WhatsApp の履歴完全性やサービス規約を確認せずに業務データを預けたい運用には適しません。採用前にwacli auth で QR ペアリング後、wacli sync --follow、wacli messages search、wacli --read-only --json doctor を順に実行し、同期範囲と出力を確認します。を実行し、履歴 coverage の範囲、webhook の payload、WhatsApp 側の制限、メディア保存量とアカウント運用を公式資料と実環境で確認してください。README の説明と自分の測定結果を分けて記録し、未確認の条件を本番の前提にしない判断が必要です。

公式情報源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
コミュニティノート

コミュニティノート