avatar

范伟彬个人网

https://fanweibin.cn

  • 首页
  • 归档
  • 链接
  • 关于
  • AI 导航
  • 健康指南
主页 OpenClaw 完整安装与使用指南：零成本打造全能 AI 助理
文章

OpenClaw 完整安装与使用指南：零成本打造全能 AI 助理

发表于 最近 更新于 最近
作者 Administrator
77~100 分钟 阅读

支持平台：macOS · Windows · Linux（服务器） 通过 Telegram、飞书接入 Claude Max 订阅，零额外 API 费用。本文区分三大平台的不同安装方式，按需查阅对应章节。

一、背景与方案选型

为什么选 OpenClaw？

OpenClaw 是目前 GitHub star 数最多的开源 AI 个人助理框架，支持通过 WhatsApp、Telegram、飞书、Discord、Slack 等主流 IM 平台接入 Claude、GPT 等大模型。

核心优势：

  • 原生支持飞书，无需自行开发 adapter

  • 支持 Anthropic Max 订阅 OAuth，无需额外 API key，零增量成本

  • tools profile 完整，支持文件读写、Shell 执行、网页抓取、浏览器自动化等

  • 52+ 内置 Skills，覆盖编程、文档、天气、邮件、社交媒体等场景

  • 跨平台，macOS / Windows / Linux 均可运行

⚠️ 防踩坑：网上存在山寨版 ComposioHQ/secure-openclaw，只支持 4 个平台，不支持飞书，且功能残缺。官方仓库是 openclaw/openclaw，安装域名是 openclaw.ai。

三种部署场景对比

场景

推荐方式

特点

个人电脑（macOS）

本地安装 + launchd 自启

可直接操作本机文件、浏览器、应用

个人电脑（Windows）

本地安装 + 任务计划程序

可操作本机，需 PowerShell 环境

Linux 服务器

安装 + systemd 自启

稳定后台运行，不依赖个人电脑

二、前置准备

2.1 安装 Node.js（≥ v22，推荐 v24）

OpenClaw 需要 Node.js v22 及以上版本。先检查现有版本：

node -v

若版本不足或未安装，按系统操作：

🍎 macOS

方式一：官方安装包（推荐新手）

访问 https://nodejs.org 下载 LTS 版本（v22+），双击 .pkg 安装。

方式二：Homebrew

brew install node@24
echo 'export PATH="/opt/homebrew/opt/node@24/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

方式三：nvm（适合需要多版本管理）

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.zshrc
nvm install 24 && nvm use 24

🪟 Windows

方式一：官方安装包（推荐新手）

访问 https://nodejs.org 下载 LTS 版本（v22+），运行安装程序，全程下一步。安装时勾选 "Add to PATH"，安装完重启终端。

方式二：winget（Windows 10/11 内置）

winget install OpenJS.NodeJS.LTS

方式三：nvm-windows

访问 https://github.com/coreybutler/nvm-windows/releases 下载 nvm-setup.exe，安装后：

nvm install 24
nvm use 24

🐧 Linux（Ubuntu / Debian）

方式一：NodeSource 官方脚本（推荐）

curl -fsSL https://deb.nodesource.com/setup_24.x | bash -
apt-get install -y nodejs

方式二：nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 24 && nvm use 24

方式三：宝塔面板

软件商店 → 搜索 Node.js → 安装 v24 → 切换版本。

2.2 配置代理（中国大陆用户必须）

OpenClaw 需要访问 api.anthropic.com，国内需要代理。

🍎 macOS 配置代理

推荐使用 Clash Verge Rev（规则代理，精准分流）：

  1. 下载：https://github.com/clash-verge-rev/clash-verge-rev/releases

  2. 安装后导入机场订阅，开启 System Proxy

  3. 代理端口默认 7897

设置终端环境变量（.zshrc）：

cat >> ~/.zshrc << 'EOF'
export http_proxy=http://127.0.0.1:7897
export https_proxy=http://127.0.0.1:7897
export no_proxy=localhost,127.0.0.1
EOF
source ~/.zshrc

# npm 单独设置
npm config set proxy http://127.0.0.1:7897
npm config set https-proxy http://127.0.0.1:7897

🪟 Windows 配置代理

同样推荐 Clash Verge Rev，下载 windows-x64 版本，开启 System Proxy。

在 PowerShell 中设置（写入 Profile 永久生效）：

# 永久写入 PowerShell Profile
if (!(Test-Path $PROFILE)) { New-Item -Path $PROFILE -Force }
Add-Content $PROFILE '$env:http_proxy = "http://127.0.0.1:7897"'
Add-Content $PROFILE '$env:https_proxy = "http://127.0.0.1:7897"'

# npm 单独设置
npm config set proxy http://127.0.0.1:7897
npm config set https-proxy http://127.0.0.1:7897

重启 PowerShell 生效。

🐧 Linux 服务器配置代理

推荐 Mihomo TUN 模式（透明代理，对 Node.js 最友好）：

# 下载安装 Mihomo
wget https://github.com/MetaCubeX/mihomo/releases/latest/download/mihomo-linux-amd64.gz
gunzip mihomo-linux-amd64.gz
mv mihomo-linux-amd64 /usr/local/bin/mihomo
chmod +x /usr/local/bin/mihomo
sudo setcap cap_net_admin,cap_net_raw,cap_net_bind_service=+ep /usr/local/bin/mihomo

配置文件 /etc/mihomo/config.yaml：

mixed-port: 7890
tun:
  enable: true
  stack: mixed
  auto-route: true
dns:
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.0/15
rules:
  - DOMAIN-SUFFIX,anthropic.com,PROXY
  - DOMAIN-SUFFIX,claude.ai,PROXY
  - MATCH,DIRECT

设置环境变量（.bashrc）：

cat >> ~/.bashrc << 'EOF'
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export no_proxy=localhost,127.0.0.1,192.168.0.0/16
EOF
source ~/.bashrc

npm config set proxy http://127.0.0.1:7890
npm config set https-proxy http://127.0.0.1:7890

三、安装 OpenClaw

3.1 执行安装脚本

🍎 macOS / 🐧 Linux

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

🪟 Windows（PowerShell，以管理员身份运行）

irm https://openclaw.ai/install.ps1 | iex

如提示执行策略限制，先运行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

安装成功后输出：

✓ Node.js v24.14.0 found
· Installing OpenClaw v2026.3.2
✓ OpenClaw installed
🦞 OpenClaw installed successfully (2026.3.2)!

安装完成后重新打开终端，使 openclaw 命令生效。

3.2 运行 onboard 配置向导

# macOS / Linux / Windows (PowerShell) 命令相同
openclaw onboard --install-daemon

--install-daemon 效果：

  • macOS → 注册 launchd 服务，登录后自动启动

  • Windows → 注册任务计划程序，登录后自动启动

  • Linux → 注册 systemd 服务，开机自动启动

3.3 向导填写说明（三端通用）

步骤

选择

说明

安全声明

Yes

确认个人使用

Onboarding 模式

QuickStart

快速配置

Model provider

Anthropic

使用 Claude

Auth 方式

Anthropic token (setup-token)

绑定 Max 订阅，零额外费用

Default model

anthropic/claude-opus-4-6

Max 最强模型

频道

选 Telegram 或 Feishu

先配一个，后续可添加

Configure skills

No

后面手动批量安装

Install daemon

Restart

立即启动服务

3.4 获取 Anthropic setup-token

需要已安装 Claude Code CLI 并登录 Claude Max 账号。

安装 Claude Code：

# 三端通用
npm install -g @anthropic-ai/claude-code

生成 token：

# 三端通用
claude setup-token

首次使用需要先运行 claude 完成 OAuth 登录授权，再执行 claude setup-token。

输出 sk-ant-oat01-... 格式的 token，复制粘贴到向导中。

四、访问 Dashboard

OpenClaw 提供 Web Dashboard 查看频道状态、配置和日志。

获取访问 URL（含 token）：

# 三端通用
openclaw config get gateway.token

拼接访问地址：http://127.0.0.1:18789/#token=<your_token>

🍎 macOS / 🪟 Windows

直接在浏览器中打开上面的 URL。

🐧 Linux 服务器

服务器无桌面，在本地电脑的终端建立 SSH 隧道后访问：

# 本地电脑执行，将 192.168.x.x 换成你的服务器 IP
ssh -N -L 18789:127.0.0.1:18789 root@192.168.x.x

然后在本地浏览器打开 http://127.0.0.1:18789/#token=...

五、配置 Telegram 频道

5.1 创建 Telegram Bot

  1. 打开 Telegram，搜索 @BotFather

  2. 发送 /newbot，填写机器人名称和用户名（username 必须以 bot 结尾）

  3. 复制 Bot Token（格式：123456789:AAE...）

5.2 添加到 OpenClaw

openclaw configure --section channels

选 Configure/link → 选 Telegram → 粘贴 Bot Token。

5.3 私聊配对

首次 DM 机器人会收到配对码提示，在终端审批：

openclaw pairing approve telegram <配对码>

5.4 开放群组响应

openclaw config set channels.telegram.groupPolicy open
openclaw daemon restart

六、配置飞书频道

6.1 创建飞书企业自建应用

  1. 打开 飞书开放平台 → 开发者后台

  2. 点击创建企业自建应用，填写名称描述

  3. 凭证与基础信息 → 复制 App ID 和 App Secret

  4. 权限管理 → 开通：im:message、im:chat、contact:user.base:readonly

  5. 版本管理与发布 → 创建版本 → 申请上线

6.2 连接到 OpenClaw

openclaw configure --section channels

选 Configure/link → 选 Feishu/Lark → 依次填入：

  • App Secret / App ID

  • 连接模式：WebSocket（无需公网 IP，国内推荐）

  • 域名：feishu.cn（国内）或 larksuite.com（海外）

6.3 开放 DM 响应

openclaw config set channels.feishu.dmPolicy open
openclaw daemon restart

七、修复 tools profile（重要！）

⚠️ 这是 OpenClaw 2026.3.x 的已知 Bug：onboard 向导会将 tools.profile 错误设置为 messaging，导致 agent 无法读取文件、执行命令，USER.md 也读不到。

# 三端通用
openclaw config set tools.profile coding
openclaw daemon restart

修复后在 IM 中发送 /reset 重置会话。

coding profile 包含：文件读写、Shell 执行、进程管理等完整工具集。

八、配置 Workspace 个性化文件

Workspace 是 agent 读取记忆和上下文的目录。

路径：

系统

路径

macOS / Linux

~/.openclaw/workspace/

Windows

%USERPROFILE%\.openclaw\workspace\

8.1 USER.md（关于你）

🍎 macOS / 🐧 Linux

cat > ~/.openclaw/workspace/USER.md << 'EOF'
# About You

- **Name:** 你的名字
- **Timezone:** Asia/Shanghai (UTC+8)
- **Language:** 中文优先，技术术语可用英文

## 身份与工作
（填写职业、公司、产品）

## 当前重点
（填写近期主要目标）

## 回复偏好
- 简洁直接，不废话
- 技术问题直接给代码
- 重要决策给多方案对比
EOF

🪟 Windows（PowerShell）

$content = @"
# About You

- **Name:** 你的名字
- **Timezone:** Asia/Shanghai (UTC+8)
- **Language:** 中文优先，技术术语可用英文

## 身份与工作
（填写职业、公司、产品）

## 当前重点
（填写近期主要目标）

## 回复偏好
- 简洁直接，不废话
- 技术问题直接给代码
- 重要决策给多方案对比
"@

$content | Out-File "$env:USERPROFILE\.openclaw\workspace\USER.md" -Encoding UTF8

8.2 SOUL.md（工作语言偏好）

🍎 macOS / 🐧 Linux

cat >> ~/.openclaw/workspace/SOUL.md << 'EOF'

## 工作语言
默认用中文回复。技术命令、代码、专有名词保持英文。
EOF

🪟 Windows（PowerShell）

Add-Content "$env:USERPROFILE\.openclaw\workspace\SOUL.md" `
  "`n## 工作语言`n默认用中文回复。技术命令、代码、专有名词保持英文。" `
  -Encoding UTF8

修改完成后，IM 中发 /reset 重置会话生效。

九、安装 Skills

9.1 批量安装内置 Skills（52 个）

由于 clawhub.com 在国内访问不稳定，推荐直接从 npm 包目录复制。

🍎 macOS / 🐧 Linux

mkdir -p ~/.openclaw/workspace/skills
cp -r $(npm root -g)/openclaw/skills/* ~/.openclaw/workspace/skills/

# 验证数量
ls ~/.openclaw/workspace/skills/ | wc -l   # 应输出 52

🪟 Windows（PowerShell）

$dest = "$env:USERPROFILE\.openclaw\workspace\skills"
New-Item -ItemType Directory -Force -Path $dest

$src = "$(npm root -g)\openclaw\skills"
Copy-Item -Path "$src\*" -Destination $dest -Recurse -Force

# 验证数量
(Get-ChildItem $dest).Count   # 应输出 52

重启生效：

openclaw daemon restart

9.2 常用 Skills 说明

Skill

用途

平台支持

feishu-doc

飞书文档读写

全平台

feishu-drive

飞书云盘管理

全平台

feishu-wiki

飞书知识库

全平台

coding-agent

派发编程子任务给 Claude Code

全平台

summarize

总结网页 / 文档 / 视频

全平台

session-logs

查询历史会话

全平台

github

GitHub 仓库 / Issue / PR 操作

全平台

weather

天气查询

全平台

browser

浏览器自动化、截图、填表

macOS / Windows 专属

tmux

后台任务管理

macOS / Linux

healthcheck

系统安全检查

全平台

十、开启网页抓取

# 三端通用
openclaw config set tools.web.fetch.enabled true
openclaw daemon restart

无需 API key，agent 可直接抓取任意 URL 内容分析。

十一、安装 GitHub CLI（可选）

🍎 macOS

brew install gh && gh auth login

🪟 Windows

winget install GitHub.cli
gh auth login

🐧 Linux

apt install gh -y && gh auth login

登录选择 GitHub.com → HTTPS → Paste an authentication token，在 GitHub Settings → Tokens 生成 token（需 repo、read:org、workflow 权限）。

十二、服务管理

通用命令（三端一致）

openclaw gateway status              # 查看运行状态
openclaw daemon restart              # 重启
openclaw doctor                      # 健康检查
openclaw skills list                 # 查看已加载 skills
openclaw configure --section channels  # 管理频道
openclaw config get agents.defaults  # 查看默认配置

系统级服务管理

🍎 macOS（launchd）

# 查看服务状态（服务名见 openclaw doctor 输出）
launchctl list | grep openclaw

# OpenClaw 的 daemon 命令已封装好，通常直接用：
openclaw daemon restart
openclaw daemon stop
openclaw daemon start

🪟 Windows（任务计划程序）

# 查看任务
Get-ScheduledTask -TaskName "*openclaw*"

# 停止 / 启动
Stop-ScheduledTask  -TaskName "OpenClaw Gateway"
Start-ScheduledTask -TaskName "OpenClaw Gateway"

🐧 Linux（systemd）

systemctl --user status openclaw-gateway
systemctl --user restart openclaw-gateway
systemctl --user enable openclaw-gateway    # 开机自启
journalctl --user -u openclaw-gateway -f   # 实时日志

IM 内置命令

命令

作用

/reset 或 /new

重置当前会话上下文

/compact

压缩上下文节省 token

/status

查看会话状态

/think high

开启深度思考模式

/verbose on

显示详细执行过程

十三、各平台能力对比

能力

🍎 macOS

🪟 Windows

🐧 Linux

文件读写（本机）

✅

✅

✅

Shell 执行

✅ zsh/bash

✅ PowerShell

✅ bash

浏览器自动化

✅

✅

⚠️ 需 Xvfb

截图

✅

✅

❌

网页抓取

✅

✅

✅

开机自启

✅ launchd

✅ 任务计划

✅ systemd

稳定后台运行

⚠️ 需保持登录

⚠️ 需保持登录

✅ 最稳定

Dashboard 浏览器直访

✅

✅

⚠️ 需 SSH 隧道

💡 推荐组合：个人电脑（macOS/Windows）用于日常对话和浏览器自动化；Linux 服务器用于稳定后台任务。条件允许可两者都部署。

十四、常见问题

Q：agent 无法读取 USER.md，说文件不存在

tools.profile 是 messaging 模式，缺少文件系统工具：

openclaw config set tools.profile coding
openclaw daemon restart

IM 中发 /reset 重置会话。

Q：飞书 DM 没有反应

openclaw config set channels.feishu.dmPolicy open
openclaw daemon restart

Q：Windows 下找不到 openclaw 命令

确认安装时使用管理员 PowerShell，且 npm 全局路径在 PATH 中：

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

# 临时添加到 PATH
$env:PATH += ";$env:APPDATA\npm"

重启 PowerShell 后通常自动生效。

Q：macOS 安装脚本报权限错误

sudo chown -R $(whoami) $(npm root -g)
curl -fsSL https://openclaw.ai/install.sh | bash

Q：clawhub skills install 失败（网络超时）

直接从本地复制（见第九章），无需网络。

Q：重复插件警告（feishu duplicate）

可忽略，功能正常。npm 安装的版本优先级更高，自动覆盖内置版本。

Q：Linux 服务器代理设置后 npm 还是超时

Node.js 原生 fetch 不走系统代理，npm 需单独设置：

npm config set proxy http://127.0.0.1:7890
npm config set https-proxy http://127.0.0.1:7890

十五、架构说明

飞书 / Telegram / Discord / Slack / WhatsApp ...
                    │
                    ▼
      ┌─────────────────────────┐
      │    OpenClaw Gateway     │
      │    127.0.0.1:18789      │
      └────────────┬────────────┘
                   │
      ┌────────────▼────────────┐
      │    Claude Opus 4.6      │
      │  (Max 订阅，零额外费用)  │
      └────────────┬────────────┘
                   │
      ┌────────────▼────────────┐
      │         Tools           │
      │ 文件/Shell/浏览器/fetch │
      └────────────┬────────────┘
                   │
      ┌────────────▼────────────┐
      │      Skills (52+)       │
      │  飞书/GitHub/天气/总结  │
      └────────────┬────────────┘
                   │
            Workspace 记忆
        USER.md / SOUL.md / 历史

十六、后续扩展方向

  • 内存系统：配置 embedding provider 实现语义长期记忆

  • Heartbeat 定时任务：让 agent 主动每天推送日报和待办提醒

  • 更多频道：Discord、Slack、企业微信

  • 自定义 Skills：用 skill-creator 开发专属业务技能

  • coding-agent：接入 Claude Code，实现后台自动编程任务

  • MCP 集成：通过 MCP 协议接入数据库、ERP 等内部系统

  • 浏览器自动化：Mac/Windows 上让 agent 自动操作网页、填写表单、截图存档

参考资源

  • 官方仓库：https://github.com/openclaw/openclaw

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

  • Skills 市场：https://clawhub.com

  • 飞书开放平台：https://open.feishu.cn

  • Clash Verge Rev：https://github.com/clash-verge-rev/clash-verge-rev

本文基于 OpenClaw 2026.3.2 验证，覆盖 macOS（Apple Silicon）、Windows 11、Debian 13 三个平台。

许可协议: 
分享

相关文章

下一篇

上一篇

Debian 13 虚拟机安装与配置完全指南（Parallels / VMware 双平台）

最近更新

  • OpenClaw 完整安装与使用指南：零成本打造全能 AI 助理
  • Debian 13 虚拟机安装与配置完全指南（Parallels / VMware 双平台）
  • Claude Code Agent Teams：多智能体协作编程的完全指南
  • 2025年度好用AI大分享：从文本到视频的全场景工具指南
  • MySQL ：如何选择 utf8mb4 排序规则（Collation）

热门标签

MCP 并发编程 通义千问 代码审查 版本对比 数字人 开发效率 DevOps 结构化并发 永久投资组合

目录

©2026 范伟彬个人网. 保留部分权利。

使用 Halo 主题 Chirpy