本篇文章已有1人收藏 | Loading收藏
⚠️ 重要安全提示：国家互联网应急中心（CNCERT）已发布关于OpenClaw安全应用的风险提示。OpenClaw存在以下主要安全风险：提示词注入、误操作、功能插件投毒、敏感信息泄露和多个高中危漏洞。截至2026年3月13日，国家网络与信息安全信息通报中心监测数据显示，境内活跃的OpenClaw互联网资产约2.3万个，存在重大安全风险。在安装使用前，请务必了解这些风险并采取相应的安全防护措施。

OpenClaw（昵称"小龙虾"）是一个开源的AI代理（AI agent）框架。不同于传统的聊天机器人，它是一种真正的"行动型"AI：在你授权的情况下，它能够理解指令，并在多个平台上执行任务，包括文件处理、浏览器自动化、系统命令执行和多平台集成等。

一、环境要求

必需环境

  • Node.js ≥ 22.0.0
  • npm ≥ 10.0.0（或 pnpm ≥ 8.0.0）

推荐配置

  • 操作系统：Linux、macOS、Windows 10/11
  • 内存：至少 4GB RAM（推荐 8GB 以上）
  • 存储空间：至少 2GB 可用空间
  • 包管理器：推荐使用 pnpm（性能更好，磁盘占用更少）

检查环境

在安装前，先检查你的 Node.js 版本：

node --version
# 应该显示 v22.x.x 或更高版本

npm --version
# 应该显示 10.x.x 或更高版本

如果版本不符合要求，请先升级 Node.js：

  • 使用 nvm（推荐）：nvm install 22
  • 或从 Node.js 官网下载安装

二、Windows系统安装指南

方式1：使用 npm 安装（推荐）

打开命令提示符或PowerShell，执行以下命令：

npm install -g openclaw@latest

方式2：使用 pnpm 安装

# 如果还没有安装 pnpm
npm install -g pnpm

# 安装 OpenClaw
pnpm add -g openclaw@latest

方式3：使用 bun 安装

bun install -g openclaw@latest

验证安装

安装完成后，验证 OpenClaw 是否正确安装：

openclaw --version

应该显示当前安装的版本号，例如：openclaw/2.1.0

三、Ubuntu系统安装指南

安装 Node.js 和 npm

首先，使用 nvm（Node Version Manager）安装 Node.js：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 重新加载 bash 配置
source ~/.bashrc

# 安装 Node.js 22
nvm install 22

# 设置默认版本
nvm alias default 22

# 验证安装
node --version
npm --version

或者，从 Ubuntu 仓库直接安装：

sudo apt update
sudo apt install nodejs npm

# 检查版本，如版本过低可使用 nvm 升级

安装 OpenClaw

# 使用 npm 安装
npm install -g openclaw@latest

# 或使用 pnpm（推荐，性能更好）
npm install -g pnpm
pnpm add -g openclaw@latest

验证安装

openclaw --version

四、初始化配置

运行引导向导

执行以下命令启动交互式配置向导：

openclaw onboard --install-daemon

配置流程

1. 选择配置模式

  • QuickStart：快速开始配置（推荐新手）
  • Custom：自定义配置（适合高级用户）

推荐选择 QuickStart 快速开始。

2. 配置 AI 模型

选择你要使用的 AI 模型供应商，常见选项：

  • MiniMax：国内可用，中文支持好
  • Kimi：月之暗面出品，长文本处理强
  • DeepSeek：推理能力强，代码能力出色
  • Claude：Anthropic 出品，综合能力强（需要国际网络）
  • OpenAI GPT：经典选择（需要国际网络）
  • Ollama：本地模型，完全离线

3. 认证配置

根据选择的模型供应商，输入相应的认证信息：

  • API Key 方式：输入从供应商获取的 API Key
  • OAuth 方式：按提示完成 OAuth 授权流程

4. 跳过可选配置

首次配置时，可以暂时跳过以下配置：

  • Channel（渠道）配置 - 稍后单独配置
  • Skill（技能）安装 - 稍后从市场安装
  • Hooks（钩子）配置 - 高级功能，稍后配置

