从零部署 OpenClaw：打造你的第二大脑

兜兜风
7 阅读6分钟

从零部署 OpenClaw：打造你的第二大脑

告别"作为一个AI语言模型..."的废话助手

image.png

摘要：今天要部署的不是又一个AI聊天机器人，而是一个能接入你所有工具、记住你所有偏好、并真正帮你干活的认知伙伴。

为什么需要 OpenClaw？

先回答一个问题：为什么在已经有无数AI助手的情况下，还需要OpenClaw？

  1. 私有化部署 - 你的对话、文件、数据都在自己的机器上
  2. 工具整合 - 不是孤立的聊天机器人，而是能操作你所有工具的工作伙伴
  3. 持续记忆 - 有长短期记忆系统，能记住你的偏好和上下文
  4. 开源透明 - MIT许可证，完全可审计、可定制

如果你的AI助手还在说"作为一个AI语言模型..."，那你需要看看OpenClaw。

环境准备

系统要求

# 基础要求
- Node.js 18+、npm 或 pnpm
- macOS/Linux/WSL2 (Windows用户推荐WSL2)
- 建议内存：8GB+，磁盘：至少2GB空间

快速检查你的环境

# 检查Node版本
node --version  # 应该输出 v18+

# 检查包管理器
which npm || which pnpm  # 至少有一个

部署方式一：一步到位（推荐）

这是最简单的部署方式，适合想要快速上手的用户：

# 使用OpenClaw提供的安装脚本
curl -fsSL https://docs.openclaw.ai/install.sh | bash

这个脚本会：

  1. 克隆OpenClaw仓库
  2. 安装依赖（pnpm优先）
  3. 配置环境变量
  4. 启动Gateway服务

安装完成后，打开浏览器访问：http://localhost:18789

Windows用户注意：如果你使用WSL2，端口转发可能需要额外配置。最简单的方法是：在WSL2中运行OpenClaw，然后在Windows浏览器中直接访问。

部署方式二：手动安装（了解原理）

如果你是技术控，想完全掌控安装过程，或者遇到网络问题，这是给动手能力强的开发者的方式。

第一步：克隆仓库

# 克隆官方仓库
git clone https://github.com/openclawai/openclaw.git
cd openclaw

# 或者使用GitHub镜像（如果主仓库访问慢）
git clone https://github.com.cnpmjs.org/openclawai/openclaw.git

第二步：安装依赖

# 推荐使用pnpm（更快、占用更少空间）
npm install -g pnpm@latest
pnpm install

# 或者使用npm
npm install

第三步：首次运行配置

# 1. 设置工作目录（存放你的配置文件、记忆文件）
export OPENCLAW_WORKSPACE=~/.openclaw/workspace
mkdir -p $OPENCLAW_WORKSPACE

# 2. 复制示例配置
cp config.example.yaml config.yaml

# 3. 启动Gateway服务
pnpm start:gateway

部署方式三：Docker部署（适合服务器/生产环境）

把OpenClaw当微服务来跑，这是生产级部署的最佳实践。

3.1 Docker Compose（一步启动）

# docker-compose.yml - 这是完整的生产配置
version: '3.8'
services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw
    ports:
      - "18789:18789"  # Web管理界面
      - "18792:18792"  # 浏览器控制端口（MCP用）
    environment:
      - OPENCLAW_WORKSPACE=/workspace
      - OPENCLAW_BROWSER_PROXY=http://browser-control:3000  # 独立浏览器服务
      - NODE_ENV=production
    volumes:
      - ./workspace:/workspace           # 所有记忆和技能持久化
      - ./config.yaml:/app/config.yaml   # 主配置文件
      - ./logs:/var/log/openclaw        # 日志目录
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:18789/health"]
      interval: 30s
      timeout: 10s
      retries: 3

  # 可选：独立浏览器服务（提高稳定性）
  browser-control:
    image: browserless/chrome:latest
    container_name: browser-control
    ports:
      - "3000:3000"
    restart: unless-stopped

