openclaw-complete-deployment-guide

OpenClaw を Alibaba Cloud にデプロイする完全ガイド

Alibaba Cloud Bailian のモデル設定、Feishu／DingTalk（従来型ボット＋DEAP 高度な構成）／QQ／Discord の各プラットフォームとの連携、Qoder CLI の統合、高度な設定と運用を網羅しています。

---

⚠️ セキュリティ警告

開始する前に、以下の注意事項を必ずお読みください。

1. 個人のメインコンピューターには OpenClaw を絶対にデプロイしないでください——ファイルシステムとコマンドの実行に対する高い権限を持っています
2. 必ずクラウドサーバー（Alibaba Cloud ECS など）を使用してデプロイし、ローカル環境から隔離してください
3. API キーを安全に保管してください——環境変数または安全な保管庫を使用し、コードに直接埋め込まないでください
4. Gateway へのアクセスを制限するため、強力なランダムトークンを使用してください。単純なパスワードは避けてください
5. 認証情報を定期的にローテーションしてください——特に DingTalk／Feishu／QQ などのプラットフォームのアプリケーションキー

---

使用シーン

• Alibaba Cloud ECS サーバーに OpenClaw AI アシスタントをゼロからデプロイする
• DingTalk（Stream ボットまたは DEAP の高度な構成）を通じて AI と会話する
• Feishu、QQ、または Discord を通じて OpenClaw を接続する
• Alibaba Cloud Bailian Coding Plan を AI 推論バックエンドとして設定する
• Qoder CLI を ACP Agent として登録し、DingTalk／Feishu でコード開発を行う

例

# 安装 OpenClaw
curl -fsSL https://clawd.bot/install.sh | bash

# 启动 Gateway
openclaw gateway --port 18789 --verbose

# 交互式配置模型和渠道
openclaw onboard

# 查看所有渠道状态
openclaw channel list

# 查看实时日志
tail -f /tmp/openclaw-gateway.log

注意事項

• ローカルのメインコンピューターには絶対にデプロイせず、必ずクラウドサーバー（Alibaba Cloud ECS など）を使用してください
• DingTalk アプリケーションでは「バージョンの公開」手順を完了する必要があります。設定を保存するだけでは有効になりません
• DingTalk Client Secret、Bailian API Key、QQ ボットのキーはすべて一度しか表示されないため、すぐに保存してください
• Feishu との連携では「WebSocket 長時間接続」モードを選択し、HTTP コールバックは使用しないでください
• DingTalk DEAP 構成では、同じサーバー上で Connector を実行し、18789 ポートにローカルからアクセスできることを確認してください
• Gateway には、ランダムで強力なトークン認証を設定することをおすすめします（openssl rand -hex 24）

---

概要

このガイドでは、OpenClaw をクラウドに完全にデプロイし、複数の IM プラットフォームを通じて AI アシスタントと会話できるようにします。また、オプションで Qoder CLI を接続してコード開発を行うこともできます。

全体のアーキテクチャ：

┌────────────────────────────────────────────────────────────┐
│                         用户层                              │
│  ┌────────┐  ┌────────┐  ┌──────┐  ┌─────────┐           │
│  │  飞书  │  │  钉钉  │  │  QQ  │  │ Discord │           │
│  └───┬────┘  └───┬────┘  └──┬───┘  └────┬────┘           │
└──────┼───────────┼──────────┼───────────┼─────────────────┘
       │           │          │           │
       └───────────┴──────────┴───────────┘
                              │
                     Stream / WebSocket
                              │
┌─────────────────────────────▼──────────────────────────────┐
│                   OpenClaw Gateway :18789                   │
│  ┌──────────────────────────────────────────────────────┐  │
│  │  ACP 协议层                                           │  │
│  │  ┌──────────┐  ┌──────────┐  ┌──────────┐           │  │
│  │  │  acpx    │  │  调度器  │  │  会话管理 │           │  │
│  │  └──────────┘  └──────────┘  └──────────┘           │  │
│  └──────────────────────────────────────────────────────┘  │
│  ┌──────────────────────────────────────────────────────┐  │
│  │  渠道连接器层（飞书 / 钉钉 / QQ / Discord）           │  │
│  └──────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────┘
                              │
                    阿里云百炼 API / Qoder CLI

