OpenClaw 部署完全指南：零基础也能看懂的“养虾”手册

通过这份指南，你将学会如何在自己的电脑或云服务器上“养”一只属于自己的AI“龙虾”——让它7×24小时待命，帮你处理各种自动化任务。

一、部署前必读：了解你的“龙虾”

1.1 什么是OpenClaw？

OpenClaw（因为图标像龙虾，大家都叫它“龙虾”）是一款开源AI智能体框架。简单来说，它不是普通的聊天机器人，而是一个能真正替你干活的数字员工——可以读写你的文件、控制浏览器、处理邮件、自动回复消息等等。

1.2 部署方式怎么选？

针对不同人群，主要有三种部署方式，你可以对号入座：

部署方式 适合人群 核心优势 注意事项
阿里云一键部署 纯小白、不想折腾环境、需要24小时在线 最快（5分钟搞定）、自动配置、可公网访问 需付费（最低约9.9元/月）
本地Docker部署 有一定基础、注重隐私、开发人员 环境隔离、跨平台、方便迁移 需安装Docker，稍复杂
本地npm安装 开发者、喜欢折腾、离线使用 最轻量、可直接修改源码 需配置Node.js环境、手动处理依赖

1.3 部署前准备清单

无论选择哪种方式，都需要准备以下材料：

  • 阿里云账号：如果选择云端部署，需要先注册并完成实名认证
  • 大模型API密钥：OpenClaw本身是免费的，但调用AI能力需要付费给模型厂商。推荐用阿里云百炼Coding Plan（新用户有90天免费额度）或DeepSeek（价格便宜）
  • 基础工具：能复制粘贴命令就行，不用懂代码

⚠️ 重要提醒：OpenClaw拥有操作系统级权限，配置不当可能带来安全风险。非技术人员请谨慎部署公网版本，建议先在本地测试学习。

二、阿里云一键部署（小白最推荐，5分钟搞定）

这是最简单、最稳定的方式，适合不想折腾本地环境的普通用户。

2.1 购买服务器（已优化配置）

  1. 打开浏览器，访问 [阿里云OpenClaw一键部署专题页面]（各教程中均有此链接入口）

  2. 点击 【一键购买并部署】，按以下配置选择：

    • 镜像：选择 OpenClaw(Moltbot)镜像（系统已预装好OpenClaw）
    • 实例规格：内存必须2GiB及以上（推荐2核4G，运行更流畅）
    • 地域：默认美国（弗吉尼亚）——注意：中国内地地域联网搜索功能受限
    • 时长：新手先选1个月试用（约9.9元起）

  3. 确认购买，等待1-2分钟服务器创建完成

2.2 获取大模型API密钥（让龙虾能思考）

OpenClaw需要“大脑”来理解你的指令，这个大脑就是大模型API。

  1. 访问 [阿里云百炼大模型控制台]（新页面打开）

  2. 点击左侧 密钥管理 → 创建API-Key

  3. 验证身份后，复制生成的API Key（格式如 sk-xxxxxx）——务必保存好，关闭后就看不到了

    💡 省钱小技巧：在百炼控制台购买“Coding Plan”包月套餐（每天有两场抢购），从按量付费变成按次收费，价格更低。

2.3 配置服务器（最关键步骤）

回到阿里云轻量应用服务器控制台：

  1. 找到刚创建的服务器实例，点击进入 【应用详情】 页面

  2. 放行端口（允许外部访问）：

    • 在“OpenClaw使用步骤”区域，找到 端口放通 → 点击 【执行命令】，系统会自动放行18789端口

  3. 配置API密钥：

    • 找到 配置百炼API-Key → 点击 【一键配置】
    • 在弹出的输入框中，粘贴刚才复制的API Key → 点击 【执行命令】

  4. 生成访问令牌（相当于登录密码）：

    • 找到 配置OpenClaw → 点击 【执行命令】，系统会自动生成一个Token（32位字符）
    • 复制保存这个Token，登录时要用

  5. 获取访问地址：

    • 找到 访问控制页面 → 点击 【打开网站页面】，会弹出一个新标签页

2.4 登录并使用

  1. 在弹出的登录页面中，输入刚才保存的Token，点击登录
  2. 恭喜！你已经成功进入OpenClaw的Web控制台
  3. 现在可以试着输入：“帮我总结一下今天的科技新闻”

三、本地Docker部署（跨平台通用，推荐开发者）

如果你有自己的电脑（Windows/Mac/Linux），想完全本地运行，Docker是最干净的方式。

3.1 安装Docker（如果还没装）

Windows用户：

  • 以管理员身份打开PowerShell，输入： 
    wsl --install      # 安装Linux子系统（只需一次）
  • 重启电脑后，下载安装 Docker Desktop for Windows

Mac用户：

  • 打开终端，输入： 
    brew install docker
open -a Docker     # 启动Docker

Linux用户（Ubuntu为例）：

