# openclaw-one-setup

**Repository Path**: kain/openclaw-one-setup

## Basic Information

- **Project Name**: openclaw-one-setup
- **Description**: (Ubuntu) OpenClaw一键安装
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-09
- **Last Updated**: 2026-04-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 无影云 OpenClaw 环境安装配置

## 无影云

### 购买开通
申请开通阿里云无影云，个人版也不贵，推荐个人先用低配版，
无影云支持所有终端，推荐使用客户端，web端功能有限。安装好客户端，登录之后，在客户端购买OpenClaw优惠套餐
![控制台](image-1.png)

开通之后就在客户端启动云主机了
![控制台](image.png)

### 配置
虚拟机启动之后，opnclaw已经给你安装好了。你只需要做两件时间
1、将你申请好的钉钉机器人信息填入（联系钉钉管理员创建），**注意**：一定一定告知管理员这个机器人只给你个人开通。
2、将你申请的百炼的ApiKey 填入 （联系运维同事开通）
具体操作步骤如下：
点击右上角的第二个图标：![配置](image-2.png)，配置向导会一步步指引你完成配置。

### 使用
点击![龙虾](image-3.png)，这里要稍等一会，第一次启动会有点慢，启动好之后Chrome浏览器会打开，自动进入龙虾界面了，点击Chat进入聊天页面，可以在这里尝试使用龙虾了。
上面这一步如果没有问题了，你就可以回到钉钉，在搜索里面查找机器人（PC端），给机器人发送消息就可以收到小龙虾给你的回复了。

### 其他
- 无影云桌面因为使用的是**桌面客户端**，因此没有暴露的风险，比直接使用云主机部署这方面要安全很多。
- 无影云桌面默认会将本地盘全部挂在到云主机中，还可以共享粘贴板，因此使用起来比云主机会方便很多。你可以直接在云主机中操作或者复制本地盘的文件（建议复制到云主机中）
![本地盘](image-4.png)

## 一键安装（Ubuntu 22+）

### 模式 A：远程一键安装（推荐）
适用于直接在云主机上操作，无需手动下载仓库：
```bash
curl -fsSL https://gitee.com/kain/openclaw-one-setup/raw/master/install.sh | bash
```
> [!NOTE]
> 远程安装会自动将仓库克隆到 `~/openclaw-one-setup`，安装完成后请进入该目录修改 `env.conf` 并重启对应步骤。

### 模式 B：本地解压安装
1、下载并解压一键安装包，修改 `env.conf` 中的配置。
2、在 Terminal 中进入对应文件夹，执行：
```bash
bash install.sh
```

### 模式 C：Venus远程模式安装
1、开通Venus远程开发环境，确认<工号>.tstech.top能正常访问
2、登录远程IDE，激活IDE的Terminal窗口
3、执行
```bash
curl -fsSL https://gitee.com/kain/openclaw-one-setup/raw/master/venus.sh | bash
```
4、本机访问:<工号>-18789.tstech.top/?token=，注意第一次使用OpenClaw WebUI访问必须要使用token验证身份，如果不记得了可以在~/.openclaw.json的gateway中找到对应的token信息。

### 脚本特性
- **版本自适应**：自动识别 Ubuntu 22 与 24+，安装匹配的 Clash 版本。
- **大文件自动合并**：支持 `.zip.001` 或 `.z01` 格式的分片文件自动合并（针对 Chrome/VS Code）。
- **在线下载**：VS Code 默认自动从官网下载安装，减少分发包体积。
- **依赖自修复**：自动修复安装过程中缺失的系统库。

**Claude 提示词**
> 请作为 OpenClaw 部署专家，结合文档@docs、当前工作区的 `openclaw.json` 参考配置，以及 `env.conf` 中的环境变量信息，为我搭建并配置 OpenClaw 运行环境。
> 
> **关键原则**：所有涉及到绝对路径的地方（如用户目录、工作区等），必须动态获取当前系统实际的路径，绝不能生搬硬套参考文件中的例子。
> 
> **请务必按顺序执行完成以下核心任务**：
> 1. **配置校验与生成**：仔细核对并生成运行所需的 `openclaw.json` 配置。确保模型、端口等关键参数与 `env.conf` 对应，且所有路径配置均与当前环境吻合。
> 2. **后台服务托管**：将 OpenClaw 配置为系统级后台服务。如果是在容器系统或非root环境下，请使用 `pm2` 来守护 `gateway` 进程（请先检查 pm2 及其配置依赖是否已就绪）。
> 3. **网络与远程访问**：解除 Gateway 和 WebUI 的本地访问限制，允许外部远程访问（例如配置对应的 CORS 或白名单），并验证 OpenClaw 处于正常启动状态。
> 4. **官方插件集成**：执行 openclaw plugins install 安装 `@dingtalk-real-ai/dingtalk-connector` 与 `feishu` 扩展插件，并在配置中正确注入钉钉/飞书鉴权，默认使用钉钉，飞书作为备用，以及 Gateway 的通信 Token。 把**钉钉**作为默认Agent的通道，用户默认使用钉钉跟OpenClaw通信。
> 5. **交付访问地址**：部署完成后，请直接向我输出 WebUI 第一次访问时的完整带 token 的安全 URL 连接。
> 6. **配对**：告知用户通过token跨主机使用WebUI时需要配对
> 7. **配置调整**：修改配置时一定要先参考文档，gateway非不要不要重启。

