2026新版OpenClaw/Clawdbot完全指南:一键部署+命令大全+实战Skills,从入门到精通

简介: OpenClaw 作为开源AI助手的标杆,更新速度持续领跑行业,最新 v2026.2.12 版本已原生支持飞书通道,无需额外开发webhook或寻找第三方插件,彻底解决了中国用户的核心痛点。对于新手而言,掌握部署流程与常用命令是发挥其强大功能的基础;对于进阶用户,熟练运用模型切换、插件管理、浏览器自动化等命令,能大幅提升工作效率。

OpenClaw 作为开源AI助手的标杆,更新速度持续领跑行业,最新 v2026.2.12 版本已原生支持飞书通道,无需额外开发webhook或寻找第三方插件,彻底解决了中国用户的核心痛点。对于新手而言,掌握部署流程与常用命令是发挥其强大功能的基础;对于进阶用户,熟练运用模型切换、插件管理、浏览器自动化等命令,能大幅提升工作效率。
openClaw3.png

本文先提供阿里云OpenClaw(Clawdbot)极速部署简单步骤,再系统梳理7大类核心命令(基础操作、诊断排错、模型管理、网关通道、插件技能、浏览器自动化、配置文件),搭配实战示例与避坑指南,文中所有代码均可直接复制执行,全程规避其他云厂商名称,帮助不同层级用户快速上手。

一、阿里云OpenClaw(Clawdbot)部署简单步骤(v2026.2.12 适配版)

阿里云凭借稳定的弹性计算环境与国内优化的网络链路,成为OpenClaw部署的优选平台,v2026.2.12版本适配性更强,新手仅需6步即可完成云端部署,为后续命令操作奠定基础,OpenClaw部署详情 访问阿里云OpenClaw一键部署专题页面 了解。
OpenClaw1.png

核心部署6步速通(直接复制执行)

  1. 创建阿里云轻量应用服务器实例:登录阿里云控制台,选择中国香港/新加坡地域(免ICP备案,网络通达性强),配置选择2vCPU+4GiB内存+60GiB ESSD(满足v2026.2.12版本及多插件同时运行),镜像选择“Ubuntu 22.04-Docker 26”,完成支付后记录服务器公网IP
  2. 远程连接并安装OpenClaw核心程序
    # 远程连接服务器(替换为你的公网IP)
    ssh root@你的服务器公网IP
    # 一键安装OpenClaw v2026.2.12(自动搞定依赖与版本适配)
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --version 2026.2.12
    
  3. 交互式初始化配置
    脚本执行后进入配置向导,按以下步骤操作:
  • 安全提示:输入Yes确认已阅读安全须知;
  • 配置模式:选择QuickStart(快速配置,细节后续优化);
  • 模型选择:移动光标选择bailian/qwen3-max(阿里云百炼千问,适配中文场景);
  • 认证方式:选择API Key,输入从阿里云百炼控制台获取的API-Key;
  • 通信渠道:选择Skip for now(后续单独配置飞书);
  • 完成配置:选择Done,等待服务初始化。
  1. 配置阿里云加速源与端口放行
    # 设置ClawHub阿里云镜像源,解决海外资源下载超时问题
    openclaw config set clawhub.mirror "https://mirror.aliyun.com/clawhub/"
    # 放行核心端口(18789:Web控制台,8080:通道通信)
    firewall-cmd --add-port=18789/tcp --permanent && firewall-cmd --add-port=8080/tcp --permanent && firewall-cmd --reload
    
  2. 启动服务并设置开机自启
    # 启动OpenClaw服务
    sudo systemctl start openclaw
    # 设置开机自启,避免服务器重启后服务中断
    sudo systemctl enable openclaw
    # 验证服务状态(返回active(running)即为成功)
    sudo systemctl status openclaw
    
  3. 部署验证与版本确认
    # 查看OpenClaw版本(确认已安装v2026.2.12)
    openclaw --version
    # 打开Web控制台(浏览器输入以下地址,替换为公网IP)
    # http://你的服务器公网IP:18789
    

