OpenClaw 完整部署指南 - 构建你的 AI 助手

概述

#

OpenClaw 是一个强大的 AI 自动化工具框架，可以连接各种服务和 API。本文详细讲解部署过程。

什么是 OpenClaw？

#

OpenClaw 是一个开源的 AI 自动化框架，特点：

• Tool + Skill 架构: 工具决定能力，技能决定行为
• 跨平台: 支持 Telegram、Discord、Slack 等
• 配置灵活: 可自定义每个功能
• 安全可控: 所有操作需确认或白名单

环境要求

#

• Linux/Unix 系统
• Node.js 18+
• 500MB+ 磁盘空间
• 网络连接（访问 GitHub）

安装步骤

#

1. 安装 Node.js

#

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证
node -v
npm -v

2. 安装 OpenClaw

#

# 全局安装
npm install -g openclaw

# 验证安装
openclaw --help
openclaw version

3. 初始化配置

#

# 创建工作目录
mkdir ~/.openclaw/workspace
cd ~/.openclaw/workspace

# 创建配置文件
openclaw configure

4. 配置 Telegram Bot

#

# 获取 Bot Token
# 访问 @BotFather 创建新 Bot
# /newbot → 输入名称和用户名 → 获取 Token

# 配置 Telegram
openclaw configure channel telegram
# 输入 Bot Token

5. 启动网关

#

# 启动网关服务
openclaw gateway start

# 检查状态
openclaw gateway status

6. 绑定 AI

#

在 Telegram 中 @你的Bot → /link → 关联你的 OpenClaw 账号。

工具和技能配置

#

启用工具

#

编辑 openclaw.json：

{
  "tools": {
    "allow": [
      "read", "write", "edit",
      "exec", "process",
      "web_search", "web_fetch"
    ]
  },
  "approvals": {
    "exec": { "enabled": true }
  }
}

启用技能

#

{
  "skills": {
    "allowBundled": [
      "gog", "github", "tmux",
      "weather", "healthcheck"
    ]
  }
}

常用命令

#

# 查看状态
openclaw status

# 查看会话
openclaw sessions list

# 重启网关
openclaw gateway restart

# 更新技能
openclaw clawhub sync

重要配置项

#

approvals - 命令确认

#

{
  "approvals": {
    "exec": { "enabled": true }
  }
}

cron - 定时任务

#

{
  "cron": {
    "jobs": [
      {
        "name": "daily-brief",
        "schedule": "0 9 * * *",
        "prompt": "生成今日简报"
      }
    ]
  }
}

安全建议

#

1. 限制工具权限 - 只启用需要的工具
2. 启用命令确认 - exec 需要确认
3. 使用白名单 - 技能使用 allowBundled
4. 定期更新 - 及时更新 OpenClaw
5. 备份配置 - 保存配置文件

故障排查

#

网关启动失败

#

# 查看日志
tail -f ~/.openclaw/logs/*.log

# 检查端口占用
lsof -i :18789

# 重启服务
openclaw gateway restart

无法连接 Bot

#

• 检查 Token 是否正确
• 确认网络连接
• 重启网关服务

总结

#

OpenClaw 让你可以构建自己的 AI 助手，自动化各种任务。