AI创想

标题: OpenClaw 腾讯云 + 火山方舟（Volcengine Ark）完整安装与扩展教程 [打印本页]
作者: 米落枫    时间: 8 小时前
标题: OpenClaw 腾讯云 + 火山方舟（Volcengine Ark）完整安装与扩展教程
作者：CSDN博客
OpenClaw 腾讯云 + 火山方舟（Volcengine Ark）完整安装与扩展教程

适用场景：你准备在 腾讯云 CVM（Ubuntu LTS） 上部署一套长期在线的 OpenClaw，主模型优先使用 火山方舟 / 方舟引擎 API，并在安装完成后继续扩展 国内外渠道、插件、skills 与 MCP 类工具能力。
本文尽量把“官方手册能确认的稳定做法”和“社区里已验证但仍在快速演进的做法”分开写，避免你踩到版本变化的坑。
目录

1. 先把 5 个概念分清：模型、渠道、插件、Skills、MCP

这是很多人第一次部署 OpenClaw 时最容易混淆的地方。
1.1 模型提供商（Model Provider）

这是 OpenClaw 背后实际调用的大模型来源，比如 OpenAI、Anthropic、Z.AI(GLM)、Moonshot、MiniMax、Qianfan、Volcano Engine（火山方舟 / Doubao）等。OpenClaw 官方文档明确把它们归类在 Model Providers，模型引用格式通常是 provider/model。12
1.2 聊天渠道（Channel）

这是 OpenClaw 跟你交互的“入口”，比如 Telegram、WhatsApp、Slack、Discord、Signal、Feishu、LINE、Zalo 等。官方把这些放在 Channels 文档里。3
1.3 插件（Plugin）

插件用于给 OpenClaw 增加额外功能、命令、工具和 Gateway RPC。很多渠道本身就是以插件方式提供的，比如 Feishu、LINE、Matrix、Mattermost 等。4
1.4 Skills

Skills 更像能力包/任务包。Linux 上没有 macOS 那种 Skills 图形界面，官方建议通过 ClawHub 或把 skill 目录直接放进工作区来安装与管理。56
1.5 MCP

MCP（Model Context Protocol）本质上是外部工具/服务能力的接入协议。但到你现在要部署的这一代 OpenClaw，稳定文档里还没有一份非常成熟的一等 mcpServers 全局配置手册；官方 ACP 文档只明确写了 bridge mode 不支持 per-session mcpServers，需要在 gateway 或 agent 层配置。与此同时，社区里最近仍有关于 mcpServers 在 openclaw.json 中“不被 schema 识别”的 issue / discussion。也就是说：MCP 能力存在，但在当前稳定版里仍更适合按“实验性 / bridge / provider-specific”思路接入，而不是把它当作已经完全定型的顶层配置。789
结论：
2. 本教程推荐的部署架构

我推荐你用下面这套架构：
OpenClaw 官方对 Linux/VPS 的建议也基本是这条思路：使用 Ubuntu LTS、Node 22+、openclaw onboard --install-daemon、Linux 上用 systemd user unit，并且最好一台主机 / 一个 OS 用户对应一个可信边界。101112
3. 服务器与云资源准备（腾讯云）

3.1 CVM 规格建议

OpenClaw 官方 FAQ 给出的 VPS 基线是：
对腾讯云来说，我更建议：
3.2 安全组怎么开

腾讯云官方文档说明：只有在安全组里放通端口，对应服务才能访问；修改服务端口后，也必须同步在安全组里放通。14
初始安装阶段建议只开：

不建议一上来就开：

只有在你接这些渠道时再开：

最稳的原则：
OpenClaw Dashboard 不直接裸露到公网；对公网开放的只应该是你明确需要的 webhook / 反向代理入口。
OpenClaw 官方安全文档也明确把“非 loopback 绑定但未鉴权”列为高风险项。12
4. Ubuntu 初始化与非 root 运行用户

