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 ライセンスで配布、コミュニティの貢献を歓迎します。

前提条件

  1. DockerDocker‑Compose(v1+)。
  2. AI プロバイダー API キー(OpenAI、Gemini、Claude など)。
  3. (オプション)使用予定の対象 IM プラットフォームの認証情報。

ステップ–バイ–ステップのインストール

  1. リポジトリをクローンwgetdocker‑compose.yml を直接取得することも可能):

    git clone https://github.com/justlovemaki/OpenClaw-Docker-CN-IM.git
    cd OpenClaw-Docker-CN-IM
    

  2. 環境変数テンプレートをコピー し、環境に合わせて編集:

    cp .env.example .env
    nano .env
    
    最低限、AI モデルを設定:
    MODEL_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
    

  3. IM 認証情報を追加 (オプション。マルチプラットフォームサポートを狙うなら推奨)。例: Feishu:

    FEISHU_APP_ID=your-app-id
    FEISHU_APP_SECRET=your-app-secret
    
    必要に応じて DingTalk、QQ、WeCom を繰り返し追加。

  4. スタックを起動:

    docker compose up -d
    
    初回実行時に .env から ~/.openclaw/openclaw.json が生成されます。

  5. ゲートウェイを確認:

    docker compose logs -f
    
    OpenClaw が起動してゲートウェイポート(デフォルト 18789)でリッスンしているのが確認できるはずです。ブラウザで http://<your-host>:18789 にアクセスし、接続をテストしてください。

AI クライアントの設定

OpenClaw は OpenAIClaude プロトコルスタイルをサポートします。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 や課題の提出でコミュニティへの貢献をぜひお願いします!

この記事を共有