部署关键说明

  • 地域选择:中国香港地域延迟低,适合国内用户;新加坡地域支持跨境通信,适配Telegram等海外通道;
  • 配置要求:2vCPU+4GiB内存可满足基础使用,若需同时运行多个插件与技能,建议升级至4vCPU+8GiB配置;
  • 版本适配:v2026.2.12已原生支持飞书,无需额外安装插件,部署后可直接配置飞书通道。

阿里云用户零基础部署OpenClaw步骤喂饭级步骤流程

第一步:访问阿里云OpenClaw一键部署专题页面,找到并点击【一键购买并部署】。
阿里云OpenClaw一键部署专题页面:https://www.aliyun.com/activity/ecs/clawdbot
OpenClaw1.png
OpenClaw02.png
OpenClaw2.png
第二步:选购阿里云轻量应用服务器,配置参考如下:

  • 镜像:OpenClaw(Moltbot)镜像(已经购买服务器的用户可以重置系统重新选择镜像)
  • 实例:内存必须2GiB及以上。
  • 地域:默认美国(弗吉尼亚),目前中国内地域(除香港)的轻量应用服务器,联网搜索功能受限。
  • 时长:根据自己的需求及预算选择。
    轻量应用服务器OpenClaw镜像.png
    bailian1.png
    bailian2.png
    第三步:访问阿里云百炼大模型控制台,找到密钥管理,单击创建API-Key。
    阿里云百炼密钥管理图.png
    前往轻量应用服务器控制台,找到安装好OpenClaw的实例,进入「应用详情」放行18789端口、配置百炼API-Key、执行命令,生成访问OpenClaw的Token。
    阿里云百炼密钥管理图2.png
  • 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
  • 配置百炼API-Key,单击一键配置,输入百炼的API-Key。单击执行命令,写入API-Key。
  • 配置OpenClaw:单击执行命令,生成访问OpenClaw的Token。
  • 访问控制页面:单击打开网站页面可进入OpenClaw对话页面。

二、OpenClaw 7大类核心命令详解(附实战示例)

(一)基础操作命令(新手必会,0门槛)

这类命令覆盖安装后的初始化、服务启停、界面打开等基础操作,是使用OpenClaw的第一步。

命令 功能描述 实战示例 执行效果
openclaw --version 查看当前版本号 openclaw --version 输出:OpenClaw 2026.2.12 (f9e444d)
openclaw --help 查看所有命令与参数 openclaw --help 列出所有命令分类及核心参数
openclaw onboard 启动配置向导 openclaw onboard 重新进入初始化配置界面,可修改模型、通道等
openclaw tui 打开终端对话界面 openclaw tui 启动交互式终端聊天,新手推荐使用
openclaw dashboard 打开Web控制台 openclaw dashboard 自动跳转至http://127.0.0.1:18789
openclaw restart 重启服务 openclaw restart 输出:Restarting OpenClaw... Service restarted successfully
openclaw stop 停止服务 openclaw stop 输出:Stopping OpenClaw... Service stopped
openclaw update 更新到最新版本 openclaw update 检测并升级至最新版,当前为v2026.2.12则提示已最新

新手入门流程

# 1. 确认版本
openclaw --version
# 2. 启动配置向导
openclaw onboard
# 3. 打开终端聊天界面
openclaw tui
# 4. 后续如需修改配置,重启服务
openclaw restart

(二)诊断与排错命令(出问题就用,高效解决)

遇到服务无法启动、通道连接失败、技能调用报错等问题时,这类命令能快速定位原因并尝试修复,是保障OpenClaw稳定运行的关键。

命令 功能描述 常用参数 实战示例
openclaw doctor 全面健康检查 openclaw doctor
openclaw doctor --fix 自动修复常见问题 openclaw doctor --fix
openclaw status 查看运行状态 --all(显示完整信息)、--deep(深度检测) openclaw status --deep
openclaw logs 查看运行日志 openclaw logs
openclaw gateway status 查看网关状态 openclaw gateway status

