OpenClaw 安装与使用指南：打造你的专属 AI 助手

什么是 OpenClaw？

OpenClaw 是一个开源的自托管 AI 助手平台，它让你能够在自己的服务器上运行 AI 助手，并通过多种渠道（Telegram、WhatsApp、Discord、Slack 等）与你交互。

与传统的 AI 聊天服务不同，OpenClaw 的核心理念是自主可控：

系统要求

在安装之前，确保你的系统满足以下要求：

检查 Node.js 版本：

1

node --version

安装 OpenClaw

1

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

1

iwr -useb https://openclaw.ai/install.ps1 | iex

1
2

npm install -g openclaw@latest
openclaw onboard --install-daemon

1
2
3
4
5

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon

1

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

初始配置

安装完成后，运行配置向导：

1

openclaw onboard --install-daemon

向导会引导你完成以下配置：

1. 身份验证 — 设置访问令牌
2. 网关配置 — 配置服务端口和主机
3. 通道设置（可选）— 连接 Telegram、WhatsApp 等

常用配置命令

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 检查安装状态
openclaw doctor

# 查看网关状态
openclaw gateway status

# 启动网关服务
openclaw gateway start

# 停止网关服务
openclaw gateway stop

# 打开控制面板
openclaw dashboard

使用 Control UI 聊天

安装完成后，最快的使用方式是打开 Control UI：

1

openclaw dashboard

这会打开浏览器，进入 OpenClaw 的 Web 界面。你可以直接在浏览器中与 AI 助手对话，无需配置任何消息通道。

默认地址：http://127.0.0.1:18789/

配置消息通道

除了浏览器界面，OpenClaw 还支持通过多种消息应用与 AI 助手交互。

Telegram 配置示例

1. 在 Telegram 中找到 @BotFather
2. 创建新机器人：/newbot
3. 获取 Bot Token
4. 运行 OpenClaw 配置：

1

openclaw configure --section telegram

WhatsApp 配置示例

1

openclaw configure --section whatsapp

按照提示扫描二维码完成配对。

核心功能介绍

1. 浏览器自动化

OpenClaw 内置浏览器控制功能，AI 可以：

• 打开网页并提取内容
• 截取网页截图
• 执行网页操作（点击、填写表单等）
• 自动化测试

示例：让 AI 帮你查看某个网页

1

帮我把 https://example.com 的内容总结一下

2. 代码执行

AI 助手可以直接执行代码：

• 运行 Shell 命令
• 执行 Python/JavaScript 脚本
• 读写文件
• Git 操作

示例：

1

帮我查看当前目录的 Git 状态

3. 定时任务 (Cron)

使用内置的 cron 系统设置定时任务：

1

openclaw cron add --name "daily-report" --schedule "0 9 * * *" --command "生成每日报告"

4. 浏览器扩展

安装 OpenClaw 浏览器扩展后，AI 可以控制你正在浏览的页面：

1. 在 Chrome/Edge 中安装扩展
2. 点击工具栏上的 OpenClaw 图标
3. 让 AI 与当前页面交互

5. 多模型支持

OpenClaw 支持多种 AI 模型：

• OpenAI — GPT-4、GPT-3.5
• Anthropic — Claude 系列
• Google — Gemini
• 本地模型 — Ollama、LM Studio

在配置文件中设置默认模型：

1
2
3
4
5
6
7
8

{
  "models": {
    "default": "openai/gpt-4",
    "aliases": {
      "coding": "anthropic/claude-3-opus"
    }
  }
}

环境变量

OpenClaw 支持以下环境变量来自定义配置：

示例：

1
2

export OPENCLAW_CONFIG_PATH=/etc/openclaw/config.json
openclaw gateway start

更新与维护

更新 OpenClaw

1
2
3

npm update -g openclaw
# 或重新运行安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash

查看日志

1
2
3
4
5

# 网关日志
openclaw gateway logs

# 实时日志
openclaw gateway logs --follow

备份与迁移

OpenClaw 的数据存储在：

• 配置：~/.openclaw/config.json
• 状态：~/.openclaw/state/
• 工作区：~/.openclaw/workspace/

备份时复制这些目录即可。

故障排查

1
2
3
4
5

# 查看 npm 全局路径
npm prefix -g

# 添加到 PATH（添加到 ~/.zshrc 或 ~/.bashrc）
export PATH="$(npm prefix -g)/bin:$PATH"

1
2
3
4
5
6
7
8

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

# 查看详细错误
openclaw doctor

# 手动前台运行查看日志
openclaw gateway --port 18789

1

openclaw configure --section openai

进阶使用场景

场景 1：自动化日报

设置定时任务，每天早上 9 点让 AI 生成工作日报：

1
2
3
4

openclaw cron add \
  --name "morning-report" \
  --schedule "0 9 * * 1-5" \
  --message "请检查邮件和日历，生成今天的工作计划"

场景 2：网站监控

让 AI 定期检查网站状态：

1
2
3
4

openclaw cron add \
  --name "website-check" \
  --schedule "*/30 * * * *" \
  --command "检查 https://my-site.com 是否正常"

场景 3：代码审查助手

在 Git 项目中配置 pre-commit 钩子，让 AI 检查代码：

1
2
3

#!/bin/bash
# .git/hooks/pre-commit
openclaw agent run --task "检查本次提交的代码变更，找出潜在问题"

总结

OpenClaw 为 AI 助手的自托管提供了完整的解决方案。通过本文，你应该已经掌握了：

• ✅ 如何安装 OpenClaw
• ✅ 基本配置和启动
• ✅ 使用 Control UI 聊天
• ✅ 配置消息通道
• ✅ 核心功能的使用

OpenClaw 的生态系统正在快速发展，更多功能可以参考 官方文档。

相关链接：

• OpenClaw 官网
• GitHub 仓库
• 官方文档