从零搭建AI智能体:OpenClaw 阿里云云部署、订阅开通、对接配置百炼Coding Plan与Token Plan与排错完整指南

简介: OpenClaw作为开源AI智能体框架,依靠灵活可扩展的技能体系、多平台消息对接、自主任务执行能力,成为个人开发者、小型团队搭建专属AI助手的主流选择。它可以自主读取本地文件、执行脚本、访问网页、拆解复杂多步骤任务,实现办公自动化、代码辅助、信息搜集等场景。计算巢服务可以把实例创建、环境依赖、应用安装全部自动化处理,不用手动处理繁琐的编译、环境配置;百炼平台的Coding Plan、Token Plan两套订阅方案,分别面向代码开发、通用多模态推理场景,为OpenClaw提供稳定的大模型算力底座。本文完整覆盖部署前准备、轻量应用服务器部署、计算巢模板一键部署、订阅开通、API密钥获取、Open

OpenClaw作为开源AI智能体框架,依靠灵活可扩展的技能体系、多平台消息对接、自主任务执行能力,成为个人开发者、小型团队搭建专属AI助手的主流选择。它可以自主读取本地文件、执行脚本、访问网页、拆解复杂多步骤任务,实现办公自动化、代码辅助、信息搜集等场景。计算巢服务可以把实例创建、环境依赖、应用安装全部自动化处理,不用手动处理繁琐的编译、环境配置;百炼平台的Coding Plan、Token Plan两套订阅方案,分别面向代码开发、通用多模态推理场景,为OpenClaw提供稳定的大模型算力底座。本文完整覆盖部署前准备、轻量应用服务器部署、计算巢模板一键部署、订阅开通、API密钥获取、OpenClaw配置对接、功能验证、运维扩展、问题排查全链路,附带大量可直接复制运行的命令,帮助使用者快速完成从资源开通到智能体正常可用的完整流程。

一、部署前期准备:账号、权限与前置条件

正式部署应用之前,需要完成账号、服务开通、权限配置,避免后续部署、调用出现权限报错。

  1. 账号注册与实名认证
    登录阿里云控制台完成账号注册,必须完成实名认证,未做实名认证的账号无法使用计算巢、百炼大模型相关服务。推荐支付宝授权扫脸完成认证,流程简便。使用按量付费模式时,账户余额建议预留不低于100元,防止部署阶段余额不足导致资源创建失败。

  2. 开通百炼大模型服务
    控制台搜索百炼进入大模型服务平台,点击立即开通,开通本身不收取费用。开通之后就可以访问模型体验、密钥管理、订阅管理页面,后续生成API密钥、购买Coding Plan与Token Plan都依赖该服务。详情👉访问阿里云百炼大模型服务平台页面 了解。
    image.png
    bailian1.png
    bailian2.png

  3. RAM子账号权限配置(可选)
    如果日常使用RAM子账号操作,主账号需要在RAM控制台授予一组权限策略,分别为AliyunBSSFullAccessAliyunComputeNestUserFullAccessAliyunDashScopeFullAccessAliyunTokenPlanFullAccess。缺少其中任意权限,子账号会出现部署失败、无法读取订阅密钥、调用模型鉴权失败等问题。

选型小提示:OpenClaw有两套主流部署路径。第一种是轻量应用服务器预装镜像,适合零基础,可视化点击操作居多;第二种是计算巢模板部署,适合需要自定义实例规格、后续做二次开发的使用者。内存最低要求2GiB,推荐2核4G起步,高并发场景选择4核8G。

二、方案一:轻量应用服务器预装镜像快速部署

