OpenClaw使用指南：飞书接入、多平台配置与实用技巧全解析

2026-02-02 16:17
1020
OpenClaw是一个多代理AI工作流平台，你可以通过Web界面、终端命令或消息应用（Telegram/WhatsApp/飞书）来使用它。本文将详细介绍OpenClaw的各种使用方式，重点讲解国内用户最关注的飞书接入方法，以及日常使用中的实用技巧。


一、三种主要使用方式

1.1 Web Dashboard（最直观）

适合长时间对话、文件上传、可视化操作。
openclaw dashboard
自动打开浏览器访问http://127.0.0.1:18789/，你可以：
• Chat：直接与AI对话
• Files：上传文件让AI分析
• Settings：调整模型参数
• Monitor：查看运行状态

1.2 终端命令（最快捷）

适合快速提问、脚本集成。
# 单条提问（非交互式） openclaw agent --agent main --message "用Python写一个快速排序" # 查看当前使用的模型 openclaw models status # 切换模型 openclaw models set moonshot/kimi-k2.5 # 使用本地模式 openclaw agent --agent main --message "你好" --local

1.3 消息应用（最方便）

在Telegram/WhatsApp里像聊天一样使用。
# 查看配对码 openclaw pairing list # 批准配对 openclaw pairing approve telegram # 之后直接在Telegram里@机器人说话即可

二、飞书接入完整教程

OpenClaw连接飞书需要通过飞书开放平台创建机器人应用，然后在OpenClaw中配置对接。

2.1 飞书开放平台创建应用

1. 访问 https://open.feishu.cn/app
2. 点击“创建企业自建应用”
3. 填写应用名称（如“OpenClaw助手”），点击创建

2.2 添加机器人能力

1. 在应用管理页左侧，点击“添加应用能力”
2. 选择“机器人” → 点击“添加”
3. 给机器人起个名字，保存

2.3 获取凭证

在左侧导航栏“凭证与基础信息”中复制：
• App ID（如cli_xxxxxxxxxx）
• App Secret（需要点击“查看”按钮）

2.4 配置权限

进入“权限管理”，申请以下权限：
• contact:user.base:readonly
• im:chat、im:chat:read
• im:message、im:message.group_at_msg:readonly
• im:message.p2p_msg:readonly
• im:message:send_as_bot
• im:resource

2.5 发布应用

进入“版本管理与发布” → “创建版本” → 填写版本号 → “保存并发布”。
发布后需要在飞书客户端的工作台中找到这个应用并启用。

2.6 OpenClaw安装飞书插件

# 安装飞书插件 openclaw plugins install @m1heng-clawd/feishu # 或使用新版 openclaw plugins install feishu-openclaw

2.7 配置飞书连接

openclaw config set channels.feishu.appId "cli_你的AppID" openclaw config set channels.feishu.appSecret "你的AppSecret" openclaw config set channels.feishu.enabled true openclaw config set channels.feishu.connectionMode websocket

2.8 配置飞书事件回调

返回飞书开发者后台：
1. 进入“事件与回调”
2. “订阅方式”选择“使用长连接接收事件”（推荐，无需公网IP）
3. 点击“添加事件” → 搜索“接收消息” → 勾选添加
4. 保存

2.9 启动并测试

# 启动Gateway openclaw gateway start # 查看日志确认连接成功 tail -f ~/.openclaw/logs/gateway.log | grep feishu
测试方法：在飞书客户端进入“工作台” → 找到你的应用 → 点击进入发消息，或在群聊中@机器人发送消息。

三、其他平台接入方式

国内用户可根据实际情况选择以下平台：
平台
国内可用性
说明
飞书 (Feishu)
⭐⭐⭐⭐⭐
最推荐，服务器在国内，连接稳定
钉钉 (DingTalk)
⭐⭐⭐⭐
可通过Webhook或插件接入
企业微信 (WeCom)
⭐⭐⭐
支持，但配置较复杂
Telegram
⭐⭐
需要特殊网络环境，功能最全
Discord
⭐
国内访问困难
网页版
⭐⭐⭐⭐⭐
无需任何聊天软件
终端
⭐⭐⭐⭐⭐
直接命令行交互
快速建议：
• 公司用飞书 → 飞书机器人
• 公司用钉钉 → 钉钉机器人
• 个人/Mac用户 → 网页版（openclaw dashboard）
• 技术/开发者 → 终端命令

