OpenClaw 本地安装完整教程

一、OpenClaw介绍

OpenClaw 是一个强大的本地 AI Agent 框架，可以通过 Telegram 等聊天工具远程控制你的电脑，并让 AI 自动执行任务。

例如：

• 自动写代码
• 自动搜索资料
• 执行系统命令
• 自动化办公任务

本教程将从零开始教你如何安装 OpenClaw。

二、安装前准备

软件	说明
Node.js	运行OpenClaw
npm	安装CLI工具
Git	下载代码
Telegram	远程控制AI

检查Node版本

node -v

三、安装OpenClaw

推荐使用官方安装脚本：

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

四、初始化配置

openclaw onboard --install-daemon

配置步骤：

• 选择AI模型
• 填写API Key
• 配置Telegram
• 配置Skills

五、AI模型配置

示例：

provider: openai
model: gpt-4o
api key: sk-xxxx

或者：

provider: qwen
endpoint: https://portal.qwen.ai/v1

六、启动OpenClaw

openclaw start

查看状态

openclaw status

后台地址

http://localhost:3000

七、配置Telegram机器人

在 Telegram 搜索：

@BotFather

创建机器人：

/newbot

获取 BOT TOKEN

然后获取你的用户ID：

@userinfobot

八、配置allowFrom

allowFrom: 123456789

注意：

必须填写数字ID，不能填写用户名。

九、测试机器人

在 Telegram 发送：

hello

十、常见问题

1 Telegram不回复

原因：

• allowFrom错误
• 机器人token错误
• gateway未运行

2 Tools无法启用

解决方案：

删除配置文件中的tools内容：

~/.openclaw/agents/main/agent/

然后重启：

openclaw restart

3 插件无法安装

原因：插件市场尚未完全开放。

十一、重要目录

~/.openclaw

重要文件：

.env
models.json
auth-profiles.json

十二、升级OpenClaw

openclaw update

十三、卸载OpenClaw

rm -rf ~/.openclaw

npm uninstall -g openclaw

十四、最终效果

在 Telegram 发送：

帮我写代码
帮我搜索资料
执行任务

OpenClaw 就会在你的电脑执行任务。