根据你的操作系统选择对应的安装方式：

1. 访问 https://nodejs.org/
2. 下载 v22.14.0 LTS 或更高版本
3. 运行安装程序，一路点击 Next
4. 打开 PowerShell，验证安装：

node -v

预期输出: v22.14.0

npm -v

预期输出: 10.9.2

讯享网npm config set registry https://registry.npmmirror.com

# 安装最新版本

npm install -g openclaw@latest

验证安装

openclaw –version

预期输出: 2026.2.6 或更高版本

讯享网# 运行引导向导

openclaw onboard

或运行诊断修复

openclaw doctor –fix

openclaw config set gateway.mode local openclaw config set gateway.port 18789 openclaw config set gateway.bind loopback

讯享网openclaw gateway start

配置文件位置： C:\Users<用户名>.openclaw\openclaw.json

/bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

讯享网# 使用 Homebrew 安装 Node.js brew install node@22

添加到 PATH

echo ‘export PATH=”/opt/homebrew/opt/node@22/bin:$PATH“’ >> ~/.zshrc source ~/.zshrc

验证版本

node -v

预期输出: v22.14.0

npm -v

预期输出: 10.9.2

或者使用 nvm：

# 安装 nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

重新加载 shell

source ~/.zshrc

安装 Node.js 22

nvm install 22 nvm use 22

验证版本

node -v

预期输出: v22.14.0

讯享网npm config set registry https://registry.npmmirror.com

# 安装最新版本

npm install -g openclaw@latest

验证安装

openclaw –version

预期输出: 2026.2.6 或更高版本

讯享网# 运行引导向导

openclaw onboard

或运行诊断修复

openclaw doctor –fix

openclaw config set gateway.mode local openclaw config set gateway.port 18789 openclaw config set gateway.bind loopback

讯享网# 方式一：使用 .env 文件 echo ”ONEAPI_API_KEY=<your-api-key>“ >> ~/.openclaw/.env

方式二：添加到 shell 配置

echo ‘export ONEAPI_API_KEY=”<your-api-key>“’ >> ~/.zshrc source /.zshrc

openclaw gateway start

讯享网# 添加 NodeSource 仓库 curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -

安装 Node.js

sudo apt-get install -y nodejs

验证版本

node -v

预期输出: v24.0.0

npm -v

预期输出: 11.0.0

npm config set registry https://registry.npmmirror.com

讯享网# 安装最新版本

sudo npm install -g openclaw@latest

验证安装

openclaw –version

预期输出: 2026.2.6 或更高版本

# 运行引导向导

openclaw onboard

或运行诊断修复

openclaw doctor –fix

讯享网openclaw config set gateway.mode local openclaw config set gateway.port 18789 openclaw config set gateway.bind loopback

# 创建 systemd override 目录 mkdir -p ~/.config/systemd/user/openclaw-gateway.service.d

添加环境变量（替换为你的 API 密钥）

cat > ~/.config/systemd/user/openclaw-gateway.service.d/env.conf << ‘EOF’ [Service] Environment=ONEAPI_API_KEY=你的API密钥 EOF

重新加载 systemd

systemctl –user daemon-reload

讯享网openclaw gateway start

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

Ubuntu/Debian：

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

CentOS/RHEL/Fedora：

讯享网curl -fsSL https://rpm.nodesource.com/setup_24.x | sudo bash - sudo yum install -y nodejs

Arch Linux：

sudo pacman -S nodejs npm

验证安装：

讯享网node -v # 应显示 v22.x.x 或更高 npm -v # 应显示 npm 版本

npm config set registry https://registry.npmmirror.com

讯享网# 安装最新版本 sudo npm install -g openclaw@latest

验证安装

openclaw –version

预期输出: 2026.2.6 或更高版本

# 运行引导向导

openclaw onboard

或运行诊断修复

openclaw doctor –fix

讯享网openclaw config set gateway.mode local openclaw config set gateway.port 18789 openclaw config set gateway.bind loopback

方式一：使用 .env 文件

echo ”ONEAPI_API_KEY=你的API密钥“ >> ~/.openclaw/.env