デプロイ手順の概要：

1. Alibaba Cloud ECS サーバーを購入して設定する
2. Node.js と OpenClaw をインストールする
3. Alibaba Cloud Bailian モデル（Coding Plan）を設定する
4. Gateway の外部アクセスと認証を設定する
5. ACP プロトコルのサポートを設定する
6. Qoder CLI をインストールして設定する（オプション）
7. IM プラットフォーム（Feishu／DingTalk／QQ／Discord）を接続する

---

前提条件

必要なアカウントと権限

• Alibaba Cloud アカウント
• Alibaba Cloud Bailian アカウント（モデル API 用）
• 対象の IM プラットフォームの開発者／管理者アカウント

必要なソフトウェア（ローカル）

• SSH クライアント
• 最新のブラウザー（各プラットフォームの開発者コンソールへのアクセス用）

---

第 1 段階：Alibaba Cloud サーバーの購入と設定

1.1 推奨サーバー構成

構成項目	最低要件	推奨構成
CPU	2 コア	2 コア
メモリ	2 GiB	4 GiB
ディスク	20 GB SSD	40 GB ESSD
帯域幅	1 Mbps	20 Mbps 以上
オペレーティングシステム	Ubuntu 22.04／CentOS 8	Alibaba Cloud Linux 3
リージョン	任意	米国バージニア／中国香港（AI サービスへのアクセス遅延が小さい）

1.2 購入方法

方法 1：Compute Nest で迅速にデプロイする（初心者におすすめ）

Alibaba Cloud Compute Nest にアクセスし、事前設定済みの環境をワンクリックでデプロイします。

🔗 Alibaba Cloud Compute Nest - OpenClaw のクイックデプロイ

画面の案内に従って、リージョンの選択 → インスタンスタイプの選択 → ネットワークとセキュリティグループの設定 → 作成の確認を行います。

方法 2：ECS インスタンスを手動で購入する

1. Alibaba Cloud ECS コンソールにアクセスします
2. 「インスタンスを作成」をクリックします
3. 重要なオプション：
   • イメージ：Alibaba Cloud Linux 3／Ubuntu 22.04（OpenClaw アプリケーションイメージがある場合は、直接選択できます）
   • インスタンスタイプ：ecs.c7.large（2 コア、4 GiB）以上
   • システムディスク：40 GB ESSD
   • パブリック IP：パブリック IPv4 を割り当てます
   • 帯域幅：使用トラフィックに応じた課金、または固定帯域幅（1 Mbps 以上）
4. セキュリティグループを設定します（下記を参照）
5. ログイン認証情報を設定します（キーペアを推奨）
6. 内容を確認して作成します

1.3 セキュリティグループルールの設定

ポート	プロトコル	用途	許可する接続元
22	TCP	SSH リモート接続	自分の IP アドレス
18789	TCP	OpenClaw Gateway	0.0.0.0/0

設定手順：

1. ECS コンソール → インスタンスを見つける → 「セキュリティグループ」をクリックします
2. 「ルールの設定」→「インバウンドルール」→ 上記のルールを手動で追加します

1.4 サーバーへの接続

# 使用密码登录
ssh root@<你的服务器公网IP>

# 使用密钥登录
ssh -i /path/to/your-key.pem root@<你的服务器公网IP>

# 或通过阿里云控制台网页终端：
# ECS 控制台 → 实例详情 → 远程连接

---

第 2 段階：Node.js と OpenClaw のインストール

2.1 Node.js のインストール（nvm を推奨）

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc

# 安装 Node.js 22 LTS
nvm install 22
nvm use 22
node -v  # 验证：应输出 v22.x.x

