@shaoqing915/lark-agent
v0.1.17
Published
Lark agent for approved local commands and Codex conversations.
Readme
@shaoqing915/lark-agent
Lark agent for running approved local commands and Codex conversations from Feishu/Lark chat.
Get Started
npm install -g @shaoqing915/lark-agent
lark-agent --init-config
lark-agent--init-config writes ~/.lark-agent/.env. For local development,
./.lark-agent/.env takes precedence when it exists.
Then send one of these messages to the bot:
hello
/help
/new
/codex hello
/run codexPlain text routes to Codex by default, and standalone JPEG, PNG, GIF, or WebP messages are forwarded as temporary image inputs. Use /help to query supported commands and /new to start a fresh conversation. In group chats, @bot hello, @bot /help, @bot /new, @bot /codex hello, and @bot /run codex are also supported.
Docs
- Get Started
- Configuration
- Service Deployment And Management
- Clash / Mihomo Proxy Deployment
- Usage
- Development
Security Notes
This service can execute local commands and run Codex. Keep defaults restrictive:
- Store Feishu/Lark credentials in local config, environment variables, or encrypted secret storage.
- Keep
AGENT_COMMANDSsmall and explicit. - Run the service from a dedicated work directory.
- Set
FEISHU_VERIFICATION_TOKENbefore exposing HTTP webhook mode. - Set
FEISHU_ENCRYPT_KEYand enable encrypted callbacks; HTTP requests without a valid Feishu signature are rejected. - Do not commit plaintext
.envfiles or credentials.
