1. 企微自建應用接入 OpenClaw 后到底能不能給其他成員發(fā)消息先把結論說清楚能但發(fā)消息這件事不是 OpenClaw 直接干的而是你那個企微自建應用干的。OpenClaw 只是幫你把后端邏輯寫出來、把請求發(fā)出去真正落到同事手機上的那條消息走的是企業(yè)微信的「應用消息」接口。所以整條鏈路能不能通取決于三件事應用可見范圍有沒有覆蓋到目標成員、應用有沒有拿到發(fā)消息的接口權限、以及調(diào)用時的 access_token 是不是有效。我一開始也以為把 CorpID 和 Secret 丟給 OpenClaw 就完事了結果第一次調(diào)用直接返回 60020not allow to access from your ip第二次返回 81013user not exist折騰了半天才明白企微的權限是分層的企業(yè)級、應用級、成員級各管一段任何一層沒配對消息就發(fā)不出去。這篇就按「先核對權限再走 TaoToken 統(tǒng)一 Key 通道完成鑒權最后逐條驗證」的順序寫。適合兩類人一是已經(jīng)建好企微自建應用、想用 OpenClaw 自動發(fā)通知的開發(fā)者二是手里有 OpenClaw 但不確定企微這邊要開哪些開關的同學。核心檢索詞就是企微自建應用發(fā)消息、OpenClaw 接入企業(yè)微信、TaoToken 統(tǒng)一 Key 通道這幾個下面會反復落到具體配置上。需要提前說明的是企微的接口權限和可見范圍是在管理后臺配的OpenClaw 改不了這部分它只能改后端調(diào)用邏輯。所以別指望給 OpenClaw 發(fā)一句「幫我給張三發(fā)消息」就自動生效前置的授權動作必須人工在后臺點完。2. 接入前必須核對的企微權限與 TaoToken 統(tǒng)一 Key 通道準備2.1 企微側要拿到的三樣東西進入企微管理后臺work.weixin.qq.com用管理員賬號操作。第一樣是企業(yè) IDCorpID在「我的企業(yè)」→「企業(yè)信息」最下面形如wwxxxxxxxxxxxxxxxx。第二樣是自建應用的 AgentId 和 Secret在「應用管理」→「自建」→ 點進你的應用AgentId 是純數(shù)字Secret 點「查看」會發(fā)到管理員企微上。第三樣最關鍵應用可見范圍。在應用詳情頁的「可見范圍」里必須把要接收消息的同事加進去否則接口會報 81013。這里有個容易忽略的點可見范圍分「部門」和「成員」兩種添加方式如果你只加了部門但同事不在該部門照樣發(fā)不到。我試過把整個「研發(fā)部」加進去結果新入職還沒分配部門的同事收不到后來單獨把他加進成員列表才行。2.2 消息接口權限確認自建應用默認有「發(fā)送應用消息」的權限但如果你要用更細的能力比如發(fā)給外部聯(lián)系人、發(fā)到群機器人需要在「應用管理」里單獨申請。普通給內(nèi)部成員發(fā)文本、圖文、markdown 卡片用message/send接口就夠不需要額外申請。接口地址是https://qyapi.weixin.qq.com/cgi-bin/message/send?access_tokenACCESS_TOKEN2.3 TaoToken 統(tǒng)一 Key 通道的作用OpenClaw 在調(diào)用企微接口前需要先拿到 access_token。企微的 access_token 有效期 7200 秒且同一應用多次獲取會互相頂?shù)糇约簩懢彺孢壿嬋菀壮霾l(fā)問題。TaoToken 的統(tǒng)一 Key 通道在這里的價值是把模型調(diào)用和企微接口調(diào)用的鑒權收斂到一套 Key 管理里OpenClaw 側只需要配一次 Base URL 和 Key不用在代碼里硬編碼企微 Secret。TaoToken 的 API 入口是https://taotoken.net/api控制臺在https://taotoken.net/consoleAPI Keys 管理在https://taotoken.net/api-keys。你可以在控制臺建一個專用 Key給 OpenClaw 用權限范圍只開需要的模型和接口避免一個 Key 泄露影響全部業(yè)務。注意TaoToken 是統(tǒng)一 Key 通道不是企微的替代品。企微的 CorpID、Secret、AgentId 仍然要在企微后臺拿TaoToken 負責的是 OpenClaw 調(diào)用時的鑒權收斂。3. 可復制的企微應用配置片段與 OpenClaw 側請求示例3.1 企微應用配置片段JSON把下面這段存成wecom-app.json放在 OpenClaw 能讀到的配置目錄里。路徑按你的實際項目改我這邊放在~/.openclaw/config/wecom-app.json{ corp_id: wwxxxxxxxxxxxxxxxx, agent_id: 1000002, secret: 你的應用Secret, visible_members: [zhangsan, lisi], visible_departments: [1, 2], api_base: https://qyapi.weixin.qq.com/cgi-bin, token_cache_ttl: 7000 }visible_members和visible_departments只是給你自己核對用的實際權限以企微后臺為準。token_cache_ttl設 7000 秒比 7200 少 200 秒留出刷新緩沖。3.2 TaoToken 側配置TOMLOpenClaw 如果支持 TOML 配置可以這樣寫~/.openclaw/config/taotoken.toml[taotoken] base_url https://taotoken.net/api api_key sk-你的TaoTokenKey default_model claude-sonnet-4-20250514 [taotoken.wecom] enabled true corp_id wwxxxxxxxxxxxxxxxx agent_id 1000002Base URL、Key、Model ID 三件套在這里齊了。如果你用的是 Claude Code 或 Cline 這類工具配置項名稱可能不同但核心就是這三樣。3.3 OpenClaw 側發(fā)消息請求示例下面是一段 Python 示例OpenClaw 生成后端邏輯時可以直接用。先拿 access_token再發(fā)消息import requests import json CORP_ID wwxxxxxxxxxxxxxxxx SECRET 你的應用Secret AGENT_ID 1000002 def get_access_token(): url fhttps://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid{CORP_ID}corpsecret{SECRET} resp requests.get(url, timeout10) data resp.json() if data.get(errcode) ! 0: raise RuntimeError(fgettoken failed: {data}) return data[access_token] def send_text(to_user, content): token get_access_token() url fhttps://qyapi.weixin.qq.com/cgi-bin/message/send?access_token{token} payload { touser: to_user, msgtype: text, agentid: AGENT_ID, text: {content: content}, safe: 0 } resp requests.post(url, datajson.dumps(payload), timeout10) return resp.json() if __name__ __main__: print(send_text(zhangsan, 來自 OpenClaw 的測試消息))touser填企微賬號不是手機號是成員賬號多個用|分隔。agentid必須和你后臺的應用一致填錯會報 60011。3.4 用 TaoToken 統(tǒng)一 Key 調(diào)用模型生成消息內(nèi)容如果你想讓 OpenClaw 先調(diào)模型生成消息文案再發(fā)給同事可以這樣接import requests def gen_message(prompt): url https://taotoken.net/api/v1/chat/completions headers { Authorization: Bearer sk-你的TaoTokenKey, Content-Type: application/json } body { model: claude-sonnet-4-20250514, messages: [{role: user, content: prompt}] } resp requests.post(url, headersheaders, jsonbody, timeout30) return resp.json()[choices][0][message][content]這樣模型調(diào)用和企微發(fā)送走兩條通道但鑒權都收斂到 TaoToken 的 Key 上OpenClaw 側不用維護兩套密鑰。4. 逐條驗證請求與成功結果確認4.1 第一步驗證 access_token 能拿到先單獨跑get_access_token()成功返回類似{errcode:0,errmsg:ok,access_token:xxxxx,expires_in:7200}如果這里就失敗后面不用試了。常見錯誤 40001 是 Secret 填錯40013 是 CorpID 不對。4.2 第二步驗證應用可見范圍調(diào)message/send之前先用user/list接口確認目標成員在你的可見范圍內(nèi)https://qyapi.weixin.qq.com/cgi-bin/user/list?access_tokenTOKENdepartment_id1fetch_child1返回里能看到成員列表。如果目標同事不在說明可見范圍沒配好回后臺加。4.3 第三步發(fā)送測試消息跑send_text(zhangsan, 測試)成功返回{errcode:0,errmsg:ok,msgid:xxxxx}msgid有值就說明消息已經(jīng)投遞到企微服務器。同事那邊應該能收到來自你應用的消息卡片。4.4 第四步確認消息類型和展示文本消息最穩(wěn)markdown 消息在企微里會渲染成卡片但要注意markdown類型只支持部分語法。如果你發(fā)的是圖文articles數(shù)組里每項要有title、description、url、picurl。提示測試階段建議先發(fā)給自己確認鏈路通了再發(fā)給同事避免打擾。5. 本篇常見錯誤排查401、local proxy failed、reading choices、OAuth5.1 401 Unauthorized這個通常出現(xiàn)在調(diào) TaoToken 模型接口時Key 填錯或過期。檢查Authorization: Bearer sk-xxx里的 Key 是不是從https://taotoken.net/api-keys復制的完整值。如果 Key 沒問題看下 Base URL 是不是寫成了https://taotoken.net/api少寫/api會 404多寫斜杠可能 401。5.2 local proxy failedOpenClaw 如果配了本地代理轉發(fā)報這個錯說明代理進程沒起來或端口被占。檢查你的代理配置里base_url指向的本地端口用curl http://127.0.0.1:端口/health確認。如果是 Cline MCP 場景MCP server 沒啟動也會報類似錯誤重啟 MCP 進程即可。5.3 reading choices 報錯調(diào)模型接口返回reading choices說明響應體里沒有choices字段通常是返回了錯誤 JSON。打印完整響應看看常見原因是 model ID 寫錯比如把claude-sonnet-4-20250514寫成claude-sonnet-4。Model ID 必須和 TaoToken 控制臺里列出的完全一致。5.4 OAuth 相關報錯如果你用的是 Claude Code 接入報 OAuth 錯誤說明認證方式選錯了。Claude Code 應該用 API Key 方式不是 OAuth。在~/.claude/settings.json里配{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoTokenKey } }三件套 Base URL、Key、Model ID 都要對上。Codex 的話看~/.codex/auth.json里面OPENAI_API_KEY填 TaoToken 的 Keybase_url填https://taotoken.net/api。5.5 企微側錯誤碼對照錯誤碼含義處理60020IP 不在白名單后臺配可信 IP81013成員不存在檢查可見范圍60011agentid 無效核對 AgentId40001Secret 錯誤重新查看 Secret45009接口調(diào)用超限降低頻率6. 把 OpenClaw 發(fā)消息能力落到日常通知場景鏈路通了之后實際用法可以很靈活。比如讓 OpenClaw 監(jiān)聽某個事件觸發(fā)時先調(diào)模型生成一段通知文案再通過自建應用發(fā)給相關同事。我現(xiàn)在的做法是OpenClaw 里配一個定時任務每天下班前把當天構建結果匯總調(diào) TaoToken 的模型接口潤色成一段人話再走企微message/send發(fā)給項目組。如果你要長期跑這類編碼和 Agent 任務可以考慮 TaoToken 的 Coding Plan入口在https://taotoken.net/coding-plan適合需要穩(wěn)定調(diào)用模型做自動化的場景。只是臨時驗證模型效果的話用模型對話頁https://taotoken.net/chat就夠了。接入文檔在https://taotoken.net/docAPI Keys 在https://taotoken.net/api-keys排障時對著文檔核對參數(shù)最快。最后提醒一句企微的可見范圍和接口權限是動態(tài)的新同事入職、部門調(diào)整后都要重新核對別配一次就不管了。我踩過的坑就是部門重組后沒更新可見范圍消息靜默失敗了好幾天才發(fā)現(xiàn)。