方式二：使用 systemd（推荐用于服务器）

讯享网mkdir -p ~/.config/systemd/user/openclaw-gateway.service.d

cat > ~/.config/systemd/user/openclaw-gateway.service.d/env.conf << ‘EOF’ [Service] Environment=ONEAPI_API_KEY=你的API密钥 EOF

systemctl –user daemon-reload

openclaw gateway start

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

所有系统通用：

讯享网# 检查健康状态 openclaw health

查看可用模型

openclaw models list

查看渠道状态

openclaw channels status

Windows：

notepad C:\Users\%USERNAME%.openclaw\openclaw.json

WSL2/Linux：

讯享网nano ~/.openclaw/openclaw.json

{ ”meta“: {

讯享网"lastTouchedVersion": "2026.2.6", "lastTouchedAt": "2026-02-09T10:00:00.000Z" 

}, ”wizard“: {

"lastRunAt": "2026-02-09T10:00:00.000Z", "lastRunVersion": "2026.2.6", "lastRunCommand": "onboard", "lastRunMode": "local" 

}, ”agents“: {

讯享网"defaults": { "model": { "primary": "oneapi/gpt-4o" }, "models": { "oneapi/gpt-4o": {} }, "workspace": "~/.openclaw/workspace", "compaction": { "mode": "safeguard" }, "timeoutSeconds": 120, "maxConcurrent": 4, "subagents": { "maxConcurrent": 8 } } 

}, ”models“: {

"mode": "merge", "providers": { "oneapi": { "baseUrl": "http://your-oneapi-server/v1", "apiKey": "<your-api-key>", "api": "openai-completions", "models": [ {"id": "gpt-4o", "name": "GPT-4o"}, {"id": "claude-sonnet-4.5", "name": "Claude Sonnet 4.5"}, {"id": "gpt-4o-mini", "name": "GPT-4o Mini"} ] } } 

}, ”messages“: {

讯享网"ackReactionScope": "group-mentions" 

}, ”commands“: {

"native": "auto", "nativeSkills": "auto" 

}, ”gateway“: {

讯享网"port": 18789, "mode": "local", "bind": "loopback", "auth": { "mode": "token", "token": "<your-gateway-token>" }, "tailscale": { "mode": "off", "resetOnExit": false } 

}, ”tools“: {

"web": { "fetch": { "enabled": true } } 

}, ”browser“: {

讯享网"enabled": true, "defaultProfile": "openclaw", "headless": false, "color": "#FF4500", "profiles": { "openclaw": { "cdpPort": 18800, "color": "#FF4500" } } 

} }

重要： models 数组使用简洁格式 {”id“: ”xxx“, ”name“: ”xxx“}，不要添加额外字段。

Windows：

openclaw gateway stop openclaw gateway start

WSL2/Linux：

讯享网openclaw gateway stop openclaw gateway start

openclaw tui

讯享网# 生成 token openclaw config set gateway.auth.mode token openclaw config set gateway.auth.token $(head -c 24 /dev/urandom | xxd -p)

查看 token

cat ~/.openclaw/openclaw.json | grep token

重启 gateway

openclaw gateway stop openclaw gateway start

hostname -I | awk ‘{print $1}’

讯享网http://<WSL_IP>:18789/?token=你的token

例如：http://172.30.2.22:18789/?token=d06e4c8d54afe4d4c8e64879e586c842c057c664bf6f6b2e

或者：

1. 访问 http://<WSL_IP>:18789/
2. 在 Gateway Token 输入框中粘贴 token
3. 点击 Connect

注意：WSL2 的 IP 地址可能会变化，每次重启后需要重新获取。也可以使用 127.0.0.1:18789，WSL2 会自动转发到 Windows。

# 切换到 GPT-4o openclaw models set oneapi/gpt-4o

切换到 Claude

openclaw models set oneapi/claude-sonnet-4.5

1. 打开 Telegram，搜索 @BotFather
2. 发送 /newbot，按提示创建 bot
3. 复制 Bot Token（格式：:ABC-xxx）

