← Back to Skills Marketplace
Feishu Identity Routing
by
wxfkuq2023
· GitHub ↗
· v0.1.0
· MIT-0
96
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install feishu-identity-routing
Description
Build and use a Feishu/Lark cross-app identity master for multi-agent, multi-account routing. Use when mapping the same user across different Feishu app open...
README (SKILL.md)
Feishu Identity Routing
Use this skill when a workspace needs a reusable way to:
- merge the same human across multiple Feishu apps/accounts
- store app-local
open_idunder one canonical user subject - resolve the right
open_idfor a targetaccountId/app_context - route outbound actions correctly in multi-agent setups
What to create
Create these workspace files if missing:
identity/feishu-user-master.json— canonical data storeidentity/feishu-user-master.md— human-readable summary
Core rules
- One person = one subject
- Merge by
union_idfirst, thenuser_id - Treat
open_idas app-local only - Before any outbound action:
- resolve the user subject globally
- resolve the target app/account-specific
open_id - build the provider target from that local identity
For Feishu DM routing, use:
accountId=\x3Ctarget account>target=user:\x3Copen_id>
Scripts
Use bundled scripts when you need deterministic updates:
scripts/merge_feishu_identity.js— merge one recordscripts/merge_feishu_identity_batch.js— merge many recordsscripts/review_feishu_pending.js— approve/reject pending merges
When to read references
- Read
references/workflow.mdwhen setting up or extending the process - Read
references/schema-example.jsonwhen creating a new master file - Read
references/pending-review-policy.mdwhen conflicts appear - Read
references/outbound-routing-patterns.mdwhen implementing outbound delivery or cross-agent routing - Read
references/examples.mdwhen you want concrete merge/routing examples
Notes
- Do not hardcode a specific agent like
mainorinfoIntelOfficerinto the design. - Model routing as: global subject resolution → app-context identity selection → provider-specific outbound target.
- Keep the skill reusable across future agents and Feishu accounts.
Usage Guidance
This skill implements a plausible Feishu identity merge/routing tool, but review and adjust before installing:
- The scripts operate on /home/admin/.openclaw/workspace (hardcoded). If your workspace is elsewhere, update the scripts or provide that path — otherwise they may fail or write unexpected files.
- There are path mismatches: the batch script expects workspace/bin/merge_feishu_identity.js but the repo provides scripts/merge_feishu_identity.js. Fix file locations or invocation strings before running the batch tool.
- review_feishu_pending.js inserts reviewer metadata ('main-agent' / 'main-agent' noted in approvals). That contradicts the SKILL.md guidance; if you need different agent names, change the hardcoded strings.
- Because the scripts write and overwrite identity files, back up any existing identity files and restrict file permissions before use.
- Audit the scripts locally (they perform only local JSON read/write and spawn local node processes) and, if you will run them in automated agents, ensure the agent runs under a dedicated user with appropriate filesystem permissions.
If you cannot or do not want to modify the scripts, treat this skill as untrusted until the hardcoded paths, invocation mismatches, and agent strings are corrected.
Capability Analysis
Type: OpenClaw Skill
Name: feishu-identity-routing
Version: 0.1.0
The skill bundle is designed to manage Feishu/Lark user identities across multiple applications by maintaining a local JSON master file. It includes Node.js scripts (merge_feishu_identity.js, merge_feishu_identity_batch.js, review_feishu_pending.js) for processing identity records and resolving app-specific identifiers. The code logic is consistent with the stated purpose, lacks external network calls or data exfiltration attempts, and contains no evidence of malicious intent or prompt injection attacks.
Capability Assessment
Purpose & Capability
Name/description (Feishu identity routing) aligns with the bundled scripts and reference docs: the code implements merging, batching, and pending-review flows for a canonical feishu-user-master.json. That functionality is expected for this purpose. However, the implementation assumes a specific local workspace (/home/admin/.openclaw/workspace) which is not declared in the skill metadata and may not match a user's environment.
Instruction Scope
SKILL.md tells you to create identity/feishu-user-master.* files, which fits the purpose. But the runtime scripts read/write a hardcoded absolute path (/home/admin/.openclaw/workspace) that is not documented in SKILL.md or declared in requirements. The batch/usage strings in the scripts expect binaries at workspace/bin/... while the repository provides scripts/..., creating an invocation/path mismatch. review_feishu_pending.js also hardcodes reviewer identity strings like 'main-agent' contrary to the SKILL.md advice not to hardcode agent names.
Install Mechanism
No install spec is present (instruction-only with shipped scripts). That is low-risk from an installation perspective because nothing is downloaded or executed automatically. However, the shipped scripts will perform filesystem writes when run.
Credentials
The skill declares no required env vars, but the scripts require write/read access to a specific filesystem location (/home/admin/.openclaw/workspace). This implicit config path is effectively a required resource but is not declared. The scripts do not request API keys or external credentials, which is proportional, but implicit reliance on a particular home directory and the hardcoded 'main-agent' reviewer are surprising and should be justified or parameterized.
Persistence & Privilege
The skill does not request always:true and won't autonomously persist beyond running its scripts; however the scripts will modify a workspace master JSON (create/update pending_reviews, subjects, rejected_reviews). This write access is expected for an identity master tool but is a privileged operation on local data — ensure the workspace path is correct and that you trust the code before allowing writes.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install feishu-identity-routing - After installation, invoke the skill by name or use
/feishu-identity-routing - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release: cross-app identity master, merge/review scripts, and generalized multi-account outbound routing workflow for Feishu.
Metadata
Frequently Asked Questions
What is Feishu Identity Routing?
Build and use a Feishu/Lark cross-app identity master for multi-agent, multi-account routing. Use when mapping the same user across different Feishu app open... It is an AI Agent Skill for Claude Code / OpenClaw, with 96 downloads so far.
How do I install Feishu Identity Routing?
Run "/install feishu-identity-routing" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Feishu Identity Routing free?
Yes, Feishu Identity Routing is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Feishu Identity Routing support?
Feishu Identity Routing is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Feishu Identity Routing?
It is built and maintained by wxfkuq2023 (@wxfkuq2023); the current version is v0.1.0.
More Skills