OpenClaw 完全部署指南:从零搭建你的 AI 助手

15 阅读2分钟

前言

想要拥有一个 24 小时在线、能帮你写代码、查资料、管理文件的 AI 助手?OpenClaw 是你的最佳选择。

本文手把手教你从零部署 OpenClaw,无需编程基础,跟着步骤做就能成功。

什么是 OpenClaw

OpenClaw 是一个开源的 AI 助手框架,它可以:

  • 🤖 连接多种 AI 模型(Kimi、Claude、GPT 等)
  • 💬 接入多个聊天平台(飞书、钉钉、Telegram 等)
  • 🛠️ 执行各种任务(写代码、查资料、管理文件)
  • 🔌 扩展无限功能(通过 Skill 系统)

部署环境要求

  • Linux 服务器(Ubuntu/CentOS)或 Mac
  • Node.js 18+
  • 至少 2GB 内存
  • 稳定的网络连接

第一步:安装 Node.js

# 使用 nvm 安装(推荐)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22

# 验证安装
node -v  # 应显示 v22.x.x
npm -v   # 应显示 10.x.x

第二步:安装 OpenClaw

# 全局安装
npm install -g openclaw

# 验证安装
openclaw --version

第三步:初始化配置

# 运行配置向导
openclaw configure

# 按提示选择:
# 1. 选择 AI 模型提供商(Kimi/Claude/OpenAI)
# 2. 输入 API Key
# 3. 选择要启用的频道(飞书/钉钉等)
# 4. 配置其他选项

第四步:配置飞书(可选)

如果你想通过飞书使用 OpenClaw:

  1. 访问 飞书开放平台
  2. 创建企业自建应用
  3. 获取 App ID 和 App Secret
  4. 配置事件订阅权限
  5. 将应用发布到测试版本
# 配置飞书
openclaw config set channels.feishu.appId "cli_xxxxx"
openclaw config set channels.feishu.appSecret "your_secret"
openclaw config set channels.feishu.enabled true

第五步:启动服务

# 启动 Gateway 服务
openclaw gateway start

# 或者使用 systemd 后台运行
openclaw gateway install-service
systemctl start openclaw-gateway

第六步:验证部署

# 检查服务状态
openclaw gateway status

# 测试 AI 对话
openclaw chat "你好,OpenClaw"

常见问题

Q: 启动失败,提示端口被占用

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

# 更换端口
openclaw config set gateway.port 18888

Q: 无法连接 AI 模型

  • 检查 API Key 是否正确
  • 确认网络可以访问 AI 服务
  • 查看日志:tail -f /tmp/openclaw/*.log

Q: 飞书收不到消息

  • 检查事件订阅配置
  • 确认应用已发布
  • 验证权限是否申请

进阶配置

配置多个 AI 模型

openclaw config set models.providers.claude.apiKey "sk-xxx"
openclaw config set models.providers.claude.enabled true

安装 Skill

# 查看可用 Skill
openclaw skills list

# 安装 Skill
openclaw skills install weather
openclaw skills install github

配置定时任务

# 使用 cron 设置定时任务
openclaw cron add --name "morning-report" --schedule "0 9 * * *" --command "generate-daily-report"

安全建议

  1. 保护 API Key - 不要提交到代码仓库
  2. 设置访问密码 - 配置 gateway.auth.token
  3. 定期更新 - 及时更新 OpenClaw 和 Skill
  4. 备份配置 - 定期备份 ~/.openclaw/openclaw.json

总结

部署 OpenClaw 只需 6 步:

  1. 安装 Node.js
  2. 安装 OpenClaw
  3. 初始化配置
  4. 配置频道(飞书等)
  5. 启动服务
  6. 验证部署

现在你已经拥有了自己的 AI 助手,开始探索吧!