2.2 OpenClaw のインストール

方法 1：公式インストールスクリプトを使用する（推奨）

curl -fsSL https://clawd.bot/install.sh | bash

方法 2：npm でグローバルインストールする

npm install -g openclaw

インストールの確認：

openclaw --version
# 预期输出：版本号如 "2026.1.x"
# 若提示命令不存在，尝试旧名称：clawdbot --version

2.3 OpenClaw Gateway の起動

# 方式一：前台启动（调试用）
openclaw gateway --port 18789 --verbose

# 方式二：后台启动
nohup setsid openclaw gateway --port 18789 --verbose > /tmp/openclaw-gateway.log 2>&1 &

# 检查状态
systemctl --user status openclaw-gateway.service
# 或
openclaw gateway status

---

第 3 段階：Alibaba Cloud Bailian モデル（Coding Plan）の設定

3.1 Coding Plan プランの購入

プラン	初月の価格	2 か月目以降の価格	月間リクエスト数
Lite ベーシック版	7.9 元	40 元／月	18,000 回
Pro 上級版	39.9 元	200 元／月	90,000 回

1. Alibaba Cloud Bailian コンソールにアクセスします
2. 「Coding Plan」または「サブスクリプションプラン」に移動します
3. Lite または Pro を選択し、支払いを完了します

3.2 API 認証情報の取得

• Base URL（固定）：https://coding.dashscope.aliyuncs.com/v1
• API Key の形式：sk-sp-xxxxx

取得手順：

1. Alibaba Cloud Bailian コンソールにログインします
2. 「キー管理」または「API Keys」を開きます
3. 「API Key を作成」をクリックします
4. すぐにコピーして保存してください——画面を閉じると再表示できません

サポートされているモデル：

• qwen3.5-plus - 汎用用途（初めての方におすすめ）
• qwen3-max-2026-01-23 - 高度な推論
• kimi-k2.5 - コード生成（利用可能な場合）
• glm-5 - 中国語向けに最適化

3.3 Bailian を使用するための OpenClaw の設定

方法 1：対話形式のセットアップ

openclaw onboard

プロンプトに従って操作します。

1. 「カスタムモデルプロバイダーを追加」を選択します
2. プロバイダー ID：bailian
3. Base URL：https://coding.dashscope.aliyuncs.com/v1
4. API Key：sk-sp-xxxxx を貼り付けます
5. API タイプ：openai-completions
6. モデルを追加：qwen3.5-plus
7. デフォルトモデルに設定します

方法 2：設定ファイルを手動で編集する

~/.openclaw/openclaw.json を編集します。

{
  "models": {
    "providers": {
      "bailian": {
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "apiKey": "sk-sp-YOUR_KEY_HERE",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-plus",
            "name": "Qwen 3.5 Plus",
            "reasoning": true,
            "input": ["text"],
            "contextWindow": 32000,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3.5-plus"
      }
    }
  }
}

---

第 4 段階：Gateway の外部アクセスと認証の設定

DingTalk DEAP などの外部サービスから Gateway にアクセスする場合は、認証と HTTP エンドポイントを設定する必要があります。

4.1 強力な認証トークンの生成

openssl rand -hex 24
# 示例输出：a3f7c2e1d4b5a6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3

4.2 Gateway 設定の更新

~/.openclaw/openclaw.json を編集し、gateway セクションを追加します。

{
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "controlUI": {
      "allowInsecureAuth": false
    },
    "auth": {
      "mode": "token",
      "token": "在此处填入上一步生成的强令牌"
    },
    "http": {
      "endpoints": {
        "chatCompletions": {
          "enabled": true
        }
      }
    }
  }
}

4.3 Gateway の再起動

openclaw gateway restart

# 或手动重启：
pkill -f "openclaw gateway"
nohup setsid openclaw gateway --port 18789 --verbose > /tmp/openclaw-gateway.log 2>&1 &

4.4 Gateway が正常に動作していることの確認

