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