1. 先搞清楚 OpenClaw 到底能帮你干什么OpenClaw 2026.3.8 是一个跑在你自己设备上的开源 AI 智能体前身叫 Clawdbot中间短暂叫过 Moltbot最后定名 OpenClaw。它和普通聊天窗口最大的区别是普通 AI 告诉你「怎么做」OpenClaw 直接帮你「做出来」。它本地优先数据、文件、隐私都在你自己手里本身是一个编排层可以接不同大模型当大脑。适合谁适合想把 AI 从「问答工具」变成「数字员工」的人。你可以把它装在自己的 Mac mini、闲置电脑或云服务器上让它 24 小时待命接入钉钉、飞书、Telegram、Discord 等消息中枢帮你整理文件、写代码、清理收件箱、处理未读消息。零基础也能跟做下面从 Node.js 环境开始一步步装到能访问 Web UI再把 TaoToken 的统一 Key 通道接进去。我试过在干净的 Ubuntu 上从零跑一遍踩过的坑主要集中在 Node 版本、npm 全局路径和配置文件字段这三处正文会把可复制的骨架和验证动作都给你。2. 装之前先把 Node.js 和 npm 环境铺好OpenClaw 依赖 Git 拉取组件依赖 Node.js版本 22跑内部组件。先确认系统里有没有没有就按下面装。# 更新软件源并安装 Git sudo apt update sudo apt install git -y # 验证 Git git --versionNode.js 建议用 nvm 管理避免系统自带版本太旧。下面这段是 nvm 官方安装脚本的用法# 用 curl 安装 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash # 如果 curl 不通换 wget wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash # 重新加载环境变量让 nvm 命令生效 source ~/.bashrc # 安装 Node.js 22 nvm install 22 # 查看版本输出 v22 即可只要 22 就行 node -v npm -v这里有个细节source ~/.bashrc之后如果nvm还是提示 command not found检查一下你的 shell 是不是 zsh是的话改成source ~/.zshrc。Node 版本低于 22 会在后面安装 OpenClaw 时报引擎不兼容别省这一步。3. 全局安装 OpenClaw 2026.3.8环境好了直接用 npm 全局安装最新版。国内网络建议加镜像加速不然拉包会很慢。# 全局安装 OpenClaw 最新版 npm install -g openclawlatest # 国内镜像加速安装推荐 npm install -g openclawlatest --registryhttps://registry.npmmirror.com # 验证安装能打印版本号就成功 openclaw --version如果openclaw --version提示找不到命令多半是 npm 全局 bin 目录没进 PATH。执行npm config get prefix看路径把它下面的bin加进~/.bashrc的 PATH 里再source一次即可。其他平台macOS、Windows WSL的安装方式可以参考 OpenClaw 官方安装文档命令基本一致。4. 用 TaoToken 统一 Key 通道接入模型OpenClaw 本身是编排层需要接一个大模型当大脑。这里用 TaoToken 的统一 Key/API 通道好处是一个 Key 走通多家模型配置集中、切换方便不用在多个平台之间来回倒腾密钥。先去 TaoToken 控制台创建一个 API Key地址是 https://taotoken.net/api 控制台入口在 https://taotoken.net/console 。拿到 Key 之后OpenClaw 的模型配置有两种常见落点settings.json和config.toml取决于你用的版本和初始化方式。下面给两份可复制的骨架。先看settings.json骨架放在 OpenClaw 的工作目录下{ provider: openai-compatible, baseUrl: https://taotoken.net/api/v1, apiKey: sk-你的TaoToken密钥, model: claude-sonnet-4-20250514, timeout: 60000, maxRetries: 2 }再看config.toml骨架适合用 TOML 管理配置的场景[provider] type openai-compatible base_url https://taotoken.net/api/v1 api_key sk-你的TaoToken密钥 model claude-sonnet-4-20250514 timeout 60000 max_retries 2 [gateway] bind 0.0.0.0 port 18789两个骨架里的baseUrl都指向 TaoToken 的 API 地址apiKey换成你控制台里生成的那串。模型名按你实际要用的填TaoToken 支持多家模型具体可用列表在接入文档 https://taotoken.net/doc 里查。配置改完记得重启 OpenClaw 服务让新配置生效。注意密钥不要提交到 Git 仓库也不要在截图里露出完整串。生产环境建议用环境变量注入而不是硬编码在配置文件里。5. 跑初始化向导并验证请求成功配置写好后跑一次初始化向导把网关、工作目录、模型这些串起来openclaw onboard --install-daemon向导里依次选安装确认选yes配置方式选Manual手动配置网关位置选Local gateway (this machine)Workspace 工作目录直接回车用默认模型选择处如果你已经用 TaoToken 配好了就选对应的 openai-compatible 通道Gateway bind 选LAN (0.0.0.0)Token 选自动生成SecretRef 不要选除非你是资深 Kubernetes 用户channel 先选no跳过Search provider 选Skip for nowSkill 选noHooks 选最后两个。走完会提示安装 Gateway 成功。启动服务后验证# 查看服务状态 openclaw status # 如果浏览器访问不了用 SSH 端口转发 ssh -N -L 18789:127.0.0.1:18789 root你的服务器IP然后浏览器访问http://localhost:18789/能看到 Web UI 面板就说明网关起来了。在面板里发一条测试消息比如「你好报一下当前模型」如果正常返回内容说明 TaoToken 通道已经打通。返回 401 或超时看下一节的排查。6. 本篇常见错误排查报错一401 invalid access token or token expired。这个在接阿里百炼 provider 时特别常见根因是 baseUrl 写错了。需要把https://coding.dashscope.aliyuncs.com/v1改成https://dashscope.aliyuncs.com/compatible-mode/v1。用 TaoToken 通道的话确认baseUrl是https://taotoken.net/api/v1别多写或少写/v1。报错二openclaw: command not found。npm 全局 bin 没进 PATH。执行npm config get prefix把输出路径下的bin追加到~/.bashrc再source ~/.bashrc。报错三Node 版本不兼容。报引擎要求 22 时用nvm install 22 nvm use 22切过去再重装 OpenClaw。报错四Web UI 打不开。服务器没图形界面时必须用ssh -N -L 18789:127.0.0.1:18789 root服务器IP做端口转发再访问http://localhost:18789/。直接访问服务器公网 IP 的 18789 通常不通因为网关默认绑的是本地回环。报错五配置改了不生效。OpenClaw 读的是启动时加载的配置改完settings.json或config.toml要重启服务别只刷新浏览器。排障和接入相关的细节统一看接入文档 https://taotoken.net/doc 和 API Keys 管理页 https://taotoken.net/api-keys 。想先在网页里验证模型通不通用模型对话 https://taotoken.net/chat 如果是长期编码或跑 Agent 场景直接上 Coding Plan https://taotoken.net/coding-plan 更省心。