阿里云部署AI Agent:OpenClaw/Hermes Agent全网最简单,只需两步,详情👉访问阿里云OpenClaw/Hermes一键部署专题页面了解。
OpenClaw1.png
OpenClaw2.png
OpenClaw02.png
openClaw3.png
OpenClaw031.png
OpenClaw03.png
OpenClaw04.png
OpenClaw5.png
Openclaw6.png
Token Plan Token 最便宜/支持多模型切换:👉访问订阅阿里云百炼Token Plan AI大模型服务 。支持多模型切换,用于多模态模型灵活调用,实现多模型、多工具、多场景下的额度共享与统一管理,兼顾灵活性、稳定性与安全性,大幅降低企业使用大模型的门槛与成本。
tokenplan1.png
tokenplan1.png
tokenplan2.png
tokenplan3.png
tokenplan4.png
轻量应用服务器提供预制OpenClaw的应用镜像,开箱预置运行环境,大部分操作在控制台可视化完成,适合新手。

  1. 实例购买参数设置
    进入轻量应用服务器购买页面,应用镜像选择OpenClaw;内存至少2GiB;地域需要注意,如果需要完整联网搜索能力,优先选择海外地域;购买时长按需选择。已经拥有服务器实例的,可以通过重置系统磁盘,重新选择该预制镜像。

  2. 百炼控制台生成API‑Key
    进入百炼控制台,打开密钥管理,点击创建API‑Key,复制保存密钥字符串。如果要使用订阅套餐,需要先完成Coding Plan或者Token Plan订阅,再生成套餐专属API‑Key。注意:Coding Plan、Token Plan、普通按量付费的API‑Key互相独立,不可混用。

  3. 实例控制台完成初始化配置
    进入轻量实例详情,切换应用详情标签页。

  • 执行端口放通命令:开放18789端口,该端口是OpenClaw WebUI服务端口;
  • 执行配置API‑Key命令,粘贴百炼订阅生成的密钥;
  • 执行初始化命令生成Web访问Token凭证;
  • 执行获取访问地址命令,拿到WebUI访问链接。

完成之后浏览器打开该地址,输入访问Token,就可以进入OpenClaw交互界面。

三、方案二:计算巢模板一键部署OpenClaw

计算巢将ECS实例创建、操作系统初始化、依赖包安装、OpenClaw部署全部封装成模板,5‑10分钟完成整套环境,适合需要更高弹性、自定义实例配置的场景。

  1. 搜索部署模板
    进入计算巢服务控制台,搜索OpenClaw官方社区部署模板。模板内置操作系统、全套依赖、基础配置,不需要手动编译源码。

  2. 填写部署参数

  • 服务名称:自定义,例如OpenClaw‑Agent‑Demo
  • 地域:优先选择网络延迟低的地域,如华东、华北;
  • 实例规格:入门2核4G,高并发业务4核8G;
  • 设置管理员登录密码,妥善保管,用于SSH远程登录;
  • 安全组端口:模板会自动放行18789端口;
    其余参数保持默认即可。

确认订单,勾选协议,点击立即创建。系统自动创建云服务器、初始化环境、部署应用,等待几分钟,实例状态变为部署完成。

  1. 远程登录实例验证安装结果
    在实例详情页,使用Workbench远程连接,输入管理员密码进入终端,执行下面命令:
    #切换root用户
    sudo su root
    #查看OpenClaw版本,确认安装成功
    openclaw --version
    #启动网关核心服务
    openclaw gateway start
    #查看网关运行状态
    systemctl status openclaw‑gateway
    
    输出active (running),代表网关服务正常运行。

四、百炼两套订阅计划开通与API密钥获取

Coding Plan与Token Plan定位完全不同,需要根据业务场景选择。

  • Coding Plan:按请求次数计费,适合高频代码生成、脚本调试场景;
  • Token Plan:按Credits折算Token消耗,适合通用问答、长文档、图像视频多模态业务。

4.1 Coding Plan订阅与密钥获取

  1. 在百炼控制台,计费管理进入Coding Plan订阅页面,选择档位完成支付;
  2. 进入API密钥管理页面,创建套餐专属API‑Key,格式一般为sk‑sp‑xxxx
  3. 记录Coding Plan兼容OpenAI接口的BaseURL:https://coding.dashscope.aliyuncs.com/v1

