Moltbot/OpenClaw 本地部署完整教程

worxfr

423人浏览 · 2026-03-10 08:45:00

worxfr · 2026-03-10 08:45:00 发布

一、部署前准备

1.1 硬件要求

配置项	最低要求	推荐配置
CPU	4核	8核+
内存	8GB	16GB+（跑本地模型需要更多）
硬盘	20GB 可用空间	SSD 50GB+
网络	稳定的互联网连接	—

1.2 支持的操作系统

系统	支持情况	备注
macOS	✅ 最佳	Mac Mini M芯片跑本地模型很香
Linux	✅ 完全支持	Ubuntu/Debian 推荐
Windows	✅ 支持	需要使用 WSL2

二、环境准备

2.1 安装 Node.js（要求 v22+）

这是关键一步，Moltbot 要求 Node.js v22 或更高版本。

macOS / Linux

# 方法1：使用 nvm（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 重新加载终端配置
source ~/.bashrc   # 或 source ~/.zshrc

# 安装 Node.js 22
nvm install 22
nvm use 22

# 验证版本
node -v   # 应显示 v22.x.x

Windows（使用 nvm-windows）

# 1. 先下载安装 nvm-windows
# 访问：https://github.com/coreybutler/nvm-windows/releases

# 2. 安装 Node.js 22
nvm install 22.22.0
nvm use 22.22.0

# 3. 验证
node -v

示例输出：

D:\clawdbot>nvm install 22.22.0
Downloading node.js version 22.22.0 (64-bit)...

2.2 获取 API 密钥

你需要选择一个大语言模型提供商，准备好 API Key：

提供商	获取地址	免费额度	备注
Anthropic Claude	console.anthropic.com	$5 新用户	推荐，效果最好
OpenAI	platform.openai.com	$5 新用户	常用
Google Gemini	aistudio.google.com	免费层可用	性价比高
DeepSeek	platform.deepseek.com	新用户赠送	国内可直连
本地模型	Ollama / LM Studio	完全免费	无需API

获取 Anthropic API Key（详细步骤）

访问 console.anthropic.com
注册/登录账号
点击左侧菜单 API Keys
点击 Create Key
复制生成的密钥（以 sk-ant- 开头）

示例格式：sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

获取 OpenAI API Key（详细步骤）

访问 platform.openai.com
登录后点击右上角头像 → View API Keys
点击 Create new secret key
复制密钥（以 sk- 开头）

示例格式：sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

获取 Google Gemini API Key

访问 aistudio.google.com
点击 Get API Key
创建或选择 Google Cloud 项目
复制生成的密钥

示例格式：AIzaSyxxxxxxxxxxxxxxxxxxxxxxxxx

获取 DeepSeek API Key（国内推荐）

访问 platform.deepseek.com
注册登录
进入 API Keys 页面
创建并复制密钥

示例格式：sk-xxxxxxxxxxxxxxxxxxxxxxxx

三、安装 Moltbot/OpenClaw

3.1 一键安装脚本

# 官方安装脚本
curl -fsSL https://clawd.bot/install.sh | bash

# 重新加载 shell
exec bash

3.2 或者通过 npm 安装

npm install -g clawdbot

安装过程中可能看到一些警告，属于正常现象：

npm warn deprecated npmlog@6.0.2: This package is no longer supported.

3.3 验证安装

clawdbot --version
# 或
openclaw --version

四、配置 API Key

4.1 方式一：通过配置向导（推荐新手）

clawdbot onboard

向导会交互式引导你输入 API Key：

? Select LLM provider:
  > Anthropic (Claude)
    OpenAI (GPT)
    Google (Gemini)
    Local Model (Ollama)

? Enter your Anthropic API Key:
  > sk-ant-api03-xxxxxx（输入时不显示）

✓ API Key validated successfully!

4.2 方式二：通过环境变量配置

在终端中设置环境变量：

# Anthropic Claude
export ANTHROPIC_API_KEY="sk-ant-api03-your-key-here"

