前言
想要拥有一个 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:
- 访问 飞书开放平台
- 创建企业自建应用
- 获取 App ID 和 App Secret
- 配置事件订阅权限
- 将应用发布到测试版本
# 配置飞书
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"
安全建议
- 保护 API Key - 不要提交到代码仓库
- 设置访问密码 - 配置 gateway.auth.token
- 定期更新 - 及时更新 OpenClaw 和 Skill
- 备份配置 - 定期备份
~/.openclaw/openclaw.json
总结
部署 OpenClaw 只需 6 步:
- 安装 Node.js
- 安装 OpenClaw
- 初始化配置
- 配置频道(飞书等)
- 启动服务
- 验证部署
现在你已经拥有了自己的 AI 助手,开始探索吧!