OpenClaw 部署配置使用指南

一、什么是 OpenClaw

OpenClaw 是一个自托管的 AI 助手网关，让你可以通过 WhatsApp、Telegram、Discord 等聊天工具与 AI 助手对话。它运行在你自己的服务器上，数据完全由你掌控。

核心特点：

自托管：运行在你的硬件上，你的规则

多渠道：一个网关服务 WhatsApp、Telegram、Discord 等

AI 原生：支持工具使用、会话管理、多代理路由

开源免费：MIT 许可，社区驱动

二、系统要求

Node.js 24（推荐）或 Node.js 22 LTS

操作系统：macOS、Linux、Windows（推荐 WSL2）

AI 提供商 API 密钥（阿里云、OpenAI、Anthropic 等）

三、部署安装

方法一：安装脚本（推荐）

macOS / Linux：

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

Windows PowerShell：

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

方法二：npm 安装

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

四、配置说明

配置文件位置：~/.openclaw/openclaw.json

配置示例：

{ "agents": { "defaults": { "workspace": "~/.openclaw/workspace", "model": { "primary": "alibaba-bailian/qwen3.5-plus" } } }, "channels": { "whatsapp": { "enabled": true, "dmPolicy": "pairing" } } }

主要配置项：

agents - AI 代理配置（工作区、模型选择）

channels - 聊天渠道配置（WhatsApp、Telegram 等）

models - 模型目录和别名

session - 会话管理和重置策略

tools - 工具权限控制

gateway - 网关服务设置

五、使用方法

启动网关：

openclaw gateway

连接聊天渠道：

openclaw channels login whatsapp

打开 Web 控制面板：

openclaw dashboard

六、常用命令

openclaw status

- 查看网关运行状态

openclaw doctor

- 诊断配置问题

openclaw dashboard

- 打开 Web 控制面板

openclaw configure

- 配置向导

openclaw channels login

- 登录聊天渠道

openclaw gateway start

- 启动网关服务

openclaw gateway stop

- 停止网关服务

openclaw config get

- 获取配置项

openclaw config set

- 设置配置项

七、安全建议

不要在聊天中明文发送 API 密钥

定期重置敏感凭证（如 appsecret）

配置 IP 白名单限制 API 访问

使用 allowFrom 限制可访问用户

八、获取帮助

官方文档：https://docs.openclaw.ai

GitHub：https://github.com/openclaw/openclaw

Discord 社区：https://discord.com/invite/clawd

ClawHub 技能市场：https://clawhub.com

开始你的 OpenClaw 之旅吧！