OpenClaw Docker CN-IM:中国IM AIゲートウェイをデプロイ
OpenClaw Docker CN-IM: 中国IM AIゲートウェイをデプロイ
中国の主要メッセージングサービス(Feishu、DingTalk、QQ、WeCom)で会話するAIアシスタントを構築している場合、堅牢でモジュラブルなバックエンドが必要です。OpenClaw‑Docker‑CN‑IMはまさにそれを提供します:AIゲートウェイ、主要プラットフォームのプラグイン、AIコード支援をオプションで備えたワンクリックのDockerイメージです。
なぜ OpenClaw‑CN‑IM?
- 設定不要、Docker駆動:イメージをプルし、
docker-compose up -dを実行するとほぼ準備完了。 - ワンインストールで全プラグイン:Feishu、DingTalk、QQ、WeCom が事前インストールされ、自動で有効化されます。
- AIファースト:環境変数1つで、OpenAI/Claude 互換モデルを自由に切り替え可能。
- 永続ストレージ:設定とワークスペースは Docker ボリュームに保存され、再起動時にデータが失われることはありません。
- オープンソース:GPL‑3.0 ライセンスで配布、コミュニティの貢献を歓迎します。
前提条件
- Docker と Docker‑Compose(v1+)。
- AI プロバイダー API キー(OpenAI、Gemini、Claude など)。
- (オプション)使用予定の対象 IM プラットフォームの認証情報。
ステップ–バイ–ステップのインストール
-
リポジトリをクローン(
wgetでdocker‑compose.ymlを直接取得することも可能):git clone https://github.com/justlovemaki/OpenClaw-Docker-CN-IM.git cd OpenClaw-Docker-CN-IM -
環境変数テンプレートをコピー し、環境に合わせて編集:
最低限、AI モデルを設定:cp .env.example .env nano .envMODEL_ID=gemini-3-flash-preview BASE_URL=https://api.gemini.google/v1 API_KEY=sk-… API_PROTOCOL=openai-completions CONTEXT_WINDOW=1000000 MAX_TOKENS=8192 -
IM 認証情報を追加 (オプション。マルチプラットフォームサポートを狙うなら推奨)。例: Feishu:
必要に応じて DingTalk、QQ、WeCom を繰り返し追加。FEISHU_APP_ID=your-app-id FEISHU_APP_SECRET=your-app-secret -
スタックを起動:
初回実行時にdocker compose up -d.envから~/.openclaw/openclaw.jsonが生成されます。 -
ゲートウェイを確認:
OpenClaw が起動してゲートウェイポート(デフォルト 18789)でリッスンしているのが確認できるはずです。ブラウザでdocker compose logs -fhttp://<your-host>:18789にアクセスし、接続をテストしてください。
AI クライアントの設定
OpenClaw は OpenAI と Claude プロトコルスタイルをサポートします。Gemini を使う場合は OpenAI プロトコルを選択。
API_PROTOCOL=openai-completions
BASE_URL=https://api.gemini.google/v1
Claude の場合:
API_PROTOCOL=anthropic-messages
BASE_URL=http://localhost:3000
API_KEY フィールドは単に AI ベンダーへ転送されます。必要であればローカル AIClient-2-API サービスを設定し、外部コールをゼロにできます。
データ永続化
Docker ボリュームで公開される主なフォルダは次のとおりです。
/home/node/.openclaw– 設定とプラグインデータ。/home/node/.openclaw/workspace– OpenCode AI やその他サービス用ワークスペース。
全部をリセットしたい場合はホストボリュームを削除し、再起動:
docker compose down -v
トラブルシューティングのヒント
| 問題 | 予想される原因 | 対処 |
|---|---|---|
docker-compose logs で「permission denied」が表示 |
ボリュームのパーミッション不一致 | コンテナ内の node ユーザーがホストフォルダを所有しているか、または --user フラグを使用 |
| Feishu にメッセージが届かない | IM 認証情報が不足している、またはイベント購読が設定されていない | FEISHU_APP_ID/SECRET を再確認し、Feishu のアプリダッシュボードで im.message.receive_v1 を有効化 |
| AI API 呼び出しで 401 エラー | API_KEY が間違っている、またはスコープが足りない |
キーを検証し、プロバイダーが選択したモデルを許可しているか確認 |
| ゲートウェイポートの競合 | ポート 18789/18790 が既に使用中 | 環境変数 OPENCLAW_GATEWAY_PORT / OPENCLAW_BRIDGE_PORT を変更 |
基本を超えて
- AIClient‑2‑API:ローカル API アグリゲーターを稼働させ、AI キーをインターネットに露出させない。
- Playwright 統合:組み込みの Playwright ツールを使ってブラウザ操作を自動化し、より豊富な AI 機能を追加。
- TTS:音声対応ボット向けに中国語音声合成を有効化。
- カスタムプラグイン:Node‑JS パッケージを
/plugins以下に置き、openclaw.jsonを更新すると新しいチャネルを追加可能。
おわりに
OpenClaw‑Docker‑CN‑IM は、複雑なマルチプラットフォーム AI ゲートウェイをワンライナーの docker-compose コマンドで実現します。Feishu ワークスペースに AI を追加する趣味家であれ、横断的アシスタントをデプロイする小規模ビジネスであれ、このソリューションは導入ハードルを劇的に下げます。
デプロイを楽しみつつ、GitHub リポジトリへの PR や課題の提出でコミュニティへの貢献をぜひお願いします!