curl http://127.0.0.1:18789/health
# 应返回 {"status":"ok"} 或类似响应

---

第 5 段階：ACP プロトコルのサポート設定

ACP（Agent Client Protocol）プロトコルを使用すると、OpenClaw で複数の AI Agent をオーケストレーションできます。

5.1 安装并启用 ACPX 插件

# 安装 ACPX 插件
openclaw plugins install @openclaw/acpx

# 启用插件
openclaw config set plugins.entries.acpx.enabled true

5.2 配置 ACP 参数

# 启用 ACP
openclaw config set acp.enabled true

# 启用 ACP 调度
openclaw config set acp.dispatch.enabled true

# 设置后端为 acpx
openclaw config set acp.backend "acpx"

# 设置默认 Agent
openclaw config set acp.defaultAgent "openclaw"

# 设置允许的 Agents
openclaw config set acp.allowedAgents '["openclaw","claude","codex","opencode","gemini"]'

# 设置最大并发会话数
openclaw config set acp.maxConcurrentSessions 8

5.3 重启 Gateway 使配置生效

openclaw gateway restart

5.4 验证 ACP 配置

openclaw config get acp --raw
# 应输出：
# {
#   "enabled": true,
#   "dispatch": { "enabled": true },
#   "backend": "acpx",
#   "defaultAgent": "openclaw",
#   "allowedAgents": [...]
# }

---

第六阶段：安装并配置 Qoder CLI（可选）

如果你希望通过 Qoder 进行代码开发，可安装 Qoder CLI 并将其注册为 ACP Agent。

6.1 安装 Qoder CLI

npm install -g @qoder-ai/qodercli

# 验证安装
qodercli --version

6.2 配置 Qoder CLI 认证

方式一：环境变量（临时）

export QODER_PERSONAL_ACCESS_TOKEN="your-api-key-here"
qodercli status  # 验证登录

方式二：持久化配置文件

mkdir -p ~/.config/qoder
cat > ~/.config/qoder/config.json << 'EOF'
{
  "api_key": "your-api-key-here"
}
EOF

6.3 配置 acpx 支持 Qoder

mkdir -p ~/.acpx
cat > ~/.acpx/config.json << 'EOF'
{
  "agents": {
    "qoder": {
      "command": "env QODER_PERSONAL_ACCESS_TOKEN=your-api-key-here qodercli --acp"
    }
  },
  "defaultAgent": "qoder",
  "defaultPermissions": "approve-all"
}
EOF

6.4 将 Qoder 注册到 ACP

# 添加 qoder 到允许的 Agents 列表
openclaw config set acp.allowedAgents '["openclaw","qoder","claude","codex","opencode","gemini"]'

# 可选：设置 qoder 为默认 Agent
openclaw config set acp.defaultAgent "qoder"

# 重启 Gateway
openclaw gateway restart

6.5 测试 Qoder CLI

qodercli -p "hello" --max-turns 1
# 若返回结果，说明 Qoder CLI 工作正常

---

第七阶段：飞书 Bot 集成

7.1 创建飞书企业自建应用

1. 访问 飞书开放平台
2. 点击「创建应用」→ 选择「企业自建」
3. 填写应用名称（如「OpenClaw 助手」）和描述
4. 立即记录 App ID 和 App Secret

7.2 配置必需权限

进入应用「权限管理」，开启以下权限：

contact:user.base:readonly   获取用户基本信息
im:message                   读取消息
im:message:send_as_bot       发送消息（Bot 身份）
im:resource                  获取消息中的资源

确认 4 个权限全部激活。

7.3 启用机器人并配置事件订阅

1. 进入「应用能力」→ 添加「机器人」
2. 事件订阅：选择「使用长连接接收事件」（WebSocket，无需公网 URL）
3. 添加事件：im.message.receive_v1（接收消息事件）
4. 保存并创建版本
5. 发布应用（企业内部审批即可）

7.4 配置 OpenClaw 接入飞书

