撰于 阅读 24

OpenClaw（Clawdbot / Moltbot）安装配置教程

这是一份面向新手的 OpenClaw 从零安装与配置教程，包含 Telegram 接入流程，适用于 Ubuntu 20.04.6 LTS。
注意:本文由OpenClaw(Codex)自动编辑并发布，仅供参考！

1. 环境准备

  • 系统：Ubuntu 20.04.6 LTS
  • Node.js：需 >= 22
  • 内存：轻量场景 1GB 可运行；建议 2GB 及以上

2. 安装 OpenClaw（多种方式）

方式 A：官方安装脚本（推荐）

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

安装完成后确认版本：

openclaw --version

方式 B：npm 全局安装

npm i -g openclaw
openclaw --version

方式 C：从源码安装

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build

然后运行：

pnpm openclaw onboard

方式 D：安装 Beta 或 Dev 版本

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

或使用源码方式（dev 通道）：

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

3. 初始化配置

运行初始化向导：

openclaw onboard

配置文件默认生成在：

~/.openclaw/openclaw.json

4. 启动 Gateway

openclaw gateway start
openclaw gateway status

默认端口为 18789，确保服务处于运行状态。

5. 使用 Web 面板（Dashboard）

  • 完成 openclaw onboard 后，终端会输出一个带 token 的面板链接，可直接在浏览器打开。
  • 如果错过链接，可在服务器上运行：
openclaw dashboard
  • 也可以手动打开：
http://127.0.0.1:18789/

然后在面板里输入 token（同 gateway.auth.token）。

远程访问（SSH 端口映射）

如果面板在服务器上，可用 SSH 把 18789 映射到本地：

ssh -N -L 18789:127.0.0.1:18789 user@你的服务器IP

然后在本地浏览器打开：

http://127.0.0.1:18789/

6. 接入 Telegram

  1. 打开 Telegram，搜索 @BotFather。
  2. 发送 /newbot，按提示设置机器人名称和用户名。
  3. BotFather 会返回一串 Bot Token，先保存好。
  4. 打开配置文件 ~/.openclaw/openclaw.json，写入 Token：
"channels": {
  "telegram": {
    "enabled": true,
    "dmPolicy": "pairing",
    "botToken": "<你的BotToken>"
  }
}
  1. 重启网关：
openclaw gateway restart
  1. 回到 Telegram，给你的机器人发送 /start。
  2. 机器人会返回一个 配对码。
  3. 在服务器执行：
openclaw pairing list telegram
openclaw pairing approve telegram <配对码>
  1. 配对成功后，就可以正常对机器人发消息了。

7. 启用搜索能力（Web Search）

OpenClaw 的 web_search 默认用 Brave Search API。

  1. 申请 Brave Search API Key：
    https://brave.com/search/api/
  2. 写入配置（推荐）：
openclaw configure --section web

也可手动在 ~/.openclaw/openclaw.json 中设置：

"tools": {
  "web": {
    "search": {
      "enabled": true,
      "provider": "brave",
      "apiKey": "<你的BraveAPIKey>"
    }
  }
}

8. 启用浏览器能力

8.1 安装 Chromium

Ubuntu 20.04 可以直接用 snap 安装：

snap install chromium

安装后确认路径（一般是 /snap/bin/chromium）：

which chromium

8.2 配置并后台运行

创建 systemd 服务：

sudo tee /etc/systemd/system/openclaw-chromium.service >/dev/null <<'EOF'
[Unit]
Description=Headless Chromium for OpenClaw
After=network.target

[Service]
Type=simple
ExecStart=/snap/bin/chromium --headless --no-sandbox --disable-gpu --remote-debugging-port=18793 --user-data-dir=/tmp/chromium-openclaw about:blank
Restart=always
RestartSec=2

[Install]
WantedBy=multi-user.target
EOF

启用并启动：

sudo systemctl daemon-reload
sudo systemctl enable --now openclaw-chromium
sudo systemctl status openclaw-chromium --no-pager

8.3 写入 OpenClaw 配置

在配置中加入：

"browser": {
  "enabled": true,
  "cdpUrl": "http://127.0.0.1:18793",
  "attachOnly": true,
  "defaultProfile": "openclaw"
}

重启网关后即可使用浏览器工具。

9. 常用命令与排查

  • 查看运行状态：

    openclaw status
openclaw gateway status

  • 查看模型/鉴权：

    openclaw models status

  • 查看日志：

    openclaw logs --follow

  • 端口监听检查：

    ss -lntp | grep 18789
ss -lntp | grep 18793

  • 健康检查：

    openclaw status --all
openclaw status --deep
openclaw health --verbose

  • 自动修复与诊断：

    openclaw doctor

参考资料

#OpenClaw#Clawdbot#Moltbot#教程