1. 為什么要在 Ubuntu 上用微信遙控 OpenClawOpenClaw 是一個(gè)能在本機(jī)執(zhí)行命令、讀寫(xiě)文件、跑自動(dòng)化腳本的智能體框架而微信幾乎是我們每天打開(kāi)次數(shù)最多的 App。把這兩者接起來(lái)等于給電腦裝了一個(gè)隨身遙控器你在外面發(fā)一句「幫我看看服務(wù)器內(nèi)存」家里的 Ubuntu 機(jī)器就真的去執(zhí)行free -h并把結(jié)果回給你。整個(gè)過(guò)程不需要你寫(xiě)一行業(yè)務(wù)代碼核心工作只有兩件——把 OpenClaw 跑起來(lái)把微信入口和模型鑒權(quán)打通。這篇教程聚焦 Ubuntu 環(huán)境用 npm 全局安裝 OpenClaw再通過(guò) ClawBot 插件把微信變成消息入口最后用 TaoToken 的統(tǒng)一 Key 和 API 通道解決 ClawBot 與模型服務(wù)之間的鑒權(quán)配置問(wèn)題。適合誰(shuí)有臺(tái)常開(kāi)的 Ubuntu 機(jī)器云主機(jī)或家里的小主機(jī)都行、會(huì)用終端敲命令、想讓微信直接指揮電腦干活的同學(xué)。全程零代碼配置骨架我會(huì)直接給你可復(fù)制的config.toml和settings.json照著填就能跑。需要提前說(shuō)清楚一個(gè)概念OpenClaw 本身不生產(chǎn)模型能力它是個(gè)「調(diào)度中樞」真正干活的是背后的大模型。所以鏈路是「微信 → ClawBot 橋接 → OpenClaw → 模型 API」。這條鏈路里最容易翻車的就是最后一跳的鑒權(quán)也就是模型服務(wù)認(rèn)不認(rèn)你的 Key。下面我會(huì)把這一跳單獨(dú)拆開(kāi)講。2. 前置準(zhǔn)備Ubuntu 環(huán)境與 TaoToken 統(tǒng)一 Key2.1 基礎(chǔ)環(huán)境檢查先確認(rèn)你的 Ubuntu 版本和 Node 環(huán)境。OpenClaw 走 npm 分發(fā)Node 版本太低會(huì)在安裝階段就報(bào)錯(cuò)。我實(shí)測(cè)下來(lái) Node 20 LTS 最穩(wěn)。# 查看系統(tǒng)版本 lsb_release -a # 查看 Node 與 npm 版本建議 Node 20 node -v npm -v如果 Node 版本低于 18先升級(jí)。用 nvm 管理最省心curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 20 nvm use 202.2 全局安裝 OpenClawnpm install -g openclawlatest # 驗(yàn)證安裝 openclaw --version看到版本號(hào)輸出就說(shuō)明裝好了。如果提示command not found多半是 npm 全局 bin 目錄沒(méi)進(jìn) PATH執(zhí)行npm config get prefix看看路徑再把它加到~/.bashrc里。2.3 為什么用 TaoToken 統(tǒng)一 KeyClawBot 橋接層和 OpenClaw 主進(jìn)程都要訪問(wèn)模型服務(wù)如果各自配一套 Key改起來(lái)很痛苦。TaoToken 提供統(tǒng)一的 API 通道一個(gè) Key 就能覆蓋對(duì)話、編碼等多種模型調(diào)用場(chǎng)景配置時(shí)只需要維護(hù)一處鑒權(quán)信息。對(duì)小白來(lái)說(shuō)最大的好處是不用去研究各家模型服務(wù)商的鑒權(quán)差異填一個(gè)地址加一個(gè) Key 就完事。先去控制臺(tái)把 Key 建出來(lái)地址是 https://taotoken.net/api-keys 登錄后新建一個(gè) Key 并復(fù)制保存。API 基礎(chǔ)地址統(tǒng)一用 https://taotoken.net/api 注意這個(gè)地址后面不加任何多余路徑OpenClaw 會(huì)自己拼接。注意Key 只在創(chuàng)建時(shí)完整顯示一次務(wù)必先存到安全的地方。不要把它提交到 Git 倉(cāng)庫(kù)也不要在截圖里露出。3. 可復(fù)制配置config.toml 與 settings.json 骨架OpenClaw 的配置分兩層主進(jìn)程讀config.tomlClawBot 橋接插件讀settings.json。兩個(gè)文件都要指向 TaoToken 的通道這樣鑒權(quán)才一致。3.1 主進(jìn)程 config.toml配置文件默認(rèn)放在~/.openclaw/config.toml沒(méi)有就手動(dòng)建mkdir -p ~/.openclaw nano ~/.openclaw/config.toml把下面這份骨架粘進(jìn)去把a(bǔ)pi_key換成你自己的# OpenClaw 主配置 [server] host 127.0.0.1 port 8787 [model] # 統(tǒng)一走 TaoToken 通道 provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密鑰 model claude-sonnet-4-20250514 timeout 120 [agent] # 允許執(zhí)行本地命令微信指令會(huì)走這里 allow_shell true work_dir /home/你的用戶名 max_steps 15 [log] level info file /home/你的用戶名/.openclaw/openclaw.log幾個(gè)參數(shù)說(shuō)明一下。base_url必須是https://taotoken.net/api不要自己加/v1之類的后綴兼容層會(huì)處理。allow_shell打開(kāi)后微信發(fā)來(lái)的指令才能落到終端執(zhí)行如果你只想讓它讀文件可以設(shè)成 false。max_steps控制單次任務(wù)最多執(zhí)行多少步防止一個(gè)指令觸發(fā)無(wú)限循環(huán)。3.2 ClawBot 橋接 settings.json橋接插件單獨(dú)讀自己的配置路徑在~/.openclaw/plugins/weixin/settings.jsonmkdir -p ~/.openclaw/plugins/weixin nano ~/.openclaw/plugins/weixin/settings.json內(nèi)容如下{ bridge: { enabled: true, listen_port: 8790, openclaw_endpoint: http://127.0.0.1:8787 }, auth: { provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密鑰, model: claude-sonnet-4-20250514 }, wechat: { bot_name: ClawBot, reply_timeout: 90, allow_groups: false } }這里auth段和主配置保持一致都用同一個(gè) TaoToken Key。openclaw_endpoint指向主進(jìn)程的 8787 端口橋接層收到微信消息后轉(zhuǎn)發(fā)給它。allow_groups建議先設(shè) false只允許私聊避免群里誤觸發(fā)。提示兩個(gè)文件里的 Key 必須相同否則會(huì)出現(xiàn)「主進(jìn)程能跑、微信沒(méi)反應(yīng)」的詭異現(xiàn)象這是最常見(jiàn)的鑒權(quán)不一致問(wèn)題。4. 部署 ClawBot 橋接并驗(yàn)證消息回環(huán)4.1 安裝微信橋接套件配置寫(xiě)好后用官方 CLI 一鍵安裝并初始化橋接套件npx -y tencent-weixin/openclaw-weixin-clilatest install這條命令會(huì)自動(dòng)拉取橋接依賴、讀取你剛才寫(xiě)的settings.json并注冊(cè)到 OpenClaw 的插件目錄。執(zhí)行完看到plugin registered: weixin就對(duì)了。4.2 啟動(dòng) OpenClaw 主進(jìn)程openclaw start前臺(tái)啟動(dòng)方便看日志。確認(rèn)輸出里有server listening on 127.0.0.1:8787和plugin weixin loaded。如果插件沒(méi)加載檢查settings.json的 JSON 格式多一個(gè)逗號(hào)都會(huì)導(dǎo)致解析失敗。4.3 掃碼綁定微信橋接啟動(dòng)后終端會(huì)輸出一個(gè)字符二維碼。打開(kāi)微信依次進(jìn)入「我 → 設(shè)置 → 插件」找到 ClawBot 卡片紅色龍蝦圖標(biāo)點(diǎn)進(jìn)去按提示掃描終端二維碼手機(jī)端確認(rèn)授權(quán)。成功標(biāo)志有兩個(gè)終端顯示Successfully bound to WeChat: 你的昵稱同時(shí)微信通訊錄里出現(xiàn)一個(gè)叫 ClawBot 的聯(lián)系人。4.4 驗(yàn)證請(qǐng)求發(fā)第一條遠(yuǎn)程指令在微信 ClawBot 對(duì)話框里發(fā)送你好請(qǐng)告訴我當(dāng)前系統(tǒng)的運(yùn)行內(nèi)存占用情況。正常情況下幾秒后你會(huì)收到類似這樣的回復(fù)當(dāng)前內(nèi)存總 15.6 GiB已用 4.2 GiB可用 11.4 GiB占用約 27%。這說(shuō)明「微信 → 橋接 → OpenClaw → TaoToken 通道 → 模型 → 回傳」整條鏈路通了。如果想讓驗(yàn)證更直觀可以再發(fā)一條「在 /tmp 下創(chuàng)建一個(gè) test.txt 并寫(xiě)入 hello」然后去 Ubuntu 上cat /tmp/test.txt確認(rèn)文件真的生成了。5. 本篇常見(jiàn)錯(cuò)排查清單接入過(guò)程里報(bào)錯(cuò)基本集中在鑒權(quán)和端口兩類下面按現(xiàn)象給排查動(dòng)作。5.1 微信發(fā)消息沒(méi)反應(yīng)先看主進(jìn)程日志~/.openclaw/openclaw.log。如果日志里出現(xiàn)401 Unauthorized或invalid api key說(shuō)明 TaoToken Key 填錯(cuò)了或者兩個(gè)配置文件不一致。核對(duì)config.toml和settings.json里的api_key是否完全相同注意別把首尾空格帶進(jìn)去。如果日志里根本沒(méi)有收到請(qǐng)求那是橋接層沒(méi)轉(zhuǎn)發(fā)成功。檢查settings.json里的openclaw_endpoint是不是http://127.0.0.1:8787以及主進(jìn)程是否真的在監(jiān)聽(tīng)這個(gè)端口ss -tlnp | grep 87875.2 報(bào)錯(cuò) model not found這是模型名寫(xiě)錯(cuò)了。model字段要填 TaoToken 通道支持的模型標(biāo)識(shí)別自己編。如果拿不準(zhǔn)先去模型對(duì)話頁(yè)面確認(rèn)可用模型列表地址是 https://taotoken.net/models 把頁(yè)面上顯示的模型名原樣填進(jìn)配置。5.3 橋接插件加載失敗現(xiàn)象是啟動(dòng)時(shí)提示plugin weixin not found。多半是settings.json格式錯(cuò)誤。用下面這條命令校驗(yàn) JSONpython3 -m json.tool ~/.openclaw/plugins/weixin/settings.json能正常輸出格式化內(nèi)容就說(shuō)明格式?jīng)]問(wèn)題報(bào)錯(cuò)就按提示的行號(hào)去改。5.4 指令執(zhí)行超時(shí)微信側(cè)等了很久沒(méi)回復(fù)日志里顯示timeout。把config.toml里的timeout從 120 調(diào)大到 180同時(shí)把max_steps降到 10 以內(nèi)。復(fù)雜任務(wù)拆成幾條簡(jiǎn)單指令發(fā)比一條長(zhǎng)指令更穩(wěn)。5.5 端口被占用啟動(dòng)報(bào)address already in use說(shuō)明 8787 或 8790 被別的進(jìn)程占了。查一下是誰(shuí)lsof -i :8787要么殺掉占用進(jìn)程要么把配置里的端口改成 8887、8890 這類不沖突的。6. 長(zhǎng)期編碼與 Agent 場(chǎng)景的通道選擇如果你只是偶爾用微信查個(gè)內(nèi)存、建個(gè)文件上面這套配置就夠了。但如果你打算把 OpenClaw 當(dāng)成長(zhǎng)期的編碼助手或自動(dòng)化 Agent頻繁跑多步任務(wù)那按量計(jì)費(fèi)的通道在成本上不太劃算。這種場(chǎng)景更適合用 Coding Plan 這類包月方案配合 OpenClaw 的 Agent 模式跑長(zhǎng)任務(wù)不用擔(dān)心每一步都產(chǎn)生調(diào)用費(fèi)用。配置方式不變還是同一個(gè) API 地址只是把 Key 換成 Coding Plan 對(duì)應(yīng)的憑證。切換后config.toml和settings.json里的base_url保持https://taotoken.net/api不動(dòng)只改api_key即可。想了解具體方案可以去 https://taotoken.net/coding-plan 看說(shuō)明。最后留一個(gè)我踩過(guò)的坑改完配置一定要重啟 OpenClaw 主進(jìn)程橋接插件不會(huì)熱加載settings.json。很多人改完 Key 發(fā)現(xiàn)沒(méi)生效就是因?yàn)橹恢貑⒘藰蚪記](méi)重啟主進(jìn)程。養(yǎng)成「改配置 →openclaw stop→openclaw start」的習(xí)慣能省掉一大半莫名其妙的排查時(shí)間。