# OpenAI
export OPENAI_API_KEY="sk-proj-your-key-here"

# Google Gemini
export GOOGLE_API_KEY="AIzaSy-your-key-here"

# DeepSeek
export DEEPSEEK_API_KEY="sk-your-key-here"

永久生效（写入配置文件）：

# macOS / Linux (zsh)
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"' >> ~/.zshrc
source ~/.zshrc

# macOS / Linux (bash)
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"' >> ~/.bashrc
source ~/.bashrc

# Windows PowerShell
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-api03-xxxxx", "User")

4.3 方式三：通过配置文件

编辑配置文件 ~/.config/clawdbot/config.yaml：

# ~/.config/clawdbot/config.yaml

llm:
  provider: anthropic  # 可选: anthropic, openai, google, ollama
  api_key: sk-ant-api03-your-key-here
  model: claude-sonnet-4-20250514  # 指定模型
  
  # 或者使用 OpenAI
  # provider: openai
  # api_key: sk-proj-your-key-here
  # model: gpt-4o
  
  # 或者使用本地模型
  # provider: ollama
  # endpoint: http://localhost:11434
  # model: llama3

workspace: ~/moltbot-workspace

# 可选：自定义 API 端点（用于代理或私有部署）
# api_base: https://your-proxy.com/v1

4.4 方式四：使用 .env 文件

在工作目录创建 .env 文件：

# .env 文件
ANTHROPIC_API_KEY=sk-ant-api03-xxxxx
OPENAI_API_KEY=sk-proj-xxxxx
GOOGLE_API_KEY=AIzaSy-xxxxx

# 可选配置
LLM_PROVIDER=anthropic
LLM_MODEL=claude-sonnet-4-20250514

4.5 验证 API Key 是否生效

# 测试连接
clawdbot test-connection

# 或直接启动看是否报错
clawdbot gateway start

成功输出：

✓ Connected to Anthropic API
✓ Model: claude-sonnet-4-20250514
✓ Gateway ready on port 18789

五、启动与运行

5.1 运行配置向导

clawdbot onboard

配置向导会引导你完成以下步骤：

步骤 1：选择大语言模型

? Select LLM provider:
  > Anthropic (Claude)
    OpenAI (GPT)
    Google (Gemini)
    Local Model (Ollama)

步骤 2：设置工作空间

? Enter workspace directory:
  > ~/moltbot-workspace

步骤 3：选择聊天渠道

? Select channel (QuickStart):
  > Telegram (Bot API)
    WhatsApp (QR link)
    Discord (Bot API)
    Slack (Socket Mode)
    Skip for now

步骤 4：选择包管理器

? Select package manager for skills:
  > npm
    yarn
    pnpm

5.2 启动网关服务

方式一：前台运行（测试用）

clawdbot gateway start

方式二：后台守护进程（推荐长期使用）

clawdbot onboard --install-daemon

这会将 Moltbot 配置为 systemd 服务，实现开机自启。

六、常见命令速查表

6.1 核心命令

命令	说明	示例
`clawdbot onboard`	运行配置向导	首次安装必用
`clawdbot gateway start`	启动网关服务	前台运行
`clawdbot gateway stop`	停止网关服务	—
`clawdbot gateway restart`	重启网关服务	修改配置后使用
`clawdbot gateway status`	查看运行状态	检查是否正常

6.2 渠道管理命令

命令	说明
`clawdbot channels add`	添加新的聊天渠道
`clawdbot channels list`	列出所有已连接渠道
`clawdbot channels remove <name>`	移除指定渠道
`clawdbot channels reconnect <name>`	重新连接指定渠道

6.3 技能管理命令

命令	说明
`clawdbot skills list`	列出所有可用技能
`clawdbot skills enable <name>`	启用指定技能
`clawdbot skills disable <name>`	禁用指定技能
`clawdbot skills install <package>`	安装第三方技能包

6.4 配置管理命令

