本指南提供一套在阿里云服务器上部署 OpenClaw 的完整流程，目标是实现通过多种 IM 平台与 AI 助手对话，并可选接入 Qoder CLI 进行代码开发。
一、用途与整体架构 用户层包含飞书、钉钉、QQ、Discord 等平台，通过 Stream / WebSocket 连接到 OpenClaw Gateway（默认端口 18789）。Gateway 内部包含 ACP 协议层（acpx、调度器、会话管理）与渠道连接器层，后端对接阿里云百炼 API 或 Qoder CLI。
二、安全警告 文档强调：切勿在个人主力电脑上部署 OpenClaw，因其具有高文件系统和命令执行权限；务必使用云服务器（如阿里云 ECS）与本地环境隔离；保护好 API 密钥，使用环境变量或安全保险箱，不要硬编码；使用强随机令牌限制 Gateway 访问；定期轮换凭证，特别是钉钉/飞书/QQ 等平台的应用密钥。
三、前置要求 需要阿里云账号、阿里云百炼账号（用于模型 API）、目标 IM 平台的开发者/管理员账号；本地需要 SSH 客户端和现代浏览器。
四、部署步骤总览
- 购买并配置阿里云 ECS 服务器；2. 安装 Node.js 与 OpenClaw；3. 配置阿里云百炼模型（Coding Plan）；4. 配置 Gateway 外部访问与认证；5. 配置 ACP 协议支持；6. 安装并配置 Qoder CLI（可选）；7. 接入 IM 平台（飞书 / 钉钉 / QQ / Discord）。
五、服务器与安装 推荐配置为 2 核 CPU、4 GiB 内存、40 GB ESSD、20 Mbps+ 带宽，操作系统可选 Ubuntu 22.04 / CentOS 8 / Alibaba Cloud Linux 3，地域建议美国弗吉尼亚或中国香港。可通过阿里云计算巢快速部署或手动购买 ECS。安全组需开放 22（SSH，限本人 IP）与 18789（Gateway）端口。安装 Node.js 推荐使用 nvm 安装 Node.js 22 LTS；OpenClaw 可通过官方脚本 curl -fsSL https://clawd.bot/install.sh | bash 或 npm install -g openclaw 安装。
六、模型配置 阿里云百炼 Coding Plan 提供 Lite 基础版（首月 7.9 元，次月 40 元/月，18,000 次/月）与 Pro 高级版（首月 39.9 元，次月 200 元/月，90,000 次/月）。Base URL 为 https://coding.dashscope.aliyuncs.com/v1，API Key 格式为 sk-sp-xxxxx。支持模型包括 qwen3.5-plus、qwen3-max-2026-01-23、kimi-k2.5、glm-5。可通过 openclaw onboard 交互式配置或手动编辑 ~/.openclaw/openclaw.json。
七、Gateway 与 ACP Gateway 认证令牌可用 openssl rand -hex 24 生成，配置 token 认证模式并启用 chatCompletions HTTP 端点。ACP 协议支持通过安装 @openclaw/acpx 插件并设置 acp.enabled、acp.dispatch.enabled、acp.backend、acp.defaultAgent、acp.allowedAgents、acp.maxConcurrentSessions 等参数启用。
八、Qoder CLI（可选） 通过 npm install -g @qoder-ai/qodercli 安装，配置认证后可注册为 ACP Agent，在 ~/.acpx/config.json 中定义 qoder 命令，并加入 acp.allowedAgents 列表。
九、IM 平台接入 飞书：创建企业自建应用，配置 contact:user.base:readonly、im:message、im:message:send_as_bot、im:resource 权限，使用 WebSocket 长连接接收事件，订阅 im.message.receive_v1。 钉钉：提供方案 A 传统机器人（Stream 模式，安装钉钉插件并配置 clientId/clientSecret 等）与方案 B DEAP Agent（高级，需运行 Connector 隧道并配置 apihost 127.0.0.1:18789 与 gatewayToken）。钉钉应用必须完成「版本发布」流程。 QQ：在 QQ 开放平台创建机器人，配置 IP 白名单，通过 onboard 输入机器人 ID 与密钥。 Discord：在 Discord Developer Portal 创建 Bot，开启 Message Content Intent，生成邀请链接，通过 onboard 输入 Bot Token。
十、运维与排查 文档提供 systemd 服务配置、日志监控、常见问题速查表（如 401 Unauthorized、405 Method Not Allowed、机器人无响应、DEAP Connector 断开、insufficient scope 等）及对应解决方案。
文档中部分内容（如具体价格、模型可用性、下载链接）以资料所述为准，实际使用请以官方最新信息为准。