实战场景

  1. 服务启动失败,执行健康检查与自动修复:
    ```bash

    执行全面健康检查

    openclaw doctor

    输出示例:

    Running health check...

    Gateway: running

    Channels: 2 connected

    Plugins: 5 loaded

    Config: credentials dir mode 755

自动修复检测到的问题

openclaw doctor --fix

输出示例:

Attempting auto-fix...

√ Fixed: chmod 700 credentials


2. 深度检查网关与端口状态:
```bash
openclaw status --deep
# 输出示例:
# Overview
# | Dashboard | http://127.0.0.1:18789 |
# | Gateway   | ws://127.0.0.1:18789   |
# | Agents    | 1 · sessions 2          |
# | Memory    | enabled                |
  1. 查看错误日志排查问题:
    openclaw logs
    # 输出示例(关键日志):
    # [08:30:15] INFO Gateway started
    # [08:30:16] SUCCESS Session created
    # [09:10:23] ERROR Feishu channel connection failed: invalid appSecret
    

(三)模型管理命令(配置/切换AI模型,适配不同场景)

OpenClaw支持多模型切换,可根据任务类型(写作、编码、数据分析)选择最优模型,v2026.2.12版本新增对阿里云百炼千问、智谱GLM-4.7等国内模型的原生支持。

命令 功能描述 实战示例 执行效果
openclaw models list 列出已配置模型 openclaw models list 显示所有可用模型及默认模型
openclaw models set <模型名> 切换默认模型 openclaw models set bailian/qwen3-max 设置百炼千问为默认模型
openclaw models auth login --provider <提供商> OAuth登录认证 openclaw models auth login --provider qwen-portal 打开浏览器完成OAuth登录
openclaw models auth paste-token --provider <提供商> Token认证 openclaw models auth paste-token --provider openai 手动输入API-Key完成认证

常用模型切换示例

  1. 切换到阿里云百炼千问:

    openclaw models set bailian/qwen3-max-2026-01-23
    # 输出:Default model updated
    
  2. 切换到智谱GLM-4.7:

    openclaw models set zai/glm-4.7
    # 输出:Default model updated
    
  3. 切换到MiniMax:

    openclaw models set minimax/MiniMax-M2.1
    # 输出:Default model updated
    
  4. 查看当前已配置模型:

    openclaw models list
    # 输出示例:
    # Configured models:
    # · kimi-coding/k2p5 (default)
    # · bailian/qwen3-max
    # · zai/glm-4.7
    # · minimax/MiniMax-M2.1
    

进阶配置:手动添加第三方模型(如火山引擎模型)
若需使用未内置的第三方模型,可编辑配置文件添加:

# 编辑主配置文件
nano ~/.openclaw/openclaw.json

models.providers中添加模型配置:

"models": {
   
  "providers": {
   
    "huoshan": {
   
      "type": "api-key",
      "apiKey": "你的火山引擎API-Key",
      "models": {
   
        "huoshan/quark": {
   
          "contextWindow": 128000,
          "maxTokens": 8192
        }
      }
    }
  }
}

保存后重启服务:openclaw restart

(四)网关与通道管理命令(连接聊天软件,实现多端交互)

v2026.2.12版本最大亮点是原生支持飞书通道,无需额外插件,同时兼容Telegram、Discord等10+通信平台,通过以下命令可快速配置与管理通道。

4.1 网关核心命令(Gateway是服务核心)

命令 功能描述 常用参数 实战示例
openclaw gateway 启动网关 --port <端口>(指定端口)、--verbose(显示详细日志) openclaw gateway --port 8080
openclaw gateway restart 重启网关 openclaw gateway restart
openclaw gateway status 查看网关状态 openclaw gateway status

4.2 通道管理命令(连接飞书、Telegram等)

命令 功能描述 实战示例
openclaw channels list 列出已配置通道 openclaw channels list
openclaw channels status 查看所有通道状态 openclaw channels status
openclaw channels add 交互式添加通道 openclaw channels add
openclaw channels add --channel <通道名> --token <令牌> 非交互式添加通道 openclaw channels add --channel telegram --token "你的Telegram Bot Token"
openclaw channels remove --channel <通道名> 移除通道 openclaw channels remove --channel slack
openclaw channels logs 查看通道日志 openclaw channels logs --channel feishu