命令	说明
`clawdbot config show`	显示当前配置
`clawdbot config set <key> <value>`	设置配置项
`clawdbot config reset`	重置为默认配置
`clawdbot test-connection`	测试 API 连接

6.5 日志与调试命令

命令	说明
`clawdbot logs`	查看实时日志
`clawdbot logs --tail 100`	查看最近100行日志
`clawdbot debug`	以调试模式启动
`clawdbot doctor`	诊断常见问题

6.6 其他实用命令

命令	说明
`clawdbot --version`	查看版本号
`clawdbot --help`	查看帮助信息
`clawdbot update`	更新到最新版本
`clawdbot uninstall`	卸载 Moltbot

6.7 聊天中的斜杠命令

在连接的聊天应用中，可以使用以下命令：

命令	说明
`/help`	显示帮助信息
`/skills`	列出所有技能
`/model`	查看/切换当前模型
`/clear`	清除对话历史
`/status`	查看机器人状态
`/config`	查看当前配置

七、连接聊天渠道

7.1 连接 WhatsApp

WhatsApp 是最常用的渠道之一：

clawdbot channels add
# 选择 WhatsApp (QR link)

系统会在终端显示二维码，用手机 WhatsApp 扫码：

打开 WhatsApp → 设置 → 已链接设备
点击 链接设备 → 扫描终端二维码

7.2 连接 Telegram

clawdbot channels add
# 选择 Telegram (Bot API)
# 输入你的 Bot Token（从 @BotFather 获取）

获取 Telegram Bot Token：

在 Telegram 搜索 @BotFather
发送 /newbot
按提示设置名称
复制获得的 Token

7.3 连接 Discord

clawdbot channels add
# 选择 Discord (Bot API)
# 输入你的 Discord Bot Token

八、使用本地模型（完全免费）

如果你不想付费使用 API，可以配置本地 LLM。

8.1 安装 Ollama

# macOS / Linux
curl -fsSL https://ollama.com/install.sh | sh

# 下载模型
ollama pull llama3        # 8B 参数，推荐
ollama pull qwen2.5:7b    # 中文优化
ollama pull deepseek-r1   # 推理能力强

8.2 在 Moltbot 中配置

clawdbot onboard

? Select LLM provider:
  > Local Model (Ollama)

? Enter Ollama endpoint:
  > http://localhost:11434

? Select model:
  > llama3

或者直接修改配置文件：

# ~/.config/clawdbot/config.yaml
llm:
  provider: ollama
  endpoint: http://localhost:11434
  model: llama3

九、访问 Web 控制面板

Moltbot 提供了网页控制面板：

# 直接访问（仅本机）
http://127.0.0.1:18789

如果是远程服务器，需要建立 SSH 隧道：

# 本地执行
ssh -L 18789:127.0.0.1:18789 用户名@服务器IP

# 然后访问
http://127.0.0.1:18789

十、自定义 Skill（进阶）

10.1 创建技能文件

在工作空间目录下创建 skills/my-skill.ts：

// skills/my-file-search.ts
export default {
  name: "my-file-search",
  description: "搜索本地文件",
  
  async execute(query: string) {
    // 你的逻辑代码
    return `搜索结果: ${query}`;
  }
}

10.2 加载技能

重启网关后，新技能会自动加载：

clawdbot gateway restart

十一、常见问题排查

Q1：API Key 无效怎么办？

# 检查环境变量是否设置
echo $ANTHROPIC_API_KEY

# 重新配置
clawdbot config set llm.api_key "your-new-key"

# 测试连接
clawdbot test-connection

Q2：Node.js 版本不对怎么办？

# 使用 nvm 切换版本
nvm install 22
nvm use 22
node -v  # 确认版本

Q3：扫码后 WhatsApp 连不上？

# 检查状态
clawdbot channels list

# 重新连接
clawdbot channels reconnect whatsapp

# 查看日志
clawdbot logs

Q4：如何让 Moltbot 7×24 小时运行？

方法一：使用守护进程

clawdbot onboard --install-daemon

方法二：使用 screen/tmux

