1. 为什么我放弃了树莓派改用 Ubuntu 小主机跑 OpenClaw如果你也在搜「OpenClaw Ubuntu 部署」「OpenClaw 飞书接入」「OpenClaw 本地安装教程」那这篇就是写给你的。OpenClaw俗称“龙虾”曾用名 ClawdBot、Moltbot是一个开源、本地优先、能自主执行任务的 AI 智能体框架简单说就是让大模型真正“动手”操作你的设备——执行终端命令、读写文件、跑脚本、调 API从“对话 AI”变成“行动 AI”。它适合谁适合想私有化部署、数据不出本机、又希望用飞书/Telegram 等日常工具直接指挥机器人的个人开发者和折腾党。我一开始的打算是在树莓派 4B 上装2G 内存、16G 存储卡结果安装 OpenClaw 时一直报内存不够。我试过创建 swap、关掉桌面只留命令行还是不行2G 确实太小了。后来翻出一台闲置的联想 ThinkCentre M73 小主机i3-4130T、8G 内存、256G 固态装的是 Ubuntu 22.04 桌面版24 小时待机没噪音里面也没什么重要资料拿来跑 OpenClaw 简直太合适。所以这篇就带你在这类 Ubuntu 机器上从零部署一个原汁原味的 OpenClaw并接入 TaoToken 统一 Key/API 通道最后用飞书发消息验证机器人真的能回你。整条链路我会拆成环境准备 → 安装 OpenClaw → 初始化向导 → 飞书通道配置 → 接入 TaoToken → 启动验证 → 排错。每一步都给可复制的命令和配置片段你照着敲就行。2. 装 OpenClaw 前先把 Node.js 和 npm 环境备好OpenClaw 的核心代码是 TypeScript 写的最终编译成 JavaScript 运行而 Node.js 就是让 JS/TS 脱离浏览器、直接在你机器上跑的运行时环境。没有它OpenClaw 起不来。官方要求 Node.js 版本不低于 22npm 会随 Node.js 一起装上。先确认系统版本我这边是 Ubuntu 22.04.3lsb_release -a uname -m如果 apt 源太慢可以换成国内镜像。编辑源列表sudo nano /etc/apt/sources.list把内容替换为阿里云 jammy 源注意备份原文件deb https://mirrors.aliyun.com/ubuntu/ jammy main restricted universe multiverse deb-src https://mirrors.aliyun.com/ubuntu/ jammy main restricted universe multiverse deb https://mirrors.aliyun.com/ubuntu/ jammy-security main restricted universe multiverse deb-src https://mirrors.aliyun.com/ubuntu/ jammy-security main restricted universe multiverse deb https://mirrors.aliyun.com/ubuntu/ jammy-updates main restricted universe multiverse deb-src https://mirrors.aliyun.com/ubuntu/ jammy-updates main restricted universe multiverse deb https://mirrors.aliyun.com/ubuntu/ jammy-backports main restricted universe multiverse deb-src https://mirrors.aliyun.com/ubuntu/ jammy-backports main restricted universe multiverse更新并安装基础工具sudo apt update sudo apt upgrade -y sudo apt install -y curl git安装 Node.js 22用 NodeSource 源版本更可控curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs node --version npm --versionnode --version应显示 v22.x.x 以上。接着把 npm 源换成国内镜像装包会快很多npm config set registry https://registry.npmmirror.com npm config get registry注意如果你走官方一键脚本安装脚本会自动检测并安装 Node.js这一步可以跳过但走 npm 全局安装就必须先备好环境。3. 安装 OpenClaw 并跑通初始化向导安装有两种主流方式。一键脚本适合小白全自动npm 全局安装适合已有 Node.js 环境、想灵活控制版本的开发者。我两种都试过网络一般时 npm 方式更稳。方式一一键脚本curl -fsSL https://openclaw.ai/install.sh | bash脚本会自动检测系统、安装或更新 Node.js、全局装 OpenClaw 最新版并启动 onboard 向导。网络不好容易卡住卡住就换方式二。方式二npm 全局安装sudo npm install -g openclaw openclaw --version装完开始初始化openclaw onboard向导会依次问你几件事我按实际选择说明。首先是安全确认默认是个人使用模式personal-by-default单人操作限制较宽松如果要用于共享或多用户场景必须先做安全加固与锁定否则风险很大。个人用选 Yes 继续。接着选部署模式QuickStart 用默认参数快速跑通后续可用openclaw configure改Manual 手动逐项配置适合生产或定制需求。我第一次选 QuickStart 先跑通。然后选接入的大模型和认证方式输入 API Key、选模型版本。这里先随便选一个能用的后面我们会统一换成 TaoToken 通道。再选通信平台勾选飞书。飞书集成插件选Download from npm (openclaw/feishu)版本最新、自动更新。App Secret 的提供方式个人测试选Enter App Secret直接写进 OpenClaw 配置文件简单但明文存储别用在生产环境。连接模式选 WebSocket无需公网 IP 和域名本地内网就能用消息实时性高是官方推荐默认方式。群聊响应策略个人用建议选Disabled或Open (requires mention)避免误触发。联网搜索服务可以先跳过之后用openclaw configure --section web再配。技能Skills配置第一次也选 No 跳过先完成核心部署。Hooks 同样 Skip for now。最后启动方式选Hatch in TUI (recommended)终端里直接起轻量高效。4. 接入 TaoToken 统一 Key/API 通道OpenClaw 是模型无关的可以对接各种云端模型。但如果你不想在多个平台之间来回切 Key、管额度用 TaoToken 做统一通道会省事很多。它把模型调用收敛到一个 API 入口OpenClaw 这边只要改 base_url 和 api_key 就行。先去控制台拿 Key打开 https://taotoken.net/api 在 API Keys 页面创建一个新 Key复制保存。接入文档在 https://taotoken.net/api 对应的 doc 路径下里面有各语言的调用示例配置前扫一眼确认字段名。OpenClaw 的模型配置在~/.openclaw/config.toml不同版本路径可能略有差异用openclaw config path确认。下面是一份可复制的骨架把api_key换成你自己的[gateway] host 127.0.0.1 port 18789 [agent] default_model gpt-4o-mini [models.providers.taotoken] base_url https://taotoken.net/api/v1 api_key sk-你的TaoToken密钥 api openai-completions [models.aliases] fast taotoken/gpt-4o-mini smart taotoken/gpt-4o如果你更习惯用 JSON 片段管理渠道可以在~/.openclaw/settings.json里补一段{ channels: { feishu: { enabled: true, mode: websocket, appId: cli_你的AppID, appSecret: 你的AppSecret, groupPolicy: disabled } }, modelProvider: { name: taotoken, baseUrl: https://taotoken.net/api/v1, apiKey: sk-你的TaoToken密钥 } }改完配置后重载openclaw configure --section model openclaw restart提示base_url 末尾的/v1别漏很多 404 都是这里写错。api_key 不要提交到 Git配置文件权限设成 600。5. 配置飞书通道并验证机器人响应飞书这边要去开放平台建应用。打开 https://open.feishu.cn/ 创建企业自建应用填机器人基本信息添加机器人能力。权限管理里删掉原有内容粘贴下面这段导入{ scopes: { tenant: [ im:message, im:message.group_at_msg:readonly, im:message.p2p_msg:readonly, im:message:send_as_bot, im:resource, contact:user.base:readonly, docx:document, drive:drive ], user: [] } }然后修改订阅方式添加事件接收消息相关创建版本并发布。在凭证页面找到 App ID 和 App Secret填回 OpenClaw 向导别填反。连接模式选 WebSocket版本选中国版飞书。启动机器人openclaw start openclaw statusstatus显示 gateway running、feishu connected 就对了。打开飞书 App进工作台找到你发布的机器人发一条消息比如“你好帮我看看当前目录有哪些文件”。第一次可能提示访问权限需要审核按提示输入with:后面的命令完成授权。授权后机器人会回复说明整条链路通了。想验证模型通道是否走的是 TaoToken可以在 TUI 里发一句需要模型推理的话然后看日志openclaw logs --follow日志里出现providertaotoken和对应 model 名就说明统一通道生效了。如果你更想先在网页里直接试模型对话可以打开 https://taotoken.net/api 的模型对话入口确认 Key 和模型可用再回到 OpenClaw 排查通道问题。6. 本篇常见报错排查装的过程中我踩了几个坑列出来帮你省时间。报Node.js version too old说明 Node 低于 22。用node --version确认低于就按第 2 节重装别用 apt 自带的旧版本。报EACCES permission denied装 npm 包时别急着sudo npm install -g先修 npm 全局目录权限mkdir -p ~/.npm-global npm config set prefix ~/.npm-global echo export PATH~/.npm-global/bin:$PATH ~/.bashrc source ~/.bashrc飞书机器人不回消息先看openclaw logs --follow。常见原因是 App ID/Secret 填反、权限没发布版本、或事件订阅没加。WebSocket 模式下不需要公网地址如果日志显示连接失败检查机器出网是否正常。模型调用报 401多半是 TaoToken Key 写错或没带Bearer。OpenClaw 的 provider 配置里 api_key 直接填sk-开头的串即可别手动加前缀。报 404 就检查 base_url 是不是https://taotoken.net/api/v1。内存不够导致安装中断free -h看一下。2G 机器基本没戏建议 4G 起步8G 更稳。可以临时加 swap 顶一下sudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile长期编码或跑 Agent 任务的话可以考虑 TaoToken 的 Coding Plan额度更划算适合把 OpenClaw 当日常助手用。接入和排障相关的 Key、文档都在 https://taotoken.net/api 的 API Keys 和接入文档里遇到问题先翻文档再动手改配置。