运行引导：

openclaw onboard

按提示操作：

1. 接受风险：是
2. 配置方式：快速开始
3. 模型供应商：选择已配置的百炼
4. 通道：选择飞书
5. 输入凭证：App ID、App Secret（来自步骤 7.1）
6. 启用技能：是
7. 选择钩子：session-memory
8. 重启 Gateway：是

7.5 使用飞书机器人

• 工作台：飞书 → 工作台 → 找到应用 → 开始聊天
• 全局搜索：搜索应用名称直接进入
• 群聊：将机器人加入群组 → @提及机器人交互

---

第八阶段：钉钉集成

钉钉提供两种接入方案，根据需求选择：

方案	复杂度	特点
方案 A：传统机器人（Stream 模式）	较低	直接配置，无需额外组件
方案 B：DEAP Agent（高级）	较高	通过 Connector 隧道，功能更丰富

---

方案 A：钉钉机器人（Stream 模式）

A-1：安装钉钉插件

openclaw plugins install https://github.com/soimy/openclaw-channel-dingtalk.git

# 验证安装
openclaw plugins list

A-2：在钉钉开放平台创建企业内部应用

1. 访问 钉钉开放平台
2. 使用企业管理员账号登录
3. 点击「创建应用」→ 选择「企业内部应用」
4. 填写应用信息（名称、描述、图标）
5. 点击「确定创建」
6. 在「凭证与基础信息」中记录 Client ID（AppKey）和 Client Secret（AppSecret）

⚠️ Client Secret 只显示一次，请立即妥善保存。

A-3：配置应用权限

进入「权限管理」，申请以下权限：

通讯录权限：

• qyapi_get_member - 获取企业成员信息
• qyapi_get_department_list - 获取部门列表

机器人权限：

• chat:chat:readonly / chat:chat:write
• im:chat:readonly / im:chat:write / im:chat:write:group
• Card.Instance.Write / Card.Streaming.Write
• qyapi_robot_sendmsg

点击「批量申请」，等待管理员审批通过。

A-4：配置并发布机器人

1. 进入「机器人」页面 → 添加机器人 → 选择「自定义机器人」
2. 消息接收模式：Stream 模式（WebSocket，无需公网 IP）
3. 进入「版本管理与发布」→ 创建新版本（1.0.0）→ 申请发布

A-5：配置 OpenClaw 连接钉钉

编辑 ~/.openclaw/openclaw.json，在 channels 中添加：

{
  "channels": {
    "dingtalk": {
      "enabled": true,
      "clientId": "你的_APPKEY",
      "clientSecret": "你的_APPSECRET",
      "robotCode": "你的_APPKEY",
      "corpId": "你的_CORPID",
      "agentId": "你的_AGENTID",
      "dmPolicy": "open",
      "groupPolicy": "open",
      "messageType": "markdown",
      "streamMode": true,
      "autoReply": true,
      "debug": false
    }
  }
}

或使用命令行配置：

openclaw config set channels.dingtalk.enabled true
openclaw config set channels.dingtalk.clientId "YOUR_CLIENT_ID"
openclaw config set channels.dingtalk.clientSecret "YOUR_CLIENT_SECRET"
openclaw config set channels.dingtalk.sessionTimeout 1800000

openclaw gateway restart

A-6：将机器人添加到群聊

1. 打开目标钉钉群 → 群设置 → 智能群助手
2. 添加机器人 → 企业内部机器人 → 找到你的机器人 → 添加

验证： 在群聊中发送 @OpenClaw 助手 你好，机器人应回复。

---

方案 B：钉钉 DEAP Agent（高级方案）

架构： 钉钉 App → DEAP 云端 → Connector 隧道 → 你的服务器 Gateway

B-1：获取 DEAP 凭证

1. CorpId：钉钉开放平台 → 企业信息
2. DEAP API Key：钉钉 DEAP 平台 → 安全与权限 → API-Key 管理 → 创建密钥

