OPENCLAW 安装教程

什么是 OPENCLAW？

OpenClaw 是一个开源的 AI 助手框架，支持多渠道接入（QQ、Telegram、Discord 等），可以本地部署运行，支持多种大模型接入。

环境要求

• macOS / Linux 系统

• Node.js 18+

• Homebrew（包管理器）

安装步骤

1. 安装 Homebrew

如果未安装 Homebrew，运行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装 OpenClaw

官方一键安装脚本：

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

或者使用 npm 全局安装：

npm install -g openclaw

3. 配置 OpenClaw

运行配置向导：

openclaw configure

或者手动编辑配置文件：

vim ~/.openclaw/openclaw.json

4. 启动网关

openclaw gateway start

5. 检查状态

openclaw gateway status

常用命令

配置示例

配置 QQ 机器人

# 添加 QQ 频道
openclaw channels add --channel qqbot --token "你的机器人Token"
​
# 启用 QQ 插件
openclaw plugins install @tencent-connect/openclaw-qqbot@latest
​
# 重启网关
openclaw gateway restart

配置大模型

编辑 ~/.openclaw/openclaw.json：

{
  "llm": {
    "default": "deepseek",
    "providers": {
      "deepseek": {
        "base_url": "https://api.deepseek.com/v1",
        "api_key": "你的API密钥"
      }
    }
  }
}

注意事项

1. 保持 Token 安全：机器人 Token 不要泄露

2. 配置备份：定期备份 ~/.openclaw/ 目录

3. 日志查看：使用 openclaw logs --follow 排查问题

常见问题

网关无法启动

# 检查端口占用
lsof -i :18789
​
# 查看错误日志
openclaw logs

机器人无法响应

1. 检查插件是否启用：openclaw plugins list

2. 检查频道配置：openclaw channels list

3. 重启网关：openclaw gateway restart

卸载 OPENCLAW

如果需要完全卸载 OpenClaw，可以运行官方卸载脚本或手动执行：

方法一：使用卸载脚本

项目提供了完整的卸载脚本 ~/un.sh，执行：

bash ~/un.sh

手动卸载步骤

1. 停止服务

openclaw gateway stop

2. 卸载 CLI 工具

npm rm -g openclaw
# 或 pnpm bun

3. 删除数据目录

rm -rf ~/.openclaw
rm -rf ~/.clawdbot
rm -rf ~/.moltbot

4. 删除自启服务

rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist

5. 验证

which openclaw  # 应无输出
ls ~/.openclaw  # 应报错"No such file"