飞书通道配置实战(v2026.2.12原生支持)

  1. 启用飞书插件(v2026.2.12已预装,仅需启用):

    openclaw plugins enable feishu
    # 输出:Enabled: @openclaw/feishu
    
  2. 交互式添加飞书通道:

    openclaw channels add --channel feishu
    # 按提示输入飞书AppID和AppSecret:
    # Enter Feishu AppID: cli_a9f21xxxxx89bcd
    # Enter Feishu AppSecret: w6cPunaxxxxBl1HHtdF
    # 配置完成后输出:Feishu channel added successfully
    
  3. 查看飞书通道状态:

    openclaw channels status
    # 输出示例:
    # Channels:
    # · telegram connected
    # · feishu connected
    # · slack X disconnected
    

支持的通道类型:whatsapp、telegram、discord、slack、googlechat、signal、imessage、msteams、mattermost、feishu(v2026.2.12新增)

(五)插件与技能管理命令(扩展功能,解锁更多场景)

插件(Plugin)用于连接外部平台,技能(Skill)用于扩展核心功能,通过ClawHub管理,v2026.2.12版本优化了插件加载速度与技能兼容性。

5.1 插件管理命令

命令 功能描述 实战示例
openclaw plugins list 列出所有插件 openclaw plugins list
openclaw plugins enable <插件名> 启用插件 openclaw plugins enable feishu
openclaw plugins disable <插件名> 禁用插件 openclaw plugins disable slack
openclaw plugins install <插件名> 安装插件 openclaw plugins install @openclaw/discord
openclaw plugins doctor 检查插件加载错误 openclaw plugins doctor

常用插件清单

  • @openclaw/feishu:飞书集成(v2026.2.12预装)
  • @openclaw/telegram:Telegram机器人
  • @openclaw/whatsapp:WhatsApp集成
  • @openclaw/slack:Slack集成
  • @openclaw/discord:Discord机器人

5.2 技能管理命令(ClawHub)

命令 功能描述 实战示例
openclaw skills list 列出已安装技能 openclaw skills list
clawhub search <关键词> 搜索社区技能 clawhub search pdf
clawhub install <技能名> 安装技能 clawhub install nano-pdf
clawhub list 列出已安装技能 clawhub list
clawhub sync --all 更新所有技能 clawhub sync --all

技能管理实战

  1. 搜索并安装PDF处理技能:
    ```bash

    搜索PDF相关技能

    clawhub search pdf

    输出示例:

    Found 4 skills:

    · nano-pdf v1.0.0

    · pdf-extract v1.0.0

    · pdf-convert v1.0.1

    · pdf-summary v0.9.0

安装nano-pdf技能

clawhub install nano-pdf

输出:Installing nano-pdf... Installed nano-pdf v1.0.0


2. 查看已安装技能并更新:
```bash
# 列出已安装技能
clawhub list
# 输出:· nano-pdf 1.0.0

# 更新所有技能
clawhub sync --all
# 输出:Syncing all skills... All skills are up to date

(六)浏览器自动化命令(网页操作全自动化)

OpenClaw的浏览器自动化功能可模拟人工操作,实现网页打开、内容提取、截图、点击输入等操作,无需手动打开浏览器,适用于信息抓取、流程自动化等场景。

命令 功能描述 实战示例
openclaw browser open <URL> 打开指定网页 openclaw browser open https://github.com/openclaw
openclaw browser snapshot 截取页面快照 openclaw browser snapshot
openclaw browser click <元素> 点击页面元素 openclaw browser click "Sign in"
openclaw browser type <元素> <文字> 输入文字 openclaw browser type "search-box" "OpenClaw"
openclaw browser screenshot 网页截图 openclaw browser screenshot
openclaw browser close 关闭浏览器 openclaw browser close

浏览器自动化实战流程

# 1. 打开OpenClaw GitHub仓库
openclaw browser open https://github.com/openclaw
# 输出:Opening browser.... Browser opened: github.com/openclaw

# 2. 点击"Sign in"按钮
openclaw browser click "Sign in"
# 输出:Clicking element: Sign in

# 3. 在搜索框输入"OpenClaw v2026.2.12"
openclaw browser type "search-box" "OpenClaw v2026.2.12"
# 输出:Typing: OpenClaw v2026.2.12

# 4. 截取当前页面截图
openclaw browser screenshot
# 输出:Screenshot saved to /tmp/screenshot_002.png