4.2 Token Plan订阅与密钥获取

  1. 计费管理进入Token Plan页面,选择个人或者团队版,选择档位完成订阅;
  2. 团队版需要先分配席位,再生成专属API‑Key;
  3. 记录Token Plan兼容接口BaseURL:https://token‑plan.cn‑beijing.maas.aliyuncs.com/compatible‑mode/v1

重要提醒:两套订阅生成的密钥不能混用,Coding Plan密钥只能访问Coding Plan接口,Token Plan密钥只能访问Token Plan接口。

五、OpenClaw配置对接Coding Plan、Token Plan

部署完成之后,修改OpenClaw配置文件,接入两套订阅的模型服务,两套方案可以共存,按需切换模型。

  1. 远程登录服务器,进入配置目录

    sudo su root
    cd ~/.openclaw
    ls
    

    可以看到核心配置文件openclaw.json

  2. 配置Coding Plan(代码开发场景)
    编辑openclaw.json,新增provider配置:

    {
         
    "models": {
         
     "providers": {
         
       "bailian_coding": {
         
         "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
         "apiKey": "sk‑sp‑xxxxxxxxxxxxxxxxxxxxxxxx",
         "models": [
           {
         
             "id": "qwen‑coder‑turbo",
             "name": "Qwen Coder Turbo"
           },
           {
         
             "id": "qwen‑turbo",
             "name": "Qwen Turbo"
           }
         ],
         "timeout": 30
       }
     }
    }
    }
    
  3. 配置Token Plan(通用AI、多模态场景)
    继续在providers节点下增加Token Plan配置,与coding配置同级:

    "bailian_token": {
         
    "baseUrl": "https://token‑plan.cn‑beijing.maas.aliyuncs.com/compatible‑mode/v1",
    "apiKey": "sk‑sp‑xxxxxxxxxxxxxxxxxxxxxxxx",
    "models": [
     {
         
       "id": "qwen‑max",
       "name": "Qwen Max"
     },
     {
         
       "id": "qwen‑long",
       "name": "Qwen Long"
     }
    ],
    "timeout": 30
    }
    
  4. 设置模型优先级与默认模型

    "agents": {
         
    "defaults": {
         
     "model": {
         
       "primary": "bailian_coding/qwen‑coder‑turbo"
     }
    }
    },
    "models": {
         
    "priority": ["bailian_coding","bailian_token"]
    }
    
  5. 重载配置让修改生效

    openclaw config reload
    

安全优化建议:不要把密钥明文写进配置文件,可以使用环境变量保存密钥。示例:

#会话临时生效
export DASHSCOPE_API_KEY_CODING="sk‑sp‑xxxxxx"
export DASHSCOPE_API_KEY_TOKEN="sk‑sp‑xxxxxx"
#写入bashrc永久生效
echo "export DASHSCOPE_API_KEY_CODING=sk‑sp‑xxxxxx" >> ~/.bashrc
echo "export DASHSCOPE_API_KEY_TOKEN=sk‑sp‑xxxxxx" >> ~/.bashrc
source ~/.bashrc

配置文件内apiKey字段改为{"source":"env","id":"DASHSCOPE_API_KEY_CODING"}读取环境变量密钥。

六、功能验证、WebUI启动、开机自启配置

配置完成,需要验证模型调用是否正常,同时配置服务开机自动启动。

  1. 设置网关开机自启

    systemctl enable openclaw‑gateway
    #查看是否开启成功,输出enabled代表成功
    systemctl is‑enabled openclaw‑gateway
    
  2. 进入OpenClaw交互终端测试模型调用

    openclaw
    #测试代码模型
    请写一个Python快速排序函数
    #测试通用大模型
    简单介绍OpenClaw智能体框架
    

    模型正常返回结果,说明对接订阅套餐成功。

  3. 启动WebUI可视化管理界面

    openclaw webui start --port 18789
    

    浏览器访问http://服务器公网IP:18789,输入访问Token,即可进入可视化界面,可以管理技能、会话、模型切换。

七、扩展能力:ClawHub技能市场、多消息网关配置

