OpenClaw的安装与使用

本文由deepseek提供辅助编写

OpenClaw简介

最近这个龙虾机器人很红，最早是叫ClawBot，后来被Claude告了，改成MoltBot，然后又改成现在的OpenClaw。

主要特性:

支持多个AI模型接入(OpenAI、Claude、等)
多渠道消息推送(Telegram、钉钉、企业微信等)
插件化架构,易于扩展
支持对话上下文管理
Docker部署支持
配置简单,开箱即用

安装OpenClaw

准备工作

需要准备一台配置为2C2G或更高的虚拟机, 确保虚拟机有外网访问权限。系统为Linux，这里以Debian13为例。

安装步骤

使用官方一键安装脚本安装OpenClaw:

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

建议使用当前用户安装，如果用root用户安装可以有更大的权限，但也有更大的风险。

安装过程中需要配置AI接口，如果你有OpenAI或Claude的API直接配置上去就好了，早年Deepseek没有在支持列表里，需要后面再配，这里只能先跳过，现在版本已经支持了。

安装过程中如果有问题，可以再次安装

# 完全重装
openclaw setup
# 安装后的设置
openclaw onboard

如果openclaw命令不能使用，可能需要重新登录一下当前用户。如果登录后还不行，则需要再次运行一键安装脚本。

配置DeepSeek API

DeepSeek是国内优秀的AI模型提供商,提供免费和付费的API服务。OpenClaw支持对接DeepSeek API,配置方式与OpenAI类似。

1. 获取DeepSeek API Key

访问DeepSeek官网: https://platform.deepseek.com
注册账号并登录
进入API Keys页面
点击"Create new API Key"创建新的API密钥
保存生成的API Key

2. 配置OpenClaw使用DeepSeek

编辑OpenClaw配置文件:

vim ~/.openclaw/openclaw.json

修改AI配置部分:

"models": {
  "providers": {
    "deepseek": {
      "baseUrl": "https://api.deepseek.com/v1",  # DeepSeek API地址
      "apiKey": "你的DeepSeek API Key",
      "auth": "api-key",
      "api": "openai-completions",
      "models": [
        {
          "id": "deepseek-v4-flase",
          "name": "Deepseek V4 Flash",
          "contextWindow": 1048576,
          "maxTokens": 16384
        }
        {
          "id": "deepseek-v4-pro",
          "name": "Deepseek V4 Pro",
          "contextWindow": 1048576,
          "maxTokens": 16384
        }
      ]
    }
  }
}

4. 测试DeepSeek API

重启OpenClaw服务后,发送测试消息:

systemctl --user restart openclaw
# 或
openclaw gateway restart

在Telegram或钉钉中发送消息,OpenClaw会使用DeepSeek模型进行回复。

5. 使用DeepSeek免费额度

DeepSeek新用户提供免费API额度, 可以在DeepSeek控制台查看使用情况:

登录DeepSeek平台
进入Dashboard页面
查看API使用统计和剩余额度

如果免费额度用完, 可以充值付费使用或换其它的服务商，但目前Deepseek是性价比最高的。

配置Telegram频道

Telegram是OpenClaw最常用的消息推送渠道之一。配置Telegram频道需要创建Bot并获取Bot Token。

1. 创建Telegram Bot

在Telegram中搜索并添加BotFather (@BotFather)
发送命令 /newbot 创建新机器人
按提示设置机器人的名称和用户名
创建成功后,BotFather会返回一个Bot Token,格式如 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
保存这个Token,后续配置需要用到

2. 配置OpenClaw

直接用onboard命令配置即可。

获取Telegram用户ID的方法:

在Telegram中搜索并添加userinfobot (@userinfobot)
点击"Start"按钮
机器人会返回你的用户ID

3. 配置Webhook(可选)

如果你有公网域名,可以配置Webhook来接收Telegram消息:

确保域名可以访问到OpenClaw服务
设置Telegram Webhook:

curl -X POST "https://api.telegram.org/bot你的Bot Token/setWebhook" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://你的域名/webhook/telegram",
    "secret_token": "your-secret-key"
  }'

验证Webhook设置:

