前言

OpenClaw 是一个开源的 AI 助手框架，支持通过多种渠道与用户交互。本文将详细介绍如何配置 飞书（Feishu） 和 Telegram 两个常用渠道，让你的 AI 助手随时随地响应用户消息。

为什么需要多渠道接入？

想象一下这些场景：

  • 📱 通勤路上 - 用 Telegram 快速查询信息
  • 💼 工作时间 - 在飞书里直接@AI 助手协作
  • 🏠 居家办公 - 所有渠道消息自动同步

多渠道接入让你：

  • ✅ 在不同场景使用最方便的沟通工具
  • ✅ 消息历史自动同步，上下文不丢失
  • ✅ 统一后端，多个入口

环境准备

前置条件

  • ✅ OpenClaw 已部署（Docker 或本地）
  • ✅ 飞书开发者账号
  • ✅ Telegram 账号
  • ✅ SSH 密钥配置（用于 Git 备份）

目录结构

1
2
3
4
5
openclaw/
├── workspace/          # 工作目录（记忆文件）
├── feishu/            # 飞书配置
├── telegram/          # Telegram 配置
└── openclaw.json      # 主配置文件

配置飞书渠道

步骤 1：创建飞书应用

  1. 打开 飞书开发者平台
  2. 点击 “创建应用”

  3. 填写应用信息：

    • 应用名称：OpenClaw Assistant
    • 应用图标：上传一个机器人图标
    • 应用描述：AI 智能助手

  4. 创建成功后，记录 App ID 和 App Secret

步骤 2：配置应用权限

在应用管理后台，添加以下权限：

1
2
3
4
5
✅ im:message
✅ im:message.p2p
✅ im:message.group_at_msg
✅ contact:contact
✅ contact:group

步骤 3：创建机器人

  1. 进入 “机器人” 功能页
  2. 点击 “创建机器人”

  3. 配置机器人信息：

    • 机器人名称：OpenClaw
    • 头像：上传机器人头像
    • 功能：支持单聊和群聊

  4. 记录 Bot ID（格式：ou_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx）

步骤 4：配置事件订阅

  1. 进入 “事件订阅” 页

  2. 配置 请求 URL：

    1
    https://your-domain.com/feishu/event

    如果使用 Docker 部署，需要配置反向代理（Nginx/Caddy）

  3. 订阅以下事件：

    1
    2
    ✅ 接收消息 v2.0
    ✅ 用户状态变更

  4. 保存后，飞书会发送验证请求，确保服务端正确响应

步骤 5：配置 OpenClaw

在 OpenClaw 配置文件中添加飞书渠道：

1
2
3
4
5
6
7
8
9
10
11
{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_a9381443c6611bd8",
      "appSecret": "your-app-secret",
      "botId": "ou_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "verificationToken": "your-verification-token"
    }
  }
}

步骤 6：发布应用到飞书

  1. 进入 “版本管理与发布”
  2. 点击 “创建版本”
  3. 提交审核（个人使用可选择 “仅自己可用”）
  4. 审核通过后，在飞书中搜索你的应用名称即可添加

配置 Telegram 渠道

步骤 1：创建 Telegram Bot

  1. 在 Telegram 中搜索 @BotFather
  2. 发送 /newbot 命令

  3. 按提示输入：

    • Bot 名称：OpenClaw Assistant
    • Bot 用户名：必须以 bot 结尾，如 OpenClawHelper_bot

  4. 创建成功后，记录 Bot Token（格式：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

步骤 2：配置 Bot 功能

向 @BotFather 发送以下命令配置 Bot：

1
2
3
4
5
6
/setcommands
选择你的 Bot
输入命令列表：
start - 开始使用
help - 帮助信息
status - 查看状态

步骤 3：配置 OpenClaw

在 OpenClaw 配置文件中添加 Telegram 渠道：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
      "webhook": {
        "enabled": false,
        "url": "https://your-domain.com/telegram/webhook"
      },
      "polling": {
        "enabled": true,
        "interval": 1000
      }
    }
  }
}

注意：推荐使用 polling 模式（轮询），无需配置公网 IP 和 HTTPS

步骤 4：测试 Bot

  1. 在 Telegram 中搜索你的 Bot 用户名
  2. 点击 “Start” 或发送 /start
  3. Bot 应该回复欢迎消息

统一配置示例