5. 打开 Web UI

配置完成后，选择打开 Web UI：

? 是否打开 Web UI? Yes
✓ 正在启动 Dashboard...
✓ Dashboard 已启动: http://127.0.0.1:18789

浏览器会自动打开 OpenClaw 的 Web 管理界面。如果浏览器没有自动打开，可以手动访问 http://127.0.0.1:18789。

五、对接硅基流动（SiliconFlow）平台

硅基流动（SiliconFlow）是一家专注于人工智能应用软件开发的科技公司，成立于2023年8月，总部位于北京海淀区。公司由袁进辉博士创立，使命是降低大模型应用成本和开发门槛，加速AGI普惠人类的发展进程。

SiliconCloud 是硅基流动推出的一站式大模型云服务平台，提供更快、更便宜、更全面的主流开源大模型API服务，包括Qwen、DeepSeek、GLM、Yi、Mistral、LLaMA 3、SDXL、InstantID等模型。

步骤1：注册硅基流动账号

  1. 访问硅基流动官网：https://cloud.siliconflow.cn/
  2. 使用手机号注册账号
  3. 注册时可填写邀请码获得免费额度（如：pnMnTjoJ）

新用户注册完成后，可获得 2000万 Tokens（约14元的平台配额）。

步骤2：创建 API 密钥

  1. 登录后，在左侧导航栏找到「API密钥」
  2. 点击「新建密钥」
  3. 在密钥描述栏填写描述（如：Cherry Studio），方便识别
  4. 点击创建后，复制生成的 API Key（点击即可复制）

⚠️ 安全注意：请妥善保管你的 API Key，不要泄露给他人。免费额度有限，泄露可能导致额度被耗尽。

步骤3：配置 OpenClaw 连接硅基流动

方法1：通过 Web UI 配置

  1. 访问 OpenClaw Web 界面：http://127.0.0.1:18789
  2. 点击右上角「设置」
  3. 搜索模型平台「SiliconFlow」或「硅基流动」
  4. 粘贴之前复制的 API Key
  5. 点击「检测」按钮，验证配置是否正确
  6. 验证通过后保存配置

方法2：通过命令行配置

# 使用配置向导重新配置
openclaw onboard

# 或直接编辑配置文件
openclaw config edit

步骤4：添加和选择模型

配置完成后，你将可以看到硅基流动提供的所有模型。推荐的模型包括：

  • Pro/zai-org/GLM-5：智谱AI的GLM-5模型
  • DeepSeek-V3：深度求索的V3版本，推理能力强
  • Qwen：阿里云通义千问系列
  • Yi：零一万物系列模型

添加模型后，例如选择 Pro/zai-org/GLM-5，即可开始使用。

六、常用命令

管理命令

# 打开 Web Dashboard
openclaw dashboard

# 启动 Gateway 控制平面
openclaw gateway --port 18789 --verbose

# 查看运行状态
openclaw status

# 查看日志
openclaw logs

# 运行诊断工具
openclaw doctor

# 停止所有服务
openclaw stop

Agent 命令

# 与助手对话
openclaw agent --message "你好" --thinking high

# 发送消息到指定渠道
openclaw message send --to +1234567890 --message "Hello from OpenClaw"

# 列出所有 Agent
openclaw agents list

# 添加新 Agent
openclaw agents add <agent-name>

# 编辑 Agent 配置
openclaw agents edit <agent-name>

Channel 命令

# 列出所有渠道
openclaw channels list

# 添加新渠道
openclaw channels add

# 删除渠道
openclaw channels remove <channel-name>

# 重启渠道
openclaw channels restart <channel-name>

Skill 命令

# 列出已安装的技能
openclaw skills list

# 搜索技能（需要先安装 clawhub）
clawhub search <关键词>

# 安装技能
clawhub install <skill-name>

# 卸载技能
openclaw skills uninstall <skill-name>

更新命令

# 更新到最新稳定版
openclaw update

# 切换版本通道
openclaw update --channel stable   # 稳定版
openclaw update --channel beta     # 测试版
openclaw update --channel dev      # 开发版