先用腾讯云控制台拿到服务器公网 IP，通过 SSH 连进去：
  1. ssh ubuntu@<你的服务器公网IP># 或者 ssh root@<公网IP>，取决于镜像默认用户
复制代码
更新系统：
  1. sudoapt update &&sudoapt upgrade -ysudoaptinstall-ycurlgit jq ca-certificates build-essential unzip
复制代码
创建一个专门跑 OpenClaw 的普通用户：
  1. sudo adduser openclaw
  2. sudousermod-aGsudo openclaw
  3. su - openclaw
复制代码
为什么这么做？因为 OpenClaw 官方安全文档建议把一个 Gateway 视作一个可信边界，最好一台主机 / 一个 OS 用户对应一个边界；同时，你用普通用户运行，也更符合 Linux 的长期服务实践。1112
5. 安装 OpenClaw（官方推荐路径）

OpenClaw 官方 Getting Started 给出的最快安装路径是：
  1. curl-fsSL https://openclaw.ai/install.sh |bash
  2. openclaw onboard --install-daemon
  3. openclaw gateway status
  4. openclaw dashboard
复制代码
其中官方前提条件是 Node 22 或更新版本。安装脚本是官方推荐路径。10
所以你在 openclaw 用户下直接执行：
  1. curl-fsSL https://openclaw.ai/install.sh |bashsource ~/.bashrc
  2. node--version
  3. openclaw --version
复制代码
如果 node --version 不是 22+，先修 Node，再继续。
5.1 跑 onboarding
  1. openclaw onboard --install-daemon
复制代码
Linux 上，官方向导会尽量给你装成 systemd user unit，并尝试 loginctl enable-linger <user>，让你退出 SSH 后服务还能继续运行。15
5.2 向导里怎么选

推荐你这样选：
安装完成后检查：
  1. openclaw gateway status
  2. openclaw logs --follow
复制代码
如果服务没有自动起来，你可以补一遍：
  1. openclaw gateway install
  2. systemctl --user daemon-reload
  3. systemctl --userenable--now openclaw-gateway.service
  4. openclaw gateway status
复制代码
6. 接入方舟引擎 API：推荐两种方式

火山引擎官方文档明确写了：方舟模型 API 尽可能兼容 OpenAI API，通常只需要改少量配置，例如 base url、model、api_key。16
而 OpenClaw 官方文档又提供了两条路：
6.1 方案 A：直接用 OpenClaw 官方内置 volcengine provider（推荐）

如果你只是想稳定地用方舟 / Doubao / 方舟里的常见模型，这条最简单。
官方 Model Providers 文档给出的信息是：
推荐做法

把 key 写进 ~/.openclaw/.env：
  1. mkdir-p ~/.openclaw
  2. cat>> ~/.openclaw/.env <<'ENV'
  3. VOLCANO_ENGINE_API_KEY=你的方舟APIKey
  4. OPENCLAW_GATEWAY_TOKEN=你自己生成的一个长随机串
  5. ENV
复制代码
然后重启或重新加载网关：
  1. openclaw gateway restart
  2. openclaw models list
复制代码
你也可以重新跑一次向导：
  1. openclaw onboard --auth-choice volcengine-api-key
复制代码
最小配置示例
  1. {
  2.   gateway: {
  3.     bind: "loopback",
  4.     port: 18789,
  5.     auth: {
  6.       mode: "token",
  7.       token: "${OPENCLAW_GATEWAY_TOKEN}"
  8.     }
  9.   },
  10.   agents: {
  11.     defaults: {
  12.       workspace: "~/.openclaw/workspace",
  13.       model: {
  14.         primary: "volcengine/doubao-seed-1-8-251228",
  15.         fallbacks: ["zai/glm-5", "moonshot/kimi-k2.5"]
  16.       }
  17.     }
  18.   }
  19. }
复制代码
6.2 方案 B：把你自己的方舟 OpenAI-compatible 接入点当成 Custom Provider

