openclaw-complete-deployment-guide by nathansteelqoder/openclaw-config-qoder-integration
npx skills add https://github.com/nathansteelqoder/openclaw-config-qoder-integration --skill openclaw-complete-deployment-guide覆盖阿里云百炼模型配置、飞书 / 钉钉(传统机器人 + DEAP 高级方案)/ QQ / Discord 全平台接入、Qoder CLI 集成,以及高级配置与运维。
在开始之前,请务必阅读以下注意事项:
# 安装 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
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
openssl rand -hex 24)本指南将带你完成一套完整的 OpenClaw 云端部署,实现通过多种 IM 平台与 AI 助手对话,并可选接入 Qoder CLI 进行代码开发。
整体架构:
┌────────────────────────────────────────────────────────────┐
│ 用户层 │
│ ┌────────┐ ┌────────┐ ┌──────┐ ┌─────────┐ │
│ │ 飞书 │ │ 钉钉 │ │ QQ │ │ Discord │ │
│ └───┬────┘ └───┬────┘ └──┬───┘ └────┬────┘ │
└──────┼───────────┼──────────┼───────────┼─────────────────┘
│ │ │ │
└───────────┴──────────┴───────────┘
│
Stream / WebSocket
│
┌─────────────────────────────▼──────────────────────────────┐
│ OpenClaw Gateway :18789 │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ ACP 协议层 │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │
│ │ │ acpx │ │ 调度器 │ │ 会话管理 │ │ │
│ │ └──────────┘ └──────────┘ └──────────┘ │ │
│ └──────────────────────────────────────────────────────┘ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ 渠道连接器层(飞书 / 钉钉 / QQ / Discord) │ │
│ └──────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
│
阿里云百炼 API / Qoder CLI
部署步骤总览:
| 配置项 | 最低要求 | 推荐配置 |
|---|---|---|
| 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 服务延迟低) |
方式一:通过计算巢快速部署(推荐新手)
访问阿里云计算巢,一键部署预配置环境:
按页面指引:选择地域 → 选择实例规格 → 配置网络和安全组 → 确认创建。
方式二:手动购买 ECS 实例
ecs.c7.large(2 核 4 GiB)或更高| 端口 | 协议 | 用途 | 授权对象 |
|---|---|---|---|
| 22 | TCP | SSH 远程连接 | 你的 IP 地址 |
| 18789 | TCP | OpenClaw Gateway | 0.0.0.0/0 |
配置步骤:
# 使用密码登录
ssh root@<你的服务器公网IP>
# 使用密钥登录
ssh -i /path/to/your-key.pem root@<你的服务器公网IP>
# 或通过阿里云控制台网页终端:
# ECS 控制台 → 实例详情 → 远程连接
# 安装 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
方式一:通过官方安装脚本(推荐)
curl -fsSL https://clawd.bot/install.sh | bash
方式二:通过 npm 全局安装
npm install -g openclaw
验证安装:
openclaw --version
# 预期输出:版本号如 "2026.1.x"
# 若提示命令不存在,尝试旧名称:clawdbot --version
# 方式一:前台启动(调试用)
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
| 套餐 | 首月价格 | 次月价格 | 每月请求量 |
|---|---|---|---|
| Lite 基础版 | 7.9 元 | 40 元/月 | 18,000 次 |
| Pro 高级版 | 39.9 元 | 200 元/月 | 90,000 次 |
https://coding.dashscope.aliyuncs.com/v1sk-sp-xxxxx获取步骤:
支持的模型:
qwen3.5-plus - 通用场景(推荐入门)qwen3-max-2026-01-23 - 高级推理kimi-k2.5 - 代码生成(如可用)glm-5 - 中文优化方式一:交互式引导
openclaw onboard
按提示操作:
bailianhttps://coding.dashscope.aliyuncs.com/v1sk-sp-xxxxxopenai-completionsqwen3.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"
}
}
}
}
当需要通过钉钉 DEAP 或其他外部服务访问 Gateway 时,需配置认证和 HTTP 端点。
openssl rand -hex 24
# 示例输出:a3f7c2e1d4b5a6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3
编辑 ~/.openclaw/openclaw.json,添加 gateway 部分:
{
"gateway": {
"port": 18789,
"mode": "local",
"bind": "loopback",
"controlUI": {
"allowInsecureAuth": false
},
"auth": {
"mode": "token",
"token": "在此处填入上一步生成的强令牌"
},
"http": {
"endpoints": {
"chatCompletions": {
"enabled": true
}
}
}
}
}
openclaw gateway restart
# 或手动重启:
pkill -f "openclaw gateway"
nohup setsid openclaw gateway --port 18789 --verbose > /tmp/openclaw-gateway.log 2>&1 &
curl http://127.0.0.1:18789/health
# 应返回 {"status":"ok"} 或类似响应
ACP(Agent Client Protocol)协议允许 OpenClaw 调度多种 AI Agent。
# 安装 ACPX 插件
openclaw plugins install @openclaw/acpx
# 启用插件
openclaw config set plugins.entries.acpx.enabled true
# 启用 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
openclaw gateway restart
openclaw config get acp --raw
# 应输出:
# {
# "enabled": true,
# "dispatch": { "enabled": true },
# "backend": "acpx",
# "defaultAgent": "openclaw",
# "allowedAgents": [...]
# }
如果你希望通过 Qoder 进行代码开发,可安装 Qoder CLI 并将其注册为 ACP Agent。
npm install -g @qoder-ai/qodercli
# 验证安装
qodercli --version
方式一:环境变量(临时)
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
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
# 添加 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
qodercli -p "hello" --max-turns 1
# 若返回结果,说明 Qoder CLI 工作正常
进入应用「权限管理」,开启以下权限:
contact:user.base:readonly 获取用户基本信息
im:message 读取消息
im:message:send_as_bot 发送消息(Bot 身份)
im:resource 获取消息中的资源
确认 4 个权限全部激活。
im.message.receive_v1(接收消息事件)运行引导:
openclaw onboard
按提示操作:
钉钉提供两种接入方案,根据需求选择:
| 方案 | 复杂度 | 特点 |
|---|---|---|
| 方案 A:传统机器人(Stream 模式) | 较低 | 直接配置,无需额外组件 |
| 方案 B:DEAP Agent(高级) | 较高 | 通过 Connector 隧道,功能更丰富 |
openclaw plugins install https://github.com/soimy/openclaw-channel-dingtalk.git
# 验证安装
openclaw plugins list
⚠️ Client Secret 只显示一次,请立即妥善保存。
进入「权限管理」,申请以下权限:
通讯录权限:
qyapi_get_member - 获取企业成员信息qyapi_get_department_list - 获取部门列表机器人权限:
chat:chat:readonly / chat:chat:writeim:chat:readonly / im:chat:write / im:chat:write:groupCard.Instance.Write / Card.Streaming.Writeqyapi_robot_sendmsg点击「批量申请」,等待管理员审批通过。
编辑 ~/.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
验证: 在群聊中发送 @OpenClaw 助手 你好,机器人应回复。
架构: 钉钉 App → DEAP 云端 → Connector 隧道 → 你的服务器 Gateway
# 检查服务器架构
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
127.0.0.1:18789openclaw onboard
选择 QQ 作为通道,输入:
完成剩余步骤(模型选择、技能、钩子)。
botopenclaw onboard
选择 Discord 作为通道,输入 Bot Token(来自步骤 10.1)。
遗留说明 :部分旧版文档使用
clawdbot,请统一使用openclaw。
你现在用的是什么模型?
用三句话总结什么是 OpenClaw
创建一个工作日报模板
# 查看 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. 推荐一个提高效率的小技巧
# 设置允许的 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": "处理超时,请简化您的问题后重试。"
}
# 增加系统文件描述符限制
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
# 配置 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 | 钉钉权限未通过审批 | 重新申请权限并等待审批 |
# 检查端口占用
netstat -tlnp | grep 18789
# 查看详细日志
openclaw logs
# 强制重启
openclaw gateway restart --force
排查步骤:
openclaw logs dingtalk -f排查步骤:
# 检查服务器是否能访问外部服务
ping oapi.dingtalk.com
ping open.feishu.cn
# 检查防火墙是否阻止出站连接
# 尝试重启对应渠道连接器
openclaw channel restart dingtalk
# 检查服务器资源
top
free -h
# 查看 ACP 会话状态
openclaw sessions list
# 检查 OpenClaw 错误日志
openclaw logs --tail 200
| 平台 | 关键凭证 | 连接模式 | 特殊要求 |
|---|---|---|---|
| 飞书 | App ID、App Secret | WebSocket 长连接 | 4 个权限,im.message.receive_v1 事件 |
| 钉钉(传统机器人) | AppKey、AppSecret、Cor |
覆盖阿里云百炼模型配置、飞书 / 钉钉(传统机器人 + DEAP 高级方案)/ QQ / Discord 全平台接入、Qoder CLI 集成,以及高级配置与运维。
在开始之前,请务必阅读以下注意事项:
# 安装 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
openssl rand -hex 24)本指南将带你完成一套完整的 OpenClaw 云端部署,实现通过多种 IM 平台与 AI 助手对话,并可选接入 Qoder CLI 进行代码开发。
整体架构:
┌────────────────────────────────────────────────────────────┐
│ 用户层 │
│ ┌────────┐ ┌────────┐ ┌──────┐ ┌─────────┐ │
│ │ 飞书 │ │ 钉钉 │ │ QQ │ │ Discord │ │
│ └───┬────┘ └───┬────┘ └──┬───┘ └────┬────┘ │
└──────┼───────────┼──────────┼───────────┼─────────────────┘
│ │ │ │
└───────────┴──────────┴───────────┘
│
Stream / WebSocket
│
┌─────────────────────────────▼──────────────────────────────┐
│ OpenClaw Gateway :18789 │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ ACP 协议层 │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │
│ │ │ acpx │ │ 调度器 │ │ 会话管理 │ │ │
│ │ └──────────┘ └──────────┘ └──────────┘ │ │
│ └──────────────────────────────────────────────────────┘ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ 渠道连接器层(飞书 / 钉钉 / QQ / Discord) │ │
│ └──────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
│
阿里云百炼 API / Qoder CLI
部署步骤总览:
| 配置项 | 最低要求 | 推荐配置 |
|---|---|---|
| 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 服务延迟低) |
方式一:通过计算巢快速部署(推荐新手)
访问阿里云计算巢,一键部署预配置环境:
按页面指引:选择地域 → 选择实例规格 → 配置网络和安全组 → 确认创建。
方式二:手动购买 ECS 实例
ecs.c7.large(2 核 4 GiB)或更高| 端口 | 协议 | 用途 | 授权对象 |
|---|---|---|---|
| 22 | TCP | SSH 远程连接 | 你的 IP 地址 |
| 18789 | TCP | OpenClaw Gateway | 0.0.0.0/0 |
配置步骤:
# 使用密码登录
ssh root@<你的服务器公网IP>
# 使用密钥登录
ssh -i /path/to/your-key.pem root@<你的服务器公网IP>
# 或通过阿里云控制台网页终端:
# ECS 控制台 → 实例详情 → 远程连接
# 安装 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
方式一:通过官方安装脚本(推荐)
curl -fsSL https://clawd.bot/install.sh | bash
方式二:通过 npm 全局安装
npm install -g openclaw
验证安装:
openclaw --version
# 预期输出:版本号如 "2026.1.x"
# 若提示命令不存在,尝试旧名称:clawdbot --version
# 方式一:前台启动(调试用)
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
| 套餐 | 首月价格 | 次月价格 | 每月请求量 |
|---|---|---|---|
| Lite 基础版 | 7.9 元 | 40 元/月 | 18,000 次 |
| Pro 高级版 | 39.9 元 | 200 元/月 | 90,000 次 |
https://coding.dashscope.aliyuncs.com/v1sk-sp-xxxxx获取步骤:
支持的模型:
qwen3.5-plus - 通用场景(推荐入门)qwen3-max-2026-01-23 - 高级推理kimi-k2.5 - 代码生成(如可用)glm-5 - 中文优化方式一:交互式引导
openclaw onboard
按提示操作:
bailianhttps://coding.dashscope.aliyuncs.com/v1sk-sp-xxxxxopenai-completionsqwen3.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"
}
}
}
}
当需要通过钉钉 DEAP 或其他外部服务访问 Gateway 时,需配置认证和 HTTP 端点。
openssl rand -hex 24
# 示例输出:a3f7c2e1d4b5a6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3
编辑 ~/.openclaw/openclaw.json,添加 gateway 部分:
{
"gateway": {
"port": 18789,
"mode": "local",
"bind": "loopback",
"controlUI": {
"allowInsecureAuth": false
},
"auth": {
"mode": "token",
"token": "在此处填入上一步生成的强令牌"
},
"http": {
"endpoints": {
"chatCompletions": {
"enabled": true
}
}
}
}
}
openclaw gateway restart
# 或手动重启:
pkill -f "openclaw gateway"
nohup setsid openclaw gateway --port 18789 --verbose > /tmp/openclaw-gateway.log 2>&1 &
curl http://127.0.0.1:18789/health
# 应返回 {"status":"ok"} 或类似响应
ACP(Agent Client Protocol)协议允许 OpenClaw 调度多种 AI Agent。
# 安装 ACPX 插件
openclaw plugins install @openclaw/acpx
# 启用插件
openclaw config set plugins.entries.acpx.enabled true
# 启用 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
openclaw gateway restart
openclaw config get acp --raw
# 应输出:
# {
# "enabled": true,
# "dispatch": { "enabled": true },
# "backend": "acpx",
# "defaultAgent": "openclaw",
# "allowedAgents": [...]
# }
如果你希望通过 Qoder 进行代码开发,可安装 Qoder CLI 并将其注册为 ACP Agent。
npm install -g @qoder-ai/qodercli
# 验证安装
qodercli --version
方式一:环境变量(临时)
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
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
# 添加 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
qodercli -p "hello" --max-turns 1
# 若返回结果,说明 Qoder CLI 工作正常
进入应用「权限管理」,开启以下权限:
contact:user.base:readonly 获取用户基本信息
im:message 读取消息
im:message:send_as_bot 发送消息(Bot 身份)
im:resource 获取消息中的资源
确认 4 个权限全部激活。
im.message.receive_v1(接收消息事件)运行引导:
openclaw onboard
按提示操作:
钉钉提供两种接入方案,根据需求选择:
| 方案 | 复杂度 | 特点 |
|---|---|---|
| 方案 A:传统机器人(Stream 模式) | 较低 | 直接配置,无需额外组件 |
| 方案 B:DEAP Agent(高级) | 较高 | 通过 Connector 隧道,功能更丰富 |
openclaw plugins install https://github.com/soimy/openclaw-channel-dingtalk.git
# 验证安装
openclaw plugins list
⚠️ Client Secret 只显示一次,请立即妥善保存。
进入「权限管理」,申请以下权限:
通讯录权限:
qyapi_get_member - 获取企业成员信息qyapi_get_department_list - 获取部门列表机器人权限:
chat:chat:readonly / chat:chat:writeim:chat:readonly / im:chat:write / im:chat:write:groupCard.Instance.Write / Card.Streaming.Writeqyapi_robot_sendmsg点击「批量申请」,等待管理员审批通过。
编辑 ~/.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
验证: 在群聊中发送 @OpenClaw 助手 你好,机器人应回复。
架构: 钉钉 App → DEAP 云端 → Connector 隧道 → 你的服务器 Gateway
# 检查服务器架构
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
127.0.0.1:18789openclaw onboard
选择 QQ 作为通道,输入:
完成剩余步骤(模型选择、技能、钩子)。
botopenclaw onboard
选择 Discord 作为通道,输入 Bot Token(来自步骤 10.1)。
遗留说明 :部分旧版文档使用
clawdbot,请统一使用openclaw。
你现在用的是什么模型?
用三句话总结什么是 OpenClaw
创建一个工作日报模板
# 查看 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. 推荐一个提高效率的小技巧
# 设置允许的 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": "处理超时,请简化您的问题后重试。"
}
# 增加系统文件描述符限制
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
# 配置 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 会话数 |
# 检查端口占用
netstat -tlnp | grep 18789
# 查看详细日志
openclaw logs
# 强制重启
openclaw gateway restart --force
排查步骤:
openclaw logs dingtalk -f排查步骤:
# 检查服务器是否能访问外部服务
ping oapi.dingtalk.com
ping open.feishu.cn
# 检查防火墙是否阻止出站连接
# 尝试重启对应渠道连接器
openclaw channel restart dingtalk
# 检查服务器资源
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 在同一服务器 |
| 机器人 ID、机器人密钥 | HTTP API | 服务器公网 IP 加入白名单 |
使用环境变量代替配置文件中的硬编码令牌(推荐):
# 添加到 ~/.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 # 特定渠道状态
Weekly Installs
284
Repository
First Seen
Mar 6, 2026
Security Audits
Gen Agent Trust HubFailSocketWarnSnykFail
Installed on
qoder254
kimi-cli47
gemini-cli47
amp47
cline47
github-copilot47
Azure RBAC 权限管理工具:查找最小角色、创建自定义角色与自动化分配
101,200 周安装
Sigma Tutor:AI 代码审查专家,一对一编程导师,布鲁姆 2-Sigma 个性化学习
279 周安装
ordercli 命令行工具:Foodora 订单追踪与自动化管理,支持历史查看与重新下单
279 周安装
songsee音频分析工具:从MP3/WAV生成频谱图、梅尔频谱、色度特征等可视化面板
279 周安装
Uniswap CCA 部署指南 - 连续清算拍卖智能合约跨链部署教程
279 周安装
AI行为模式技能 - 自适应AI操作模式:头脑风暴、实施、调试、审查、教学、发布
279 周安装
evolve:目标驱动的自主代码改进与质量提升循环工具
280 周安装
insufficient scope| 钉钉权限未通过审批 |
| 重新申请权限并等待审批 |
| Discord | Bot Token | WebSocket Gateway | 启用 Message Content Intent |