📖 通道使用简介

OpenClaw 支持多种对话通道，包括飞书、微信、Discord 等。本指南将介绍如何充分利用这些通道，特别是文件分享等高级功能。

  • 飞书通道的配置和使用
  • 文件分享的正确方法
  • 不同通道的特性和限制
  • 最佳实践和故障排除

📱 飞书通道

📱

飞书通道配置

配置步骤

  1. 创建飞书应用

    访问 open.feishu.cn/app 创建企业自建应用

  2. 配置权限

    在权限管理中添加所需权限（参考安装教程中的权限清单）

  3. 在 OpenClaw 中配置

    打开管理界面 → 通道设置 → 飞书 → 填写 App ID 和 App Secret

  4. 配置事件订阅

    在飞书开放平台中设置长连接接收事件

💬

飞书聊天技巧

@ 机器人

在群聊中 @OpenClaw 机器人开始对话

命令触发

你: /help
OpenClaw 命令帮助： /new - 开始新对话 /skill - 使用技能 /agent - 切换代理 /help - 显示帮助

消息格式

  • 支持文本消息
  • 支持图片、文件上传
  • 支持 @ 提及
  • 支持富文本格式

📤 文件分享技巧

📁

如何让 OpenClaw 发送文件

💡 重要技巧

默认情况下，OpenClaw 可能只会发送文件路径，而不是实际文件。按照以下步骤教 OpenClaw 如何正确发送文件：

步骤 1：首次对话教学

你: 当你需要给我发送文件时，请先将文件复制到工作目录 `/home/lin13/.openclaw/workspace/`，然后从那里发送给我，而不是只发送文件路径。
明白了！我会记住这个要求。当需要给你发送文件时，我会： 1. 确保文件存在 2. 将文件复制到 `/home/lin13/.openclaw/workspace/` 目录 3. 从该目录发送实际文件给你

步骤 2：测试文件发送

你: 请创建一个包含 "Hello World" 的文本文件，然后发送给我。
正在创建文件并发送给你... [文件: hello.txt]

工作目录说明

Terminal 
# 查看工作目录
ls -la ~/.openclaw/workspace/

# 确保目录存在
mkdir -p ~/.openclaw/workspace/

# 设置权限
chmod 755 ~/.openclaw/workspace/
💡

文件分享最佳实践

支持的文件类型

  • 文本文件 (.txt, .md, .json 等)
  • 文档文件 (.docx, .pdf 等)
  • 图片文件 (.jpg, .png, .gif 等)
  • 音频文件 (.mp3, .wav 等)
  • 视频文件 (.mp4, .mov 等)
  • 压缩文件 (.zip, .tar.gz 等)

文件大小限制

⚠️ 注意

不同通道有不同的文件大小限制：

  • 飞书：最大 100MB
  • 微信：最大 25MB
  • Discord：最大 8MB（普通用户）

文件命名建议

  • 使用清晰的文件名
  • 避免使用特殊字符
  • 使用英文或数字命名
  • 添加时间戳便于区分

🌐 其他通道

💬

支持的通道

通道 状态 特点 配置难度
飞书 ✅ 稳定 企业级，支持丰富功能 中等
微信 ⚠️ 需扫码 个人使用方便 简单
Discord ✅ 稳定 社区友好 中等
Telegram ✅ 稳定 隐私性好 中等
Slack ✅ 稳定 团队协作 中等
WhatsApp ⚠️ 需认证 全球使用 较高
🔧

通道配置通用步骤

  1. 选择通道

    在 OpenClaw 管理界面中选择要配置的通道

  2. 获取凭证

    根据通道要求获取相应的 API 密钥或令牌

  3. 配置参数

    填写通道所需的配置参数

  4. 测试连接

    发送测试消息确认通道正常工作

  5. 启动通道

    启用通道并开始使用

💡 最佳实践

🌟

对话技巧

清晰的指令

好的: 请帮我创建一个名为 "todo.md" 的文件，内容包括今天的任务清单，然后发送给我。
不好: 给我一个文件。

分步指导

对于复杂任务，分步骤指导 OpenClaw：

你: 1. 首先创建一个包含 "Hello" 的文本文件 2. 然后将其复制到工作目录 3. 最后发送给我
正在执行步骤 1... 正在执行步骤 2... 正在执行步骤 3... [文件: hello.txt]

使用上下文

保持对话的连贯性，让 OpenClaw 理解你的意图：

你: 我需要一个项目计划 你: 请创建一个详细的计划文档 你: 然后发送给我
正在创建项目计划文档... [文件: project-plan.md]
🔒

安全注意事项

保护敏感信息

  • 不要在对话中发送密码、API 密钥等敏感信息
  • 使用环境变量存储敏感配置
  • 定期检查通道权限设置

文件安全

  • 只发送和接收可信的文件
  • 定期清理工作目录中的临时文件
  • 设置合理的文件权限

隐私保护

  • 了解各通道的隐私政策
  • 控制消息的可见范围
  • 使用端到端加密的通道

🔧 故障排除

❌

常见问题

文件发送问题

只收到文件路径，没有实际文件

解决方案：重新教导 OpenClaw 文件发送方法，确保它理解需要从工作目录发送实际文件

文件发送失败

解决方案：检查文件大小是否超过通道限制，确保工作目录有足够权限

通道连接问题

通道离线

解决方案：检查网络连接，验证凭证是否正确，重启 OpenClaw Gateway

消息发送失败

解决方案：检查通道权限，确保消息内容符合通道规范

权限问题

权限不足

解决方案：在通道平台中添加所需权限，重新授权

📞

获取帮助

  • OpenClaw 社区：加入 Discord 社区获取支持
  • GitHub Issues：在相关项目的 GitHub 仓库中提交问题
  • 官方文档：参考 OpenClaw 官方文档
  • 通道平台支持：联系各通道平台的技术支持