OpenClaw(曾用名 Clawdbot、Moltbot)是一个开源、自托管的 AI 智能体(Agent)系统。它不仅仅是一个聊天机器人,更像是一个拥有“手脚”的 24/7 全天候数字员工。本文是关于 OpenClaw 的详细介绍、安装部署及配置指南。
OpenClaw 介绍
OpenClaw 运行在本地设备(PC、Mac Mini、树莓派)或云服务器(VPS)上,充当私人 AI 助理。
- 核心特性:
- 自托管与隐私:数据和运行环境完全在自己的控制之下。
- 多渠道接入:通过熟悉的即时通讯软件(微信/WeChat via 桥接, Telegram, WhatsApp, Discord, Slack 等)与它对话。
- 执行能力:它不仅能生成文本,还能执行真实任务(如写代码、操作文件、控制浏览器、管理日历、发送邮件等)。
- 模型无关性:支持接入 OpenAI (GPT-4o), Anthropic (Claude 3.5), DeepSeek, Google Gemini 等主流大模型,也支持通过 Ollama 接入本地模型。
- 持久记忆:拥有长期记忆能力,能记住你的偏好和上下文。
环境准备 (Prerequisites)
在安装之前,请确保环境满足以下要求:
- 操作系统:macOS, Linux (Ubuntu/Debian 推荐), 或 Windows (通过 WSL2)。
- 运行环境:
- Node.js:版本需 v20 或更高(推荐 v22+)。
- 包管理器:
npm或pnpm。
- API Key:准备好s打算使用的 AI 服务的 API Key(如 OpenAI API Key 或 Anthropic API Key)。
安装与部署
OpenClaw 提供了几种安装方式,最简单的是使用官方的一键脚本。
一键脚本安装(推荐 macOS/Linux)
打开终端(Terminal),运行以下命令:
curl -fsSL https://openclaw.ai/install.sh | bash该脚本会自动检测环境、安装 Node.js 依赖并下载 OpenClaw 核心文件。
Windows (PowerShell)
在 PowerShell 中运行:
iwr -useb https://openclaw.ai/install.ps1 | iexDocker 部署 (适合隔离环境)
openclaw 可以直接使用 Docker Compose 启动,避免污染本机环境。
- 克隆仓库:
bashgit clone https://github.com/openclaw/openclaw.git cd openclaw - 启动容器:
注意:Docker 模式下,AI 对宿主机的操作权限会被限制在容器内(沙盒环境),适合安全性要求高的场景。
bashdocker-compose up -d
配置指南 (Configuration)
安装完成后,OpenClaw 会自动启动初始化向导。如果没有自动启动,可以手动运行:
openclaw onboard初始化设置 (Onboarding)
向导会通过命令行交互引导完成基础配置:
- 选择 AI 提供商:选择
OpenAI、Anthropic或Ollama(本地)。 - 输入 API Key:粘贴 API 密钥。
- 选择模型:例如
gpt-4o或claude-3-5-sonnet。
连接通讯渠道 (Connect Channels)
这是 OpenClaw 的核心——让 AI 连上聊天软件。 运行命令:
openclaw channels login以 Telegram 为例:
- 在 Telegram 中搜索
@BotFather。 - 发送
/newbot创建一个新机器人,获取 Bot Token。 - 在 OpenClaw 的命令行中选择 Telegram,并粘贴该 Token。
- 在 Telegram 中向新 Bot 发送
/start,OpenClaw 会回复并建立连接。
配置文件修改 (高级配置)
OpenClaw 的配置存储在用户主目录下的 .openclaw 文件夹中。
- 配置文件路径:
~/.openclaw/openclaw.json - 工作区路径:
~/openclaw/workspace(AI 生成的文件会存放在这里)
可以手动编辑 openclaw.json 来添加更多细节,例如修改系统提示词(System Prompt)或调整权限。
{
`agents`: {
`defaults`: {
`model`: `gpt-4o`,
`temperature`: 0.5
}
},
`skills`: {
`enabled`: [`browser`, `filesystem`, `shell`]
}
}常用命令
openclaw gateway:启动网关服务(保持 AI 在线)。openclaw onboard:重新运行配置向导。openclaw update:更新到最新版本。openclaw doctor:检查环境健康状态和依赖问题。
常见使用场景与技巧
- 本地模型 (免费使用):安装 Ollama 后,下载
llama3或qwen2.5-coder模型。在 OpenClaw 配置中选择 Ollama,即可实现完全离线且免费的 AI 助理。 - 安全性:默认情况下,OpenClaw 拥有较高的系统权限(如读写文件)。建议初学者不要直接在生产环境服务器的 root 账户下运行,或者使用 Docker 版本以利用其沙盒机制。
- 技能扩展 (Skills):OpenClaw 支持通过 YAML 定义技能,你可以教它如何调用特定的 API(如查询天气、股票或控制智能家居)。
最近更新
最新评论