curl -fsSL https://get.docker.com | bash
sudo systemctl enable docker
sudo systemctl start docker

3.2 创建数据目录（存放配置和记忆）

OpenClaw的所有配置、技能和记忆都存放在本地文件夹中，避免容器重启后丢失。

Windows（PowerShell）：

mkdir -p $HOME/OpenClaw/config,$HOME/OpenClaw/skills,$HOME/OpenClaw/logs,$HOME/OpenClaw/workspace,$HOME/OpenClaw/memory

Mac/Linux（终端）：

mkdir -p ~/OpenClaw/{config,skills,logs,workspace,memory}
chmod -R 777 ~/OpenClaw   # 给予权限，避免读写问题

3.3 启动OpenClaw容器

复制以下命令到终端/PowerShell执行（Windows用户注意将\换成`）：

docker run -d \
  --name openclaw \
  --restart always \
  -p 18789:18789 \
  -v ~/OpenClaw/config:/app/config \
  -v ~/OpenClaw/skills:/app/skills \
  -v ~/OpenClaw/logs:/app/logs \
  -v ~/OpenClaw/workspace:/app/workspace \
  -v ~/OpenClaw/memory:/app/memory \
  -e TZ=Asia/Shanghai \
  openclaw/openclaw:2026.3.19    # 使用最新稳定版

命令解释：

  • -d：后台运行
  • --restart always：开机自动启动
  • -p 18789:18789：将容器的18789端口映射到本机
  • -v：将容器内的目录挂载到本地（数据持久化）
  • -e TZ=Asia/Shanghai：设置时区

3.4 初始化配置

# 进入容器内部
docker exec -it openclaw bash

# 执行完整初始化
openclaw init --full

# 退出容器
exit

3.5 访问控制台

打开浏览器，访问：http://localhost:18789

首次登录需要生成Token。在终端执行：

docker exec -it openclaw openclaw token generate

复制输出的Token，粘贴到登录页面即可。

四、本地npm安装（最轻量，适合开发者）

如果你习惯用命令行，想直接修改源码或最小化运行，用npm安装。

4.1 安装Node.js环境

Windows：

  • 下载安装 Node.js 22+（安装时勾选“Add to PATH”）

Mac：

brew install node@22
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Linux（Ubuntu）：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt install -y nodejs

验证安装：

node --version   # 应显示 v22.x.x
npm --version    # 应显示 9.x.x 以上

4.2 配置国内镜像（加速下载）

npm config set registry https://registry.npmmirror.com

4.3 全局安装OpenClaw

npm install -g openclaw@latest

验证安装：

openclaw --version   # 应显示 2026.x.x

4.4 运行初始化向导（新手引导）

这是官方推荐的配置方式，交互式问答，不用手动改文件：

openclaw onboard --install-daemon

按照提示选择：

  • 本地Gateway：选“本地”（获得最高权限）
  • 认证方式：选Token或密码
  • 模型配置：如果暂时没有API Key，可以选“跳过”，后面再配

4.5 手动启动服务（如果向导没自动启动）

openclaw gateway start

4.6 验证服务状态

openclaw health

如果输出OK，说明你的“龙虾”已经活蹦乱跳了。

访问 http://localhost:18789，用生成的Token登录。

五、配置大模型API（给龙虾装上大脑）

无论哪种部署方式，都需要配置大模型API才能让OpenClaw真正工作。以下是两种主流配置。

5.1 配置阿里云百炼API（推荐国内用户）

获取密钥：

  1. 访问阿里云百炼控制台
  2. 左侧“密钥管理” → “创建API Key”
  3. 保存生成的 sk- 开头的密钥

修改配置文件：

配置文件位置取决于部署方式：

  • Docker/npm安装：~/.openclaw/openclaw.json（Mac/Linux）或 C:\Users\用户名\.openclaw\openclaw.json（Windows）
  • 阿里云一键部署：通过Web控制台的“设置”页面修改

用文本编辑器打开配置文件，找到 "models" 部分，添加或修改为：

"models": {
  "providers": {
    "bailian": {
      "apiKey": "sk-xxxxxx",        // 替换成你的API Key
      "modelName": "qwen3.5-plus",  // 通义千问模型
      "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1"
    }
  },
  "defaultProvider": "bailian"
}

重启服务：

openclaw gateway restart

5.2 配置本地大模型（零成本，需显卡）

如果你有NVIDIA显卡（推荐RTX 3060 12GB以上），可以用LM Studio运行本地模型，完全免费。

安装LM Studio：

  1. 访问 lmstudio.ai 下载安装
  2. 打开LM Studio，搜索下载 qwen3.5-7b 或 qwen3.5-14b（根据显存选择）
  3. 左侧“Server”选项卡，开启 “Enable Server” 和 “Enable OpenAI Compatibility”
  4. 记住端口号（默认1234）

修改OpenClaw配置：

"models": {
  "providers": {
    "local-gpu": {
      "baseUrl": "http://localhost:1234/v1",
      "apiKey": "",                 // 本地模型不需要密钥
      "api": "openai-completions",
      "models": [{
        "id": "qwen3.5-7b",
        "name": "Qwen3.5(Local)",
        "contextWindow": 100000
      }]
    }
  },
  "defaultProvider": "local-gpu"
}

重启服务后，就可以免费使用本地AI了。

六、安装Skills（给龙虾装工具）

Skills是OpenClaw的功能插件，装上就能让龙虾做更多事情。

6.1 安装技能管理工具

npm install -g clawhub

6.2 常用技能推荐

技能名称 作用 安装命令
联网搜索 让龙虾能上网查资料 clawhub install tavily-search
浏览器控制 自动打开网页、点击、截图 clawhub install agent-browser
文件管理 整理桌面、重命名文件 clawhub install file-manager
内容摘要 总结长文章、PDF clawhub install summarize
日历管理 安排日程、设置提醒 clawhub install calendar
飞书/钉钉 接入企业IM 通过Web控制台配置

6.3 安装示例

# 安装联网搜索技能
clawhub install tavily-search

# 安装后查看已安装技能
openclaw skill list

# 重启网关使技能生效
openclaw gateway restart

⚠️ 安全警告：ClawHub上有超过1.3万个技能，但存在大量恶意插件。安装前务必审查源码，只安装官方推荐或社区高赞的技能。

七、常见问题排查

7.1 服务启动失败

现象：openclaw gateway start 报错
解决：

  • 检查端口是否被占用：lsof -i:18789（Mac/Linux）或 netstat -ano | findstr 18789（Windows）
  • 修改端口：openclaw config set gateway.port 18790

7.2 无法访问Web控制台

现象：浏览器打不开 http://localhost:18789
解决：

  • 确认服务已启动：openclaw gateway status
  • 检查防火墙是否放行18789端口
  • 如果是云服务器，检查安全组规则是否放行该端口

7.3 模型API调用失败

现象：龙虾回复“模型连接失败”或类似错误
解决：

  • 确认API Key是否正确（注意不要有空格）
  • 检查余额：阿里云百炼控制台查看是否欠费
  • 测试网络：curl https://dashscope.aliyuncs.com/compatible-mode/v1/models

7.4 局域网访问配置

如果你想让同一WiFi下的手机或另一台电脑访问龙虾：

# 修改监听地址为0.0.0.0（允许所有来源）
openclaw config set gateway.host 0.0.0.0
openclaw gateway restart

然后用 http://本机IP:18789 访问（本机IP可用 ipconfig 或 ifconfig 查看）。

八、安全须知（非常重要！）

OpenClaw拥有操作系统的读写权限，配置不当可能导致严重风险。请务必遵守以下规则：

  1. 不要暴露默认端口到公网：18789端口没有内置强认证，暴露后5分钟内就可能被攻击
  2. 修改默认Token：安装后立即用 openclaw token generate 重新生成
  3. 最小权限原则：不要用root/管理员账号运行OpenClaw，创建专用系统用户
  4. 慎装第三方技能：只安装经过审查的技能，安装前查看源码
  5. 定期更新：关注GitHub Release，及时升级修复漏洞
  6. 数据隔离：不要在存有核心机密（如银行密钥、商业机密）的设备上部署

九、下一步：开始使用你的龙虾

部署完成后，可以尝试以下指令，感受一下“数字员工”的威力：

  • “帮我整理桌面上的文件，按类型放到不同文件夹”
  • “搜索今天AI领域的头条新闻，生成一份摘要”
  • “每天早上8点提醒我打卡，并查询天气”
  • “把这封邮件翻译成英文，并回复草稿”

更多玩法和技能，可以加入 “虾聊社区”（xialiao.ai）与万千“养虾人”交流。

附录：常用命令速查表

操作 命令
查看版本 openclaw --version
启动服务 openclaw gateway start
停止服务 openclaw gateway stop
重启服务 openclaw gateway restart
查看状态 openclaw gateway status
查看日志 tail -f ~/.openclaw/logs/gateway.log
生成新Token openclaw token generate
列出技能 openclaw skill list
安装技能 clawhub install 技能名称
健康检查 openclaw health

（本文基于OpenClaw v2026.3.19及阿里云百炼2026年3月服务编写，命令已验证可执行）

Logo
AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

cover

北京中视天威AI虚拟演播室系统：4K实时抠像+AI数字人+虚拟场景一站式解决方案

avatar AtomGit开源社区

领先大半年，这份小龙虾国产平替AiPy使用指南请收好

最近技术圈有个有趣的现象：当大家都在讨论某款国外AI智能体（圈内昵称"小龙虾"）时，一部分人已经默默用上了功能更成熟、开发时间更早的国产替代品。这不是什么秘密爆料，而是一个开源项目自然生长的结果。

avatar AtomGit开源社区
cover

Hermes-Agent 的全方位深度拆解分析

avatar AtomGit开源社区