OpenClaw 作为开源AI助手的标杆,更新速度持续领跑行业,最新 v2026.2.12 版本已原生支持飞书通道,无需额外开发webhook或寻找第三方插件,彻底解决了中国用户的核心痛点。对于新手而言,掌握部署流程与常用命令是发挥其强大功能的基础;对于进阶用户,熟练运用模型切换、插件管理、浏览器自动化等命令,能大幅提升工作效率。
本文先提供阿里云OpenClaw(Clawdbot)极速部署简单步骤,再系统梳理7大类核心命令(基础操作、诊断排错、模型管理、网关通道、插件技能、浏览器自动化、配置文件),搭配实战示例与避坑指南,文中所有代码均可直接复制执行,全程规避其他云厂商名称,帮助不同层级用户快速上手。
一、阿里云OpenClaw(Clawdbot)部署简单步骤(v2026.2.12 适配版)
阿里云凭借稳定的弹性计算环境与国内优化的网络链路,成为OpenClaw部署的优选平台,v2026.2.12版本适配性更强,新手仅需6步即可完成云端部署,为后续命令操作奠定基础,OpenClaw部署详情 访问阿里云OpenClaw一键部署专题页面 了解。
核心部署6步速通(直接复制执行)
- 创建阿里云轻量应用服务器实例:登录阿里云控制台,选择中国香港/新加坡地域(免ICP备案,网络通达性强),配置选择2vCPU+4GiB内存+60GiB ESSD(满足v2026.2.12版本及多插件同时运行),镜像选择“Ubuntu 22.04-Docker 26”,完成支付后记录服务器公网IP。
- 远程连接并安装OpenClaw核心程序:
# 远程连接服务器(替换为你的公网IP) ssh root@你的服务器公网IP # 一键安装OpenClaw v2026.2.12(自动搞定依赖与版本适配) curl -fsSL https://openclaw.ai/install.sh | bash -s -- --version 2026.2.12 - 交互式初始化配置:
脚本执行后进入配置向导,按以下步骤操作:
- 安全提示:输入
Yes确认已阅读安全须知; - 配置模式:选择
QuickStart(快速配置,细节后续优化); - 模型选择:移动光标选择
bailian/qwen3-max(阿里云百炼千问,适配中文场景); - 认证方式:选择
API Key,输入从阿里云百炼控制台获取的API-Key; - 通信渠道:选择
Skip for now(后续单独配置飞书); - 完成配置:选择
Done,等待服务初始化。
- 配置阿里云加速源与端口放行:
# 设置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 - 启动服务并设置开机自启:
# 启动OpenClaw服务 sudo systemctl start openclaw # 设置开机自启,避免服务器重启后服务中断 sudo systemctl enable openclaw # 验证服务状态(返回active(running)即为成功) sudo systemctl status openclaw - 部署验证与版本确认:
# 查看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


第二步:选购阿里云轻量应用服务器,配置参考如下:
- 镜像:OpenClaw(Moltbot)镜像(已经购买服务器的用户可以重置系统重新选择镜像)
- 实例:内存必须2GiB及以上。
- 地域:默认美国(弗吉尼亚),目前中国内地域(除香港)的轻量应用服务器,联网搜索功能受限。
- 时长:根据自己的需求及预算选择。



第三步:访问阿里云百炼大模型控制台,找到密钥管理,单击创建API-Key。
前往轻量应用服务器控制台,找到安装好OpenClaw的实例,进入「应用详情」放行18789端口、配置百炼API-Key、执行命令,生成访问OpenClaw的Token。
- 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
- 配置百炼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 |
实战场景:
- 服务启动失败,执行健康检查与自动修复:
```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 |
- 查看错误日志排查问题:
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完成认证 |
常用模型切换示例:
切换到阿里云百炼千问:
openclaw models set bailian/qwen3-max-2026-01-23 # 输出:Default model updated切换到智谱GLM-4.7:
openclaw models set zai/glm-4.7 # 输出:Default model updated切换到MiniMax:
openclaw models set minimax/MiniMax-M2.1 # 输出:Default model updated查看当前已配置模型:
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原生支持):
启用飞书插件(v2026.2.12已预装,仅需启用):
openclaw plugins enable feishu # 输出:Enabled: @openclaw/feishu交互式添加飞书通道:
openclaw channels add --channel feishu # 按提示输入飞书AppID和AppSecret: # Enter Feishu AppID: cli_a9f21xxxxx89bcd # Enter Feishu AppSecret: w6cPunaxxxxBl1HHtdF # 配置完成后输出:Feishu channel added successfully查看飞书通道状态:
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 |
技能管理实战:
- 搜索并安装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 |
配置文件操作注意事项:
- 任何修改后必须重启服务才能生效:
openclaw restart; - 编辑前建议备份配置文件:
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak; - 新手推荐使用
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输入错误或飞书应用未开通机器人权限。
解决方案:
- 重新获取飞书AppSecret(飞书开放平台→应用→凭证与基础信息);
- 确保飞书应用已添加“机器人”能力并开通相关权限;
- 重新添加飞书通道:
# 先移除错误通道 openclaw channels remove --channel feishu # 重新交互式添加,仔细输入AppID和AppSecret openclaw channels add --channel feishu
问题2:模型切换后,技能调用报错“model not found”
现象:执行openclaw models set bailian/qwen3-max后,调用技能提示模型未找到。
原因:模型名称输入错误或未完成认证。
解决方案:
- 查看已配置模型,确认名称正确:
openclaw models list; - 若模型未显示,重新添加认证:
openclaw models auth paste-token --provider qwen-portal # 粘贴阿里云百炼API-Key - 重启服务后再次切换模型:
openclaw restart openclaw models set bailian/qwen3-max
问题3:浏览器自动化命令提示“browser not found”
现象:执行openclaw browser open <URL>后,提示浏览器未找到。
原因:未安装浏览器驱动或系统缺少浏览器。
解决方案:
- 安装Chrome浏览器及驱动:
sudo apt update && sudo apt install -y chromium-browser chromium-chromedriver - 配置浏览器驱动路径:
openclaw config set browser.driverPath "/usr/bin/chromedriver" - 重启服务:
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的无限潜力!