OpenClaw & Moltbook FAQ

OpenClaw は、複数のメッセージングプラットフォーム（WhatsApp、Telegram、Discord など）に独自の AI アシスタントをデプロイできるオープンソースの AI アシスタントフレームワークです。 Moltbook は、OpenClaw ユーザーが自己ホスティングなしで既存のインスタンスに参加できるコミュニティ主導の共有サービスです。 適している人：開発者、技術愛好家、プライベート AI アシスタントを必要とするチーム、AI インタラクションを自分でコントロールしたい人。

Desktop（GUI）は初心者におすすめです - ビジュアル設定、リアルタイムログ、ワンクリック操作を提供します。 CLI が適している場合： • サーバーデプロイメント • 自動化とスクリプティング • リソースが限られた環境 • ターミナルワークフローを好む開発者 両バージョンとも同じコア機能を共有しています。

最小成功チェックリスト： 1. OpenClaw がインストールされ実行中（ヘルスステータスを確認） 2. 少なくとも1つのモデル API キーを設定（OpenAI、Anthropic など） 3. 1つのメッセージングチャンネルを接続（初心者には Telegram を推奨） 4. テストメッセージを送信して応答を受信 Desktop 版では通常 5-10 分で完了します。

必須： • 少なくとも1つの AI モデル API キー（OpenAI、Anthropic、Google など） チャンネル連携用（少なくとも1つ）： • WhatsApp：WhatsApp がインストールされた携帯電話のみ • Telegram：@BotFather でボットを作成 • Discord：Discord Developer Portal でアプリケーションを作成 オプション： • 拡張機能用の Web 検索 API キー

1つのチャンネルから始めるメリット： • 基本を正しく理解することに集中できる • メッセージフローを明確に理解できる • 問題のデバッグが容易 • 複雑さを追加する前に自信をつける 慣れたら、チャンネルの追加は簡単です。

インストール後、以下を確認してください： 1. `openclaw health` または `openclaw status`（CLI）を実行、または Desktop でヘルスステータスを確認 2. すべてのサービスに緑のチェックマークが表示されていることを確認 3. ゲートウェイにアクセスできることを確認（デフォルト：http://127.0.0.1:18789） 4. ログにエラーメッセージがないか確認 すべてのチェックが通れば、チャンネルを設定する準備ができています。

起動問題 Top 5： 1. ポートが使用中（他のアプリが 18789 を使用） 2. API キーが見つからないか無効 3. 権限不足（管理者として実行してみてください） 4. ファイアウォールが接続をブロック 5. 依存関係が古い（Node.js v22+ が必要） まずログを確認してください - 通常、正確な問題を指摘しています。

解決策： 1. 競合するプロセスを見つけて停止： • Mac/Linux: `lsof -i :18789` で確認後 `kill [PID]` • Windows (WSL): `lsof -i :18789` で確認後 `kill [PID]` 2. または OpenClaw のポートを変更： • 起動時に `openclaw gateway --port 18790` を使用 • または onboard 時に `--gateway-port 18790` を指定

以下の手順を順番に試してください： 1. ログを確認：`openclaw logs --follow` でエラーメッセージを確認 2. 再設定：`openclaw configure` を実行して設定をリセット 3. 再インストール：`npm install -g openclaw@latest` 4. リリースノートで破壊的変更を確認 5. それでも失敗する場合は、ログと共に GitHub Issues で報告

OpenClaw は主に `~/.openclaw/openclaw.json` 設定ファイルで管理されています。 一般的な問題： 1. 設定変更後にサービスを再起動していない 2. 間違った設定ファイルパスを使用 3. JSON 構文エラー（カンマや引用符の欠落） 4. 環境変数は onboard 時にパラメータで渡す必要がある 設定を確認：`openclaw status` を実行してアクティブな設定を確認。

レストランに例えると： • モデル = シェフ（応答を生成する AI） • チャンネル = 入口（WhatsApp、Telegram など） • ゲートウェイ = フロント（リクエストを受信してルーティング） • スキル = 特別な能力（Web 検索、コード実行など） 少なくとも1つのモデルと1つのチャンネルが必要です。ゲートウェイは自動的に実行されます。スキルはオプションの拡張機能です。

