手把手教你通过一行 curl 命令在 WSL 2 上快速安装 Hermes Agent，并完成模型连接与基础配置。
在 WSL2 上安装和配置 OpenCode AI 编程助手的完整步骤，包括安装脚本、环境配置和常见问题排查。
在 WSL2 上安装和配置 OpenClaw AI Agent 的完整步骤，包括 npm 安装、模型配置和基础使用。
详细介绍在 WSL2 环境中安装和配置 Claude Code 的优势、步骤和最佳实践，为开发者提供更好的 AI 编程体验。
Hermes Agent 可以作为完整的飞书机器人运行。连接后，你可以在私信或群聊中与 Agent 对话，接收定时任务的推送结果，并通过网关发送文本、图片、音频和文件附件。
支持两种连接模式：
Hermes 在不同场景下的行为
群聊会话隔离行为由 config.yaml 控制：
除非你明确希望群内所有人共享一个会话，否则不要改为 false。
在 WSL2 命令行中输入以下命令：
然后选择 Feishu / Lark。
继续选择 第一个选项，用二维码创建。
系统会生成一个二维码。
用飞书移动端 APP 扫描该二维码。Hermes 会自动创建具有正确权限的机器人应用，并保存凭据。
创建完成后，可点击“打开应用”，进入飞书私信窗口。
接下来要选择私信如何授权。
Hermes Agent 推荐使用 DM 配对审批。
群聊信息的处理，选择 Respond only when @mentioned in groups 即可。
Home chat ID (optional, for cron/notifications): 直接回车跳过。
Install the gateway as a systemd service? (runs in background, starts on boot) [Y/n]: 选“y”。
选择网关在后台的运行方式。
Start the service now? [Y/n]: 选“y”。
完成后，通过飞书 APP 随便给刚才创建的 Hermes 应用发条信息，会收到一条类似 hermes pairing approve feishu XXXXXX 的命令。
在 WSL2 命令行中输入这条类似的命令，即可完成配对：
出现以下提示，说明配置成功。
在飞书 / Lark 聊天中发送 /set-home，将其标记为定时任务结果和跨平台通知的主频道。
出现以下提示，就算完成配置：
以后需要通过飞书 APP 使用 Hermes Agent，只需在 WSL2 命令行中输入以下命令。
WebSocket 和群组级 ACL 通过 config.yaml 中的 platforms.feishu.extra 配置。
FEISHU_VERIFICATION_TOKEN |
| 否 |
| （空） |
| Webhook 负载认证令牌 |
FEISHU_GROUP_POLICY | 否 | allowlist | 群消息策略：open, allowlist, disabled |
FEISHU_BOT_OPEN_ID | 否 | （空） | 机器人 open_id（用于 @ 检测） |
FEISHU_BOT_USER_ID | 否 | （空） | 机器人 user_id（用于 @ 检测） |
FEISHU_BOT_NAME | 否 | （空） | 机器人显示名称（用于 @ 检测） |
FEISHU_WEBHOOK_HOST | 否 | 127.0.0.1 | Webhook 服务器绑定地址 |
FEISHU_WEBHOOK_PORT | 否 | 8765 | Webhook 服务器端口 |
FEISHU_WEBHOOK_PATH | 否 | /feishu/webhook | Webhook 端点路径 |
HERMES_FEISHU_DEDUP_CACHE_SIZE | 否 | 2048 | 最大去重消息 ID 数 |
HERMES_FEISHU_TEXT_BATCH_DELAY_SECONDS | 否 | 0.6 | 文本突发合并静默期 |
HERMES_FEISHU_TEXT_BATCH_MAX_MESSAGES | 否 | 8 | 每批最大文本消息数 |
HERMES_FEISHU_TEXT_BATCH_MAX_CHARS | 否 | 4000 | 每批最大字符数 |
HERMES_FEISHU_MEDIA_BATCH_DELAY_SECONDS | 否 | 0.8 | 媒体突发合并静默期 |
授予 admin:app.info:readonly 权限，或手动设置 FEISHU_BOT_OPEN_ID / FEISHU_BOT_NAME |
| 点击审批按钮时错误 200340 | 在飞书开发者控制台启用交互式卡片能力并配置卡片请求 URL |
| Webhook 限流 | 同一 IP 每分钟超过 120 个请求，通常是配置错误或循环 |