## 资源
- Ubuntu 22.04 ([下载地址](https://mirrors.qlu.edu.cn/ubuntu-releases/24.04.4/ubuntu-24.04.4-desktop-amd64.iso))
- VirtualBox 7.2.6 ([下载地址](https://download.virtualbox.org/virtualbox/7.2.6/VirtualBox-7.2.6a-172322-Win.exe))
- 输入法:
```
sudo apt install ibus ibus-libpinyin
```

## 手动安装

### 安装Node
安装nodejs nvm 管理工具
windows 平台，下载地址：
https://github.com/coreybutler/nvm-windows/releases

Max&Linux

```
curl -o- https://gitee.com/mirrors/nvm/raw/master/install.sh | bash
```

将nvm.sh 注入到启动脚本中，防止重启后环境丢失

安装node 24

```
nvm node_mirror https://npmmirror.com
nvm npm_mirror https://npmmirror.com

nvm install 24
```

配置环境
```
npm config set registry https://registry.npmmirror.com
```

设置 Node 24 为默认环境

### 安装claude code cli

安装
```
npm install -g @anthropic-ai/claude-code
```

配置claude,新增文件 ~/.claude/settings.json
```json
{
  "env": {
    "ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}",
    "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic"
  },
  "permissions": {
    "allow": ["Bash", "Read", "Edit", "Write", "WebSearch"]
  },
  "model": "qwen3-max-2026-01-23",
  "enabledPlugins": {
    "code-simplifier@claude-plugins-official": true
  }
}
```

新增文件 ~/.claude.json（如果claude启动失败，提示无法连接，需要将hasCompletedOnboarding设置为true）
```
{
  "hasCompletedOnboarding": true
}

```

### 安装OpenClaw

```
npm install -g openclaw@latest
```

### OpenClaw Plugin

```json
{
  "channels": {
    "dingtalk-connector": {
      "enabled": true,
      "clientId": "*********",
      "clientSecret": "***********"
    },
    "feishu": {
      "enabled": true,
      "groupPolicy": "open",
      "streaming": true,
      "blockStreaming": "true",
      "requireMention": "false",
      "accounts": {
        "main": {
          "appId": "*********",
          "appSecret": "******",
          "botName": "******"
        },
        "default": {
          "dmPolicy": "open"
        }
      }
    }
  },
  "installs": {
      "dingtalk-connector": {
        "source": "npm",
        "spec": "https://github.com/DingTalk-Real-AI/dingtalk-moltbot-connector.git",
        "installPath": "/home/admin/.openclaw/extensions/dingtalk-connector",
        "version": "0.6.0"        
      },
      "qqbot": {
        "source": "npm",
        "spec": "https://github.com/sliverp/qqbot.git",
        "installPath": "/home/admin/.openclaw/extensions/qqbot",
        "version": "1.2.3"        
      },
      "feishu": {
        "source": "npm",
        "spec": "@m1heng-clawd/feishu",
        "installPath": "/home/admin/.openclaw/extensions/feishu",
        "version": "0.1.6"
      }
    }
}
```

## Q&A
Q：OpenClaw WebUI 配对错误

A：现在对webui的权限限制加强了，第一带token跨主机访问时，需要在主机上执行命名approve当前设备才行，否则会提示配对失败。
```shell
openclaw devices list
openclaw devices approve <requestId>
```

可以直接把这段话发给claude，让它帮你执行。

---
Q：OpenClaw接收不到钉钉消息

A：2026.3.7 钉钉通道的状态显示不正常，先在WebUI的日志中看一下钉钉连接日志是否有错误信息，有的话交给Claude帮你处理。如果状态没问题就需要确认一下默认Agent是否绑定到钉钉上。同时在web控制台频道中的钉钉信息中检查对应的钉钉的配置信息是否正确。
```json
"bindings": [
    {
      "type": "route",
      "agentId": "main",
      "match": {
        "channel": "dingtalk-connector"
      }
    }
  ],
```