在 ~/.openclaw/openclaw.json 中添加：

讯享网{ ”channels“: {

"telegram": { "enabled": true, "dmPolicy": "pairing", "botToken": "你的Bot Token", "groupPolicy": "open", "streamMode": "partial", "groups": { "*": { "requireMention": false } } } 

}, ”plugins“: {

讯享网"entries": { "telegram": { "enabled": true } } 

} }

首次私聊 bot 时会返回配对提示：

OpenClaw: access not configured. Your Telegram user id:  Pairing code: XXXXXXXX

运行批准命令：

讯享网openclaw pairing approve telegram <配对码>

重要：在 BotFather 中关闭 Privacy Mode（ /mybots → Bot Settings → Group Privacy → Disable），否则 bot 只能看到 @提及 的消息。

# 安装飞书插件 openclaw plugins install @openclaw/feishu

添加飞书渠道

openclaw channels add

选择 Feishu，输入 App ID 和 App Secret

配置示例：

讯享网{

”channels“: {

"feishu": { "enabled": true, "dmPolicy": "pairing", "accounts": { "main": { "appId": "cli_xxx", "appSecret": "xxx", "botName": "AI 助手" } } } 

} }

详细文档：https://docs.openclaw.ai/channels/feishu

钉钉通过社区插件 clawdbot-channel-dingtalk 支持，使用 Stream 模式（无需公网 IP）。

讯享网# 方法 A：通过远程仓库安装（推荐） openclaw plugins install https://github.com/soimy/clawdbot-channel-dingtalk.git

方法 B：本地安装（Windows 如果远程安装失败）

git clone https://github.com/soimy/clawdbot-channel-dingtalk.git dingtalk-plugin cd dingtalk-plugin npm install openclaw plugins install -l .

1. 访问 钉钉开放平台
2. 点击「创建应用」，填写应用名称和描述
3. 在左侧导航栏点击「添加应用能力」，添加「机器人」
4. 重要：消息接收模式选择 Stream 模式
5. 在「权限管理」中开启以下权限：

• qyapi_robot_sendmsg — 发送机器人消息
• Card.Instance.Write — 创建和投放卡片实例（可选，用于互动卡片）
• Card.Streaming.Write — 对卡片进行流式更新（可选）

1. 点击「版本管理与发布」，创建并发布新版本
2. 等待管理员审批（如果需要）

在「凭证与基础信息」页面获取：

• Client ID (AppKey)：如 dingxxxxxx
• Client Secret (AppSecret)：如 xxxxxxxx
• Robot Code：与 Client ID 相同
• Agent ID：应用 ID，如
• Corp ID：企业 ID（可选）

在 ~/.openclaw/openclaw.json 中添加：

{ ”channels“: {

讯享网"dingtalk": { "enabled": true, "clientId": "dingxxxxxx", "clientSecret": "your-app-secret", "robotCode": "dingxxxxxx", "agentId": "", "dmPolicy": "open", "groupPolicy": "open", "messageType": "markdown" } 

}, ”plugins“: {

"entries": { "dingtalk": { "enabled": true } } 

} }

或使用命令行配置：

讯享网openclaw config set channels.dingtalk.enabled true openclaw config set channels.dingtalk.clientId ”你的 Client ID“ openclaw config set channels.dingtalk.clientSecret ”你的 Client Secret“ openclaw config set channels.dingtalk.robotCode ”你的 Robot Code“ openclaw config set channels.dingtalk.agentId ”你的 Agent ID“ openclaw config set channels.dingtalk.dmPolicy open openclaw config set channels.dingtalk.groupPolicy open openclaw config set channels.dingtalk.messageType markdown

openclaw gateway stop openclaw gateway start

启动后应看到日志：

讯享网[dingtalk] [default] DingTalk Stream client connected successfully

在钉钉中找到你的机器人，发送消息测试。

Q: 插件安装失败 spawn EINVAL

Windows 上可能出现此错误，使用本地安装方式：

git clone https://github.com/soimy/clawdbot-channel-dingtalk.git dingtalk-plugin cd dingtalk-plugin npm install openclaw plugins install -l .

