OpenClaw(龙虾)AI智能体部署指南：从本地到云端，小白也能轻松上手

嘉恩督

524人浏览 · 2026-04-01 18:31:28

嘉恩督 · 2026-04-01 18:31:28 发布

OpenClaw(龙虾)AI智能体部署指南：从本地到云端，小白也能轻松上手🦞

一、前言

最近，OpenClaw（昵称"龙虾"）这款开源AI智能体火遍全网，它能帮你处理邮件、管理日程、写代码、做数据分析，甚至自动完成办公任务。很多小伙伴想自己部署"养虾"，但又不知道从何下手。这篇指南将带你从0到1完成OpenClaw的部署，涵盖Windows、macOS、Linux本地部署和云服务器部署，还有常见问题排查，让你一次成功！

二、部署前准备

2.1 系统要求

环境	最低配置	推荐配置
CPU	2核心+	4核心+
内存	4GB+	8GB+
磁盘	10GB可用空间	20GB SSD
网络	稳定网络连接	带宽≥10Mbps
系统版本	Windows 10/11、macOS 12+、Linux（Ubuntu 20.04+）	同最低要求
依赖	Node.js v18.0+（源码部署）	Node.js v20.0+

2.2 必备资源

模型API密钥：OpenClaw本身是框架，需要接入大模型才能工作。推荐以下免费选项：
- 阿里云百炼：新用户90天免费额度（超7000万Token）
- 智谱GLM：新用户有免费额度
- Ollama本地模型：完全免费，无需联网
终端工具：
- Windows：PowerShell（管理员模式）
- macOS/Linux：自带终端

三、本地部署（小白首选）

3.1 Windows一键部署（最省心）

以管理员身份打开PowerShell

执行一键安装脚本：

iwr -useb https://openclaw.ai/install.ps1 | iex

国内用户推荐使用镜像加速：

iwr -useb https://clawd.org.cn/install.ps1 | iex

等待3-5分钟，自动完成环境检测、依赖安装和路径配置
初始化配置：
```
openclaw onboard --install-daemon
```
- 风险提示选Yes
- 模式选Quick Start（快速开始）
- 选择模型服务商，粘贴API Key（鼠标右键粘贴）
- 其余选项全选No，最后选Open the Web UI
浏览器自动打开http://localhost:3000，看到龙虾面板，部署成功！

3.2 macOS/Linux一键部署

打开终端

执行一键安装脚本：

curl -fsSL https://openclaw.ai/install.sh | bash

国内用户：

curl -fsSL https://clawd.org.cn/install.sh | bash

等待安装完成，显示"OpenClaw installed successfully"即成功
初始化配置（同Windows步骤4）

启动服务：

openclaw gateway start
openclaw dashboard

访问http://localhost:3000使用

3.3 源码部署（适合开发者）

安装Node.js和pnpm：
```
npm install -g pnpm
```

克隆项目：

git clone https://github.com/openclaw/openclaw.git
cd openclaw

安装依赖并编译：
```
pnpm install
pnpm build:all
```
复制配置文件并修改：
```
cp config.example.yaml config.yaml
```
启动项目：
```
pnpm start
```
后台守护运行：
```
openclaw start --daemon
```

四、云服务器部署（7×24小时在线）

以阿里云为例，其他云平台（腾讯云、华为云）操作类似。

4.1 服务器准备

购买ECS服务器，推荐配置：2核4GB，Ubuntu 22.04系统，带宽1Mbps+
配置安全组，放行以下端口：
- 3000（Web UI）
- 18789（API网关）
- 4317（监控）
远程连接服务器（使用SSH工具）

4.2 安装部署

执行一键安装脚本：

curl -fsSL https://clawd.org.cn/install.sh | bash

初始化配置（同本地部署）
设置开机自启：
```
sudo openclaw gateway install
```
验证服务：
```
openclaw --version
```
访问http://服务器IP:3000使用

4.3 模型配置（阿里云百炼示例）

打开阿里云百炼平台，开通服务
进入密钥管理→创建Access Key
复制Access Key ID和Access Key Secret
在OpenClaw Web UI中配置模型，选择"阿里云百炼"，粘贴密钥

4.4 模型配置（火山平台示例）

其他平台的coding plan太难抢了，每次都没看见有，等不急了就订阅了，用下面的链接可以领券：方舟 Coding Plan 支持 Doubao、GLM、DeepSeek、Kimi、MiniMax 等模型，工具不限，现在订阅9折，低至36元，订阅越多越划算！立即订阅：https://volcengine.com/L/9o0BVmyO3es/ 邀请码：W27T8DTC
在这里插入图片描述

在这里插入图片描述
配置文档：https://www.volcengine.com/docs/82379/2183190?lang=zh
直接复制：

