Here’s a fully localized, SEO- and GEO-optimized English blog post based on your Chinese content.
It follows English reading habits, includes keyword-rich headings, a clear structure, and actionable takeaways.
Title:
How to Fully Control Feishu with Hermes Agent: A Step-by-Step CLI Guide
Meta Description:
Learn how to configure and use the Feishu CLI with Hermes Agent to take complete control of your Feishu workflows. Includes setup, authorization, verification, and real-world use cases.
How to Fully Control Feishu with Hermes Agent: A Step-by-Step CLI Guide
Author: Yue Ge
Published: May 10, 2026
Reading Time: 8 minutes
Introduction: Why Hermes + Feishu CLI Matters
If you’ve tried using Hermes Agent to organize notes or documents in Feishu, you might have run into permission issues. I did.
The problem wasn’t Hermes — it was that I had only authorized the OpenClaw Feishu bot, not Hermes. That meant Hermes couldn’t access or modify my Feishu workspace.
This guide shows you exactly how to set up the Feishu CLI for Hermes Agent so your AI assistant can fully manage your Feishu content — creating docs, inviting members, updating permissions, and more — all automatically.
Prerequisites: Basic Feishu Bot Setup
Before starting, make sure you’ve created a Feishu bot and completed the initial configuration.
If you haven’t, follow the standard Feishu developer setup process first.
(Note: This guide assumes you already have a bot ready.)
Lesson Learned: Many users think authorizing one bot applies to all AI agents. In reality, each agent (like Hermes) needs its own authorization. Think of it like giving each person their own key — one key doesn’t open every door.
Step 1: Install the Feishu CLI for Hermes
Question: How do I install the Feishu CLI for Hermes and verify it works?
If you haven’t installed the Feishu CLI yet, send this command to your Hermes bot:
Please help me install the Feishu CLI.
请帮我安装飞书CLI
Wait for the installation to complete. Then, open your terminal (PowerShell or command line) and check the version:
lark-cli --version
If a version number appears, the installation was successful.
Tip: Don’t install the CLI from your system terminal directly — always use the Hermes bot to ensure you get the correct AI-compatible version.
Step 2: Initialize the Feishu Bot Configuration
Question: How do I correctly initialize the Hermes Feishu bot configuration?
In your terminal, run:
lark-cli config init --new
or
lark-cli 配置初始化 --new
You’ll receive a link. Open it and select “Choose Existing Application.” Then pick the Feishu bot you created for Hermes.
Wait for the configuration to complete.
Important: Make sure you select the correct Hermes bot. I once chose the wrong app and spent hours debugging why permissions weren’t applying.
Step 3: Log In and Authorize Permissions
Question: How do I complete login and authorization for Feishu CLI?
Run this command:
lark-cli auth login
You’ll be prompted to choose permission scopes. To give Hermes full control, select “All Permissions.”
Then open the provided authorization link in your browser and click “Authorize.”
Once done, your Hermes bot will have complete access to your Feishu workspace.
Real-World Use: After authorization, I tested creating documents, inviting members, and setting permissions — all worked smoothly. I even had Hermes read meeting notes from Feishu groups, summarize them, and write a structured report automatically. Saved me at least two hours.
Step 4: Verify Permissions and Test Basic Operations
Question: How do I verify that Hermes has full Feishu control?
Ask your bot to check Feishu permissions. You may need to confirm a few prompts.
After that, try simple commands like:
-
Create a new document -
List files in a folder -
Invite a user to a space
If these work, your setup is complete.
Step 5: Common Issues and Best Practices
Permission Scope
Only grant the permissions you need. If you only need document access, don’t authorize contact management.
Environment Variables
If you see permission errors, run your terminal as administrator or adjust PowerShell execution policies.
Network Stability
Authorization requires access to Feishu servers. Use a stable connection to avoid failed authorizations.
Quick Reference: Full Setup Checklist
| Step | Action | Verification | Notes |
|---|---|---|---|
| 1. Install | Send “install Feishu CLI” via Hermes bot | lark-cli --version |
Use bot, not system terminal |
| 2. Initialize | lark-cli config init --new |
Select correct Hermes app | Avoid wrong app selection |
| 3. Authorize | lark-cli auth login |
Browser authorization | Choose appropriate permissions |
| 4. Test | Run simple Feishu commands | Observe results | Ensure network stability |
Key Commands
# Install CLI (via Hermes bot)
请帮我安装飞书CLI
# Check version
lark-cli --version
# Initialize config
lark-cli config init --new
# Login and authorize
lark-cli auth login
Frequently Asked Questions (FAQ)
Q: Why doesn’t Hermes detect the installed Feishu CLI?
A: This is usually an environment variable issue, or you installed a different app’s CLI. Reinstall via the Hermes bot to ensure compatibility.
Q: What if I get a permission error during authorization?
A: Check your Feishu account permissions or contact your admin to confirm access rights.
Q: Can I authorize only specific permissions?
A: Yes. Choose only what you need. But note: missing permissions may block certain features.
Q: Do I need to log in again after authorization?
A: Authorization usually persists for a while, but reauthorize periodically for security.
Q: Do I need to reconfigure if I switch computers?
A: Yes. Each environment requires its own setup and authorization.
Final Thoughts
With these steps, your Hermes Agent can fully manage Feishu — automating workflows, organizing content, and saving you time.
The goal of tools like this isn’t to complicate your work, but to simplify it.
Now go make your AI assistant do the heavy lifting. 🚀