Q: 连接成功但消息处理出错

1. 检查是否有多个进程在监听钉钉消息（如之前的桥接脚本）
2. 停止所有相关进程，只保留 Gateway

Q: 应用需要审批

企业内部应用需要管理员审批，联系你的钉钉管理员。

Q: 权限不足

确保在钉钉开放平台开启了 qyapi_robot_sendmsg 权限。

详细文档：https://github.com/soimy/clawdbot-channel-dingtalk

企业微信有官方开放平台 API，可以参考钉钉插件开发：

配置 Brave Search API：

讯享网{ ”tools“: {

"web": { "search": { "enabled": true, "apiKey": "你的 Brave API Key" } } 

} }

获取 API Key：https://brave.com/search/api/

讯享网# 安装 Playwright npx playwright install chromium

配置：

{ ”browser“: {

讯享网"enabled": true, "defaultProfile": "openclaw", "headless": false, "color": "#FF4500", "profiles": { "openclaw": { "cdpPort": 18800, "color": "#FF4500" } } 

} }

{ ”gateway“: {

讯享网"bind": "0.0.0.0", "auth": { "mode": "token", "token": "你的安全token" } 

} }

安全提醒：远程访问时务必设置强密码 token。

OpenClaw 内置了多个桌面自动化 Skills，可以通过自然语言控制电脑。

openclaw skills list

在 Web Dashboard 或 Telegram 中发送：

列出窗口：

讯享网列出当前所有打开的窗口

截图：

截图保存到桌面

激活窗口：

讯享网激活微信窗口

发送快捷键：

发送 Ctrl+S 保存当前文件

最小化窗口：

讯享网最小化 Chrome 窗口

用 Playwright 打开百度，搜索 OpenClaw，然后截图

通过桌面自动化，可以让 OpenClaw 控制 IDE 完成开发任务：

讯享网激活 Windsurf 窗口，然后让它写一个用户登录功能 切换到 VS Code，打开终端执行 npm test

原理：OpenClaw 通过 windows-control skill 激活 IDE 窗口，然后发送键盘输入与 IDE 内置的 AI 助手交互。

列出连接的 Android 设备 在 Android 设备上截图

1. Windows 用户：windows-control 和 uiautomation 开箱即用
2. PowerShell 版本：Windows ¹⁰⁄₁₁ 自带的 PowerShell 5.x 不支持 && 操作符，AI 会自动使用 ; 替代
3. 权限问题：某些操作可能需要管理员权限
4. 编码问题：已修复中文 Windows 的 UTF-8 编码问题

讯享网# PyAutoGUI（跨平台桌面控制） pip install pyautogui pillow

Tesseract OCR（屏幕文字识别）

Windows:

choco install tesseract

macOS:

brew install tesseract

Android ADB

Windows:

scoop install adb

macOS:

brew install android-platform-tools

OpenClaw 内置了多个业务场景 Skills，帮助销售、运营、HR 等岗位提高效率。

帮我写一封跟进邮件给张总，上周讨论了 ERP 系统方案，他对价格有顾虑 客户说”太贵了“，帮我生成 3 种回应话术 生成一份报价单，产品是企业版 SaaS，50 用户，单价 1000 元

讯享网策划一个双 11 促销活动，预算 5 万，目标提升 GMV 20% 为我们的新产品写 5 条朋友圈文案 分析这组转化数据：曝光 10000，点击 500，下单 30

为”如何提高工作效率“写一篇公众号文章大纲 写一个 60 秒的短视频脚本，推广我们的 App 为”未来城市“生成 Midjourney 提示词

讯享网为产品经理岗位撰写 JD 生成 10 个产品经理面试问题 帮这位员工写绩效评语，完成率 120%，表现优秀

把这个项目分解成可执行的任务，时间 2 个月 整理今天的会议纪要，提取行动项 识别这个项目的潜在风险

讯享网帮我写一个 SQL 查询最近 30 天的销售数据，按产品分组 分析这份 Excel 数据，找出销售额 Top 10 的客户 生成本周运营数据周报

# 检查 gateway 是否运行 openclaw health

