🚀 快速开始

本文档将引导你完成 NeoWeb AI 的安装和首次使用，整个过程大约需要 5 分钟。

系统要求

项目	要求
操作系统	macOS 12+、Ubuntu 20.04+、Debian 11+
Node.js	18.0.0 或更高版本
内存	最低 512MB，建议 2GB+
磁盘空间	至少 200MB 可用空间
网络	用于下载安装包和调用云端模型 API

安装方式

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

运行以下命令，脚本将自动检测环境、下载并安装 NeoWeb AI：

bash

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

安装完成后，脚本会提示你运行 neowebai start 启动服务。

方式二：手动安装

如果你偏好手动下载安装包：

bash

# 1. 从下载站下载安装包
wget https://ai.neowebai.com/download/neowebai-v1.0.0.tar.gz

# 2. 解压并进入目录
tar -xzf neowebai-v1.0.0.tar.gz
cd neowebai-v1.0.0

# 3. 运行安装脚本
bash install.sh

启动服务

安装完成后，使用以下命令启动 NeoWeb AI：

bash

# 前台启动
neowebai start

# 后台运行
neowebai start --daemon

# 查看状态
neowebai status

# 停止服务
neowebai stop

服务启动后，打开浏览器访问：

url

http://localhost:3001

💡 默认端口为 3001。如需更改，在配置文件中修改 PORT 环境变量，或使用 neowebai start --port 8080。

首次配置

第一步：配置 AI 模型

进入 设置 → 模型，根据你的需求添加 AI 模型：

国内模型：通义千问、文心一言、DeepSeek 等，需要填入对应平台的 API Key
国际模型：Claude、GPT-4、Gemini 等，需要对应服务商的 API Key
本地模型：配置 EXO 或 Ollama 的本地地址，完全离线运行

详细配置方法请参考模型配置文档。

第二步：了解工具系统

NeoWeb AI 内置 97+ 工具，AI 可以直接调用这些工具完成实际任务：

读写文件、执行 Shell 命令、搜索网络
控制 Mac 系统（截图、通知、剪贴板）
管理远程 SSH 服务器

在对话中直接描述任务，AI 会自动选择合适的工具。

第三步：尝试技能系统

18 个预置技能覆盖常见工作场景。进入技能面板，选择一个技能激活后即可在对话中使用。

验证安装

安装成功后，你也可以通过 API 验证服务是否正常运行：

bash

curl http://localhost:3001/api/status

正常响应如下：

json

{
  "status": "running",
  "version": "1.0.0",
  "uptime": 42,
  "models": 3,
  "skills": 18,
  "tools": 97
}

升级

bash

neowebai update

卸载

bash

neowebai uninstall

ℹ️ 卸载不会删除你的数据目录（~/.neowebai/），如需完全清除请手动删除。

遇到问题？

如遇到安装或启动问题：

检查 Node.js 版本：node --version（需要 18+）
查看错误日志：neowebai logs
确认端口 3001 未被占用：lsof -i :3001
发送邮件：support@liurenai.com

🚀 Quick Start

This guide walks you through installing NeoWeb AI. The whole process takes about 5 minutes.

System Requirements

Item	Requirement
OS	macOS 12+, Ubuntu 20.04+, Debian 11+
Node.js	18.0.0 or higher
Memory	Min 512MB, 2GB+ recommended
Disk	At least 200MB free
Network	For downloading packages and calling cloud model APIs

Installation

Option 1: One-click Install Script (Recommended)

Run the command below — the script auto-detects your environment, downloads and installs NeoWeb AI:

bash

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

After installation, the script will prompt you to run neowebai start to launch the service.

Option 2: Manual Installation

If you prefer to download the package manually:

bash

# 1. Download from the release server
wget https://ai.neowebai.com/download/neowebai-v1.0.0.tar.gz

# 2. Extract and enter directory
tar -xzf neowebai-v1.0.0.tar.gz
cd neowebai-v1.0.0

# 3. Run install script
bash install.sh

Start the Service

bash

# Run in foreground
neowebai start

# Run as daemon
neowebai start --daemon

# Check status
neowebai status

# Stop service
neowebai stop

Once started, open your browser and go to:

url

http://localhost:3001

💡 Default port is 3001. To change it, set the PORT env variable or use neowebai start --port 8080.

Initial Setup

Step 1: Configure an AI Model

Go to Settings → Models and add an AI model:

Chinese models: Qwen, ERNIE, DeepSeek, etc. — enter the platform's API Key
International models: Claude, GPT-4, Gemini — enter your provider's API Key
Local models: configure EXO or Ollama's local address for fully offline operation

For detailed setup, see the Model Configuration guide.

Step 2: Explore the Tool System

NeoWeb AI has 97+ built-in tools AI can call directly:

Read/write files, run Shell commands, search the web
Control Mac system (screenshots, notifications, clipboard)
Manage remote SSH servers

Step 3: Try the Skills System

18 preset skills cover common work scenarios. Open the Skills panel, activate a skill, and use it in your conversation.

Verify Installation

bash

curl http://localhost:3001/api/status

json

{
  "status": "running",
  "version": "1.0.0",
  "uptime": 42,
  "models": 3,
  "skills": 18,
  "tools": 97
}

Upgrade

bash

neowebai update

Uninstall

bash

neowebai uninstall

ℹ️ Uninstall does not remove your data directory (~/.neowebai/). Delete it manually for a clean removal.

Troubleshooting

If you encounter issues:

Check Node.js version: node --version (requires 18+)
View error logs: neowebai logs
Confirm port 3001 is not in use: lsof -i :3001
Email us: support@liurenai.com