启动命令：

# 一键启动（带健康检查）
docker-compose up -d --wait

# 查看日志
docker-compose logs -f openclaw

3.2 纯Docker命令（更精细控制）

# 创建一个数据卷（避免权限问题）
docker volume create openclaw-workspace

# 运行容器（带资源限制）
docker run -d \
  --name openclaw \
  --restart=unless-stopped \
  -p 18789:18789 \
  -p 18792:18792 \
  -v openclaw-workspace:/workspace \
  -v $(pwd)/config.yaml:/app/config.yaml \
  --memory="1g" \
  --cpus="2" \
  --ulimit nofile=65536:65536 \
  ghcr.io/openclaw/openclaw:latest

3.3 云原生部署（K8s YAML）

# k8s-deployment.yaml - 在Kubernetes上跑
apiVersion: apps/v1
kind: Deployment
metadata:
  name: openclaw
spec:
  replicas: 2  # 双副本确保高可用
  selector:
    matchLabels:
      app: openclaw
  template:
    metadata:
      labels:
        app: openclaw
    spec:
      containers:
      - name: openclaw
        image: ghcr.io/openclaw/openclaw:latest
        ports:
        - containerPort: 18789
        - containerPort: 18792
        env:
        - name: OPENCLAW_WORKSPACE
          value: "/workspace"
        volumeMounts:
        - name: workspace
          mountPath: "/workspace"
        - name: config
          mountPath: "/app/config.yaml"
          subPath: "config.yaml"
        resources:
          requests:
            memory: "512Mi"
            cpu: "250m"
          limits:
            memory: "1Gi"
            cpu: "500m"
        livenessProbe:
          httpGet:
            path: /health
            port: 18789
          initialDelaySeconds: 30
          periodSeconds: 10
      volumes:
      - name: workspace
        persistentVolumeClaim:
          claimName: openclaw-pvc
      - name: config
        configMap:
          name: openclaw-config

核心配置详解

安装完成后，需要配置config.yaml文件，这是OpenClaw的核心。

1. AI模型配置（必填）

agents:
  defaults:
    model: "siliconflow/deepseek-ai/DeepSeek-V3.2"
    # 其他可选项：
    # - "openai/gpt-4"
    # - "anthropic/claude-3-opus"
    # - "google/gemini-2.0"

模型选择建议：

  • 性价比之选：DeepSeek-V3.2（性价比高）
  • 最佳体验：GPT-4（需要OpenAI API key）
  • 长文本处理：Claude-3.5-Sonnet（128K上下文）
  • 代码专用：Claude-3.5-Haiku（速度快，成本低）

2. 技能配置（让你的AI学会用工具）

skills:
  # 内置技能，开箱即用
  enabled:
    - github  # GitHub操作
    - things-mac  # Things 3任务管理（macOS）
    - gog  # Google Workspace集成
    - weather  # 天气查询
  
  # 手动安装的技能
  external:
    - /path/to/custom-skill

3. 通道配置（如何与AI对话）

channels:
  telegram:
    enabled: true
    token: "YOUR_BOT_TOKEN"  # 从@BotFather获取
  discord:
    enabled: true
    token: "YOUR_DISCORD_BOT_TOKEN"
  webchat:
    enabled: true  # 网页聊天界面，默认开启

初始设置：认识你的第二大脑

成功启动后，首次访问http://localhost:18789，你会进入一个引导流程：

创建你的身份文件

在~/.openclaw/workspace/目录下会有几个核心文件：

# IDENTITY.md - AI助手的身份
- Name: 龙虾（你可以改成你喜欢的名字）
- Creature: 认知增强型AI
- Vibe: 直击重点，不说废话

# USER.md - 关于你
- Name: 你的名字
- Timezone: 你的时区
- Profession: 你的专业领域

