1. 整体设计为什么我把 OpenClaw 放到腾讯云主机上1.1 先说结论OpenClaw 到底是个什么玩意OpenClaw 是个开源的 AI Agent 框架你可以把它理解成一个“能指挥工具干活”的私人助理。它不像 ChatGPT 网页版那样只能聊天而是能根据你给的指令自己去调用本机命令、读写文件、访问网页、操作各种 API甚至连接外部工具。核心价值在于它把“大模型思考”和“实际执行”打通了——模型负责理解意图、拆解步骤OpenClaw 负责真正把事办成。我最早是在自己电脑上跑 OpenClaw 的Windows 环境折腾起来不是说不行但有个很现实的问题电脑一关服务就断了人不在家它也没法对外提供服务。后来我把主意打到了云主机上。腾讯云主机现在新用户活动价很低买一台 2核4G 的轻量应用服务器一个月也就一杯奶茶钱却能换来一台 24 小时在线的“Agent 专用机”。这篇就是我在腾讯云主机上从零装通 OpenClaw 的完整记录照着走你也能在半小时内把它跑起来。1.2 为什么选云主机而不是本地电脑很多人一开始和我一样习惯在本地 Windows 上搭 OpenClaw。本地跑的好处是省事装个 Node.js 就能用但坏处也明显一是断电断网就失联二是出门在外没法随时访问三是如果你的 Windows 开启了休眠或者自动更新跑一半的服务可能直接没了。云主机的优势就是把这几个痛点全部消掉。腾讯云的机器放在机房全天在线公网 IP 是固定的你随时随地用手机、平板、公司电脑连上去就能操作。更关键的是云环境更接近 Linux 的生产环境OpenClaw 这类 Agent 框架天生和 Linux 生态配合默契跑系统命令、挂定时任务、配 Nginx 反向代理都比 Windows 顺手得多。1.3 方案选型轻量服务器够不够用腾讯云上选择很多最常见的就是云服务器 CVM 和轻量应用服务器。我的建议是纯跑 OpenClaw 加少量技能轻量服务器的 2核4G 套餐完全够用如果你以后打算接本地大模型 Ollama那 CPU 得往 4核8G 以上走因为模型推理很吃内存。系统镜像我推荐 Ubuntu 22.04 LTS别问为什么不选 Windows Server。OpenClaw 依赖 Node.js 和 RedisLinux 下装这些就是回车敲几条命令的事而且长期稳定。如果你按教程第一次装选 Ubuntu 22.04 基本就是最省心的路径。腾讯云的安全组默认规则建议只放行必要的端口后面会有专门板块讲。2. 核心细节解析与实操要点2.1 购买云主机时的关键参数怎么定买机器的时候有四个地方容易选错我一个个说清楚。地域选你离得近的城市比如你在华南就选广州华北选北京或天津。离得近延迟低远程敲命令手感明显不一样。但也别纠结OpenClaw 不是实时对战应用几十毫秒延迟感知不强。套餐2核4G 起步5M 带宽固定足够。OpenClaw 的 HTTP 交互主要是文本和 JSON带宽需求极小真正费流量的是拉镜像、装依赖那几步后面用不上多少。系统选 Ubuntu 22.04 LTS这个版本 NodeNode.js 20 和 Redis 7 的兼容性很好而且腾讯云的镜像源更新及时。安全组这个最容易忽略。默认一般是放行 22 端口SSH但你 OpenClaw 起来之后如果想用网页控制台得额外放行对应端口。后面实操部分我会给一份最小开放清单别贪多端口越少越安全。2.2 登录云主机的方式密码还是密钥新买的腾讯云主机初始化时会让设置 root 密码。我强烈建议顺便创建一对 SSH 密钥用密钥登录比密码安全一个量级还能省去每次输密码的麻烦。在腾讯云控制台创建密钥后下载私钥文件到本地然后用终端工具登录。Windows 用户我推荐用一个叫 Xterminal 或者直接用系统自带的 PowerShell 来连macOS 用户直接开终端。连接命令很简单ssh -i ~/路径/你的密钥.pem ubuntu你的服务器公网IP如果你懒得搞密钥密码登录也行只是记得把 root 密码设复杂一点。腾讯云控制台还支持“一键登录”适合应急查看但正经干活还是走终端。2.3 安装环境前的三个底层认知在运行任何安装命令之前有几个概念必须清楚否则后面出错你会一头雾水。第一OpenClaw 是一个 Node.js 应用。它本质上就是一个跑在 Node 运行时里的服务所以装 Node.js 是第一步。很多同学卡在“我明明装了 OpenClaw 为什么说找不到命令”十有八九是 Node 没装好或者 npm 全局路径没配。第二OpenClaw 需要一个 Redis 做状态存储。Redis 是开源内存数据库OpenClaw 用它缓存会话记录、存储临时状态。Redis 和 OpenClaw 的关系有点像数据库和网站的关系——网站要读写数据库OpenClaw 也要读写 Redis。不装 RedisOpenClaw 启动会直接报错。第三大模型连接方式是配置出来的。OpenClaw 本身不带大模型它需要接一个“大脑”。你可以接 OpenAI 的 API也可以接本地 Ollama 部署的开源模型。这个配置在初始化时设定后期可以随时改。2.4 模型接入方式怎么选OpenClaw 的模型接入有两种主流路子按需选就行。第一种接线上 API。比如 OpenAI、DeepSeek、通义千问等厂商的接口。优点是不占本地算力效果一般最好缺点是每一轮对话都要消耗 API 额度长期用要算成本。第二种接本地 Ollama。在云主机上装 Ollama然后拉取开源模型比如 Qwen2.5 7B用纯 CPU 推理OpenClaw 调用的是本地地址。优点是免费、数据不出服务器、隐私性强缺点是对 CPU 和内存要求高7B 模型在 4G 内存的机器上会比较吃力对话速度慢偶尔还会卡。如果你只想先跑通流程我建议先用便宜的线上 API把整个链路验证没问题了再考虑要不要上本地模型。这是我在实际试用中最稳的一条路径——先用 API 把 OpenClaw 玩明白再折腾 Ollama不然排错时混在一起很难定位问题。3. 实操过程与核心环节实现3.1 从零到跑通完整命令流下面是我在腾讯云 Ubuntu 22.04 主机上实际操作过的完整流程。登录服务器后按顺序执行。先更新系统软件包这个习惯能避免很多依赖问题sudo apt update sudo apt upgrade -y然后安装基础工具git 拉代码要用curl 和 wget 下载脚本要用sudo apt install -y git curl wget接着装 Node.js 20。这里推荐用 NodeSource 源比 apt 官方源的版本新得多curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs验证一下版本确保装上了node -v npm -v然后装 Redissudo apt install -y redis-server sudo systemctl enable redis-server sudo systemctl start redis-server验证 Redis 是否正常redis-cli ping返回 PONG 就说明 Redis 活着。接着安装 OpenClaw。这里要说明一下项目更新很快安装方式可能调整最常见的是通过 npm 全局安装或者把源码 clone 下来跑。我实践下来推荐 npm 全局安装升级简单sudo npm install -g openclaw安装完成后查看版本确认openclaw --version如果提示 command not found多半是 npm 全局目录没在 PATH 里。这个问题的解法我放在第 4 节专门讲。3.2 初始化配置openclaw init 的过程OpenClaw 装好后先不要直接启动先初始化。初始化命令很简单openclaw init这个命令会交互式地问你几个问题模型提供商选哪家、API Key 填什么、GTP 模型名字是什么、Agent 的名字和性格设定等。不同版本问题会略有差异但核心就是这些。回答完以后OpenClaw 会在你的工作目录下生成一个配置目录里面包含 config 配置文件、skills 技能目录、可以放脚本和知识文件的目录等。我的建议是首次初始化模型提供商先选你手上已有 API 的那家API Key 填好模型名选便宜的版本比如 DeepSeek 的轻量模型先跑通再说。Agent 人格描述先用默认的等后续你熟悉了再改。如果你初始化过程中不小心填错了不用重新 init直接打开配置文件改就行。配置文件一般是 JSON 或 YAML 格式里面有 model、apiKey、persona 这些字段按格式改完重启就生效。3.3 启动服务并保持进程常驻第一次启动直接用前台模式跑看日志输出openclaw start如果一切正常你会看到类似“Agent is ready”的日志。这时候先别急着关终端新开一个 SSH 窗口在另一个终端里测试能不能对话。OpenClaw 的交互方式有几种命令行聊天、HTTP API、Web 控制台等。最简单的是直接用它的交互命令openclaw chat在 chat 界面里输入“你好”如果模型配置没问题你应该能看到回复。这步通过说明主干链路全通了。接下来最关键的一步让 OpenClaw 在后台常驻。直接 CtrlC 停掉前台进程然后用 PM2 管起来。PM2 是 Node.js 生态最常用的进程守护工具可以让服务开机自启、崩溃自动拉起。安装并启动sudo npm install -g pm2 pm2 start openclaw --name openclaw pm2 save这里注意PM2 启动的命令不一定是openclaw如果你的 OpenClaw 是通过源码方式安装的要用pm2 start src/index.js这种用法。具体启动入口看官方文档说明以你当前版本为准。启动后用下面命令看状态pm2 status看到 online 状态就稳了。pm2 save把当前进程列表保存下来再执行pm2 startup设置开机自启。这样才能做到重启云主机后 OpenClaw 自动复活不用每次手动敲命令。3.4 安全组与防火墙的最小端口策略腾讯云主机除了系统内防火墙还有一层云防火墙安全组。安全组的规则是在控制台配的。最稳妥的最小规则是放行 22 端口SSH 登录用。放行 80 和 443如果你打算用 Nginx 反代把 Web 控制台暴露出去。其他端口一律不开。如果你暂时不需要外网访问 Web 界面那就只开放 22其他全部拦截。OpenClaw 的 Web 控制台如果只想自己看可以把服务绑定在 127.0.0.1然后用 SSH 隧道转发到本地浏览器访问这样公网完全不需要开额外端口安全性最好。我在实际使用中就是用的 SSH 隧道方案省心不怕被扫端口。4. 常见问题与排查技巧实录4.1 openclaw 命令找不到怎么办这个我在腾讯云上遇到过至少五次。执行openclaw --version提示 command not found但 npm 明明安装成功了。原因基本都出在 PATH 上没有包含 npm 全局 bin 目录。解决方法很简单npm config get prefix如果输出是/usr/local说明全局 bin 目录在/usr/local/bin这个一般已经在 PATH 里了。如果输出是/usr/lib/node_modules这种可能需要手动加。更省事的方法是直接用 npx 运行npx openclaw startnpx 会自动找到 npm 全局包里的可执行文件。或者干脆配好 PATH在~/.bashrc里加一行export PATH$PATH:$(npm prefix -g)/bin然后source ~/.bashrc重新加载。这样之后再敲 openclaw 就认了。4.2 模型 API 连接失败、认证报错怎么排查跑openclaw chat时如果提示 API 认证失败或者无法安全验证先别急着怀疑 OpenClaw 本身。我用下面的顺序排查顺序别乱基本能命中 90% 的原因。第一检查 API Key 是否填对。很多人复制 Key 的时候敲进了多余空格或者填成了别人 API 的 Key。打开配置文件手动看一遍确认字段正确。第二测试 API 连通性。用 curl 直接调一下模型服务商的接口如果 curl 都报错那就是网络问题跟 OpenClaw 无关。curl https://api.deepseek.com/v1/models -H Authorization: Bearer 你的KEY第三检查系统时间。如果云主机的时间不同步HTTPS 证书校验会失败报错表现就是“无法安全验证”。这招很隐蔽我踩过一次。用date看当前时间如果差太多执行sudo apt install -y ntpdate sudo ntpdate ntp.aliyun.com同步完时间再试大概率就好了。这里要特别提醒热搜词里有“openclaw无法安全验证请在 PowerShell 中运行 wsl -- status”这种说法那是 Windows 本地方案遇到的 WSL 环境问题跟云主机上跑 Linux 完全不是一回事。你在腾讯云主机上装的是原生 Ubuntu不需要 WSL也不会遇到这类问题。4.3 内存不足、进程被杀掉怎么办OpenClaw 本体其实不占内存真正吃内存的是本地模型。如果你在 4G 内存机器上再拉一个 7B 模型系统随时可能 OOM 把进程杀了。表现就是 PM2 里 status 变成 errored 或 stopped看日志会发现 killed。最简单的解法是不跑本地模型全用 API。如果非要本地模型至少要 8G 内存并且设置 Ollama 的并发数为 1把模型显存/内存占用控制住。另一个常见情况是 Redis 和 OpenClaw 同时吃内存导致紧张。Redis 默认占用很小但如果你的会话数据攒多了可以设置 Redis 的 maxmemory 限制比如 256MBredis-cli config set maxmemory 256mb不过这个配置重启会失效要永久生效得去 /etc/redis/redis.conf 里改。4.4 常见问题速查表现象可能原因解决办法openclaw 命令 not foundnpm 全局目录不在 PATH用 npx 或配置 PATH 后重新登录Redis 连不上Redis 未启动或端口被占用systemctl start redis-server用redis-cli ping验证模型认证失败API Key 错误或网络连不上配置里检查 Key用 curl 测 API 接口无法安全验证/SSL 报错系统时间不同步ntpdate ntp.aliyun.com同步时间进程被 OOM kill内存不足多为本地模型导致改用 API或升级机型配置端口访问不通云安全组未放行在腾讯云控制台调整安全组规则4.5 关于 Windows 与云主机环境的差异提醒我在搜索相关经验时看到很多人在 Windows 上配置 OpenClaw 时踩了不同类型的坑什么“openclaw windows companion 怎么配置”、“WSL 环境问题”之类的。Windows 方案确实有它的场景比如你只想在自己电脑上快速体验那装个 Node.js、跑个 Redis也能跑起来甚至用 WSL 模拟 Linux 环境来跑也有一堆人这么干。但如果你追求稳定、长期在线、随时远程访问云主机方案明显更省心。Windows 上跑服务还要面对系统更新重启、休眠断网这类意外而 Ubuntu 云主机基本是“一次配好长期免维护”的状态。我的建议是想体验就本地 Windows 随便搞搞想真正用起来就直接上腾讯云别在 Windows 环境上花太多时间去排错。5. 进阶玩法与后续扩展5.1 用 Skill 扩展 OpenClaw 的工具能力OpenClaw 的很大一个卖点是 Skill 扩展。所谓 Skill可以理解成给 Agent 装上一个又一个“技能包”。比如你给它加一个“定时提醒”的 Skill它就能按你的要求定时发消息加一个“查天气”的 Skill它就能自己请求天气 API 并整理结果。Skill 的安装方式很简单把技能目录放到配置文件夹下的 skills 目录重启服务它就会被自动加载。每个 Skill 通常包含一份描述文件和一个执行脚本描述文件说明这个技能的功能、触发方式和参数。这里没有统一的复杂写法你用的时候去看对应 Skill 的 README按照模板改就行。我的实操心得是不要一次性装一堆 Skill。每个 Skill 都会占用模型上下文和增加调度的复杂度装多了你会发现 Agent 有时候会选错技能。一个阶段只加一两个跑顺了再加才是最稳的节奏。5.2 通过 HTTP API 把 OpenClaw 接到其他系统OpenClaw 提供了 HTTP API 接口这意味着你可以把它嵌入到自己的脚本、小程序甚至网站里。比如说你想在公司内网搭一个 AI 工单助手可以用 Python 写个服务接收工单请求然后调 OpenClaw 的 HTTP 接口去处理再把结果返回。配置里开启 HTTP 服务后默认会监听一个本地端口。公网访问要慎重至少加一层 Token 鉴权或者用 Nginx 做代理并把端口隐藏。我个人强烈不建议直接把 OpenClaw 的 HTTP 端口暴露公网除非你做好了认证否则等于给陌生人开了一个可以指挥你主机的入口这风险太大了。如果要对外提供服务用 Nginx 反向代理把 /api 转发到 OpenClaw 的本地端口再用一个简单的 API Key 头做校验。Nginx 配置文件不复杂网上模板一堆配完之后测一下转发和鉴权确认只能带 Key 才能访问再绑定域名和 HTTPS。这一套弄完你的 Agent 就算正式“面向服务”了。5.3 搭配腾讯云周边能力做知识库OpenClaw 的 Agent 能力还能进一步扩展接向量数据库做长期记忆。腾讯云上有向量数据库产品也可以自己在主机里装一个轻量级的向量库把文档切块、嵌入、存储然后让 OpenClaw 根据用户问题检索相关内容。这样你的 Agent 就有了“读过很多资料后回答你”的能力而不是只靠模型现有知识。这个扩展我觉得是 OpenClaw 最值得挖掘的方向之一。官方文档里应该有对应的工具接入说明照着配就行。如果你不想用数据库产品最小成本的方案是直接在文件系统里存 Markdown 知识文件让 OpenClaw 去读文件效果也还可以只是检索能力弱一些。最后的个人操作体会整套流程跑下来我最想强调的一件事先把最简单的主链路跑通再做锦上添花。很多朋友一上来就想把 Skill、Ollama、HTTP API、知识库全部接好结果环境哪里出了问题都不知道该查哪一环。我自己第一遍就是因为同时配了本地模型和远程 API折腾了一个下午才定位到是 API Key 填错了。后来学乖了每次变更只做一件事跑通了再动下一个。另外一个小技巧用 PM2 管理 OpenClaw 之后日志文件会越攒越大。我习惯每天看一眼pm2 logs openclaw --lines 50顺手清理一下旧日志。具体清理命令不同版本不一样但思路是一样的日志只是排错用的留最近几天足够。腾讯云主机上装 OpenClaw 这件事真没有想象中复杂。你只要记住一条主线装 Node.js、装 Redis、装 OpenClaw、配模型、用 PM2 挂起来。剩下的所有花活都是在这条主线上长出来的。先把它跑起来你就已经超过大多数只收藏不实操的人了。