B-2：在服务器上安装并运行 Connector

# 检查服务器架构
uname -m  # x86_64 或 aarch64

# 从以下地址下载对应版本：
# https://github.com/DingTalk-Real-AI/dingtalk-moltbot-connector/releases
cd ~
wget [下载链接] -O connector.zip
unzip -o connector.zip
cd connector-linux-amd64  # 根据实际目录名调整
chmod +x connector-linux

# 后台运行 Connector
nohup ./connector-linux \
  -deapCorpId 你的_CORPID \
  -deapApiKey 你的_DEAP_APIKEY \
  > /tmp/dingtalk-connector.log 2>&1 &

# 验证运行状态
ps aux | grep connector
tail -20 /tmp/dingtalk-connector.log

B-3：在 DEAP 平台创建 Agent

1. 访问 钉钉 DEAP 平台
2. 创建新 Agent
3. 添加技能：搜索「OpenClaw」或「OpenClaw Gateway」
4. 配置技能参数：
   • apikey：你的 DEAP API Key
   • apihost：127.0.0.1:18789
   • gatewayToken：第四阶段配置的 Gateway 认证令牌
5. 发布 Agent

B-4：在钉钉中使用 DEAP Agent

• 在钉钉 App 中搜索 Agent 名称
• 直接用自然语言发送任务，命令通过隧道在阿里云服务器上执行

---

第九阶段：QQ Bot 集成

9.1 创建 QQ 机器人

1. 访问 QQ 开放平台
2. 重要：需注册账号（非 QQ 账号直接登录）
3. 登录 → 「机器人」→「创建机器人」
4. 填写名称和描述
5. 立即记录机器人 ID 和机器人密钥（关闭后无法再次查看）

9.2 配置 IP 白名单

1. QQ 开放平台 → 机器人详情 → IP 白名单
2. 将阿里云服务器的公网 IP 加入白名单

9.3 配置 OpenClaw

openclaw onboard

选择 QQ 作为通道，输入：

• 机器人 ID
• 机器人密钥

完成剩余步骤（模型选择、技能、钩子）。

---

第十阶段：Discord Bot 集成

10.1 创建 Discord Bot

1. 访问 Discord Developer Portal
2. 「New Application」→ 输入应用名称
3. 进入「Bot」标签页
4. 点击「Reset Token」→ 立即复制并保存 Bot Token
5. 开启「Message Content Intent」（消息内容意图权限）

10.2 生成邀请链接并加入服务器

1. 进入「OAuth2」→「URL Generator」
2. Scope 选择：bot
3. Bot Permissions 勾选：
   • Send Messages
   • Read Message History
4. 复制生成的 URL，在浏览器中打开
5. 选择你的 Discord 服务器 → 授权

10.3 配置 OpenClaw

openclaw onboard

选择 Discord 作为通道，输入 Bot Token（来自步骤 10.1）。

遗留说明：部分旧版文档使用 clawdbot，请统一使用 openclaw。

---

验证与使用示例

全平台通用测试消息

你现在用的是什么模型？
用三句话总结什么是 OpenClaw
创建一个工作日报模板

检查 Gateway 状态

# 查看 Gateway 运行日志
tail -50 /tmp/openclaw-gateway.log

# 查看所有渠道状态
openclaw channel list

# 查看 ACP 会话
openclaw sessions list

钉钉使用示例

# 日常对话
@OpenClaw 助手 你好，请介绍一下你自己

# 代码需求
@OpenClaw 助手 帮我写一段 Python 爬虫代码，抓取网页标题

# 指定特定 Agent
@OpenClaw 助手 /acp spawn claude 分析这段代码的 bug

# 如果安装了 Qoder CLI
@OpenClaw 助手 用 qoder 开发一个 TODO 应用

# 多轮对话
@OpenClaw 助手 我想开发一个个人博客（使用 Next.js 和 TypeScript）

并行任务执行示例

一次发送多个任务以提升效率：

