ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

2026年OpenClaw搭建实战:腾讯云2分钟部署+大模型APIKey与Skill集成配置指南

2026年OpenClaw搭建实战:腾讯云2分钟部署+大模型APIKey与Skill集成配置指南 1. 为什么要在腾讯云上跑 OpenClawOpenClaw曾用名 Clawdbot是一个可以自己部署的 AI Agent 框架核心能力是让模型不只是聊天而是能真正动手读写文件、联网搜索、调用浏览器、做内容摘要、跑自动化流程。它靠 Node.js 运行支持云端服务器长期在线也支持本地离线跑数据默认落在自己机器上可控性比纯 SaaS 强不少。适合谁一类是想在云端挂一个 7×24 小时在线的 Agent、随时用手机或浏览器下指令的开发者另一类是想把大模型 API Key 统一管理、不想在多个项目里到处粘贴密钥的人。我这次选腾讯云轻量应用服务器原因是开箱即用、按量便宜、公网 IP 直接给2 分钟内能跑通一个可访问的 Web 控制台。整篇的路线是腾讯云环境准备 → Node.js 依赖 → TaoToken 统一 Key 接入 → 大模型 API Key 写进 config.toml → Skill 集成 → 启动自检。命令都能直接复制遇到报错我在第 5 节集中排。2. 前置准备TaoToken 统一 Key 与腾讯云环境2.1 为什么用 TaoToken 而不是每个模型单独配 KeyOpenClaw 的模型配置支持多种 provider但如果你同时想用不同厂商的模型做对比或者 Skill 里要调不同能力一个个去各平台申请 Key、记额度、改配置会很碎。TaoToken 的思路是提供一个统一的 API 入口你拿一个 Key就能在 OpenClaw 里通过改base_url和model_name切换后端模型配置骨架不用大改。对 OpenClaw 这种需要频繁切换模型试效果的场景这点很实用。你可以在模型对话页面先验证 Key 能不能正常出结果再写进配置文件。官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 地址写进配置用这个不带参数https://taotoken.net/api拿 Key 的地方https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注意API 地址填https://taotoken.net/api不要带任何查询参数否则部分客户端会拼接出错。2.2 腾讯云轻量服务器配置在腾讯云控制台买一台轻量应用服务器配置参考项目建议值说明镜像Ubuntu 22.04 LTS依赖安装最顺规格2 核 2GB 起1GB 内存跑 Agent 容易 OOM系统盘40GB 以上装 Node 和 Skill 够用防火墙放行 18789OpenClaw Web 控制台默认端口登录SSH 密钥或密码后面用 SSH 操作买完在「防火墙」里加一条规则TCP 18789来源0.0.0.0/0测试阶段先全开稳定后建议限制来源 IP。2.3 登录服务器并检查环境用 SSH 连上服务器先看系统版本和内存cat /etc/os-release free -hfree -h里 available 低于 800MB 的话建议升配不然后面启动网关会莫名退出。3. 可复制配置Node.js、OpenClaw 与 config.toml3.1 安装 Node.js 22 与基础工具OpenClaw 要求 Node.js 22.x 及以上。Ubuntu 用 NodeSource 源装最省事sudo apt update sudo apt install -y curl git curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs node -v npm -vnode -v输出v22.x.x就对了。如果提示command not found说明上一步没装成功重跑 NodeSource 那两行。3.2 配置 npm 镜像并安装 OpenClaw国内服务器直连 npm 官方源会慢先换镜像npm config set registry https://registry.npmmirror.com npm install -g openclaw openclaw --versionopenclaw --version能打印版本号说明全局安装成功。3.3 初始化并设置公网访问openclaw onboard按提示走同意协议 → 选择快速启动 → 模型配置先跳过下一步手写→ 启用需要的通道。初始化完成后设置监听地址和端口openclaw config set gateway.host 0.0.0.0 openclaw config set gateway.port 18789gateway.host设成0.0.0.0才能从公网访问只设127.0.0.1的话外网打不开。3.4 写入 config.toml 模型骨架OpenClaw 的模型配置写在config.toml里。路径一般是Linux/macOS~/.openclaw/config.tomlWindowsC:\Users\用户名\.openclaw\config.toml先确认文件位置ls -la ~/.openclaw/用编辑器打开config.toml写入下面这段骨架。把你的TaoToken密钥换成你在 api-keys 页面拿到的 Key[model] provider openai-compatible base_url https://taotoken.net/api api_key 你的TaoToken密钥 model_name gpt-4o-mini max_tokens 2048 temperature 0.7 timeout 60 reasoning false几个参数的作用参数作用建议provider协议类型统一用 openai-compatiblebase_urlAPI 入口固定https://taotoken.net/apimodel_name调用的模型按需换先小模型验证timeout超时秒数云端建议 60reasoning推理链开关回复为空时设 false注意base_url结尾不要加/v1或斜杠OpenClaw 会自己拼路径多写反而 404。改完重启网关让配置生效openclaw gateway restart4. 验证请求与 Skill 集成4.1 启动服务并做一次自检openclaw gateway start openclaw gateway statusstatus显示 running 就说明网关起来了。然后看日志确认模型配置被加载openclaw logs --follow日志里出现模型初始化的记录、没有api_key invalid之类的报错就说明 Key 接对了。浏览器打开http://你的服务器公网IP:18789能进 Web 控制台输入一句「你好帮我列一下当前目录文件」模型能返回结果说明整条链路通了。4.2 安装 Skill 管理工具Skill 是 OpenClaw 的功能扩展模块搜索、浏览器操作、摘要、文件管理都靠它。先装管理工具npm install -g clawhub clawhub --version4.3 安装常用 Skillclawhub install tavily-search clawhub install agent-browser clawhub install summarize clawhub install skill-vetter通用格式就是clawhub install 技能名。装完查看列表openclaw skill list4.4 启动 Skill 并验证生效openclaw skill start tavily-search openclaw skill status tavily-searchstatus显示 enabled 后重启网关加载openclaw gateway restart回到 Web 控制台输入「用搜索查一下今天的天气」如果返回的是实时搜索结果而不是模型编的内容说明 Skill 已经挂上了。4.5 完整启动自检流程把上面串成一条可复现的检查链每次改完配置跑一遍node -v openclaw --version openclaw gateway status openclaw skill list openclaw logs --follow五项依次通过Node 版本对、OpenClaw 装好、网关在跑、Skill 列表非空、日志无报错就算部署完成。5. 本篇常见错排查5.1 openclaw: command not found全局安装没进 PATH。先确认npm root -g看输出的全局目录在不在 PATH 里。不在的话重装一次npm install -g openclaw或者关掉终端重开让 PATH 刷新。5.2 服务启动后自动退出多半是内存不够。free -h看 available低于 800MB 就升配。也可以看日志定位openclaw logs如果是端口被占用查一下lsof -i:18789 kill -9 进程ID5.3 公网打不开 Web 控制台按顺序查三件事网关是否在跑openclaw gateway status、腾讯云防火墙是否放行 18789、gateway.host是否设成了0.0.0.0。三个都对还打不开重启网关再试。5.4 模型调用失败或回复为空先确认config.toml里api_key没写错、base_url是https://taotoken.net/api且没带多余路径。回复为空时把reasoning设成false再重启。响应超时就调大timeout、调小max_tokens。5.5 Skill 装了不生效clawhub命令不可用就重装npm install -g clawhub。装完不生效先openclaw skill list看有没有再openclaw gateway restart重启加载。安装失败多半是镜像问题重设npm config set registry https://registry.npmmirror.com再装。5.6 配置文件写不进去检查当前用户对~/.openclaw/的读写权限。实在乱了就重置openclaw onboard --reset6. 后续怎么用与 Key 管理跑通之后日常就是openclaw gateway start起服务、浏览器进控制台下指令、openclaw logs --follow看执行过程。Skill 按需加不用一次装全装多了启动会慢。模型这块如果你要长期跑编码类任务或 Agent 自动化建议用 Coding Plan 把调用成本压下来比按 token 计费更适合高频场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content想先验证模型效果、对比不同模型输出直接在模型对话页面试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentKey 的创建和管理都在控制台建议给 OpenClaw 单独建一个 Key方便按项目看用量、出问题好定位https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入细节和参数说明以文档为准遇到配置项不确定就翻一下https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content如果你用的是 Claude Code 这类编码工具想让它走同一套 Key参考这个接入页https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后提醒一句config.toml里的 Key 是明文服务器别随便给人登防火墙稳定后把 18789 的来源限制到自己的 IP能省不少心。
返回列表