四、实用技巧与场景

4.1 让AI执行操作（不仅是聊天）

OpenClaw的核心是代理（Agent），它可以：
• 读写本地文件
• 执行命令（需要授权）
• 管理待办事项
• 发送消息
# 让AI读取文件并分析 openclaw agent --agent main --message "请分析 ~/Documents/report.txt 的内容" # 让AI帮你写代码并保存 openclaw agent --agent main --message "写一个 Docker Compose 文件并保存到 ~/docker-compose.yml"

4.2 使用子代理（Sub-agents）

复杂任务可以分解成多个子代理并行处理。默认配置允许最多4个并发主代理，8个子代理。
示例：“帮我规划旅行，同时查询天气和机票”

4.3 查看日志和状态

# 查看Gateway实时日志 tail -f ~/.openclaw/logs/gateway.log # 检查配置是否正确 openclaw doctor # 自动修复配置问题 openclaw doctor --fix

4.4 环境变量快速切换

# 临时切换API Key（不修改配置文件） export MOONSHOT_API_KEY="sk-新的key" openclaw gateway restart

4.5 常用场景示例

场景A：编程助手
# 解释报错 openclaw agent --agent main --message "解释这个错误：Traceback: FileNotFoundError..." # 重构代码 openclaw agent --agent main --message "帮我把这个函数重构得更Pythonic：[粘贴代码]"
场景B：文件处理
# 总结PDF openclaw agent --agent main --message "总结 ~/Downloads/paper.pdf 的要点" # 批量重命名建议 openclaw agent --agent main --message "我有一堆照片 IMG_001.jpg 到 IMG_100.jpg，帮我写个脚本按日期重命名"
场景C：自动化工作流
# 创建定时任务 openclaw agent --agent main --message "每天早上9点检查邮件并总结发给我"

五、常用命令速查

命令
用途
openclaw models status
查看当前模型配置
openclaw models set moonshot/kimi-k2.5
设置默认模型
openclaw gateway install
安装Gateway服务
openclaw gateway start/stop/restart
控制Gateway
openclaw gateway status
查看Gateway状态
openclaw agent --agent main --message "内容"
发送消息
openclaw dashboard
打开Web界面
openclaw auth list
查看认证配置
openclaw health --deep
深度健康检查
openclaw doctor
诊断配置问题

六、故障排查与安全建议

6.1 常见问题

问题
解决方法
“未建立长连接”提示
确保OpenClaw Gateway已启动
发消息没反应
检查权限是否全部申请并开通
401错误
App ID或App Secret填错了，重新复制
群聊@机器人没反应
确认添加了im:message.group_at_msg:readonly权限

6.2 安全建议

• 别给最高权限，先read-only + 确认机制
• 定期审计：openclaw security audit --deep
• 自动修复：openclaw security audit --fix
• 建议在干净虚拟机或独立Mac Mini上跑24/7

6.3 关键概念理解

概念
说明
Gateway
后台服务，管理所有连接和状态，必须保持运行
Agent
AI代理，相当于一个工作助手，main是默认代理
Session
对话会话，每次对话有唯一ID，可以恢复历史
Provider
AI服务提供商（如Moonshot、OpenAI）
Skills
代理的能力（文件操作、代码执行、网络请求等）

结语

OpenClaw + Kimi K2.5的组合为国内用户提供了一个强大的本地AI代理解决方案。通过飞书接入，你可以在手机、电脑上随时随地与AI助手交互。无论是日常问答、编程辅助，还是文件处理和自动化工作流，OpenClaw都能胜任。希望本指南能帮助你快速上手，打造属于自己的私人AI助理！
0
好文章，需要你的鼓励