请处理以下任务：
1. 用三句话总结 OpenClaw
2. 创建一个包含 5 项的每周待办模板
3. 推荐一个提高效率的小技巧

---

高级配置

配置多个 Agent

# 设置允许的 Agents 列表
openclaw config set acp.allowedAgents '["openclaw","qoder","claude","codex","opencode","gemini"]'

# 在聊天中使用特定 Agent
# /acp spawn codex --mode persistent   使用 Codex
# /acp spawn claude --mode persistent  使用 Claude
# /acp spawn qoder --mode persistent   使用 Qoder

配置持久化会话

# 启用会话绑定（同一话题持续使用同一 Agent）
openclaw config set session.threadBindings.enabled true
openclaw config set session.threadBindings.ttlHours 24

openclaw gateway restart

配置安全策略

# 设置执行权限级别
# strict: 严格限制   moderate: 适度限制   approve-all: 全部批准
openclaw config set acp.permissions "strict"

# 设置任务超时时间（秒）
openclaw config set acp.timeout 300

配置消息回复模板

新建 ~/.openclaw/dingtalk-templates.json：

{
  "welcome": "你好！我是 OpenClaw AI 助手，有什么可以帮助你的吗？",
  "error": "抱歉，处理您的请求时出现了错误，请稍后重试。",
  "thinking": "正在思考中...",
  "timeout": "处理超时，请简化您的问题后重试。"
}

---

性能优化与运维

配置 systemd 系统服务（推荐生产环境）

# 增加系统文件描述符限制
echo "fs.file-max = 65535" >> /etc/sysctl.conf
sysctl -p

# 创建 systemd 服务
cat > /etc/systemd/system/openclaw.service << 'EOF'
[Unit]
Description=OpenClaw Gateway
After=network.target

[Service]
Type=simple
User=root
ExecStart=/root/.nvm/versions/node/v22.22.0/bin/openclaw gateway
Restart=always
RestartSec=5
Environment="PATH=/root/.nvm/versions/node/v22.22.0/bin:/usr/bin:/usr/local/bin"

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable openclaw
systemctl start openclaw
systemctl status openclaw

监控与日志管理

# 实时查看 Gateway 日志
tail -f /tmp/openclaw-gateway.log

# 查看 ACP 状态
openclaw acp status

# 查看所有会话
openclaw sessions list

# 查看钉钉渠道指标
openclaw channel metrics dingtalk

# 通过 systemd 查看日志
journalctl -u openclaw -f

钉钉 DEAP Connector 守护进程

# 配置 Connector 开机自启
cat > /etc/systemd/system/dingtalk-connector.service << 'EOF'
[Unit]
Description=DingTalk DEAP Connector
After=network.target openclaw.service

[Service]
Type=simple
User=root
WorkingDirectory=/root/connector-linux-amd64
ExecStart=/root/connector-linux-amd64/connector-linux \
  -deapCorpId YOUR_CORPID \
  -deapApiKey YOUR_DEAP_APIKEY
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

systemctl enable dingtalk-connector
systemctl start dingtalk-connector

---

常见问题排查

故障速查表

现象	可能原因	解决方案
401 Unauthorized	Gateway Token 不匹配	检查 openclaw.json 中的 token 与 DEAP/机器人配置一致
405 Method Not Allowed	HTTP 端点未启用	确保 gateway.http.endpoints.chatCompletions.enabled: true
机器人完全无响应	应用未发布 / 权限缺失	检查应用发布状态和权限审批
DEAP Connector 断开	防火墙 / 端口问题	确保 18789 端口本地可访问，检查防火墙规则
机器人回复慢	服务器资源不足	检查 CPU/内存，查看 ACP 会话数
insufficient scope	钉钉权限未通过审批	重新申请权限并等待审批

问题 1：Gateway 启动失败

# 检查端口占用
netstat -tlnp | grep 18789

# 查看详细日志
openclaw logs

# 强制重启
openclaw gateway restart --force

问题 2：钉钉机器人无响应