完整的 openclaw.json 配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_a9381443c6611bd8",
      "appSecret": "xxxxxxxxxxxxxxxxxxxx",
      "botId": "ou_62b3f6fccea0779b98367c1390dddfed",
      "verificationToken": "xxxxxxxxxxxx"
    },
    "telegram": {
      "enabled": true,
      "botToken": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
      "polling": {
        "enabled": true,
        "interval": 1000
      }
    }
  },
  "memory": {
    "workspace": "/home/node/.openclaw/workspace",
    "autoBackup": true,
    "backupInterval": 7200000
  },
  "model": {
    "provider": "bailian",
    "model": "qwen3.5-plus",
    "temperature": 0.7
  }
}

Docker 部署配置

使用 Docker Compose 一键部署：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
version: '3.8'

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "4000:4000"    # 本地预览端口
    volumes:
      - ./workspace:/home/node/.openclaw/workspace
      - ./credentials:/home/node/.openclaw/credentials
      - ~/.ssh:/home/node/.ssh:ro
    environment:
      - OPENCLAW_CONFIG=/home/node/.openclaw/workspace/openclaw.json
      - TZ=Asia/Shanghai
    network_mode: host

启动服务：

1
docker-compose up -d

查看日志：

1
docker-compose logs -f openclaw

测试多渠道消息

测试场景 1：飞书单聊

  1. 在飞书中找到你的机器人
  2. 发送消息：”今天天气怎么样？”
  3. 机器人应该回复天气信息

测试场景 2：Telegram 私聊

  1. 在 Telegram 中打开你的 Bot
  2. 发送消息：”帮我写一首诗”
  3. Bot 应该创作一首诗

测试场景 3：消息同步

  1. 在飞书中发送：”记住我喜欢喝奶茶”
  2. 切换到 Telegram 发送：”我喜欢喝什么？”
  3. AI 应该回答：”你喜欢喝奶茶”

✅ 这说明记忆文件在多渠道间共享

常见问题排查

问题 1：飞书消息不回复

检查清单：

  • App ID 和 App Secret 是否正确
  • 事件订阅 URL 是否可访问
  • 机器人权限是否足够
  • 验证 Token 是否匹配

调试方法：

1
2
# 查看飞书渠道日志
docker logs openclaw | grep feishu

问题 2：Telegram Bot 无响应

检查清单：

  • Bot Token 是否正确
  • Polling 是否启用
  • 网络连接是否正常
  • Bot 是否被用户 Block

调试方法：

1
2
# 测试 Bot Token
curl https://api.telegram.org/bot<YOUR_TOKEN>/getMe

问题 3：多渠道记忆不同步

原因： 工作目录未正确挂载

解决方案：

1
2
volumes:
  - ./workspace:/home/node/.openclaw/workspace  # 确保所有渠道共享

高级配置

渠道特定配置

为不同渠道设置不同的回复策略：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "channels": {
    "feishu": {
      "enabled": true,
      "replyFormat": "markdown",
      "maxTokens": 2000
    },
    "telegram": {
      "enabled": true,
      "replyFormat": "html",
      "maxTokens": 1500
    }
  }
}

消息过滤

配置关键词过滤：

1
2
3
4
5
6
{
  "filters": {
    "blockedKeywords": ["广告", "营销", "推广"],
    "allowedUsers": ["ou_xxxxx", "123456789"]
  }
}

自动备份

配置记忆文件自动备份到 GitHub：

1
2
3
4
5
6
7
8
9
10
11
{
  "backup": {
    "enabled": true,
    "schedule": "0 */2 * * *",
    "git": {
      "remoteUrl": "git@github.com:username/openClawRemember.git",
      "autoCommit": true,
      "autoPush": true
    }
  }
}

最佳实践

1. 安全性

  • ✅ 不要将 App Secret、Bot Token 提交到 Git
  • ✅ 使用环境变量存储敏感信息
  • ✅ 定期轮换密钥

2. 性能优化

  • ✅ 使用连接池减少 API 调用延迟
  • ✅ 配置消息队列处理高峰流量
  • ✅ 启用缓存减少重复计算

3. 用户体验

  • ✅ 设置合理的回复超时时间
  • ✅ 提供清晰的帮助命令
  • ✅ 在群聊中只在被@时回复

4. 监控告警

  • ✅ 记录所有渠道的消息日志
  • ✅ 配置错误告警（邮件/短信）
  • ✅ 定期检查渠道连接状态

总结

通过本文，你学会了：

  1. ✅ 配置飞书渠道（创建应用、机器人、事件订阅）
  2. ✅ 配置 Telegram 渠道（创建 Bot、设置 Token）
  3. ✅ 统一配置文件管理多渠道
  4. ✅ Docker 部署和测试
  5. ✅ 常见问题排查和高级配置

现在你的 AI 助手已经可以通过飞书和 Telegram 随时响应了！

参考链接

下一篇预告： 《OpenClaw 技能开发实战 - 自定义 AI 助手能力扩展》