wecom-cli完整指南让人类与AI Agent都能在终端操作企业微信的官方CLI【免费下载链接】wecom-cli企业微信开放平台命令行工具 — 让人类和 AI Agent 都能在终端中操作企业微信项目地址: https://gitcode.com/gh_mirrors/we/wecom-cliwecom-cli 是企业微信开放平台的官方命令行工具CLI让人类和 AI Agent 都能在终端中操作企业微信发消息、发邮件、建文档、管日程、开会议、处理待办一条命令搞定。本指南面向新手带你 5 分钟完成安装快速上手全部核心功能。wecom-cli 是什么为什么值得装一个传统上操作企业微信要么打开网页后台点点点要么自己写代码调 API申请凭证、签名、处理分页……劝退率极高。wecom-cli 把这一切封装成了一条终端命令对人类像用git一样用wecom-cli查会话、发 Markdown 消息、搜文档、下载文件全部命令化对 AI Agent内置了 15 个 Agent Skills见 skills/ 目录大模型可以直接读懂每个能力的触发条件、工作流和参数示例自动替你完成跨应用的办公任务对开发者Rust 编写、跨平台macOS / Linux / Windows x64JSON 结构化输出天然适合写脚本和 CI一句话它是企业微信的终端入口也是AI Agent 操作企业微信的手。快速安装3 步跑通 wecom-cli前置条件项目要求平台macOSx64/arm64、Linuxx64/arm64、Windowsx64Node.js≥ 18企业微信账号必须机器人 Bot ID / Secret可选也可以扫码授权一键安装命令# 1. 安装 CLI npm install -g wecom/cli # 2. 安装 CLI SkillAI Agent 场景必需 npx skills add WeComTeam/wecom-cli -y -g # 3. 配置凭证交互式仅需一次 wecom-cli auth init # 4. 查看授权状态 wecom-cli auth show 从源码构建供开发者克隆仓库后执行cargo run -p wecom-cli -- --help即可仓库结构说明见 docs/development.md。两种授权方式怎么选方式命令适合谁扫码接入推荐wecom-cli auth init所有人终端出二维码企业微信扫码即可手动接入wecom-cli auth init --manual服务器等无扫码条件的环境凭证加密存储在本机AES-256-GCM见 crates/wecom-cli/src/auth/只需配置一次。auth show --status只输出authorized/unauthorized单行方便脚本判断。核心功能一览12 大企业微信品类全覆盖wecom-cli 覆盖企业微信核心业务wecom-cli --help可查看你当前账号实际可用的品类品类能做什么 消息向单聊/群聊推送 Markdown、图片、文件、语音、视频 邮件发送、回复、转发、搜索、查看邮件详情 文档在线文档新建、导入、读取、追加与覆盖写入 表格在线表格新建/导入/读写智能表格子表、字段、记录、视图、图表管理✅ 待办创建、分派、完成、删除待办 日程日程增删改查、闲忙查询、会议室预订 会议创建/取消会议、查询详情、读取纪要与转写原文 微盘文件搜索、上传、下载 通讯录按姓名/拼音/别名搜索成员获取部门与职务信息完整命令参考见 docs/cli-reference.mdSkills 全部分工见 docs/skills.md。日常使用最常用的 6 类命令1. 随时查看帮助新手第一招wecom-cli --help # 列出所有品类 wecom-cli message --help # 列出 message 下的所有工具 wecom-cli message aibot sessions list --help # 查看某命令需要哪些参数服务目录是服务端动态下发的帮助内容始终与实际能力同步不用背命令。2. 发消息先查会话再推送内容# 查看机器人最近对话过的单聊/群聊 wecom-cli message aibot sessions list # 用返回的会话 ID 发送一条 Markdown 消息--json 直接给请求体 wecom-cli message aibot messages send --json {chat_id:...,msgtype:markdown,markdown:{content:**周报**已生成 }}3. 搜索与读取文档# 搜索周报相关文档 wecom-cli doc search --json {keywords:[周报],limit:10}4. 三个万能执行 flagFlag作用典型场景--dry-run只校验并打印将发送的请求不实际调用先预览再执行避免误操作--page-count n游标式自动分页最多拉 n 页NDJSON 输出批量拉取列表--output file响应体写入文件大结果落盘5. 让 AI Agent 替你干活这是 wecom-cli 最有特色的部分。安装 Skills 后任何支持 Agent Skills 的 AI 助手都能按标准流程操作企业微信。内置 15 个 Skill每个都带完整的SKILL.md工作流说明例如wecomcli-calendar建日程、查忙闲、订会议室wecomcli-email搜索邮件、读取正文与附件wecomcli-smartsheet管理智能表格数据与视图附带 20 行业模板见 skills/wecomcli-smartsheet/assets/templates/wecomcli-pptx从素材直接生成在线 PPTwecomcli-shared所有业务 Skill 的公共前置检查安装、版本、授权对 Agent 说一句帮我给上周的会议建个跟进待办它会自动完成查会议 → 查通讯录 → 创建待办的全流程。6. 调试与集成利器wecom-cli schema list # 列出所有服务及方法 schema wecom-cli schema get doc.search # 获取指定方法的 schema wecom-cli cache status # 查看服务发现缓存状态需要自定义接入点时可通过WECOM_CLI_ACCESS_TOKEN、WECOM_CLI_LOG_LEVEL等环境变量控制行为完整清单见 docs/cli-reference.md 的「环境变量」一节。安全设计你的凭证与文件有多安全凭证加密auth init后凭证以 AES-256-GCM 加密存于~/.config/wecom/credentials.enc0600 权限密钥优先存系统 keyring文件沙箱文件读写限制在当前工作目录与系统临时目录内凭据目录如.ssh、.env、.git一律拒绝相关策略见 crates/wecom-fs/src/sandbox/结构化错误错误以 JSON 输出到 stdout日志走 stderr脚本解析不脏乱退出码0/1/2语义清晰数据收集透明默认仅回传 Agent 程序名与调用链路用于问题定位从源码构建时可一键关闭详见 docs/data-collection.md常见问题 FAQQ提示unauthorized怎么办执行wecom-cli auth init重新扫码授权再wecom-cli auth show --status确认输出authorized。Q命令找不到 / 版本号不对先跑wecom-cli --version确认 ≥ 1.2.1不满足则重新npm install -g wecom/cli。Q能在没有浏览器的服务器上部署吗可以。使用wecom-cli auth init --manual手动输入 Bot ID 和 Secret或用--noninteractive配合--output-qrcode把二维码导出成 PNG 拿过去扫。Q输出怎么接入自己的脚本默认 stdout 是紧凑 JSON配合--output落文件或 shell 重定向即可批量列表用--page-count得到 NDJSON每行一页。进阶源码结构速览面向开发者wecom-cli 是 Rust Cargo workspace核心代码分四个 crate详见 docs/development.md路径职责crates/wecom/核心库客户端、服务发现、schema 指令解析、媒体上传等crates/wecom-cli/可执行入口auth 鉴权体系、配置、日志crates/wecom-transport/传输层HTTP 后端、长任务轮询、请求/响应信封crates/wecom-fs/文件系统与沙箱策略本地开发只需cargo check --workspace/cargo test --workspace即可全量检查与测试端到端测试规范见 docs/e2e/FRAMEWORK.md。总结wecom-cli 用一条npm install -g wecom/cli就把企业微信搬进了终端✅ 安装只需 3 步凭证扫码一次配置终身受用✅ 消息、邮件、文档、日程、会议、待办、微盘、通讯录12 大品类命令全覆盖✅ 内置 15 个 Agent Skills让 AI 助手直接成为你的企业微信操作手✅ 沙箱、加密、结构化错误等安全设计开箱即用无论是想给办公流程提效的个人还是希望让 AI Agent 接管重复办公任务的团队wecom-cli 都是目前终端操作企业微信的最短路径。现在打开终端输入wecom-cli --help开始你的第一次调用吧 【免费下载链接】wecom-cli企业微信开放平台命令行工具 — 让人类和 AI Agent 都能在终端中操作企业微信项目地址: https://gitcode.com/gh_mirrors/we/wecom-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