最も簡単な方法は、インタラクティブ設定ウィザードを実行することです： ``` $ openclaw onboard ``` ウィザードが案内する内容： • AI モデルプロバイダーの選択（Anthropic/OpenAI など） • API キーの入力 • ゲートウェイサービスのインストールと起動 設定完了後、`openclaw channels login telegram` でチャンネルを接続。 デフォルトのゲートウェイは 127.0.0.1:18789 にバインド（ローカルアクセスのみ - 安全）。

Desktop で：設定 → スキル → トグルで切り替え CLI で： • 利用可能なスキルを表示：`openclaw skills list` • スキルをインストール：`openclaw skills install [skill-name]` • スキルを有効化：`openclaw skills enable [skill-name]` 安全のヒント： • 不要なスキルを無効に • 有効にする前にスキルの権限を確認 • 新しいスキルはまず安全な環境でテスト • コードを実行できるスキルもある - 慎重に有効化

モデルの切り替え： 1. `openclaw onboard` を再度実行して新しいプロバイダーで再設定 2. または `~/.openclaw/openclaw.json` の agents.defaults.model 設定を編集 3. サービスを再起動：`openclaw gateway status` で確認 新しいモデルが失敗した場合： • `openclaw models status` を実行してモデル接続を確認 • プロバイダーのウェブサイトで API キーの有効性を確認 • モデル名のスペルを確認（例：`anthropic/claude-opus-4-5`） • アカウントのレート制限やクォータを確認

セキュリティチェックリスト： ✓ デフォルトでゲートウェイを localhost（127.0.0.1）に維持 ✓ ポートを公開インターネットに直接公開しない ✓ リモートアクセスが必要な場合は使用： • VPN または SSH トンネル • 認証付きリバースプロキシ • Cloudflare Tunnel ✓ 利用可能な場合は認証を有効に ✓ 本番環境では HTTPS を使用

以下の修正を試してください： 1. 携帯電話とコンピューターが同じネットワーク上にあることを確認 2. QR コードを更新（すぐに期限切れになります） 3. 携帯電話の WhatsApp を最新バージョンに更新 4. Web インターフェースを使用している場合はブラウザキャッシュをクリア 5. 明るい環境でスキャンを試す 6. VPN を一時的に無効に それでも失敗する場合は、電話リンクコード方式を試してください。

セッションの問題は通常以下が原因です： 1. 携帯電話がオフラインまたはスリープ状態 2. 携帯電話で WhatsApp からログアウト 3. 別のデバイスで WhatsApp Web を使用 4. ネットワークの不安定さ 解決策： • 携帯電話を安定した WiFi に接続 • WhatsApp のバッテリー最適化を無効に • 他の場所で WhatsApp Web を開かない • WhatsApp アプリの更新を確認

グループの動作は通常意図的なものです： • 設定でグループ返信が有効になっているか確認 • ボットはグループで応答するために @メンションが必要な場合がある • 安全のため、デフォルト設定でグループメッセージが無効になっている可能性 有効にする方法： • Desktop 設定でグループ返信を有効に • または `openclaw pairing` でグループ権限を管理 • まず小さなグループでテストして正常に動作することを確認

Telegram ボットはデフォルトでプライバシーモードが有効です： 1. @BotFather を開く 2. /mybots を送信 3. ボットを選択 4. Bot Settings → Group Privacy → Turn OFF または、ボットをグループ管理者にする - 管理者はプライバシーモードに関係なくすべてのメッセージを見ることができます。

簡単な手順： 1. Telegram を開き、@BotFather を検索 2. /newbot を送信 3. 名前を選択（表示名） 4. ユーザー名を選択（'bot' で終わる必要があります） 5. 提供された API トークンをコピー 6. トークンを OpenClaw 設定に追加 オプション：/setcommands を使用してコマンドヒントを追加。

通常は intents の問題です： 1. Discord Developer Portal に移動 2. アプリケーション → Bot を選択 3. これらの Privileged Intents を有効に： • MESSAGE CONTENT INTENT • SERVER MEMBERS INTENT（必要な場合） 4. 保存してボットを再起動 また確認：ボットがチャンネルでメッセージ読み取り権限を持っているか。

必須の intents： • Guilds - 基本的なサーバー情報 • Guild Messages - メッセージを受信 • Message Content - メッセージテキストを読み取り（特権） オプション： • Guild Members - ユーザー情報（特権） • Direct Messages - DM サポート 注意：特権 intents は 100 以上のサーバーにいるボットには認証が必要です。

