<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom">
    <channel>
        <title>墨梅博客 - 标签: 飞书</title>
        <link>https://momei.app/</link>
        <description>Momei Blog - AI-driven, natively internationalized developer blog platform.</description>
        <lastBuildDate>Sun, 28 Jun 2026 10:27:50 GMT</lastBuildDate>
        <docs>https://validator.w3.org/feed/docs/rss2.html</docs>
        <generator>Momei Blog</generator>
        <language>zh-CN</language>
        <image>
            <title>墨梅博客 - 标签: 飞书</title>
            <url>https://momei.app/logo.png</url>
            <link>https://momei.app/</link>
        </image>
        <copyright>© 2026 墨梅博客. All rights reserved.</copyright>
        <atom:link href="https://momei.app/feed/tag/%E9%A3%9E%E4%B9%A6.xml" rel="self" type="application/rss+xml"/>
        <item>
            <title><![CDATA[记一次基于 Hermes Agent 的 AI 助手自动化深度使用体验]]></title>
            <link>https://momei.app/posts/hermes-agent-docker-deployment-deepseek-v4-feishu</link>
            <guid isPermaLink="false">https://momei.app/posts/hermes-agent-docker-deployment-deepseek-v4-feishu</guid>
            <pubDate>Sun, 28 Jun 2026 10:27:50 GMT</pubDate>
            <description><![CDATA[从 Docker 部署到实际使用，全面分享基于 Hermes Agent 自部署 AI 助手接入飞书、配置搜索 MCP、低成本调用 DeepSeek V4 Flash 的完整经验和技巧。]]></description>
            <content:encoded><![CDATA[<p><img src="https://oss.cmyr.dev/momei-files/posts/67c36aaa97c04ecd/image/20260628102153767-e9ytfga.png" alt="记一次基于 Hermes Agent 的 AI 助手自动化深度使用体验" /></p><blockquote>
<p><strong>摘要</strong>：本文记录了将 Hermes Agent 部署到 Docker、接入飞书、配置 tinyfish-mcp 搜索、搭配 DeepSeek V4 Flash 低成本方案，以及两周深度使用的真实体验。适合有一定 Docker 基础、想搭建自部署 AI 助手的读者。</p>
</blockquote>
<p>在上期博客 <a href="https://momei.app/posts/2026-24-caomei-weekly-hermes-agent-momei-weekly">《Hermes Agent AI 助手与墨梅博客更新 | 2026 年第 24 周草梅周报》</a> 中简单提了一下 <a href="https://github.com/NousResearch/hermes-agent">Hermes Agent</a>，这次将结合最近几周的真实使用体验，来给出一个完整的部署和使用报告。</p>
<blockquote>
<p>官方文档：<a href="https://hermes-agent.nousresearch.com/docs/zh-Hans/">https://hermes-agent.nousresearch.com/docs/zh-Hans/</a></p>
</blockquote>
<h2 id="部署" tabindex="-1"><a class="header-anchor" href="#部署">部署</a></h2>
<p>首先，和 OpenClaw 一样，要想使用 Hermes Agent，先得部署 Hermes Agent。</p>
<p>考虑到此类 AI 助手的所需要的权限非常大，因此非常<strong>不推荐</strong>在个人电脑上部署，如需部署，还是建议优先使用 Docker 这样的容器环境来部署，和主机环境进行隔离，以减少被误删文件和被攻击的风险。</p>
<blockquote>
<p>Docker 容器本身就是安全边界</p>
</blockquote>
<p>接下来介绍一下如何通过 Docker 部署 Hermes Agent。</p>
<p>首先进行一些前期准备，包括 Linux 服务器、Docker、LLM 的 API Key。</p>
<h3 id="环境要求" tabindex="-1"><a class="header-anchor" href="#环境要求">环境要求</a></h3>
<ul>
<li><strong>服务器</strong>：Linux（最好不低于 2 核 4G，否则会有卡死的风险）</li>
<li><strong>Docker</strong>：已安装 docker、docker-compose</li>
<li><strong>API Key</strong>：至少一个 LLM 厂商的密钥（DeepSeek、OpenAI 等）</li>
<li><strong>消息网关</strong>：这里以飞书为例（你可以选择任意一个支持的<a href="https://hermes-agent.nousresearch.com/docs/zh-Hans/user-guide/messaging/">消息平台</a>，例如 QQ、企业微信、钉钉等）</li>
</ul>
<h3 id="安装" tabindex="-1"><a class="header-anchor" href="#安装">安装</a></h3>
<p>在服务器合适的目录下写入以下 <code>docker-compose.yml</code> 配置文件。</p>
<pre><code class="language-yml"># 
# Hermes Agent — Docker Compose 部署
# 配置: DeepSeek V4 Flash + 飞书 WebSocket
#
services:
  hermes:
    image: nousresearch/hermes-agent:latest
    container_name: hermes
    restart: unless-stopped
    volumes:
      - ./hermes_data:/opt/data
    env_file:
      - .env
    environment:
      # ---- 用户权限 ----
      - HERMES_UID=${HERMES_UID:-1000}
      - HERMES_GID=${HERMES_GID:-1000}
      # ---- DeepSeek Provider ----
      - DEEPSEEK_API_KEY=${DEEPSEEK_API_KEY}
      # ---- 飞书渠道 (WebSocket 模式) ----
      - FEISHU_APP_ID=${FEISHU_APP_ID}
      - FEISHU_APP_SECRET=${FEISHU_APP_SECRET}
      - FEISHU_DOMAIN=feishu
      - FEISHU_CONNECTION_MODE=websocket
      # ---- 飞书安全白名单 (强烈推荐) ----
      - FEISHU_ALLOWED_USERS=${FEISHU_ALLOWED_USERS}
      # ---- 推荐: 设置 home chat 用于 cron/通知 ----
      - FEISHU_HOME_CHANNEL=${FEISHU_HOME_CHANNEL}
      # - GATEWAY_ALLOW_ALL_USERS=${GATEWAY_ALLOW_ALL_USERS:-false}
      - GATEWAY_ALLOWED_USERS=${GATEWAY_ALLOWED_USERS}
      - OPENCODE_GO_API_KEY=${OPENCODE_GO_API_KEY}
    command: [&quot;gateway&quot;, &quot;run&quot;]

</code></pre>
<p>在这里选择用 DeepSeek V4 Flash 作为后端 AI 模型，飞书作为前端交互客户端。在这里不使用 Web dashboard，也就不开放任何端口，所有消息通过飞书发送和接收。所有数据保存到当前目录下的 <code>hermes_data</code> 目录（和官方有差异，官方默认是 <code>~/.hermes/</code>，我这里用自定义挂载是为了方便备份）。</p>
<p>当然，上述配置还是不完整的，因为没有对应的环境变量。</p>
<p>在同一目录下新建 <code>.env</code> 文件，配置参考如下，请注意替换成你的真实值。</p>
<pre><code class="language-ini"># === DeepSeek API ===
# 在 https://platform.deepseek.com 申请
DEEPSEEK_API_KEY=sk-xxxx

# === 飞书应用凭据 ===
# 在 https://open.feishu.cn/app 申请，具体申请过程参考下文
FEISHU_APP_ID=cli_xxxx
FEISHU_APP_SECRET=xxxxx
FEISHU_DOMAIN=feishu
FEISHU_CONNECTION_MODE=websocket

# === 飞书安全白名单 (用逗号分隔用户 open_id) ===
FEISHU_ALLOWED_USERS=ou_xxxx

# === 可选: Home Chat ID (cron job 结果、通知发送到此) ===
# FEISHU_HOME_CHANNEL=oc_xxx
# 允许的用户 ID。
# GATEWAY_ALLOWED_USERS=xxx
# 第一次使用建议先设置成允许所有用户，不过请确保该应用只有自己使用！
GATEWAY_ALLOW_ALL_USERS=true 
</code></pre>
<p>除此之外，你还需要在 <code>hermes_data</code> 目录下创建一个 <code>config.yaml</code> 文件，内容如下：</p>
<pre><code class="language-yaml">model:
  provider: deepseek
  default: deepseek-v4-flash
</code></pre>
<blockquote>
<p>你也可以使用任何<a href="https://hermes-agent.nousresearch.com/docs/zh-Hans/integrations/providers">支持的 AI 提供商</a>。</p>
</blockquote>
<p>当然，你也可以通过命令行配置，通过以下命令进入设置向导，向导会提示你输入 API 密钥并将其写入 <code>./hermes_data/.env</code></p>
<pre><code class="language-sh">docker run -it --rm \
  -v ./hermes_data:/opt/data \
  nousresearch/hermes-agent setup
</code></pre>
<h3 id="接入飞书平台" tabindex="-1"><a class="header-anchor" href="#接入飞书平台">接入飞书平台</a></h3>
<p>在这里需要一个飞书应用凭据和用户的 open_id，先讲一下飞书智能体应用如何创建。</p>
<p>首先登录<a href="https://open.feishu.cn/app">飞书开发者后台</a>，可以看到首页已经置顶了 <code>创建飞书智能体应用</code> 的入口，如果没有的话也可以点击下面的 <code>创建企业自建应用</code> 入口来创建。</p>
<p><img src="https://oss.cmyr.dev/images/20260628000643113.png" alt="飞书开发者后台 - 创建智能体应用入口"></p>
<p>然后就可以看到设置头像和名称的页面了，直接点 <code>立即创建</code> 就行了。</p>
<p><img src="https://oss.cmyr.dev/images/20260628000617122.png" alt="飞书开发者后台 - 创建智能体应用"></p>
<p>然后就能直接看到 App ID 和 App Secret 了，复制到环境变量中。</p>
<p><img src="https://oss.cmyr.dev/images/20260628000747468.png" alt="image-20260628000747412"></p>
<p>之后在项目目录下面执行以下命令，启用 Hermes Agent 的 Docker 镜像即可。</p>
<pre><code class="language-sh">docker compose up -d 
</code></pre>
<p>这时候就可以给机器人发消息来验证接入是否成功了。</p>
<p><img src="https://oss.cmyr.dev/images/20260628001752563.png" alt="image-20260628001752386"></p>
<p>如果没有响应，一般是没有配置 <code>飞书安全白名单</code> 和 <code>允许的用户 ID</code> 的缘故。</p>
<p>这种情况下可以先临时把 <code>GATEWAY_ALLOW_ALL_USERS</code> 设置成 <code>true</code>，然后直接询问 AI 用户的 <code>open_id</code>，并在 <code>FEISHU_ALLOWED_USERS</code> 和 <code>GATEWAY_ALLOWED_USERS</code> 中填入。</p>
<blockquote>
<p>也可以直接去看 <code>logs/gateway.log</code> 的日志。</p>
</blockquote>
<p><img src="https://oss.cmyr.dev/images/20260628002340089.png" alt="image-20260628002340001"></p>
<h2 id="使用" tabindex="-1"><a class="header-anchor" href="#使用">使用</a></h2>
<p>AI 能够通过飞书渠道进行回复之后，就可以正式开始使用了。</p>
<p>比如说，您可以先向它自我介绍一下，它就会记下来，以后也会直接引用。</p>
<p><img src="https://oss.cmyr.dev/images/20260628003453006.png" alt="image-20260628003452887"></p>
<p>然后是一些使用上的小技巧。</p>
<h3 id="部署搜索-mcp" tabindex="-1"><a class="header-anchor" href="#部署搜索-mcp">部署搜索 MCP</a></h3>
<p>众所周知，没有搜索工具的 AI 大模型依旧是个笨蛋，而在我的真实使用过程中，搜索类工具的触发概率基本上到了 80%~90%，做调研、探索、核实等任务的时候基本上是刚需，因此我选择了接入 <a href="https://github.com/CaoMeiYouRen/tinyfish-mcp">tinyfish-mcp</a>，可以说非常好用。</p>
<blockquote>
<p>tinyfish-mcp 的部署请参考官方文档。</p>
</blockquote>
<p>部署完 tinyfish-mcp 后，在 <code>config.yaml</code> 中配置即可。</p>
<pre><code class="language-yml">mcp_servers:
  tinyfish-search:
    url: &quot;https://tinyfish.example.com/mcp&quot;
    headers:
      Authorization: &quot;Bearer xxxxxx&quot;
</code></pre>
<p><img src="https://oss.cmyr.dev/images/20260628004015715.png" alt="image-20260628004015611"></p>
<h3 id="配置-tool-search" tabindex="-1"><a class="header-anchor" href="#配置-tool-search">配置 Tool Search</a></h3>
<p>如果你配置了多个 MCP 的话，那么就会发现 MCP 的 schema 占用了大量的上下文，因此可以考虑显式启用 <code>Tool Search</code> 功能。</p>
<p>在 <code>config.yaml</code> 配置中这样设置：</p>
<pre><code class="language-yml">tools:
  tool_search:
    enabled: true       # 之前是 auto，现在显式启用
    threshold_pct: 10   # MCP/插件工具超过上下文 10% 时触发
    search_default_limit: 5
    max_search_limit: 20

</code></pre>
<p>由于像 DeepSeek V4 这样的模型是支持 1M 上下文的，所以按照 auto 的 10% 自动触发来计算的话，得要 100k 左右的 MCP schema 上下文占用才会启用，而这个时候 MCP schema 的占用其实已经太大了，所以建议改成显式启用。</p>
<h3 id="使用便宜的-ai-模型" tabindex="-1"><a class="header-anchor" href="#使用便宜的-ai-模型">使用便宜的 AI 模型</a></h3>
<p>虽然也有人通过 Hermes Agent 编程，但大部分情况下还是跟它聊天多，而这种情况下是不需要太好的模型的，加上使用高级模型带来的开支是不容忽视的，所以还是建议大家使用便宜的 AI 模型，比如说高性价比的 DeepSeek V4 Flash，而不是 DeepSeek V4 Pro。如果真的需要编程，再通过调用 Claude Code、OpenCode 等 AI 工具来编程。</p>
<p>在这里个人比较推荐通过 <a href="https://opencode.ai/go?ref=T6C9392XGM">OpenCode Go</a> 来调用 DeepSeek V4 Flash，能比 DeepSeek 官方还优惠一些。</p>
<blockquote>
<p>以上链接包含我的邀请码，通过此链接注册你和我都能获得一定免费使用额度。</p>
<p>OpenCode Go 官方文档：<a href="https://opencode.ai/docs/zh-cn/go">https://opencode.ai/docs/zh-cn/go</a></p>
</blockquote>
<p>具体的原理就是 OpenCode Go 只需要 10 美元一个月，但是额度上却有 60 美元。</p>
<p>虽然 OpenCode Go 里面 DeepSeek V4 Pro 目前还没有同步 DeepSeek 官方的 2.5 折优惠，但是 DeepSeek V4 Flash 的价格是一致的，所以确实可以用 10 美元的价格用 60 美元额度的 DeepSeek V4 Flash，在各类 AI 模型中也算性价比最高的那一档了。</p>
<p>此外 OpenCode Go 还可以配合 Qwen3.7 Plus 来解决图像识别的问题，算是性价比最高的 AI 模型套餐之一了。</p>
<p><img src="https://oss.cmyr.dev/images/20260628010217867.png" alt="image-20260628010217783"></p>
<p>如果使用 OpenCode Go，在环境变量中的配置项就要对应改成 OpenCode Go 的，比如：</p>
<pre><code class="language-ini">OPENCODE_GO_API_KEY=xxxx
</code></pre>
<p>并且 <code>config.yaml</code> 配置的 <code>model.provider</code> 字段也要做如下修改：</p>
<pre><code class="language-yaml">model:
  provider: opencode-go
  default: deepseek-v4-flash
</code></pre>
<h3 id="配置视觉模型" tabindex="-1"><a class="header-anchor" href="#配置视觉模型">配置视觉模型</a></h3>
<p>如果你使用了 DeepSeek V4 系列作为 Hermes Agent 后端的主力 AI 模型，那么会遇到一个问题，那就是 deepseek-v4 目前还不支持识别图像，所以无法识别你发送的图片，影响使用体验。</p>
<p>在 Hermes Agent 中是支持单独设置视觉模型的，所以可以在 <code>config.yaml</code> 配置的 <code>auxiliary.vision.model</code> 字段中设置了 <code>qwen3.7-plus</code> 等支持图像识别的 AI 模型，来弥补 DeepSeek V4 Flash 的不足。</p>
<pre><code class="language-yml">auxiliary:
  vision:
    provider: opencode-go
    model: qwen3.7-plus
</code></pre>
<p><img src="https://oss.cmyr.dev/images/20260614220340272.png" alt="image-20260614220340115"></p>
<h3 id="自动化整理记忆" tabindex="-1"><a class="header-anchor" href="#自动化整理记忆">自动化整理记忆</a></h3>
<p>Hermes Agent 是支持设置定时任务的，为了强化它的自主学习能力，可以要求它每天凌晨的时候自动扫描过去 24 小时的会话，提取可复用的知识，从而省去了人工要求它复用的工夫。</p>
<blockquote>
<p>参考 prompt： “扫描过去 24 小时的所有会话，提取可复用的知识…”</p>
</blockquote>
<p>这里有一个小问题是，在 cron job 中无法直接写入 Memory，也就是说无法直接修改 Agent 记忆，所以只能采用间接方案，用 <code>file</code> 工具写入 <code>reusable-knowledge.json</code> 作为文件级知识库。</p>
<h3 id="使用-markdown-发送消息" tabindex="-1"><a class="header-anchor" href="#使用-markdown-发送消息">使用 markdown 发送消息</a></h3>
<p>由于飞书的限制，表格在消息中是无法渲染的，所以可以考虑转换成 markdown 文件作为附件进行发送，这样可以解决排版问题，也可以避免消息中出现了不支持的 markdown 排版字符。</p>
<blockquote>
<p>你可以直接要求 AI 以 markdown 文件格式发送附件，或者要求检测到表格字符后就自动转换成 markdown 附件。</p>
</blockquote>
<p><img src="https://oss.cmyr.dev/images/20260614220405504.png" alt="image-20260614220405355"></p>
<h2 id="一些使用体验" tabindex="-1"><a class="header-anchor" href="#一些使用体验">一些使用体验</a></h2>
<p>接下来聊聊自己这段时间使用 Hermes Agent 的感受吧。</p>
<p>首先就是非常的强大，非常的好用。</p>
<p>最开始对它的期望也就是个高度定制化的豆包而已，但现在看起来远比豆包好用。</p>
<p>为什么？</p>
<p>豆包不能执行代码、不能操作文件、也不能定时自省——而 Hermes Agent 把这些都集成在了一个界面中，这就是它比豆包好用的地方。</p>
<p>一方面，通过自建的 <a href="https://github.com/CaoMeiYouRen/tinyfish-mcp">tinyfish-mcp</a> 解决的搜索质量问题，另一方面，通过 <a href="https://github.com/CaoMeiYouRen/cmyr-skills-agents/tree/master/skills/super-search">super-search</a> 解决了调查报告质量的问题，可以说这是超过绝大部分 AI 搜索工具结果质量的基石。</p>
<p>其次则是定时任务系统。</p>
<p>个人也是使用过类似 n8n 这样的可视化低代码平台，虽然说写一个定时任务并不复杂，但手动去写、手动去连线还是有点麻烦，而自己写脚本也是嫌麻烦，而通过 Hermes Agent 一句话就能让它自己写脚本，并且出了问题还能自己修复，这就非常的愉快了。</p>
<p>而这些只是 Hermes Agent 最基础的功能，Hermes Agent 从本质上讲就是个自部署的 AI 助手，是可以轻松加入绝大多数工作流的，把它拉进工作群就是个最简单的使用方式了（不过得记得做好权限控制），剩下的交给时间就行，多互动，就会越来越好用。</p>
<p>即便一时间找不到合适的使用方式，那就真的把它当成一个 AI 聊天工具就行，有什么问题问一下，还能帮你总结经验。</p>
<h2 id="写在最后" tabindex="-1"><a class="header-anchor" href="#写在最后">写在最后</a></h2>
<p>最后其实也没有要多说的了，从 AI 能够通过飞书渠道进行回复之后，剩下的要做的事情就只剩下多用了，遇到不会的就问 AI，还可以让它自己解决问题，从而跑通整个自动化流程。</p>
<p>可以预见的是，从 OpenClaw 开始的自部署个人 AI Agent 框架爆火并不是偶然，而是一个刚需，未来只会出现更多像 Hermes Agent 这样的项目来满足用户需求。</p>
<p>而基于 Hermes Agent 这样的 AI 助手，能够实现的自动化是超乎想象的，可以说完全能够替代人工操作。而至于是<strong>取代</strong>还是<strong>解放</strong>，就见仁见智了。</p>
<p>我们下期再见，拜拜~</p>
<hr>
<p>您可以通过以下方式订阅草梅博客的更新：</p>
<ul>
<li><strong>博客</strong>：<a href="https://blog.cmyr.ltd">草梅友仁的博客</a></li>
<li><strong>墨梅博客</strong>：<a href="https://momei.app">墨梅博客</a></li>
<li><strong>RSS</strong>：<a href="https://blog.cmyr.ltd/atom.xml">草梅友仁的博客 RSS</a></li>
<li><strong>公众号</strong>：<a href="https://oss.cmyr.dev/images/20241025184516839-21n2ctv.png">草梅友仁的后花园</a></li>
<li><strong>邮箱订阅</strong>：<a href="https://listmonk.cmyr.dev/subscription/form">草梅友仁的博客订阅</a></li>
</ul>
<h2 id="往期回顾" tabindex="-1"><a class="header-anchor" href="#往期回顾">往期回顾</a></h2>
<ul>
<li><a href="https://blog.cmyr.ltd/archives/2026-24-caomei-weekly-hermes-agent-momei-weekly.html">2026-06-14 Hermes Agent AI 助手与墨梅博客更新 | 2026 年第 24 周草梅周报</a></li>
<li><a href="https://blog.cmyr.ltd/archives/2026-23-caomei-weekly-momei-blog-1-19-0-release-copilot-price-increase-alternative.html">2026-06-07 墨梅博客 1.19.0 发布与 Copilot 涨价替代方案 | 2026 年第 23 周草梅周报</a></li>
<li><a href="https://blog.cmyr.ltd/archives/2026-22-caomei-weekly-super-search-momei-open-source.html">2026-05-31 AI 超级搜索与墨梅博客开源动态 | 2026 年第 22 周草梅周报</a></li>
</ul>
]]></content:encoded>
            <author>草梅友仁</author>
            <category>技术教程</category>
            <enclosure length="1485891" type="audio/mpeg" url="https://oss.cmyr.dev/momei-files/posts/67c36aaa97c04ecd/audio/tts/20260628100051528-9gr6nam.mp3"/>
        </item>
    </channel>
</rss>