七、守护进程配置（Ubuntu）

安装守护进程

openclaw onboard --install-daemon

创建 systemd 服务

创建 systemd 服务文件：

sudo nano /etc/systemd/system/openclaw.service

添加以下内容（将 <你的用户名> 替换为实际用户名）：

[Unit]
Description=OpenClaw AI Agent
After=network.target

[Service]
Type=simple
User=<你的用户名>
ExecStart=/usr/bin/openclaw gateway
Restart always

[Install]
WantedBy=multi-user.target

启用并启动服务：

sudo systemctl enable openclaw
sudo systemctl start openclaw
sudo systemctl status openclaw

管理守护进程

# 启动守护进程
openclaw daemon start

# 停止守护进程
openclaw daemon stop

# 重启守护进程
openclaw daemon restart

# 查看守护进程状态
openclaw daemon status

八、安全防护建议

鉴于国家互联网应急中心发布的安全风险提示，强烈建议采取以下安全措施：

1. 网络隔离

  • 不要在公网开放 OpenClaw 的 Web 端口（18789）
  • 使用防火墙限制访问来源IP
  • 建议仅在本地网络使用

2. 访问控制

  • 修改默认端口：openclaw gateway --port [新端口号]
  • 为 Web UI 添加身份验证
  • 配置 API 访问白名单

3. 插件安全

  • 仅安装官方或可信来源的 Skill 插件
  • 定期检查已安装插件的安全性
  • 对从第三方渠道获取的插件保持警惕

4. 数据保护

  • 定期备份重要配置和数据
  • 不要在对话中暴露敏感信息（密钥、密码等）
  • 加密存储聊天记录和配置文件

5. 漏洞管理

  • 及时更新 OpenClaw 到最新版本：openclaw update
  • 关注官方安全公告
  • 定期运行系统扫描检测漏洞

6. 权限最小化

  • 为 OpenClaw 创建单独的低权限用户账号
  • 限制其文件系统访问权限
  • 谨慎授予系统命令执行权限

九、常见问题与故障排查

Q1: 安装时提示权限错误？

如果遇到 EACCES 权限错误，可以：

方法1：使用 nvm 管理 Node.js（推荐）

方法2：配置 npm 全局目录

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Q2: 如何卸载 OpenClaw？

# 卸载全局包
npm uninstall -g openclaw

# 删除配置文件（可选）
rm -rf ~/.openclaw    # Linux/macOS
# 删除 C:\Users\<用户名>\.openclaw 文件夹    # Windows

Q3: 如何更换模型供应商？

# 重新运行配置向导
openclaw onboard

# 或直接编辑配置文件
openclaw config edit

Q4: 端口 18789 被占用怎么办？

# 使用其他端口启动
openclaw gateway --port 18790

故障排查命令

# 查看日志
openclaw logs

# 运行诊断工具
openclaw doctor

# 重启服务
openclaw stop
openclaw gateway

十、结语

通过本教程，你应该已经成功在 Ubuntu 或 Windows 系统上安装了 OpenClaw，并完成了与硅基流动平台的对接。现在，你可以开始探索这个强大的 AI 工具，让智能体协助你完成各种任务。

记住，安全永远是第一位的。在使用 OpenClaw 的过程中，请务必遵循上述安全防护建议，保护好你的数据和隐私。

下一步，你可以：

  • 接入渠道：连接飞书、企业微信、Telegram、WhatsApp 等通讯平台
  • 安装技能：从技能市场扩展 Agent 能力
  • 配置多Agent：设置多个具有不同专业能力的智能体
  • 探索高级功能：学习如何使用浏览器工具、文件处理等

参考资料

  • OpenClaw 中文教程 - 安装与环境
  • 国家互联网应急中心 - 关于OpenClaw安全应用的风险提示
  • 硅基流动（SiliconFlow）官方介绍及注册指南
免责声明：本教程仅供学习交流使用。OpenClaw 存在安全风险，请在了解风险并采取适当防护措施的前提下谨慎使用。作者不对因使用本教程而导致的任何数据丢失、安全漏洞或法律问题承担责任。