消息通道：企业微信与飞书

企业微信 Bot 接入流程

企业微信（WeCom）是国内使用最广泛的企业通讯工具之一。OpenClaw 支持通过企业微信的群机器人 Webhook 和应用机器人两种方式接入。

方式一：群机器人 Webhook（最简单）

1. 打开企业微信，进入目标群聊的聊天界面
2. 点击群设置 > 群机器人 > 添加机器人
3. 选择"新机器人"，设置名称和头像
4. 创建成功后复制 Webhook 地址
5. 在 OpenClaw 中配置：

// openclaw.config.ts
import { defineConfig } from 'openclaw';

export default defineConfig({
  model: {
    provider: 'anthropic',
    model: 'claude-sonnet-4-20250514',
    apiKey: process.env.ANTHROPIC_API_KEY,
  },
  bots: [
    {
      name: 'wecom-assistant',
      platform: 'wecom',
      webhookUrl: process.env.WECOM_WEBHOOK_URL,
      systemPrompt: '你是企业微信中的 AI 助手，回复正式专业。',
      // 企业微信群机器人仅支持主动推送消息
      mode: 'webhook-only',
    },
  ],
});

方式二：应用机器人（支持双向对话）

1. 登录企业微信管理后台（https://work.weixin.qq.com/wework_admin）
2. 进入"应用管理" > "自建" > "创建应用"
3. 上传应用 Logo，设置可见范围
4. 获取 CorpID、AgentID 和 Secret
5. 配置接收消息的 URL 和 Token

# .env 文件
WECOM_CORP_ID=wwdxxxxxxxxxxxx
WECOM_AGENT_ID=1000001
WECOM_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxx
WECOM_TOKEN=xxxxxxxxxxxx
WECOM_AES_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxx

飞书 Bot 接入流程

飞书（Lark）在国内企业中使用广泛，其 Bot 接入需要创建应用并配置事件订阅。

1. 访问飞书开发者平台（https://open.feishu.cn）
2. 点击"创建企业自建应用"
3. 在"应用功能"中开启"机器人"能力
4. 配置事件订阅，添加 im.message.receive_v1 事件
5. 发布应用并获取 App ID 和 App Secret

// 飞书通道配置
{
  name: 'lark-assistant',
  platform: 'lark',
  appId: process.env.LARK_APP_ID,
  appSecret: process.env.LARK_APP_SECRET,
  systemPrompt: '你是飞书上的 AI 助手。',
  // 飞书特有的卡片消息配置
  enableCard: true,
  cardTemplate: 'default',
}

钉钉机器人集成

钉钉机器人提供 Webhook 和 Stream 两种接入模式。

1. 登录钉钉开放平台（https://open.dingtalk.com）
2. 创建应用并选择"机器人"能力
3. 配置机器人出入参和消息接收地址
4. 发布应用并获取 ClientID 和 ClientSecret

// 钉钉通道配置
{
  name: 'dingtalk-bot',
  platform: 'dingtalk',
  clientId: process.env.DINGTALK_CLIENT_ID,
  clientSecret: process.env.DINGTALK_CLIENT_SECRET,
  systemPrompt: '你是钉钉上的 AI 助手。',
  // 钉钉支持的消息类型
  messageTypes: ['text', 'markdown', 'actionCard'],
}

国内平台特殊处理

接入国内消息平台时，需要特别注意以下问题：

内容安全审核

国内平台普遍要求对接内容安全服务，对发送的消息进行敏感内容过滤。OpenClaw 内置了内容安全插件：

// 启用内容安全插件
plugins: [
  {
    name: 'content-security',
    package: '@openclaw/plugin-content-security',
    options: {
      provider: 'baidu',        // 可选: baidu | aliyun | tencent
      apiKey: process.env.CENSOR_API_KEY,
      secretKey: process.env.CENSOR_SECRET_KEY,
      // 审核策略：strict（严格）/ moderate（中等）/ loose（宽松）
      strategy: 'moderate',
      // 自动替换敏感词
      autoReplace: true,
    },
  },
],

网络限制

国内服务器访问海外 AI 模型 API 时可能需要代理配置。OpenClaw 支持为 LLM 调用配置代理：

// 模型层代理配置
model: {
  provider: 'anthropic',
  model: 'claude-sonnet-4-20250514',
  apiKey: process.env.ANTHROPIC_API_KEY,
  // 配置 HTTP 代理
  httpAgent: {
    host: '127.0.0.1',
    port: 7890,
    protocol: 'http',
  },
},

平台接入差异对比

以下表格对比了四个国内平台在接入过程中的主要差异：

实战：配置企业微信群机器人

以下是完整的企业微信群机器人配置步骤：

1. 在企业微信中创建群聊，添加群机器人并复制 Webhook 地址
2. 配置 OpenClaw 项目：

import { defineConfig } from 'openclaw';

export default defineConfig({
  model: {
    provider: 'anthropic',
    model: 'claude-sonnet-4-20250514',
    apiKey: process.env.ANTHROPIC_API_KEY,
    httpAgent: {
      host: '127.0.0.1',
      port: 7890,
    },
  },
  bots: [
    {
      name: 'wecom-group-bot',
      platform: 'wecom',
      webhookUrl: process.env.WECOM_WEBHOOK_URL,
      systemPrompt: '你是企业微信群中的 AI 助手。
- 回答技术问题
- 提供工作建议
- 回复正式但不失友好',
      mode: 'webhook-only',
    },
  ],
  plugins: [
    {
      name: 'content-security',
      package: '@openclaw/plugin-content-security',
      options: { strategy: 'moderate' },
    },
  ],
});

3. 使用以下命令发送测试消息验证配置是否正确：

curl -X POST https://qyapi.weixin.qq.com/cgi-bin/webhook/send \
  -H "Content-Type: application/json" \
  -d '{"msgtype":"text","text":{"content":"Hello OpenClaw"}}'

配置完成后，当群成员 @机器人 提问时，机器人将通过 AI 模型处理后回复。通过本教程的学习，你已经掌握了 OpenClaw 接入各主流消息平台的方法，可以按需选择适合的平台进行部署。