PingSec 安全日报

root@pingsec:~$
🔵 安全研究安全资讯

OpenClaw 搭建教程：10分钟拥有私人AI助手

📅 2026年5月16日 📁 Hermes Agent ⏱ 2 分钟

OpenClaw 是一款开源自驱型 AI 智能体，类似 Hermes Agent。本文从零开始教你搭建。

什么是 OpenClaw

OpenClaw 是一款开源的 AI 智能体框架，由 Peter Steinberger 创建。它能帮你：

  • 自动化执行任务（信息收集、内容生成、定时监控）
  • 接入 1700+ 社区 Skills（技能）
  • 支持多模型接入（DeepSeek、通义千问、Ollama本地模型等）
  • 连接微信、飞书、Telegram 等 IM 平台

和 Hermes Agent 类似，但更偏个人助手场景。

环境要求

项目要求
Node.js≥ v22
操作系统macOS / Linux / Windows
网络调用云端 API 时需联网

第一步：安装 Node.js


# Linux (Ubuntu/Debian)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# macOS
brew install node

# 验证安装
node --version   # 应输出 v22.x.x
npm --version

第二步：安装 OpenClaw

方式一：官方脚本（推荐）


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

# 国内网络慢可用社区镜像
curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/install.sh | bash

方式二：npm 手动安装


npm config set registry https://registry.npmmirror.com
npm install -g openclaw

第三步：初始化配置


openclaw onboard --install-daemon

此命令会：

  1. 交互式配置向导（选择模型、设置参数）
  2. 安装后台守护进程
  3. 配置开机自启

检查网关状态：


openclaw gateway status

第四步：打开控制面板


openclaw dashboard

浏览器自动打开 http://127.0.0.1:18789/，看到 Dashboard 即部署成功。

配置 AI 模型

OpenClaw 需要配置 AI 模型作为"大脑"。编辑 ~/.openclaw/openclaw.json：

接入 DeepSeek（性价比最高）


{
  "models": {
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com/v1",
        "apiKey": "你的 DeepSeek API Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-chat",
            "name": "DeepSeek V3"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat"
      }
    }
  }
}

接入火山引擎豆包


{
  "models": {
    "providers": {
      "volcengine": {
        "baseUrl": "https://ark.cn-beijing.volces.com/api/v3",
        "apiKey": "你的火山引擎 API Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "你的推理接入点ID",
            "name": "Doubao Pro"
          }
        ]
      }
    }
  }
}

接入本地 Ollama 模型


# 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh
# 拉取模型
ollama pull qwen2.5:7b

配置 OpenClaw：


{
  "models": {
    "providers": {
      "ollama": {
        "baseUrl": "http://127.0.0.1:11434/v1",
        "apiKey": "ollama-local",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen2.5:7b",
            "name": "Qwen 2.5 7B",
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "ollama/qwen2.5:7b"
      }
    }
  }
}

⚠️ 本地模型需 8GB+ 显存，CPU 推理较慢。新手建议先用云端 API。

安装 Skills

OpenClaw 社区有 1700+ 个 Skills，通过 ClawHub 管理：


# 搜索技能
clawhub search <关键词>

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

# 更新所有技能
clawhub update --all

# 扫描同步
clawhub sync --all

为 Skill 配置环境变量（在 openclaw.json 中）：


{
  "skills": {
    "entries": {
      "morning-news": {
        "enabled": true,
        "env": {
          "NEWS_API_KEY": "你的Key"
        }
      }
    }
  }
}

常用操作


# 查看状态
openclaw gateway status

# 启动网关（前台，方便排错）
openclaw gateway --port 18789

# 打开控制面板
openclaw dashboard

# 查看日志
openclaw logs

# 更新版本
openclaw upgrade

本地 vs 云部署对比

维度本地部署云部署
成本0 元50-100 元/月
数据安全完全本地在云服务器上
24小时在线关机即断7×24 小时
远程访问需内网穿透天然支持
上手难度3 条命令需服务器运维

建议：先本地玩明白，需要再上云。

常见问题

Q：安装报网络错误？

国内网络不稳定，用社区安装脚本或 npm 镜像。

Q：Dashboard 打不开？

确认网关已启动：openclaw gateway status，手动启动：openclaw gateway --port 18789

Q：模型不回复？

检查 API Key 配置和网络连接，先 curl 测试 API 是否正常。

Q：和 Hermes Agent 有什么区别？

Hermes 偏安全研究自动化，OpenClaw 偏个人 AI 助手。两者 Skills 机制相似，但生态不同。

更多信息：https://github.com/yeasy/openclaw_guide

← 返回首页