企业微信 CLI 接入 AI Agent 实践
企业微信已支持 CLI 开源,将消息、日程、文档、智能表格、会议、待办、通讯录等核心能力开放给主流 AI Agent 调用。AI 不再仅能回答问题,还可执行查成员、发消息、建待办、拉会议、读写文档等操作。
架构方案
建议采用以下链路:
- 企业微信 CLI Skill:负责把企业微信能力变成可调用工具。
- OpenClaw:负责本地统一网关,让 AI 请求走同一入口。
- 88API:提供 Claude / GPT / Gemini 等多模型能力,一个 Key 可统一切换。
工作链路如下:
AI Agent / 客户端 -> OpenClaw 本地网关 -> 88API -> Claude / GPT / Gemini -> 企业微信 CLI Skills -> 消息 / 日程 / 文档 / 待办 / 会议 / 通讯录
企业微信支持的 Skills
1. 消息与通讯录
wecom-msg:会话列表、消息记录、媒体下载、文本发送wecom-contact-lookup:通讯录成员查询,支持按姓名或别名搜索
2. 待办与日程
wecom-get-todo-list:待办列表查询,支持时间过滤和分页wecom-get-todo-detail:待办详情批量查询wecom-edit-todo:待办创建、更新、删除和状态变更wecom-schedule:日程 CRUD、参与人管理、闲忙查询
3. 会议能力
wecom-meeting-create:创建预约会议wecom-meeting-manage:取消会议、更新受邀成员wecom-meeting-query:查询会议列表和详情
4. 文档与智能表格
wecom-doc-manager:文档创建、读取、编辑wecom-smartsheet-schema:智能表格子表与字段管理wecom-smartsheet-data:智能表格记录增删改查
5. 基础检查与增强能力
wecom-preflight:前置条件检查,确保权限与配置正确wecom-send-media:发送本地文件wecom-send-template-card:发送结构化模板卡片消息
实施步骤
第一步:配置模型通道
准备以下参数:
- API Base URL:
https://api.88api.shop - API Key:在 88API 控制台创建
第二步:安装 OpenClaw 网关
1)检查 Node.js 环境
node -v
npm -v
通常 Node.js 18 及以上即可。
2)安装 OpenClaw
npm install -g openclaw@latest openclaw --version
输出版本号表示安装成功。
3)执行初始化
openclaw onboard
按提示完成引导配置,确保本地网关运行。
4)启动本地 Gateway
openclaw gateway --port 18789
启动后,本地网关地址为:
http://127.0.0.1:18789/v1
模型请求统一走本地入口。
第三步:验证链路连通性
使用 OpenAI 兼容 SDK 测试。例如 Python:
from openai import OpenAI
client = OpenAI(
api_key="your-88api-key",
base_url="http://127.0.0.1:18789/v1"
)
response = client.chat.completions.create(
model="claude-opus-4-6",
messages=[
{"role": "user", "content": "你好,请介绍一下你自己。"}
]
)
print(response.choices[0].message.content)
返回内容表示链路通畅:
你的客户端 -> OpenClaw -> 88API -> 模型
建议先打通模型链路,再接入企业微信 Skill,便于排错。
第四步:安装企业微信 CLI 与 Skill
1)准备企业微信机器人凭证
参考企业微信官方指引创建支持 CLI 的机器人:
- 登录企业微信
- 进入工作台
- 找到「智能机器人」
- 选择「手动创建」
- 创建时选择 API 模式
- 连接方式选择 使用长连接
- 保存生成的 Bot ID 和 Secret
- 配置可见成员并完成权限授权 此为 Skill 调用的前提。
2)安装企业微信 CLI
npm install -g @wecom/cli
3)安装企业微信 Skill 包
npx skills add WeComTeam/wecom-cli -y -g
Skill 包是 Agent 调用企业微信能力的桥梁。
4)初始化机器人凭证
wecom-cli init --botId "YOUR_BOT_ID" --secret "YOUR_BOT_SECRET"
仅需配置一次。
5)查看支持的能力
wecom-cli --help
wecom-cli list contact
6)调用一个测试能力
例如查询通讯录:
wecom-cli call contact get_userlist '{}'
返回正常结果表示链路通畅:
企业微信 CLI / Skills -> 企业微信能力
第五步:接入 Agent 工作流
此时两部分能力已分别就绪:
- 模型侧:Agent / 客户端 -> OpenClaw -> 88API -> Claude / GPT / Gemini
- 工具侧:Agent -> wecom-cli skills -> 企业微信消息 / 日程 / 文档 / 待办 / 会议 / 通讯录
组合后可形成本地 Agent 形态:
- 用 Claude 来理解需求、判断上下文、生成决策
- 用 企业微信 Skill 去执行具体动作
- 用 OpenClaw + 88API 保持模型接入稳定、可切换、可扩展
典型场景包括:
- 查人并发消息:帮我找到产品部张三,并发一条消息提醒他下午 3 点开会。
- 查闲忙并创建日程:看一下明天下午谁有空,给项目组拉个 30 分钟同步会。
- 把会议结论写入文档:把今天例会纪要整理成文档,并同步到对应群里。
- 自动生成待办:根据这段需求讨论,给负责人创建 3 个待办,并拉上相关参与人。
该链路价值在于连接模型与企业协作动作,实现了模型能力与企业协作动作的连接。
架构优势
契合 Agent 落地关键点:
- 模型能力要能切:不同任务适合不同模型。本地统一入口不变,底层模型可灵活调整。
- 工具能力要够真实:提升效率的关键在于 AI 执行任务的能力。企业微信 CLI 为标准接入方式。
- 本地入口要统一:统一网关有助于管理多模型与技能。OpenClaw 统一模型入口,Skill 标准化工具调用,扩展性强。
最小可用配置步骤
可按以下顺序操作:
- 先跑通 88API + OpenClaw,确认本地网关可用。
- 安装企业微信 CLI + Skill 包,确认基础命令可调用。
- 测试简单业务动作:查通讯录、发一条消息、新建一个待办。
- 组合调用 Agent:先理解需求,再调用企业微信 Skill 执行动作。 此方案稳定且易排障。


