← Back to Skills Marketplace
xuxuclassmate

Feishu/Lark Setup and Troubleshooting

by XuXu · GitHub ↗ · v1.2.2 · MIT-0
cross-platform ✓ Security Clean
109
Downloads
0
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install feishu-setup-troubleshooting
Description
Set up and troubleshoot Feishu or Lark messaging integration with Hermes Agent, including connection checks, access control, and common failure modes.
README (SKILL.md)

Feishu or Lark Setup and Troubleshooting

When to use

  • A user wants to connect Hermes Agent to Feishu or Lark.
  • The bot is online but does not reply to messages.
  • You need to diagnose permissions, gateway state, or connection issues.

Prerequisites

  • Hermes Agent is installed and the hermes CLI is available.
  • A Feishu or Lark app exists with bot capability enabled.
  • The required App ID and App Secret are available.

Access-control reminder

Feishu access has two separate layers:

  • FEISHU_ALLOW_ALL_USERS
  • GATEWAY_ALLOW_ALL_USERS

If the gateway layer is still closed, Feishu users will be rejected even when the Feishu layer looks open.

Setup and troubleshooting flow

  1. Confirm configuration. Check that the required Feishu or Lark variables are present and that the domain and connection mode match the deployment.
  2. Confirm the gateway is running.
hermes gateway status
  1. Review recent logs.
hermes logs 2>&1 | grep -i feishu | tail -20
  1. Test message delivery. Send a direct message and look for an inbound message log followed by a model response.
  2. Restart after config changes.
hermes gateway restart

Common issues

  • Bot does not reply at all: the gateway is not running.
  • Unauthorized user in logs: the gateway-level allow rule is still blocking access.
  • Wrong region or domain: FEISHU_DOMAIN does not match the deployment.
  • Messages arrive but there is no answer: the model provider or API key behind Hermes is failing.

Security notes

  • Prefer an allowlist for production.
  • Never commit App Secret, encrypt keys, or verification tokens.
  • Keep the gateway running under a limited user account.
  • Review logs for sensitive output before sharing them externally.
Usage Guidance
This skill appears coherent for Feishu/Lark troubleshooting with Hermes. Before installing, ensure the hermes CLI is trustworthy and available, store FEISHU_APP_SECRET and other tokens in a secure secret store (do not paste into public logs), and prefer testing in a development environment first. Limit allowed users (use allowlists) and run the gateway under a low-privilege account. When following log instructions, inspect and redact any secrets before sharing externally. If you do not want the skill to run autonomously with access to these credentials, avoid enabling it or restrict its use to manual invocation only.
Capability Analysis
Type: OpenClaw Skill Name: feishu-setup-troubleshooting Version: 1.2.2 The skill bundle provides standard troubleshooting and setup instructions for Feishu/Lark integration with the Hermes Agent. It utilizes legitimate CLI commands (e.g., 'hermes gateway status', 'hermes logs') and includes security best practices such as advising against committing secrets and recommending the use of allowlists. No malicious patterns, data exfiltration, or suspicious obfuscation were detected in SKILL.md or _meta.json.
Capability Tags
requires-sensitive-credentials
Capability Assessment
✓ Purpose & Capability
The name and description (Feishu/Lark setup & troubleshooting for Hermes Agent) match the declared requirements: the hermes CLI is required and the env vars are Feishu- and gateway-related (APP_ID, APP_SECRET, DOMAIN, connection/allowlist settings, encryption and verification tokens). These are proportionate to the stated purpose.
✓ Instruction Scope
SKILL.md contains operational troubleshooting steps limited to checking configuration, running hermes gateway status/logs/restart, and testing messages. It does not instruct reading unrelated system files, contacting arbitrary external endpoints, or exfiltrating data. It does recommend reviewing logs (which may contain sensitive data), but also warns not to share secrets.
✓ Install Mechanism
This is an instruction-only skill with no install spec and no code files, so nothing is downloaded or written to disk by the skill itself.
✓ Credentials
The required environment variables are Feishu/Lark and gateway configuration items that a troubleshooting flow legitimately needs. The primary credential is the app secret, which is expected. The number of variables is large but appropriate for integration configuration.
✓ Persistence & Privilege
The skill is not always-enabled and does not request system-wide persistence or modify other skills. Model invocation is permitted (the platform default); while autonomous invocation increases blast radius in general, it is not combined with other red flags here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install feishu-setup-troubleshooting
  3. After installation, invoke the skill by name or use /feishu-setup-troubleshooting
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.2
Declare the required Hermes binary and Feishu environment variables in top-level skill metadata so the scan matches the guide.
v1.2.1
Translate the guide to English and keep the setup instructions aligned with the declared Feishu environment variables.
v1.2.0
安全修复：metadata中补全所有环境变量声明（FEISHU_APP_ID/SECRET等10个），消除metadata与正文不匹配问题
v1.1.0
安全修复：白名单模式提升为推荐选项；添加Security Best Practices章节；补全环境变量文档
v1.0.0
Initial publish: 飞书/Lark 消息集成配置与故障排查指南
Metadata
Slug feishu-setup-troubleshooting
Version 1.2.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 5
Frequently Asked Questions

What is Feishu/Lark Setup and Troubleshooting?

Set up and troubleshoot Feishu or Lark messaging integration with Hermes Agent, including connection checks, access control, and common failure modes. It is an AI Agent Skill for Claude Code / OpenClaw, with 109 downloads so far.

How do I install Feishu/Lark Setup and Troubleshooting?

Run "/install feishu-setup-troubleshooting" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Feishu/Lark Setup and Troubleshooting free?

Yes, Feishu/Lark Setup and Troubleshooting is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Feishu/Lark Setup and Troubleshooting support?

Feishu/Lark Setup and Troubleshooting is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Feishu/Lark Setup and Troubleshooting?

It is built and maintained by XuXu (@xuxuclassmate); the current version is v1.2.2.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments