openclaw 基础篇(安装部署与基础配置指南)

安装部署

本章介绍 OpenClaw 的主流安装方式：一键脚本、npm 手动安装、Docker 部署。

方式一：一键安装脚本（推荐）

macOS / Linux / WSL2

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

Windows PowerShell

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

仅安装程序，不立即启动配置向导：

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

方式二：npm 手动安装

# 确保 Node.js 22+node --version# 全局安装 OpenClawnpm install -g openclaw@latest# 运行配置向导（同时安装守护进程）openclaw onboard --install-daemon

方式三：Docker 部署

docker pull openclaw/openclaw:latestdocker run -d \  --name openclaw \  -p 18789:18789 \  -v ~/.openclaw:/root/.openclaw \  -e ANTHROPIC_API_KEY=sk-ant-xxx \  openclaw/openclaw:latest

安装后验证

openclaw --versionopenclaw doctoropenclaw gateway statusopenclaw dashboard

如果 openclaw dashboard网关页面能够正常打开，网关服务已正常启用。

常见问题

命令不存在，无法执行

npm prefix -gexport PATH="$(npm prefix -g)/bin:$PATH"

sharp 编译失败（macOS 常见）

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

端口冲突

lsof -i :18789openclaw gateway --port 19000

网关无法启动

openclaw doctoropenclaw doctor --fixopenclaw logs --follow

基础配置

OpenClaw 使用 ~/.openclaw/openclaw.json（JSON5）作为主配置文件。

首次向导

openclaw onboard --install-daemon

向导将自动完成：Token 认证、默认模型配置、消息渠道选择及守护进程安装。

最小可用配置

{  agents: {    defaults: {      model: {        primary: "anthropic/claude-sonnet-4-5",      },      workspace: "~/.openclaw/workspace",    },  },}

在 ~/.openclaw/.env 中写入 API Key：

ANTHROPIC_API_KEY=sk-ant-api03-xxxxx

常用命令

# 查看配置cat ~/.openclaw/openclaw.json#云端模型配置openclaw config set agents.defaults.model.primary "anthropic/claude-opus-4-6"#本地模型配置openclaw config set agents.defaults.model.primary "local/gemma4-e4b"# 读取配置openclaw config get# 修改后重启openclaw gateway restart

推荐配置示例

{  gateway: {    mode: "local",    port: 18789,    bind: "loopback",    auth: {      token: "${OPENCLAW_GATEWAY_TOKEN}",    },  },  agents: {    defaults: {      workspace: "~/.openclaw/workspace",      model: {        primary: "anthropic/claude-sonnet-4-5",        fallbacks: ["deepseek/deepseek-chat"],      },      thinkingDefault: "low",      timeoutSeconds: 600,    },  },}

配置验证

openclaw doctoropenclaw statusopenclaw dashboard

消息渠道

OpenClaw 支持同时接入多个消息渠道，一个 Gateway 统一管理。

Telegram（推荐）

在 Telegram 用 @BotFather 创建 Bot，拿到 Token。

配置 ~/.openclaw/openclaw.json：

{  channels: {    telegram: {      enabled: true,#机器人的身份密钥 / 登录凭证  botToken: "123456789:ABCdefGHIjklMNO",#私聊消息处理策略 = 配对模式      dmPolicy: "pairing",      groups: {        "*": { requireMention: true },      },    },  },}

重启并完成配对：

常见问题

# 查看日志openclaw logs --follow

私聊不回复：确认 Bot Token、Gateway 状态。
群聊不回复：需要 @机器人 或关闭 Telegram Privacy Mode。
国内网络问题：配置代理 proxy: “socks5://127.0.0.1:7890“

。

多渠道机器人接入示例

{  channels: {    telegram: { enabled: true, botToken: "xxx" },    discord: { enabled: true, token: "xxx" },    whatsapp: { dmPolicy: "pairing", allowFrom: ["+86xxxxxxxxxxx"] },  },}

下一个章节介绍《模型配置》，把默认模型与备用模型配置好。

点赞、转发、加关注

若您喜欢这篇内容，可点击文章末尾的点赞、分享、推荐。这对您无需花费太多时间，却能为我的成长提供很大助力。感谢您的支持！