# 5. 截取页面快照(结构化内容)
openclaw browser snapshot
# 输出:Capturing snapshot.. Saved to /tmp/snapshot_001.ng

# 6. 关闭浏览器
openclaw browser close
# 输出:Browser closed

(七)配置文件命令(高手进阶,谨慎操作)

OpenClaw的核心配置存储在JSON文件中,新手不建议直接编辑,进阶用户可通过命令查看或修改配置,实现个性化定制。

关键配置文件路径

  • 主配置文件:~/.openclaw/openclaw.json(最重要)
  • 默认工作区:~/.openclaw/workspace/
  • 全局技能目录:~/.openclaw/skills/
  • 记忆存储目录:~/.openclaw/agents/<ID>/memory/
  • 定时任务配置:~/.openclaw/agents/<ID>/cron/jobs.json

配置文件操作命令

命令 功能描述 实战示例
openclaw config 查看当前配置 openclaw config
openclaw config edit 编辑配置文件 openclaw config edit
nano ~/.openclaw/openclaw.json 直接编辑配置文件(Linux/macOS) nano ~/.openclaw/openclaw.json

配置文件操作注意事项

  1. 任何修改后必须重启服务才能生效:openclaw restart
  2. 编辑前建议备份配置文件:cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak
  3. 新手推荐使用openclaw config edit命令,避免直接编辑出错。

实战示例:修改网关端口

# 1. 备份配置文件
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

# 2. 编辑配置文件
nano ~/.openclaw/openclaw.json

# 3. 找到"gateway"配置项,修改port为8081
{
   
  "gateway": {
   
    "port": 8081
  }
}

# 4. 保存退出(Ctrl+O,回车,Ctrl+X)

# 5. 重启服务生效
openclaw restart

# 6. 验证端口修改成功
openclaw status
# 输出中Dashboard地址变为:http://127.0.0.1:8081

三、常见问题排查(命令实战避坑指南)

问题1:飞书通道添加失败,提示“invalid appSecret”

现象:执行openclaw channels add --channel feishu后,提示AppSecret无效。
原因:AppSecret输入错误或飞书应用未开通机器人权限。
解决方案

  1. 重新获取飞书AppSecret(飞书开放平台→应用→凭证与基础信息);
  2. 确保飞书应用已添加“机器人”能力并开通相关权限;
  3. 重新添加飞书通道:
    # 先移除错误通道
    openclaw channels remove --channel feishu
    # 重新交互式添加,仔细输入AppID和AppSecret
    openclaw channels add --channel feishu
    

问题2:模型切换后,技能调用报错“model not found”

现象:执行openclaw models set bailian/qwen3-max后,调用技能提示模型未找到。
原因:模型名称输入错误或未完成认证。
解决方案

  1. 查看已配置模型,确认名称正确:openclaw models list
  2. 若模型未显示,重新添加认证:
    openclaw models auth paste-token --provider qwen-portal
    # 粘贴阿里云百炼API-Key
    
  3. 重启服务后再次切换模型:
    openclaw restart
    openclaw models set bailian/qwen3-max
    

问题3:浏览器自动化命令提示“browser not found”

现象:执行openclaw browser open <URL>后,提示浏览器未找到。
原因:未安装浏览器驱动或系统缺少浏览器。
解决方案

  1. 安装Chrome浏览器及驱动:
    sudo apt update && sudo apt install -y chromium-browser chromium-chromedriver
    
  2. 配置浏览器驱动路径:
    openclaw config set browser.driverPath "/usr/bin/chromedriver"
    
  3. 重启服务:openclaw restart

问题4:技能安装失败,提示“download timeout”

现象:执行clawhub install <技能名>后,长时间无响应,提示下载超时。
原因:海外资源下载受限,未配置阿里云加速源。
解决方案

# 配置阿里云加速源
openclaw config set clawhub.mirror "https://mirror.aliyun.com/clawhub/"
# 重新安装技能
clawhub install <技能名>

四、总结:命令赋能,解锁OpenClaw全场景潜力

