WeComオープンソースCLI:AI Agentがメッセージ・スケジュール・ドキュメントを直接操作
WeComがwecom-cliをオープンソース化。Claude Code、Codex、QClawなど主要AI Agentから7大カテゴリのオフィス機能を呼び出せ、3ステップで接続完了。完全なコマンド例を収録します。


WeComオープンソースCLI:AI Agentがメッセージ・スケジュール・ドキュメントを直接操作
WeComがwecom-cliをオープンソース化。Claude Code、Codex、QClawなど主要AI Agentから7大カテゴリのオフィス機能を呼び出せ、3ステップで接続完了。完全なコマンド例を収録します。
WeComは2026年3月30日、wecom-cliを正式にオープンソース化しました。AI Agentはコマンドラインから、WeComのメッセージ、スケジュール、ドキュメント、会議、ToDo、連絡先、スマートシートといった7大カテゴリのオフィス機能を直接呼び出せるようになります。プロジェクトはGitHubに公開済みで、Claude Code、Codex、Work Buddy、QClawなど主要Agentツールからの接続をサポートしています。
GitHubリポジトリ:https://github.com/WecomTeam/wecom-cli
始める前の準備
- WeCom管理者アカウント(ボットの作成に使用。Bot IDとSecretの取得に必要)
- Node.js環境(npmが使えればOK)
- 想定接続時間:10分以内
- 現時点では10人以下のチームを優先サポート
3ステップで接続完了
第一段階:WeCom管理画面でボットを作成
WeCom管理画面にログインし、ボットアプリを作成して Bot ID と Secret を記録します。あとの初期化で使います。
第二段階:CLIとSkillをインストール
# 安装 CLI
npm install -g @wecom/cli
# 安装 CLI Skill(必需,供 Agent 识别能力清单)
npx skills add WeComTeam/wecom-cli -y -g第三段階:初期化して認証情報を書き込む
wecom-cli init対話形式でBot IDとSecretを入力すると、認証情報は暗号化されてローカルに保存されます。
~/.config/wecom/bot.enc初期化が完了したら、正しく呼び出せるか検証しましょう。
wecom-cli contact get_userlist '{}'メンバーリストが返ってくれば接続成功です。
コマンド構造
全体の構造は統一されています:wecom-cli <カテゴリ> <ツール名> [json_args]
# 查看所有一级命令
wecom-cli --help
# 查看某品类下有哪些工具
wecom-cli todo
wecom-cli meeting7大カテゴリの能力とよく使うコマンド
連絡先
# 获取全量可见成员
wecom-cli contact get_userlist '{}'対応Skill:wecomcli-lookup-contact。あとのメッセージ送信、会議招待、スケジュールへの参加者追加に使えます。
ToDo
# 查询待办列表
wecom-cli todo get_todo_list '{}'
# 创建待办(含提醒时间)
wecom-cli todo create_todo '{"content": "完成 Q2 规划文档", "remind_time": "2026-06-01 09:00:00"}'
# 标记待办完成
wecom-cli todo update_todo '{"todo_id": "TODO_ID", "todo_status": 0}'
# 删除待办
wecom-cli todo delete_todo '{"todo_id": "TODO_ID"}'対応Skills:wecomcli-get-todo-list、wecomcli-get-todo-detail、wecomcli-edit-todo
会議
# 查询本周会议
wecom-cli meeting list_user_meetings '{"begin_datetime": "2026-03-23 00:00", "end_datetime": "2026-03-29 23:59", "limit": 100}'
# 创建预约会议
wecom-cli meeting create_meeting '{"title": "技术方案评审", "meeting_start_datetime": "2026-03-30 15:00", "meeting_duration": 3600, "invitees": {"userid": ["zhangsan"]}}'
# 取消会议
wecom-cli meeting cancel_meeting '{"meetingid": "MEETING_ID"}'対応Skills:wecomcli-get-meeting-list、wecomcli-manage-meeting
メッセージ
# 获取会话列表
wecom-cli msg get_conversation_list '{}'
# 拉取指定会话消息
wecom-cli msg get_msg_history '{"conversation_id": "CONV_ID", "limit": 20}'
# 发送文本消息
wecom-cli msg send_text '{"conversation_id": "CONV_ID", "content": "会议纪要已整理完毕"}'対応Skills:wecomcli-get-message、wecomcli-send-message
スケジュール
# 查询日程列表
wecom-cli schedule get_schedule_list '{"begin_time": "2026-03-30 00:00", "end_time": "2026-03-30 23:59"}'
# 创建日程
wecom-cli schedule add_schedule '{"summary": "周会", "start_time": "2026-03-30 10:00", "end_time": "2026-03-30 11:00"}'
# 查询成员空闲时间
wecom-cli schedule get_user_availability '{"userids": ["zhangsan", "lisi"], "time_min": "2026-03-30 09:00", "time_max": "2026-03-30 18:00"}'対応Skills:wecomcli-manage-schedule
ドキュメント
# 创建文档
wecom-cli doc create_doc '{"doc_type": 2, "doc_name": "Q2 规划"}'
# 读取文档内容(异步,先获取 task_id)
wecom-cli doc get_doc_content '{"docid": "DOC_ID", "type": 2}'
# 编辑文档
wecom-cli doc edit_doc_content '{"docid": "DOC_ID", "content": "# 标题\n\n正文内容", "content_type": 1}'対応Skill:wecomcli-manage-doc
スマートシート
# 创建智能表格
wecom-cli doc create_doc '{"doc_type": 10, "doc_name": "任务跟踪表"}'
# 查询子表字段
wecom-cli doc smartsheet_get_fields '{"docid": "DOC_ID", "sheet_id": "SHEET_ID"}'
# 添加记录
wecom-cli doc smartsheet_add_records '{"docid": "DOC_ID", "sheet_id": "SHEET_ID", "records": [{"values": {"标题": [{"type": "text", "text": "新任务"}]}}]}'
# 更新记录
wecom-cli doc smartsheet_update_records '{"docid": "DOC_ID", "sheet_id": "SHEET_ID", "key_type": "CELL_VALUE_KEY_TYPE_FIELD_TITLE", "records": [{"record_id": "RECORD_ID", "values": {"标题": [{"type": "text", "text": "已更新"}]}}]}'
# 删除记录
wecom-cli doc smartsheet_delete_records '{"docid": "DOC_ID", "sheet_id": "SHEET_ID", "record_ids": ["RECORD_ID"]}'対応Skills:wecomcli-manage-smartsheet-schema、wecomcli-manage-smartsheet-data
典型的な自動化シーン
以下は、そのままAgentに任せられる複数ステップフローの例です。
会議議事録の自動化:会議メッセージの履歴を取得 → 議事録を生成 → WeComドキュメントに書き込み → 議事録からAction Itemを抽出 → リマインダー付きToDoを作成 → 関係者にメッセージで通知
スケジュール衝突の検出:複数人の空き時間を照会 → 共通して使える時間帯を特定 → 会議を自動予約して招待を送信
プロジェクト進捗の同期:スマートシート内のタスクステータスを読み取り → 進捗を集計 → 週報ドキュメントを生成 → 指定グループへ送信
MCPとの関係
wecom-cliとMCPは排他的な関係にありません。CLIはターミナルにアクセスできるAgent環境(Claude Code、Codex)での使用に適しており、軽量でコンテキストを占有しません。MCPはターミナルにアクセスできない環境(Claude Desktop)に適しています。Agentの実行環境に応じて両者を使い分けられます。
12個の事前パッケージ済みSkillsの設計により、Claude Code、Codex、QClawなどのツールは追加設定なしでこれらの能力を認識し、呼び出せます。
