back
loading skill details...
在阿里云服务器上部署 OpenClaw 的完整指南，涵盖阿里云百炼模型配置、飞书/钉钉/QQ/Discord 全平台接入、Qoder CLI 集成，以及高级配置与运维。
在阿里云上部署 OpenClaw 完整指南
覆盖阿里云百炼模型配置、飞书 / 钉钉（传统机器人 + DEAP 高级方案）/ QQ / Discord 全平台接入、Qoder CLI 集成，以及高级配置与运维。
⚠️ 安全警告
在开始之前，请务必阅读以下注意事项：
切勿在个人主力电脑上部署 OpenClaw——它具有高文件系统和命令执行权限
务必使用云服务器（如阿里云 ECS）进行部署，与本地环境隔离
保护好你的 API 密钥——使用环境变量或安全保险箱，不要硬编码在代码中
使用强随机令牌限制 Gateway 访问，避免使用简单密码
定期轮换凭证——特别是钉钉/飞书/QQ 等平台的应用密钥
使用场景
在阿里云 ECS 服务器上从零部署 OpenClaw AI 助手
通过钉钉（Stream 机器人或 DEAP 高级方案）与 AI 对话
通过飞书、QQ 或 Discord 接入 OpenClaw
配置阿里云百炼 Coding Plan 作为 AI 推理后端
将 Qoder CLI 注册为 ACP Agent，实现钉钉/飞书中的代码开发
示例
# 安装 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
注意事项
切勿在本地主力电脑部署，务必使用云服务器（如阿里云 ECS）
钉钉应用必须完成「版本发布」流程，仅保存配置不生效
钉钉 Client Secret、百炼 API Key、QQ 机器人密钥均只显示一次，需立即保存
飞书集成需选择「WebSocket 长连接」模式，不要使用 HTTP 回调
钉钉 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
部署步骤总览：
购买并配置阿里云 ECS 服务器
安装 Node.js 与 OpenClaw
配置阿里云百炼模型（Coding Plan）
配置 Gateway 外部访问与认证
配置 ACP 协议支持
安装并配置 Qoder CLI（可选）
接入 IM 平台（飞书 / 钉钉 / QQ / Discord）
前置要求
必需账号和权限
阿里云账号
阿里云百炼账号（用于模型 API）
目标 IM 平台的开发者/管理员账号
必需软件（本地）
SSH 客户端
现代浏览器（用于访问各平台开发者控制台）
第一阶段：阿里云服务器购买与配置
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 购买方式
方式一：通过计算巢快速部署（推荐新手）
访问阿里云计算巢，一键部署预配置环境：
🔗 阿里云计算巢 - OpenClaw 快速部署
按页面指引：选择地域 → 选择实例规格 → 配置网络和安全组 → 确认创建。
方式二：手动购买 ECS 实例
访问 阿里云 ECS 控制台
点击「创建实例」
关键选项：
镜像：Alibaba Cloud Linux 3 / Ubuntu 22.04（如有 OpenClaw 应用镜像可直接选用）
实例规格：ecs.c7.large（2 核 4 GiB）或更高
系统盘：40 GB ESSD
公网 IP：分配公网 IPv4
带宽：按使用流量或按固定带宽（至少 1 Mbps）
配置安全组（见下方）
设置登录凭证（密钥对推荐）
确认并创建
1.3 配置安全组规则
端口
协议
用途
授权对象
22
TCP
SSH 远程连接
你的 IP 地址
18789
TCP
OpenClaw Gateway
0.0.0.0/0
配置步骤：
ECS 控制台 → 找到实例 → 点击「安全组」
「配置规则」→「入方向」→「手动添加」以上规则
1.4 连接到服务器
# 使用密码登录
ssh root@<你的服务器公网IP>
# 使用密钥登录
ssh -i /path/to/your-key.pem root@<你的服务器公网IP>
# 或通过阿里云控制台网页终端：
# ECS 控制台 → 实例详情 → 远程连接
第二阶段：安装 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
方式一：通过官方安装脚本（推荐）
curl -fsSL https://clawd.bot/install.sh | bash
方式二：通过 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
第三阶段：配置阿里云百炼模型（Coding Plan）
3.1 购买 Coding Plan 套餐
套餐
首月价格
次月价格
每月请求量
Lite 基础版
7.9 元
40 元/月
18,000 次
Pro 高级版
39.9 元
200 元/月
90,000 次
访问 阿里云百炼控制台
导航至「Coding Plan」或「订阅套餐」
选择 Lite 或 Pro 完成支付
3.2 获取 API 凭证
Base URL（固定）：https://coding.dashscope.aliyuncs.com/v1
API Key 格式：sk-sp-xxxxx
获取步骤：
登录 阿里云百炼控制台
进入「密钥管理」或「API Keys」
点击「创建 API Key」
立即复制并保存——关闭后无法再次查看
支持的模型：
qwen3.5-plus - 通用场景（推荐入门）
qwen3-max-2026-01-23 - 高级推理
kimi-k2.5 - 代码生成（如可用）
glm-5 - 中文优化
3.3 配置 OpenClaw 使用百炼
方式一：交互式引导
openclaw onboard
按提示操作：
选择「添加自定义模型供应商」
供应商 ID：bailian
Base URL：https://coding.dashscope.aliyuncs.com/v1
API Key：粘贴 sk-sp-xxxxx
API 类型：openai-completions
添加模型：qwen3.5-plus
设为默认模型
方式二：手动编辑配置文件
编辑 ~/.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"
}
}
}
}
第四阶段：配置 Gateway 外部访问与认证
当需要通过钉钉 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"} 或类似响应
第五阶段：配置 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 创建飞书企业自建应用
访问 飞书开放平台
点击「创建应用」→ 选择「企业自建」
填写应用名称（如「OpenClaw 助手」）和描述
立即记录 App ID 和 App Secret
7.2 配置必需权限
进入应用「权限管理」，开启以下权限：
contact:user.base:readonly 获取用户基本信息
im:message 读取消息
im:message:send_as_bot 发送消息（Bot 身份）
im:resource 获取消息中的资源
确认 4 个权限全部激活。
7.3 启用机器人并配置事件订阅
进入「应用能力」→ 添加「机器人」
事件订阅：选择「使用长连接接收事件」（WebSocket，无需公网 URL）
添加事件：im.message.receive_v1（接收消息事件）
保存并创建版本
发布应用（企业内部审批即可）
7.4 配置 OpenClaw 接入飞书
运行引导：
openclaw onboard
按提示操作：
接受风险：是
配置方式：快速开始
模型供应商：选择已配置的百炼
通道：选择飞书
输入凭证：App ID、App Secret（来自步骤 7.1）
启用技能：是
选择钩子：session-memory
重启 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：在钉钉开放平台创建企业内部应用
访问 钉钉开放平台
使用企业管理员账号登录
点击「创建应用」→ 选择「企业内部应用」
填写应用信息（名称、描述、图标）
点击「确定创建」
在「凭证与基础信息」中记录 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：配置并发布机器人
进入「机器人」页面 → 添加机器人 → 选择「自定义机器人」
消息接收模式：Stream 模式（WebSocket，无需公网 IP）
进入「版本管理与发布」→ 创建新版本（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：将机器人添加到群聊
打开目标钉钉群 → 群设置 → 智能群助手
添加机器人 → 企业内部机器人 → 找到你的机器人 → 添加
验证： 在群聊中发送 @OpenClaw 助手 你好，机器人应回复。
方案 B：钉钉 DEAP Agent（高级方案）
架构： 钉钉 App → DEAP 云端 → Connector 隧道 → 你的服务器 Gateway
B-1：获取 DEAP 凭证
CorpId：钉钉开放平台 → 企业信息
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
访问 钉钉 DEAP 平台
创建新 Agent
添加技能：搜索「OpenClaw」或「OpenClaw Gateway」
配置技能参数：
apikey：你的 DEAP API Key
apihost：127.0.0.1:18789
gatewayToken：第四阶段配置的 Gateway 认证令牌
发布 Agent
B-4：在钉钉中使用 DEAP Agent
在钉钉 App 中搜索 Agent 名称
直接用自然语言发送任务，命令通过隧道在阿里云服务器上执行
第九阶段：QQ Bot 集成
9.1 创建 QQ 机器人
访问 QQ 开放平台
重要：需注册账号（非 QQ 账号直接登录）
登录 → 「机器人」→「创建机器人」
填写名称和描述
立即记录机器人 ID 和机器人密钥（关闭后无法再次查看）
9.2 配置 IP 白名单
QQ 开放平台 → 机器人详情 → IP 白名单
将阿里云服务器的公网 IP 加入白名单
9.3 配置 OpenClaw
openclaw onboard
选择 QQ 作为通道，输入：
机器人 ID
机器人密钥
完成剩余步骤（模型选择、技能、钩子）。
第十阶段：Discord Bot 集成
10.1 创建 Discord Bot
访问 Discord Developer Portal
「New Application」→ 输入应用名称
进入「Bot」标签页
点击「Reset Token」→ 立即复制并保存 Bot Token
开启「Message Content Intent」（消息内容意图权限）
10.2 生成邀请链接并加入服务器
进入「OAuth2」→「URL Generator」
Scope 选择：bot
Bot Permissions 勾选：
Send Messages
Read Message History
复制生成的 URL，在浏览器中打开
选择你的 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：钉钉机器人无响应
排查步骤：
确认应用已在「版本管理与发布」中正式发布（仅保存不够）
确认所有机器人权限已申请并审批通过
核对 Client ID 和 Client Secret 无误
查看连接器日志：openclaw logs dingtalk -f
确认 Stream 模式已启用
确认机器人已添加到目标群聊
问题 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 协议规范
阿里云轻量服务器文档don't have the plugin yet? install it then click "run inline in claude" again.