curl "https://api.telegram.org/bot你的Bot Token/getWebhookInfo"

4. 重启服务

配置完成后,重启OpenClaw服务使配置生效

5. 测试

在Telegram中找到你的Bot,发送消息"hello",如果配置正确,应该能收到AI的回复。

对接钉钉

OpenClaw可以通过插件对接钉钉,实现消息推送到钉钉群聊。这里使用开源插件 soimy/openclaw-channel-dingtalk。

1. 创建钉钉机器人

在钉钉群设置中选择"智能群助手"
点击"添加机器人" -> “自定义”
设置机器人名称,例如"OpenClaw"
设置安全设置,推荐选择"加签"方式
创建成功后,会获得:
- Webhook地址
- 加签密钥(Secret)

保存这些信息,后续配置需要用到。

2. 安装钉钉插件

直接在配置好的TG或openclaw的webui中把插件链接给它，让它自己配置。

3. 测试钉钉推送

重启OpenClaw服务

直接和钉钉机器人对话，或建个群后在钉钉群中发送包含触发关键词的消息,例如"AI你好",OpenClaw应该会响应并返回AI的回复。

在Docker上安装OpenClaw

Docker部署方式适合快速测试和在容器化环境中使用OpenClaw。

1. 准备工作

确保系统已安装Docker和Docker Compose

2. 创建项目目录

mkdir -p ~/openclaw
cd ~/openclaw

3. 创建docker-compose.yml

创建 docker-compose.yml 文件:

cat > docker-compose.yml << EOF
version: '3.8'

services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:2026.4.22-slim
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ~/openclaw:/home/node/.openclaw
    environment:
      - TZ=Asia/Shanghai
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s
EOF

5. 启动OpenClaw

# 拉取镜像并启动服务
docker-compose up -d

# 查看日志
docker-compose logs -f

# 查看服务状态
docker-compose ps

6. 管理命令

# 停止服务
docker-compose stop

# 启动服务
docker-compose start

# 重启服务
docker-compose restart

# 查看日志
docker-compose logs -f

# 进入容器
docker-compose exec openclaw sh

# 更新镜像
docker-compose pull
docker-compose up -d

7. 数据持久化

OpenClaw的数据(包括对话历史、配置等)会保存在 ~/.openclaw 目录中。建议定期备份这个目录:

# 备份数据
tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz data/

# 恢复数据
tar -xazf openclaw-backup-20260210.tar.gz

常见问题

1. 服务无法启动

检查日志查看错误信息:

# 系统安装方式
sudo journalctl -u openclaw -n 50

# Docker方式
docker-compose logs -f

常见原因:

配置文件语法错误
端口被占用
权限不足

2. 消息发送失败

检查:

API Key是否正确
网络连接是否正常
渠道配置是否正确(如Bot Token、Webhook地址等)
是否有防火墙限制

3. Docker容器无法访问外网

检查Docker网络配置:

# 检查Docker网络
docker network inspect bridge

# 重启Docker服务
sudo systemctl restart docker

4. 更新OpenClaw

系统安装方式:

openclaw update

Docker方式:

docker-compose pull
docker-compose up -d

总结

本文介绍了OpenClaw的多种安装和使用方式:

系统安装: 使用一键安装脚本在Debian上安装,适合长期运行的服务器环境
Telegram配置: 创建Bot并配置Webhook,实现Telegram消息推送
DeepSeek API配置: 对接国内优秀的AI模型提供商,支持免费和付费API
钉钉对接: 使用开源插件实现钉钉群聊消息推送
Docker部署: 使用Docker Compose快速部署,适合测试和容器化环境

OpenClaw提供了灵活的消息推送解决方案,可以根据实际需求选择合适的安装方式和配置选项。建议在生产环境中使用系统安装方式,并定期备份数据。

参考资源

OpenClaw官方文档: https://openclaw.ai
Telegram Bot API: https://core.telegram.org/bots/api
钉钉机器人开发: https://open.dingtalk.com/document/robots/custom-robot-access
钉钉插件仓库: https://github.com/soimy/openclaw-channel-dingtalk

推送到[go4pro.org]

友情链接

标签