{
  "models": {
    "providers": {
      "volcengine-plan": {
        "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3",
        "apiKey": "<ARK_API_KEY>",
        "api": "openai-completions",
        "models": [
          {
            "id": "ark-code-latest",
            "name": "ark-code-latest",
            "contextWindow": 256000,
            "maxTokens": 32000,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "doubao-seed-code",
            "name": "doubao-seed-code",
            "contextWindow": 256000,
            "maxTokens": 32000,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "glm-4.7",
            "name": "glm-4.7",
            "contextWindow": 200000,
            "maxTokens": 128000,
            "input": [
              "text"
            ]
          },
          {
            "id": "deepseek-v3.2",
            "name": "deepseek-v3.2",
            "contextWindow": 128000,
            "maxTokens": 32000,
            "input": [
              "text"
            ]
          },
          {
            "id": "doubao-seed-2.0-code",
            "name": "doubao-seed-2.0-code",
            "contextWindow": 256000,
            "maxTokens": 128000,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "doubao-seed-2.0-pro",
            "name": "doubao-seed-2.0-pro",
            "contextWindow": 256000,
            "maxTokens": 128000,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "doubao-seed-2.0-lite",
            "name": "doubao-seed-2.0-lite",
            "contextWindow": 256000,
            "maxTokens": 128000,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "minimax-m2.5",
            "name": "minimax-m2.5",
            "contextWindow": 200000,
            "maxTokens": 128000,
            "input": [
              "text"
            ]
          },
          {
            "id": "kimi-k2.5",
            "name": "kimi-k2.5",
            "contextWindow": 256000,
            "maxTokens": 32000,
            "input": [
              "text",
              "image"
            ]
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "volcengine-plan/ark-code-latest"
      },
      "models": {
        "volcengine-plan/ark-code-latest": {},
        "volcengine-plan/doubao-seed-2.0-code": {},
        "volcengine-plan/doubao-seed-2.0-pro": {},
        "volcengine-plan/doubao-seed-2.0-lite": {},
        "volcengine-plan/doubao-seed-code": {},
        "volcengine-plan/minimax-m2.5": {},
        "volcengine-plan/glm-4.7": {},
        "volcengine-plan/deepseek-v3.2": {},
        "volcengine-plan/kimi-k2.5": {}
      }
    }
  },
  "gateway": {
    "mode": "local"
  }
}

4.5 飞书配置

参考：https://www.runoob.com/ai-agent/openclaw-feishu.html
直接复制：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

在这里插入图片描述
事件回调和回调配置都用长连接
然后事件回调需要添加接收消息 每次都踩坑，这个不开就收不到消息
然后第一次配对，都会有配对码

4.6 skills

把这里比较火的都下载了
https://clawhub.ai/
https://skillhub.tencent.com/
在这里插入图片描述

4.7 常用命令

openclaw config
openclaw dashboard
openclaw gateway
openclaw gateway restart
openclaw gateway start
openclaw gateway stop
openclaw doctor --fix
（指定端口）
openclaw config set gateway.port 18789
openclaw gateway --port 18790
openclaw gateway status
openclaw update

五、Docker容器部署（稳定隔离）

安装Docker
拉取镜像：
```
docker pull openclaw/openclaw:latest
```

运行容器：

docker run -d -p 3000:3000 -p 18789:18789 --name openclaw openclaw/openclaw:latest

进入容器配置：

docker exec -it openclaw bash
openclaw onboard

访问http://localhost:3000

六、常见问题排查

6.1 安装失败

网络问题：切换国内镜像源，或使用代理
权限不足：Windows用管理员身份运行PowerShell，Linux/macOS加sudo
依赖冲突：卸载旧版本Node.js，重新安装v18.0+

6.2 启动失败

端口占用：

# 查看端口占用
lsof -i:3000
# 杀死进程
kill -9 进程ID

模型API错误：检查API Key是否正确，是否有访问权限，余额是否充足
日志排查：
```
openclaw logs
```

6.3 功能异常

Skills无法使用：检查网络连接，重新安装Skills
任务执行失败：检查模型权限，升级模型版本
Web UI加载缓慢：清理浏览器缓存，或使用Chrome浏览器

七、安全与优化建议

隔离环境：本地部署建议使用虚拟机或WSL2+Docker隔离
密钥管理：不要泄露API Key，定期更换密钥
资源优化：
- 关闭不需要的Skills
- 调整模型参数，降低显存占用
数据安全：定期备份配置文件和数据

八、总结

OpenClaw部署其实很简单，一键脚本就能搞定大部分工作。本地部署适合个人使用和测试，云服务器部署适合需要7×24小时在线的场景。如果遇到问题，先查看官方文档或社区讨论，也可以在评论区留言交流。祝你"养虾"成功，让AI助手帮你提升工作效率！

九、参考资料

OpenClaw官方文档：https://openclaw.ai/docs
阿里云百炼文档：https://help.aliyun.com/product/171055.html
OpenClaw GitHub仓库：https://github.com/openclaw/openclaw
https://www.runoob.com/ai-agent/openclaw-feishu.html

小贴士：如果觉得部署麻烦，也可以使用托管云服务（如kimiclaw），一键部署，官方兜底安全，完全不用懂运维。

AtomGit开源社区

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

更多推荐

工业实时检测的范式革新：基于 RT-DETR 的高性能瑕疵识别架构深度解析与实战

AtomGit开源社区

2025届最火的六大AI论文助手实际效果

AtomGit开源社区

2026届学术党必备的五大降重复率助手解析与推荐

AtomGit开源社区

所有评论(0)

查看更多评论

嘉恩督

@LeviLizhi

已为社区贡献2条内容