|
| 1 | +# Use NEKO to Connect to QwenPaw |
| 2 | + |
| 3 | +## QwenPaw Installation Guide |
| 4 | + |
| 5 | +### Step 1: Install |
| 6 | + |
| 7 | +You do not need to configure Python manually. One command completes the setup automatically. The script downloads `uv` (the Python package manager), creates a virtual environment, and installs QwenPaw with its dependencies, including Node.js and frontend assets. Note: this may not work in some network environments or under enterprise permission restrictions. |
| 8 | + |
| 9 | +macOS / Linux: |
| 10 | + |
| 11 | +```bash |
| 12 | +curl -fsSL https://qwenpaw.agentscope.io/install.sh | bash |
| 13 | +``` |
| 14 | + |
| 15 | +Windows (PowerShell): |
| 16 | + |
| 17 | +```powershell |
| 18 | +irm https://qwenpaw.agentscope.io/install.ps1 | iex |
| 19 | +``` |
| 20 | + |
| 21 | +### Step 2: Initialize |
| 22 | + |
| 23 | +After installation finishes, open a new terminal and run: |
| 24 | + |
| 25 | +```bash |
| 26 | +qwenpaw init --defaults |
| 27 | +``` |
| 28 | + |
| 29 | +This step includes a thoughtful safety warning. QwenPaw clearly tells you: |
| 30 | + |
| 31 | +> This is a personal assistant running in your local environment. It can connect to channels, run commands, and call APIs. If multiple people use the same QwenPaw instance, they will share the same permissions, including files, commands, and secrets. |
| 32 | +
|
| 33 | + |
| 34 | + |
| 35 | +You need to choose `yes` to confirm that you understand before continuing. |
| 36 | + |
| 37 | +### Step 3: Start |
| 38 | + |
| 39 | +```bash |
| 40 | +qwenpaw app |
| 41 | +``` |
| 42 | + |
| 43 | +If startup succeeds, the last line in the terminal will show: |
| 44 | + |
| 45 | +```text |
| 46 | +INFO: Uvicorn running on http://127.0.0.1:8088 (Press CTRL+C to quit) |
| 47 | +``` |
| 48 | + |
| 49 | +After the service starts, visit `http://127.0.0.1:8088` to open the QwenPaw console. |
| 50 | + |
| 51 | +## Configure the NEKO Channel: Connect NEKO to QwenPaw |
| 52 | + |
| 53 | +After initialization, QwenPaw automatically creates its configuration directory. On Windows, the default path is `C:\Users\YourUsername\.qwenpaw`. On macOS, the default path is `~/.qwenpaw`. All built-in skills are enabled by default. |
| 54 | + |
| 55 | +Find that directory. Because `.qwenpaw` is hidden: |
| 56 | + |
| 57 | +- Windows users should open File Explorer from the taskbar, choose `View > Show`, and then enable hidden items. |
| 58 | +- macOS users should open Finder, go to their Home folder, and press `Command + Shift + .` at the same time. |
| 59 | + |
| 60 | +Copy the prepared channel configuration file `custom_channels` into the `.qwenpaw` folder. |
| 61 | + |
| 62 | +Copy the [files from the character folder](assets/openclaw_guide/%E6%9B%BF%E6%8D%A2%E5%86%85%E5%AE%B9.zip) into `.qwenpaw/workspaces/default`, then delete `BOOTSTRAP.md`. |
| 63 | + |
| 64 | +Next, press `CTRL+C` in the terminal to stop qwenpaw, and run `qwenpaw app` again to restart it. |
| 65 | + |
| 66 | +Then follow the steps in the image to enable the Neko channel. |
| 67 | + |
| 68 | + |
| 69 | + |
| 70 | +## Basic Setup: Model Configuration |
| 71 | + |
| 72 | +Click Model, then choose DashScope. You can also choose a different model based on your API key. Open Settings, enter your Alibaba Cloud Bailian API key, and save it. |
| 73 | + |
| 74 | + |
| 75 | + |
| 76 | +After saving, go back to the chat page and you will be able to select the configured model. |
| 77 | + |
| 78 | +Return to N.E.K.O and you can start using openclaw. |
0 commit comments