如果你不是想直接用 OpenClaw 预设的 volcengine/* 模型，而是：
那么用 OpenClaw 官方支持的 Custom Provider 更合适。官方 onboarding 文档明确写了：Custom Provider 支持 OpenAI-compatible 或 Anthropic-compatible 端点，需要你提供 base URL、API key、model ID 和一个 Endpoint ID。17
交互式做法
  1. openclaw onboard
复制代码
然后在向导里选择：
手工配置示例

注意：下面的 ARK_OPENAI_BASE_URL 和模型 ID 需要以你在火山方舟控制台里看到的值为准；不同账号、区域、Endpoint 配置可能不同。
  1. {
  2.   gateway: {
  3.     bind: "loopback",
  4.     port: 18789,
  5.     auth: {
  6.       mode: "token",
  7.       token: "${OPENCLAW_GATEWAY_TOKEN}"
  8.     }
  9.   },
  10.   agents: {
  11.     defaults: {
  12.       workspace: "~/.openclaw/workspace",
  13.       model: {
  14.         primary: "ark-custom/your-endpoint-id"
  15.       }
  16.     }
  17.   },
  18.   models: {
  19.     mode: "merge",
  20.     providers: {
  21.       "ark-custom": {
  22.         baseUrl: "${ARK_OPENAI_BASE_URL}",
  23.         apiKey: "${VOLCANO_ENGINE_API_KEY}",
  24.         api: "openai-completions",
  25.         models: [
  26.           {
  27.             id: "your-endpoint-id",
  28.             name: "Volcengine Ark Custom Endpoint",
  29.             reasoning: true,
  30.             input: ["text"]
  31.           }
  32.         ]
  33.       }
  34.     }
  35.   }
  36. }
复制代码
这种写法本质上就是套用了 OpenClaw 官方 models.providers 自定义 provider 方案。官方配置示例里同样给出了 baseUrl + apiKey + api + models[] 的模板。18
7. 安装完成后的目录、配置文件与日志位置

OpenClaw 官方文档说明，默认配置文件在：
环境变量会从以下位置读取：
建议你重点记住这些位置：
  1. ~/.openclaw/
  2. ├── openclaw.json          # 主配置文件
  3. ├── .env                   # API key / token 等敏感信息
  4. ├── credentials/           # 渠道与认证状态
  5. ├── workspace/             # 默认工作区
  6. └── logs / 其他运行状态    # 依版本与插件而定
复制代码
官方还说明：~/.openclaw/openclaw.json 的改动多数情况下支持热加载，不一定每次都需要手工重启。20
8. 推荐的 openclaw.json 基础模板

下面给你一份比较适合腾讯云长期运行的基础版模板：
  1. {
  2.   gateway: {
  3.     bind: "loopback",
  4.     port: 18789,
  5.     auth: {
  6.       mode: "token",
  7.       token: "${OPENCLAW_GATEWAY_TOKEN}"
  8.     },
  9.     reload: {
  10.       mode: "hybrid",
  11.       debounceMs: 300
  12.     }
  13.   },
  15.   env: {
  16.     shellEnv: { enabled: true, timeoutMs: 15000 }
  17.   },
  19.   agents: {
  20.     defaults: {
  21.       workspace: "~/.openclaw/workspace",
  22.       model: {
  23.         primary: "volcengine/doubao-seed-1-8-251228",
  24.         fallbacks: ["zai/glm-5", "moonshot/kimi-k2.5"]
  25.       }
  26.     }
  27.   },
  29.   models: {
  30.     mode: "merge",
  31.     providers: {
  32.       moonshot: {
  33.         baseUrl: "https://api.moonshot.ai/v1",
  34.         apiKey: "${MOONSHOT_API_KEY}",
  35.         api: "openai-completions",
  36.         models: [{ id: "kimi-k2.5", name: "Kimi K2.5" }]
  37.       }
  38.     }
  39.   },
  41.   skills: {
  42.     mode: "merge"
  43.   }
  44. }
复制代码
这个模板体现了几个原则：
9. 国内外渠道/平台接入方法

先说最关键的一句：
微信、飞书、小艺、Telegram、Slack 这些大多不是 skills，而是 channel / plugin / platform integration。
所以你的接入思路应该是：
9.1 Feishu / 飞书（推荐的国内办公入口）

OpenClaw 官方渠道页说明：
CLI 接入
  1. openclaw channels add# 选择 Feishu，填 App ID / App Secret
复制代码
最小配置示例
  1. {
  2.   channels: {
  3.     feishu: {
  4.       enabled: true,
  5.       dmPolicy: "pairing",
  6.       accounts: {
  7.         main: {
  8.           appId: "cli_xxx",
  9.           appSecret: "xxx",
  10.           botName: "My AI assistant"
  11.         }
  12.       }
  13.     }
  14.   }
  15. }
复制代码
官方 Feishu 文档还给了比较完整的控制台步骤：创建企业应用、获取 App ID / App Secret、导入权限、启用 bot 能力、事件订阅选择 Use long connection to receive events (WebSocket)，并添加事件 im.message.receive_v1。21
对中国区办公协作场景来说，Feishu 是目前最适合放在第一优先级的国内渠道。
9.2 微信（WeChat）

目前 OpenClaw 官方文档没有把“微信个人号”列成第一方正式 channel，但官方 Community plugins 页面已经收录了一个高质量微信社区插件：
  1. openclaw plugins install @icesword760/openclaw-wechat
复制代码
官方社区插件页对它的描述是：通过 **WeChatPadPro（iPad 协议）**连接微信个人号，支持文本、图片、文件等。22
更详细的社区配置参考

另一个社区插件 README（@canghe/openclaw-wechat）给出了较完整的云端配置示例，包括：
示例大致是：
  1. {
  2.   channels: {
  3.     wechat: {
  4.       enabled: true,
  5.       apiKey: "wc_live_xxxxxxxxxxxxxxxx",
  6.       proxyUrl: "http://your-proxy:3000",
  7.       webhookHost: "你的公网 IP 或域名",
  8.       webhookPort: 18790,
  9.       webhookPath: "/webhook/wechat",
  10.       deviceType: "ipad"
  11.     }
  12.   }
  13. }
复制代码
微信接入时你要特别注意的 4 个点

因此：
9.3 LINE

OpenClaw 官方 LINE 文档说明：
所以 LINE 更适合：
9.4 Telegram / Slack / Discord / WhatsApp

这些都在官方 channels 文档里，通常比微信类社区插件更成熟。官方还明确说：
如果你只是想尽快验证整套 Gateway 正常工作，建议你先接：
这样排错最容易。
9.5 华为小艺智能体（Xiaoyi / HarmonyOS）

这个部分要单独说明：
它不是传统意义上的 OpenClaw skill

根据华为官方开发者文档检索结果，小艺开放平台已经新增 OpenClaw 模式。官方检索摘要显示：
这意味着什么

这说明“小艺”更像是：
当前最稳的操作建议

由于华为相关页面在当前环境里无法完整渲染出字段级文档，我建议你按下面思路接：
我对你更务实的建议

10. Skills 的安装、检查与更新（Linux）

Linux 上安装 skills，官方 FAQ 的原话很明确：
10.1 安装 ClawHub CLI
  1. npm i -g clawhub
  2. # 或 pnpm add -g clawhub
复制代码
10.2 搜索、安装、更新 skills
  1. clawhub search "calendar"
  2. clawhub install<skill-slug>
  3. clawhub update --all
复制代码
OpenClaw 官方 skills / ClawHub 文档给出的常见动作就是这些。628
10.3 检查 skill 是否真的可用
  1. openclaw skills list
  2. openclaw skills check -v
  3. openclaw skills info <skill-name>
复制代码
如果某个 skill 显示 blocked，通常说明：
官方 FAQ 也明确提到：Linux 上不能直接跑仅限 macOS 的技能，除非你采用 Mac gateway 或 Mac node 等特殊架构。5
10.4 国内外常见扩展思路

更适合放进“skills / 工具能力”的方向

更适合放进“channel / plugin”的方向

所以你后续扩展时，优先记住一句：
平台入口优先看 channel/plugin，任务能力优先看 skill。
11. MCP 工具怎么接：当前稳定做法与实验性做法

这是本文里最容易被写错的一段，所以我拆成两部分。
11.1 当前稳定判断

截至我检索到的文档与社区讨论：
所以如果你现在是在腾讯云上做稳定生产部署，我的建议是：
不要把 MCP 放成第一天必须完成的事项

先跑通：
然后再回来折腾 MCP。
11.2 当前更现实的 MCP 方法：走 mcporter / provider-specific bridge

OpenClaw 默认能力清单里已经把 mcporter 描述为：
用于管理外部 Skill 后端的工具服务器运行时 / CLI。29
另外，社区近期 issue 也显示：
你应该怎么理解这件事

11.3 我建议的 MCP 实施顺序

第一优先级：先用 OpenClaw 自带 tools + skills

很多你以为要靠 MCP 做的事，OpenClaw 当前已经能通过：
直接完成。
第二优先级：只接你最需要的 1 个 MCP

例如：
不要一次上 5 个。
第三优先级：把 MCP 配置跟主配置隔离管理

如果你后面真的走 mcporter，建议你把这部分单独放在工作区 config/ 下，避免把主配置文件越改越乱。
12. 常见问题与避坑建议

12.1 不要用 root 直接跑 Gateway

OpenClaw 官方安全模型是“一个 Gateway 对应一个可信边界”，而不是多租户隔离平台。长期运行时，用专门普通用户比 root 更稳。1112
12.2 Dashboard 不要直接裸露公网

更推荐：
例如：
  1. ssh-N-L18789:127.0.0.1:18789 openclaw@<你的腾讯云IP>
复制代码
然后在本地打开：
  1. http://127.0.0.1:18789/
复制代码
12.3 需要 webhook 的渠道，才考虑公网 HTTPS

所以不要为了 Dashboard 方便就把 18789 公网放开。
12.4 插件只装你明确信任的

官方安全审计清单明确把插件 / 扩展列为需要重点留意的风险面之一。32
12.5 Linux 上 skill 安装方式跟 macOS 不一样

Linux 没有 macOS 那种 Skills UI，记住用 ClawHub。5
12.6 当前 MCP 仍处于“可用但不够定型”的阶段

如果你今天的目标是“先把智能体跑起来”，那就先别让 MCP 拖慢主线。
13. 一套建议你直接照抄的落地顺序

如果你想尽量少踩坑，直接按这个顺序做：
第 1 步：腾讯云准备

第 2 步：系统初始化
  1. sudoapt update &&sudoapt upgrade -ysudoaptinstall-ycurlgit jq ca-certificates build-essential unzipsudo adduser openclaw
  2. sudousermod-aGsudo openclaw
  3. su - openclaw
复制代码
第 3 步：安装 OpenClaw
  1. curl-fsSL https://openclaw.ai/install.sh |bashsource ~/.bashrc
  2. openclaw onboard --install-daemon
复制代码
第 4 步：先接方舟模型

优先选：
第 5 步：确认 Gateway 正常
  1. openclaw gateway status
  2. openclaw logs --follow
复制代码
第 6 步：本地用 SSH 隧道打开 Dashboard
  1. ssh-N-L18789:127.0.0.1:18789 openclaw@<你的腾讯云IP>
复制代码
第 7 步：先接一个最稳的渠道

优先顺序建议：
第 8 步：再接国内增强项

第 9 步：最后再做 skills 和 MCP
  1. npm i -g clawhub
  2. clawhub search "calendar"
  3. clawhub install<skill-slug>
  4. openclaw skills check -v
复制代码
MCP 则只挑一个最需要的场景开始试，不要一次铺太大。
参考资料


原文地址：https://blog.csdn.net/m0_46808930/article/details/158979136



欢迎光临 AI创想 (http://llms-ai.com/) Powered by Discuz! X3.4