OpenClaw v2026.2.12的原生飞书支持与完善的命令体系,让其成为更贴合中国用户的AI助手。从阿里云10分钟部署,到7大类核心命令的灵活运用,用户可根据自身需求实现服务启停、模型切换、通道配置、技能扩展、浏览器自动化等全场景操作。

对于新手,建议从基础操作与诊断命令入手,先让OpenClaw跑起来;对于进阶用户,可深入学习模型管理、插件技能配置与浏览器自动化,打造个性化工作流;对于高手,可通过编辑配置文件实现深度定制。

掌握这些命令后,OpenClaw将从一个单纯的AI助手,升级为覆盖办公自动化、内容创作、开发辅助、信息抓取等多场景的生产力工具。现在,不妨从阿里云部署开始,用命令解锁OpenClaw的无限潜力!

目录
相关文章
|
23天前
|
人工智能 自然语言处理 Shell
🦞 如何在 OpenClaw (Clawdbot/Moltbot) 配置阿里云百炼 API
本教程指导用户在开源AI助手Clawdbot中集成阿里云百炼API,涵盖安装Clawdbot、获取百炼API Key、配置环境变量与模型参数、验证调用等完整流程,支持Qwen3-max thinking (Qwen3-Max-2026-01-23)/Qwen - Plus等主流模型,助力本地化智能自动化。
33384 133
🦞 如何在 OpenClaw (Clawdbot/Moltbot) 配置阿里云百炼 API
|
5天前
|
人工智能 自然语言处理 监控
OpenClaw skills重构量化交易逻辑:部署+AI全自动炒股指南(2026终极版)
2026年,AI Agent领域最震撼的突破来自OpenClaw(原Clawdbot)——这个能自主规划、执行任务的智能体,用50美元启动资金创造了48小时滚雪球至2980美元的奇迹,收益率高达5860%。其核心逻辑堪称教科书级:每10分钟扫描Polymarket近千个预测市场,借助Claude API深度推理,交叉验证NOAA天气数据、体育伤病报告、加密货币链上情绪等多维度信息,捕捉8%以上的定价偏差,再通过凯利准则将单仓位严格控制在总资金6%以内,实现低风险高频套利。
2284 9
|
18天前
|
人工智能 安全 机器人
OpenClaw(原 Clawdbot)钉钉对接保姆级教程 手把手教你打造自己的 AI 助手
OpenClaw(原Clawdbot)是一款开源本地AI助手,支持钉钉、飞书等多平台接入。本教程手把手指导Linux下部署与钉钉机器人对接,涵盖环境配置、模型选择(如Qwen)、权限设置及调试,助你快速打造私有、安全、高权限的专属AI助理。(239字)
7143 21
OpenClaw(原 Clawdbot)钉钉对接保姆级教程 手把手教你打造自己的 AI 助手
|
17天前
|
人工智能 机器人 Linux
OpenClaw(Clawdbot、Moltbot)汉化版部署教程指南(零门槛)
OpenClaw作为2026年GitHub上增长最快的开源项目之一,一周内Stars从7800飙升至12万+,其核心优势在于打破传统聊天机器人的局限,能真正执行读写文件、运行脚本、浏览器自动化等实操任务。但原版全英文界面对中文用户存在上手门槛,汉化版通过覆盖命令行(CLI)与网页控制台(Dashboard)核心模块,解决了语言障碍,同时保持与官方版本的实时同步,确保新功能最快1小时内可用。本文将详细拆解汉化版OpenClaw的搭建流程,涵盖本地安装、Docker部署、服务器远程访问等场景,同时提供环境适配、问题排查与国内应用集成方案,助力中文用户高效搭建专属AI助手。
5054 12
|
19天前
|
人工智能 机器人 Linux
保姆级 OpenClaw (原 Clawdbot)飞书对接教程 手把手教你搭建 AI 助手
OpenClaw(原Clawdbot)是一款开源本地AI智能体,支持飞书等多平台对接。本教程手把手教你Linux下部署,实现数据私有、系统控制、网页浏览与代码编写,全程保姆级操作,240字内搞定专属AI助手搭建!
5858 23
保姆级 OpenClaw (原 Clawdbot)飞书对接教程 手把手教你搭建 AI 助手

热门文章

最新文章