aliyun-openclaw-setup

OpenClaw のセットアップ

Linux に OpenClaw をデプロイし、DingTalk、Feishu、Discord、またはドキュメントに記載されているほかのチャネルを有効にして、ゲートウェイの正常性を確認します。

このワークフローを使用する

次の手順を順番に実行します。

1. Linux のランタイムを準備し、OpenClaw をインストールします。
2. 公式ドキュメントからチャネルを確認します（新しいチャネルのリクエストでは必須です）。
3. チャネル連携をインストールして確認します。
4. ~/.openclaw/openclaw.json を作成またはマージします。
5. ゲートウェイサービスを設定して起動します。
6. ヘルスチェックを実行し、ログを収集します。

前提条件

• 対象の Linux ホストへの SSH アクセス（Debian／Ubuntu を推奨）。
• 公式コネクター用の DingTalk エンタープライズアプリの認証情報（AppKey、AppSecret）、または Feishu アプリの認証情報（App ID、App Secret）、または Discord ボットトークン。
• DashScope API キー。

手順 1：ランタイムを準備する

ssh root@<server>
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt-get install -y nodejs
node --version
npm --version

手順 2：OpenClaw とチャネル連携をインストールする

npm install -g openclaw@latest
openclaw --version

# DingTalk official connector
openclaw plugins install @dingtalk-real-ai/dingtalk-connector --pin
# or install from official GitHub repo
openclaw plugins install https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector.git
openclaw plugins list | grep dingtalk

# Feishu channel
openclaw plugins install @openclaw/feishu
openclaw plugins list | grep feishu

# Discord channel (built-in, no extra plugin needed)
# Configure token in Step 3 and start gateway in Step 4

古い DingTalk プラグインからアップグレードする場合は、まずレガシーなプラグイン ID をアンインストールし、公式コネクターのみを plugins.allow に残してください。

手順 3：公式ドキュメントから追加チャネルを自動検出する

現在のセットアップに含まれていないチャネルをユーザーから求められた場合は、まず次の手順を実行します。

1. https://docs.openclaw.ai/channels/index を開きます。
2. 「Supported channels」リストから、リクエストされたチャネルのページを特定します。
3. 各チャネルのページを開き、以下を確認します。
   • 組み込みか、プラグインベースか。
   • 正確なインストールコマンド（パッケージ名を推測しないでください）。
   • 必要な認証情報／トークンと設定キー。
4. ホストでインストール／設定を適用します。
5. チャネル固有のメモを ~/.openclaw/openclaw.json に記録します。

references/channel-discovery.md のワークフローをそのまま使用してください。

手順 4：openclaw.json を設定する

~/.openclaw/openclaw.json を作成または更新し、以下を設定します。

• DashScope エンドポイントとモデル用の models.providers.bailian。
• provider/model 形式の agents.defaults.model.primary。デフォルトは bailian/glm-5 です。
• 以下の順序で指定した models.providers.bailian.models。
  1. qwen3-plus
  2. glm-5
  3. minimax-m2.5
  4. kimi-k2.5
• 以下の順序で指定した agents.defaults.model.fallbacks。
  1. bailian/qwen3-plus
  2. bailian/minimax-m2.5
  3. bailian/kimi-k2.5
• channels.dingtalk-connector、channels.feishu、または channels.discord の認証情報とポリシー。
• インストール済みのチャネルプラグインを含む plugins.allow。

重要：

• ~/.openclaw/agents/main/agent/models.json のエージェントレベルのモデル設定は、~/.openclaw/openclaw.json の設定より優先される場合があります。
• デフォルト設定が適用されていないように見える場合は、両方のファイルでプロバイダー定義を一致させてください。
• プロトコルはエンドポイントに合わせる必要があります。
  • api: openai-completions -> https://dashscope.aliyuncs.com/compatible-mode/v1 を使用します。
  • api: openai-responses -> https://dashscope.aliyuncs.com/api/v2/apps/protocols/compatible-mode/v1 を使用します。

完全なテンプレートは references/config.md を使用してください。 DingTalk のフィールドマッピングは references/dingtalk-setup.md を使用してください。 Feishu のセットアップとフィールドマッピングは references/feishu-setup.md を使用してください。 Discord のセットアップとフィールドマッピングは references/discord-setup.md を使用してください。 チャネル検出のワークフローは references/channel-discovery.md を使用してください。

手順 5：ゲートウェイをインストールして起動する

openclaw gateway install
openclaw gateway start
openclaw gateway status

ユーザーレベルの systemd で実行している場合は、設定を変更した後に再読み込みします。

systemctl --user import-environment DASHSCOPE_API_KEY
systemctl --user daemon-reload
systemctl --user restart openclaw-gateway

Step 6: 検証とトラブルシューティング

openclaw doctor
openclaw gateway status
openclaw gateway logs -f

よくある問題：

• プラグインが読み込まれない：プラグインのインストールを再実行し、plugins.allow を確認します。
• モデルが不明：agents.defaults.model.primary の形式（provider/model-id）を確認します。
• API キーエラー：models.providers.bailian.apiKey と、systemd にインポートされた DASHSCOPE_API_KEY を確認します。
• 設定を変更しても実行時のモデルが変わらない：~/.openclaw/agents/main/agent/models.json を確認して更新します。
• ペイロードが空／予期しないフォールバック：プロトコルとエンドポイントの組み合わせ（openai-completions と openai-responses）を確認し、必要に応じて古いセッションをクリアします。
• DingTalk から応答がない：openclaw logs --follow を使用し、ストリームの再接続や認証情報の問題がないか、gateway/channels/dingtalk-connector の行を確認します。
• 公式コネクターをインストールしたのに古いプローブの結果に一貫性がない：実行時ログと実際のメッセージの送受信を信頼できる情報源として使用します。
• Feishu から応答がない：イベントのサブスクリプションモードが WebSocket であり、ゲートウェイが実行中であることを確認します。
• Discord から応答がない：ボットのインテント、トークン、最初の DM に対するペアリング承認を確認します。

セキュリティに関する注意事項

• リポジトリ内のファイルに実際のシークレットをハードコードしないでください。
• 本番環境のキーはサーバー上のローカル設定またはシークレットマネージャーに保管してください。
• チケットやチャットで共有する前に、ログから機密情報を削除してください。

検証

mkdir -p output/aliyun-openclaw-setup
echo "validation_placeholder" > output/aliyun-openclaw-setup/validate.txt

合格基準：コマンドが終了コード 0 で終了し、output/aliyun-openclaw-setup/validate.txt が生成されること。

出力と証跡

• 成果物、コマンド出力、API 応答の概要を output/aliyun-openclaw-setup/ に保存します。
• 再現性を確保するため、証跡ファイルに主要なパラメーター（リージョン／リソース ID／期間）を含めます。

ワークフロー

1. ユーザーの意図、リージョン、識別子、操作が読み取り専用か変更を伴うものかを確認します。
2. 接続と権限を確認するため、最初に最小限の読み取り専用クエリを 1 つ実行します。
3. 明示的なパラメーターと限定された範囲を指定して、対象の操作を実行します。
4. 結果を検証し、出力／証跡ファイルを保存します。