【OpenClaw】Discord連携で必ずハマる「3つの壁」と解決コマンド一覧(無反応・実行承認)

AI/個人開発

【結論】Discord連携でハマる「3つの壁」と解決コマンド一覧

OpenClawをDiscordに繋いだ直後、ほぼ確実にぶつかるトラブルとその解決策をまとめた。
結論から言うと、以下のコマンドで大半は解決する。

① オンラインなのに無反応(サイレント切断)
systemctl --user restart openclaw-gateway

② サーバーのチャンネルでメンションしても無視される
openclaw config set channels.discord.guilds '{"サーバーID": {"requireMention": true}}' --json

③ ファイル操作が「Approval required」で止まる
openclaw config set tools.exec.security '"full"' --json および ask '"off"'

以下、それぞれの症状と詳しい解決手順を解説する。

壁①:突然ボットが無反応になった(サイレント切断)

Discord上では「オンライン」の緑マークがついているのに、話しかけても既読スルーされる状態。これはWebSocketの通信が裏で切れてしまっている「サイレント切断」と呼ばれる現象だ。OpenClawのステータスチェック(status --all)は「トークンが設定されているか」を見ているだけで、「今この瞬間に通信できているか」までは見ていないため、画面上はOKに見えるトラップにハマる。

解決策:Gatewayの再起動

静かにGatewayを再起動するだけで直る。頻繁に切れる場合は、cronを使って毎日深夜帯に自動再起動するようにしておくと楽だ。

$ systemctl --user restart openclaw-gateway

壁②:DMでは話せるのに、サーバー(チャンネル)で無視される

botを自サーバーに招待して、チャンネル上で @ボット名 こんにちは
とメンションしても全く反応しないケース。これは、OpenClawのデフォルト設定が「指定されたサーバー(Guild)でしか動かない」仕様になっているためだ。

解決策:サーバーIDをconfigに登録

Discord側で「開発者モード」をONにし、自分のサーバーアイコンを右クリックしてサーバーIDをコピーする。(※チャンネルIDではないので注意)

# サーバーIDを追加(requireMention: true でメンション必須にする)
$ openclaw config set channels.discord.guilds '{"あなたのサーバーID": {"requireMention": true}}' --json

# セキュリティのため、自分のユーザーIDのみに応答するよう制限(推奨)
$ openclaw config set channels.discord.allowFrom '["あなたのユーザーID"]' --json

# 設定反映のため再起動
$ systemctl --user restart openclaw-gateway

壁③:「Approval required」でファイル操作が止まる

ボットとの会話はできるようになったが、cat > file.md などのファイル書き込みや git push などを指示すると、「Approval
required(承認が必要です)」
と言われてフリーズしてしまう問題。

この時、TUI画面の ~/.openclaw/exec-approvals.json にコマンドを許可リストとして追加しても解決しなかった

解決策:openclaw.json のツール制限を解除する

外部(Discord経由)からのコマンド実行権限は、大元の openclaw.json 側で厳格にロックされている。これを以下のコマンドでフルアクセスに変更する。

# execツール自体のサンドボックス制限を解除し、フルアクセスを許可
$ openclaw config set tools.exec.security '"full"' --json

# コマンド実行前の確認プロンプト(Approval required)を無効化
$ openclaw config set tools.exec.ask '"off"' --json

# 設定反映のため再起動
$ systemctl --user restart openclaw-gateway

注意:これはAIにOSの全権限を渡す危険な設定だ。自分が構築したラズパイ上のローカル環境であり、かつ前述の「自分のユーザーIDのみに制限(allowFrom)」を行っているからこそ許容できる荒技だ。外部公開サーバーでは絶対にやってはいけない。

※2026年2月時点。OpenClaw 2026.2.26 (bc50708) 環境で検証。

コメント

タイトルとURLをコピーしました