最小 Bot Token Scopes： • chat:write - メッセージ送信 • app_mentions:read - @メンションに応答 • channels:history - チャンネルメッセージを読み取り • im:history - DM メッセージを読み取り Event Subscriptions： • message.channels • message.im • app_mention 最小限から始めて、必要に応じて追加してください。

401 は認証失敗を意味します。確認事項： 1. API キーが正しいか（余分なスペースなし） 2. キーが期限切れまたは取り消されていないか 3. キーに必要な権限/スコープがあるか 4. レート制限に達していないか 5. アカウントに十分なクレジット/クォータがあるか まずプロバイダーの API で直接キーをテストしてください。

ステップバイステップで診断： 1. モデルを直接テスト（curl/Postman）- 遅い場合はモデルの問題 2. インターネット速度とレイテンシを確認 3. 別のモデルを試す（GPT-3.5 は GPT-4 より速い） 4. プロバイダーのステータスページで障害を確認 解決策： • タイムアウト設定を増やす • 長い応答にはストリーミングを使用 • 別のモデルプロバイダーを試す

ログで以下のパターンを確認： • 'FATAL' または 'PANIC' - 重大なエラー • 'OOM' - メモリ不足 • 'ECONNREFUSED' - 依存関係に接続できない • スタックトレース - コードエラー 一般的な解決策： • メモリ割り当てを増やす • 設定エラーを修正 • 最新バージョンに更新 • 外部サービスの可用性を確認

設定のトラブルシューティング： 1. ゲートウェイを再起動しましたか？（ほとんどの変更には必要） 2. JSON ファイルの構文は正しいですか？（カンマ、引用符を確認） 3. 正しい設定ファイルですか？（`~/.openclaw/openclaw.json` である必要があります） 4. ゲートウェイは実行中ですか？（`openclaw gateway status`） 設定を確認： • `openclaw status` - 全体的なステータスを確認 • `openclaw models status` - モデル接続を確認 • `openclaw health` - ヘルスチェック

ログの場所： • Desktop：表示 → ログ（または設定 → ログフォルダを開く） • CLI：`~/.openclaw/logs/` または標準出力 • Docker：`docker logs [コンテナ名]` 重要なエラーキーワード： • ERROR, FATAL, PANIC - 重大な問題 • timeout, ETIMEDOUT - 接続の問題 • 401, 403, 429 - 認証/レート制限の問題 • ENOENT - ファイル/パスが見つからない

レポートに含めるべき内容： 1. OpenClaw バージョン（`openclaw --version`） 2. OS とバージョン 3. 再現手順 4. 予期した動作 vs 実際の動作 5. 関連するログ（機密情報を削除！） 6. 設定スニペット（API キーを削除！） 提出先：GitHub Issues ページ セキュリティ問題：セキュリティ担当者に直接メール

公開のリスク： • 誰でも AI にリクエストを送信できる • API キーが抽出される可能性 • 悪用の可能性（スパム、違法コンテンツ） • 不正使用によるコスト爆発 • ボットの行動に対する法的責任 安全なリモートアクセスオプション： • VPN（推奨） • SSH トンネル • Cloudflare Tunnel • 認証付きリバースプロキシ

安全チェックリスト： 1. 公式/検証済みのソースからですか？ 2. 利用可能な場合はソースコードを確認 3. 他のユーザーからのレビュー/問題を読む 4. 要求する権限を理解する 5. まず隔離された環境でテスト 危険信号： • 不必要な権限を要求 • 難読化/圧縮されたコード • ソースコードが利用不可 • コミュニティのフィードバックがない

即座に対応： 1. 今すぐプロバイダーのウェブサイトでキーを取り消す 2. 新しいキーを生成 3. すべての設定を新しいキーで更新 4. 使用履歴で不正なコールを確認 5. どのように漏洩したか確認（git 履歴？公開リポジトリ？） 予防策： • キーを git にコミットしない • .env ファイルを使用（gitignore に追加） • 本番環境ではシークレット管理を使用

安全なデフォルト： • ゲートウェイを localhost のみにバインド（127.0.0.1） • デフォルトでスキルを無効に • 最初はグループメッセージを無効に • レート制限を有効に • ロギングを有効に（監査用） • チャンネルボットに最小限の権限 覚えておいてください：制限的から始めて、必要に応じて緩める。