重启 gateway

openclaw gateway stop openclaw gateway start

检查日志

journalctl –user -u openclaw-gateway.service -n 50 –no-pager

确保环境变量已添加到 systemd service：

讯享网cat ~/.config/systemd/user/openclaw-gateway.service.d/env.conf

应包含：

[Service] Environment=ONEAPI_APIKEY=你的API密钥

讯享网openclaw doctor –fix

原因：有多个 bot 实例使用同一个 Bot Token。

解决方案：

1. 关闭所有 node 进程
2. 确保只有一个 Gateway 实例运行
3. 检查其他服务器是否有运行中的 bot

“models”: [ { 
讯享网"id": "gpt-4o", "name": "GPT-4o", "reasoning": false, "input": ["text"], "cost": {"input": 0, "output": 0}, "contextWindow": , "maxTokens": 8192 
 } ]

正确配置（简洁格式）：

“models”: [ {“id”: “gpt-4o”, “name”: “GPT-4o”}, {“id”: “claude-sonnet-4.5”, “name”: “Claude Sonnet 4.5”} ]

OpenClaw 是一个 自托管的 AI 消息网关，让你通过日常聊天工具（WhatsApp/Telegram/钉钉/Discord 等）随时随地访问 AI 助手。

讯享网桌面控制 | desktop-control, windows-control, macos-automation 编程开发 | coding-agent, github, playwright-browser 财务助手 | finance-assistant (报销/预算/发票) 客服助手 | customer-service (智能回复/工单/情绪分析) 数据分析 | data-analysis 内容创作 | content-creator 会议助手 | meeting-assistant 邮件助手 | email-assistant 项目管理 | project-manager, trello, notion 销售助手 | sales-assistant HR 助手 | hr-assistant 法务助手 | legal-assistant 电商运营 | ecommerce-ops 营销运营 | marketing-ops 天气查询 | weather 图片生成 | openai-image-gen 语音转写 | openai-whisper, openai-whisper-api 笔记同步 | obsidian, notion, apple-notes, bear-notes 智能家居 | openhue, sonoscli …更多见 skills/ 目录

1. 简单任务优先 — 信息查询、定时提醒、群发消息
2. 复杂任务拆分 — 不要一次性让 AI 完成太多步骤
3. 善用 Skills — 安装对应 Skill 提升成功率
4. 设置合理超时 — agents.defaults.timeoutSeconds 根据任务复杂度调整
5. 移动端为主 — 手机随时发消息是最大价值

• 需要实时交互的复杂编程 → 用 IDE 插件（Cursor/Copilot）
• 需要精确 UI 操作 → 用专业 RPA 工具
• 简单问答 → 直接用 ChatGPT/Claude 网页版

OpenClaw 的核心价值是 “随时随地通过聊天工具访问 AI”，而不是替代专业工具。
把它当成一个 7x24 小时在线的 AI 助手，通过微信/钉钉/Telegram 随时召唤，处理信息查询、定时任务、简单自动化，这才是它的甜蜜点。

现象：

• Telegram 发送消息后，AI 无响应
• Web Dashboard 聊天也可能出现类似问题
• 但命令行测试正常

原因：疑似 OpenClaw bug，Gateway 成功调用 API 后，无法正确将响应发送回渠道。

临时解决方案：使用命令行方式（稳定可用）：

openclaw agent –agent main –message “你的消息” –local

现象：运行 openclaw config set 或 openclaw doctor –fix 后，API 调用开始失败。

原因：OpenClaw 会自动将 models 数组扩展为复杂格式，导致 API 调用失败。

解决方法：

1. 备份简洁配置
2. 避免使用 openclaw config set 命令
3. 直接编辑配置文件

以下功能已在 Windows 环境下测试通过：

• 官方文档：https://docs.openclaw.ai
• Model Providers：https://docs.openclaw.ai/concepts/model-providers
• CLI 参考：https://docs.openclaw.ai/cli
• Exec 工具：https://docs.openclaw.ai/tools/exec
• Browser 工具：https://docs.openclaw.ai/tools/browser