OpenClaw China 安装使用教程-cmzhiku

项目介绍

OpenClaw China 是 OpenClaw（AI 网关）的国内 IM 扩展插件集合。OpenClaw 是一个强大的 AI 网关，可以将各种 AI 模型（如 Claude、GPT、DeepSeek 等）统一接入并对外提供服务。

而 OpenClaw China 解决了国内用户无法直接使用 Slack、Discord 等海外 IM 的问题，让你直接在钉钉、飞书、QQ、企业微信、普通微信等国内平台上与 AI 对话。

核心亮点：支持流式响应（像 ChatGPT 一样打字效果）、文件收发、语音识别、定时任务，是目前国内最完善的 AI 接入方案之一。

支持平台

🔔
钉钉
✅ 可用

🐧
QQ机器人
✅ 可用

💼
企业微信
✅ 可用

💼
企微自建
✅ 可用

📱
飞书
✅ 可用

推荐新手从钉钉开始

功能支持一览

功能	钉钉	飞书	QQ	企微机器人	企微自建
文本消息	✅	✅	✅	✅	✅
Markdown	✅	✅	✅	✅	✅
流式响应	✅	–	❌	✅	❌
图片/文件	✅	✅	✅	✅	✅
语音消息	✅	–	✅	✅	✅
定时任务	✅	✅	✅	❌	✅
群聊	✅	✅	✅	✅	❌
私聊	✅	✅	✅	✅	✅

环境要求

✅ Node.js 18+

✅ OpenClaw 已安装

📦 npm / pnpm

🌐 公网可访问（企微/飞书回调需要）

Windows 用户注意

安装方式一：npm 安装（推荐 Linux/Mac）

安装统一包（包含所有渠道）：

# 安装所有渠道插件
openclaw plugins install @openclaw-china/channels

# 启动配置向导
openclaw china setup

或安装单个渠道（不要和统一包同时安装）：

# 仅安装钉钉
openclaw plugins install @openclaw-china/dingtalk

# 仅安装QQ
openclaw plugins install @openclaw-china/qqbot

# 仅安装飞书
openclaw plugins install @openclaw-china/feishu-china

# 仅安装企业微信自建应用
openclaw plugins install @openclaw-china/wecom-app

安装方式二：源码安装（全平台通用/Windows 推荐）

步骤 1

克隆仓库并安装依赖

git clone https://github.com/BytePioneer-AI/openclaw-china.git
cd openclaw-china
pnpm install
pnpm build

git pull origin main && pnpm install && pnpm build

钉钉配置（新手推荐）

前往钉钉开发者平台创建应用

访问 open.dingtalk.com → 创建企业内部应用 → 开启机器人能力

企业微信自建应用配置（可接入普通微信）

openclaw config set channels.wecom-app.enabled true
openclaw config set channels.wecom-app.webhookPath /wecom-app
openclaw config set channels.wecom-app.token your-token
openclaw config set channels.wecom-app.encodingAESKey your-43-char-key
openclaw config set channels.wecom-app.corpId your-corp-id
openclaw config set channels.wecom-app.corpSecret your-app-secret
openclaw config set channels.wecom-app.agentId 1000002

可选：开启语音转文字（腾讯云 ASR）

openclaw config set channels.wecom-app.asr.enabled true
openclaw config set channels.wecom-app.asr.appId your-tencent-app-id
openclaw config set channels.wecom-app.asr.secretId your-secret-id
openclaw config set channels.wecom-app.asr.secretKey your-secret-key

更新插件

# npm 安装方式更新
openclaw plugins update channels

# 源码安装方式更新
git pull origin main
pnpm install
pnpm build

常见问题

Q: Windows 上 npm 安装报错 “spawn npm ENOENT”？

这是 OpenClaw 的已知 Windows 兼容性问题。请改用方式二（源码安装）。

Q: 企业微信回调校验失败？

检查 Token / EncodingAESKey 是否与后台一致，确保 encodingAESKey 为 43 位字符。同时检查 webhookPath 是否公网 HTTPS 可访问。

Q: 钉钉配置后消息没有回复？

确保开启了 HTTP 端点：openclaw config set gateway.http.endpoints.chatCompletions.enabled true，然后重启 Gateway。

Q: 如何让 AI 回复只回最终结果不要中间思考过程？

在配置中设置 replyFinalOnly: true 即可。

OpenClaw China 安装使用教程