# SOUL.md - AI的行为准则
- 核心原则：说实话，不讨好，提供洞见而非信息

关键对话：

你："你好，我是谁？"
OpenClaw："不知道。现在开始告诉我关于你的一切。"

你："我叫张三，是软件工程师"
OpenClaw："知道了。什么项目？"

你："我有一个Node.js项目"
OpenClaw："👆 代码在哪？"

这就是OpenClaw的基调：直接、高效、专注解决问题。

常用功能快速上手

基本命令

# 查看OpenClaw状态
openclaw status

# 重启Gateway服务
openclaw gateway restart

# 查看日志
openclaw logs

# 更新OpenClaw
openclaw update

配置你的技能仓库

OpenClaw的真正威力在于技能系统。安装社区技能：

# 列出可用技能
openclaw skills list

# 安装技能
openclaw skills install github  # GitHub集成完整版

创建你的第一个技能

# 创建一个新技能目录
mkdir -p ~/.openclaw/workspace/skills/my-skill

# 创建技能配置文件
cat > ~/.openclaw/workspace/skills/my-skill/SKILL.md << 'EOF'
# 我的自定义技能

## 功能描述
这是我自己定制的技能，用于...

## 使用方法
调用时使用：/my-skill [参数]

## 工具
- 需要访问我的API
- 需要读取特定文件
EOF

实战示例：让OpenClaw帮你工作

场景一：开发助手

你："帮我review这个代码"
[上传文件：server.js]
OpenClaw：
1. 🔍 代码分析完成
2. 🐛 发现3个潜在bug
3. ⚡ 给出优化建议
4. 📝 提供修正后的代码

场景三：个人助理

你："提醒我明天下午3点开会"
OpenClaw：
1. 📅 在Google Calendar创建日程
2. ⏰ 设置提前15分钟提醒
3. 📧 向参会者发送邀请
4. 📁 在Things 3创建待办事项

故障排除

常见问题一：端口已被占用

# 查看哪个进程占用了18789端口
lsof -i :18789

# 如果是其他实例，先停止它
pkill -f openclaw

# 或者更改端口
# 在config.yaml中修改：
# gateway:
#   port: 18888

常见问题二：模型API失败

# 检查模型配置
agents:
  defaults:
    model: "siliconflow/deepseek-ai/DeepSeek-V3.2"
    # 确保API key正确
    apiKeys:
      siliconflow: "YOUR_SILICONFLOW_API_KEY"

常见问题三：技能无法加载

# 重新加载技能配置
openclaw skills reload

# 查看技能加载日志
openclaw logs --filter skill

# 手动测试技能
curl http://localhost:18789/api/skills/list

获取帮助的渠道

  1. 官方文档：docs.openclaw.ai
  2. GitHub Issues：github.com/openclaw/op…
  3. Discord社区：discord.gg/clawd

高级进阶

自定义工作流

OpenClaw支持通过MCP（Model Context Protocol）连接外部服务。添加你的工具：

mcp:
  servers:
    - name: "my-tools"
      transport:
        stdio:
          command: "node"
          args: ["/path/to/my-tool-server.js"]

总结

OpenClaw不是一个普通的AI聊天机器人，它是一个可编程的认知伙伴。

核心优势：

  1. 完全掌控 - 你的数据，你的规则
  2. 工具集成 - 连接你的真实工作环境
  3. 持续进化 - 通过技能系统不断扩展能力
  4. 社区驱动 - 开源社区持续贡献新功能

开始行动：

  1. 选择一种部署方式（推荐方式一）
  2. 用5分钟完成基础配置
  3. 创建你的身份文件
  4. 安装一两个技能开始体验

标签：#AI工具 #私有部署 #开发工具 #自动化 #OpenClaw

相关话题：

互动： 如果你已经部署了OpenClaw，欢迎在评论区分享你的使用体验！

avatar
文章
阅读
粉丝