排查步骤：

1. 确认应用已在「版本管理与发布」中正式发布（仅保存不够）
2. 确认所有机器人权限已申请并审批通过
3. 核对 Client ID 和 Client Secret 无误
4. 查看连接器日志：openclaw logs dingtalk -f
5. 确认 Stream 模式已启用
6. 确认机器人已添加到目标群聊

问题 3：无法将机器人添加到群聊

排查步骤：

1. 确认你是群管理员或群主
2. 确认应用已发布并通过管理员审批
3. 在「机器人」页面确认机器人状态为「已启用」

问题 4：Stream 模式 / WebSocket 连接失败

# 检查服务器是否能访问外部服务
ping oapi.dingtalk.com
ping open.feishu.cn

# 检查防火墙是否阻止出站连接
# 尝试重启对应渠道连接器
openclaw channel restart dingtalk

问题 5：机器人回复慢或中途超时

# 检查服务器资源
top
free -h

# 查看 ACP 会话状态
openclaw sessions list

# 检查 OpenClaw 错误日志
openclaw logs --tail 200

---

快速参考卡

平台	关键凭证	连接模式	特殊要求
飞书	App ID、App Secret	WebSocket 长连接	4 个权限，im.message.receive_v1 事件
钉钉（传统机器人）	AppKey、AppSecret、CorpId、AgentId	Stream 模式	Card.Instance.Write、Card.Streaming.Write 权限
钉钉（DEAP）	CorpId、DEAP API Key、Gateway Token	Connector 隧道	Connector 需与 Gateway 在同一服务器
QQ	机器人 ID、机器人密钥	HTTP API	服务器公网 IP 加入白名单
Discord	Bot Token	WebSocket Gateway	启用 Message Content Intent

---

环境变量参考

使用环境变量代替配置文件中的硬编码令牌（推荐）：

# 添加到 ~/.bashrc 或 ~/.zshrc
export OPENCLAW_GATEWAY_TOKEN="你的_gateway_token"
export DINGTALK_CLIENT_SECRET="你的_dingtalk_secret"
export FEISHU_APP_SECRET="你的_feishu_secret"
export BAILIAN_API_KEY="sk-sp-YOUR_KEY_HERE"
export QODER_PERSONAL_ACCESS_TOKEN="你的_qoder_api_key"

然后执行 source ~/.bashrc 使配置生效。部分 OpenClaw 版本支持在 openclaw.json 中使用 $ENV_VAR 语法引用环境变量。

---

日常维护命令

重启 Gateway：

systemctl restart openclaw
# 或手动方式：
pkill -f "openclaw gateway" && nohup setsid openclaw gateway --port 18789 --verbose > /tmp/openclaw-gateway.log 2>&1 &

更新 OpenClaw：

openclaw update
# 或重新运行安装脚本：
curl -fsSL https://clawd.bot/install.sh | bash

管理插件：

openclaw plugins list
openclaw plugins update [插件名]
openclaw plugins install [插件名或 Git URL]

查看运行日志：

# Gateway 主日志
tail -f /tmp/openclaw-gateway.log

# 钉钉 DEAP Connector 日志
tail -f /tmp/dingtalk-connector.log

# 特定渠道日志
openclaw logs dingtalk -f
openclaw logs feishu -f

故障排查入口：

openclaw gateway status        # Gateway 状态
openclaw channel list          # 所有渠道状态
openclaw sessions list         # ACP 会话列表
openclaw channel status dingtalk   # 特定渠道状态

---

参考资料

• OpenClaw 官网
• OpenClaw 官方文档
• OpenClaw GitHub
• 阿里云 ECS 控制台
• 阿里云百炼控制台
• 钉钉开放平台
• 钉钉 DEAP 平台
• 钉钉企业内部应用开发指南
• 钉钉机器人开发文档
• 飞书开放平台
• QQ 开放平台
• Discord Developer Portal
• ACP 协议规范
• 阿里云轻量服务器文档