screen -S moltbot
clawdbot gateway start
# 按 Ctrl+A+D 退出

方法三：使用 PM2

npm install -g pm2
pm2 start "clawdbot gateway start" --name moltbot
pm2 save
pm2 startup

Q5：如何切换不同的 AI 模型？

# 命令行切换
clawdbot config set llm.provider openai
clawdbot config set llm.model gpt-4o
clawdbot gateway restart

# 或在聊天中
/model gpt-4o

Q6：遇到报错怎么诊断？

# 运行诊断工具
clawdbot doctor

# 查看详细日志
clawdbot logs --tail 200

# 以调试模式启动
clawdbot debug

十二、安全提醒

风险	建议
API Key 泄露	不要将 Key 提交到 Git，使用 `.env` 文件
端口暴露	不要将 18789 端口暴露到公网
权限过大	限制 Moltbot 可访问的文件目录
消息来源	启用白名单，只允许信任的账号发指令

十三、总结

完整流程回顾

1. 安装 Node.js v22+
       ↓
2. 获取 API Key（Anthropic/OpenAI/本地模型）
       ↓
3. 安装 Moltbot：curl -fsSL https://clawd.bot/install.sh | bash
       ↓
4. 运行配置：clawdbot onboard
       ↓
5. 配置 API Key → 设置工作空间 → 连接聊天渠道
       ↓
6. 启动网关：clawdbot gateway start
       ↓
7. 开始对话！

场景	LLM 选择	部署方式
轻度使用	Claude API	本地电脑
省钱方案	Ollama 本地模型	本地电脑
重度使用	Claude API + 本地备用	Mac Mini
追求稳定	云端 API	云服务器

所有评论(0)

查看更多评论

worxfr

@sinat_41883985

已为社区贡献4条内容

Moltbot/OpenClaw 本地部署完整教程

worxfr

一、部署前准备

1.1 硬件要求

1.2 支持的操作系统

二、环境准备

2.1 安装 Node.js（要求 v22+）

macOS / Linux

Windows（使用 nvm-windows）

2.2 获取 API 密钥

获取 Anthropic API Key（详细步骤）

获取 OpenAI API Key（详细步骤）

获取 Google Gemini API Key

获取 DeepSeek API Key（国内推荐）

三、安装 Moltbot/OpenClaw

3.1 一键安装脚本

3.2 或者通过 npm 安装

3.3 验证安装

四、配置 API Key

4.1 方式一：通过配置向导（推荐新手）

4.2 方式二：通过环境变量配置

4.3 方式三：通过配置文件

4.4 方式四：使用 .env 文件

4.5 验证 API Key 是否生效

五、启动与运行

5.1 运行配置向导

步骤 1：选择大语言模型

步骤 2：设置工作空间

步骤 3：选择聊天渠道

步骤 4：选择包管理器

5.2 启动网关服务

方式一：前台运行（测试用）

方式二：后台守护进程（推荐长期使用）

六、常见命令速查表

6.1 核心命令

6.2 渠道管理命令

6.3 技能管理命令

6.4 配置管理命令

6.5 日志与调试命令

6.6 其他实用命令

6.7 聊天中的斜杠命令

七、连接聊天渠道

7.1 连接 WhatsApp

7.2 连接 Telegram

7.3 连接 Discord

八、使用本地模型（完全免费）

8.1 安装 Ollama

8.2 在 Moltbot 中配置

九、访问 Web 控制面板

十、自定义 Skill（进阶）

10.1 创建技能文件

10.2 加载技能

十一、常见问题排查

Q1：API Key 无效怎么办？

Q2：Node.js 版本不对怎么办？

Q3：扫码后 WhatsApp 连不上？

Q4：如何让 Moltbot 7×24 小时运行？

Q5：如何切换不同的 AI 模型？

Q6：遇到报错怎么诊断？

十二、安全提醒

十三、总结

完整流程回顾

推荐配置方案

所有评论(0)

温馨提示：您尚未绑定手机号

worxfr