OpenClaw的能力依靠技能扩展,ClawHub是官方技能市场,可以一键安装社区开发的工具技能。

  1. 安装ClawHub CLI工具

    pip install clawhub
    #搜索可用技能
    clawhub search 文件处理
    #安装文件处理技能
    clawhub install file‑processor
    #重启网关加载新技能
    openclaw gateway restart
    
  2. 多消息平台网关,对接飞书、钉钉等IM平台

    #开启飞书消息网关
    openclaw gateway start --provider feishu
    #开启钉钉消息网关
    openclaw gateway start --provider dingtalk
    

八、高频故障排查避坑指南

  1. 部署失败,提示资源不足
    更换资源充足地域,实例规格不低于2核4G;检查账户余额是否充足。

  2. 模型调用返回鉴权报错
    确认API‑Key是对应订阅套餐生成,Coding Plan、Token Plan密钥不可混用;核对BaseURL地址;RAM账号确认已经授予全套权限。

  3. WebUI浏览器访问打不开页面
    检查安全组/防火墙是否放行18789端口;执行systemctl status openclaw‑gateway确认网关服务处于running状态。

  4. 网关服务启动失败,依赖缺失

    pip install openclaw dashscope openai
    
  5. 订阅额度耗尽,调用失败
    进入百炼订阅管理页面查看剩余额度,升级套餐档位,或者切换按量付费模式临时过渡。

  6. 重载配置不生效
    修改完json配置文件,确认JSON格式没有语法逗号、括号错误,再执行openclaw config reload

九、选型总结

OpenClaw可以通过轻量预装镜像快速上手,适合零基础个人使用者;计算巢模板部署适合需要自定义实例、二次开发的团队。Coding Plan更加适配代码脚本、编程助手高频短请求;Token Plan适配长文档、多模态图像视频等通用AI任务。两套订阅可以同时配置在OpenClaw中,业务场景不同随时切换模型。

整套流程关键点:密钥区分、权限完整授予、端口放行、配置文件JSON语法校验、定期监控订阅额度。完成全部配置后,就拥有一套可以自主执行任务、支持技能扩展、对接多消息平台的私有化AI智能体。在实际生产使用中,建议限制服务器访问白名单,保管好API‑Key与WebUI访问Token,避免密钥泄露带来额度异常消耗风险。

目录
相关文章
人工智能 缓存 前端开发
12684 74
|
5天前
|
人工智能 自然语言处理 安全
阿里云千问办公、Qoder Teams、Qoder CN区别与选择指南:模型能力、适用场景与最新活动参考
本文聚焦阿里云2026年推出的三款自研AI办公产品,清晰拆解千问办公、Qoder Teams、Qoder CN的差异化定位与能力边界:千问办公主打职场全场景提效,支持自然语言指令一键完成PPT生成、数据分析等高频办公任务;Qoder Teams面向程序员团队,深度整合AI代码生成、团队协同与企业知识库能力;Qoder CN则专为金融、政务等强合规场景打造,实现数据不出境与VPC私有化部署。文章同步给出分场景选型指南与最新活动定价,帮助不同类型的企业按需组合产品,实现业务岗、研发岗与强合规场景的AI能力全覆盖。
阿里云千问办公、Qoder Teams、Qoder CN区别与选择指南:模型能力、适用场景与最新活动参考
Web App开发 人工智能 API
1595 2
|
人工智能 JavaScript 开发工具
DeepSeek Harness 本地安装与使用指南
DeepSeek Harness(DSH)是DeepSeek AI开源的Agent运行框架,支持本地文件操作、命令执行与工具调用。基于Cordis插件架构,具备高扩展性与强可控性,适合开发者搭建可控Agent环境或开展模型基准测试。当前为开发者预览版,需Node.js环境,推荐先用`npx @deepseek-ai/dsh web`快速体验。
4944 0
人工智能 Java BI
1697 1
人工智能 JavaScript 测试技术
2658 2
开发工具 Swift git
2013 6
人工智能 JavaScript 测试技术
1266 4