Neko Agent Documentation

# 1. Clone the repository
git clone https://github.com/your-org/neko-agent.git
cd neko-agent

# 2. Install dependencies
npm install

# 3. Set up environment variables
cp .env.local.example .env.local

# 4. Edit .env.local with your keys:
#    OPENCLAW_API_URL=https://api.openclaw.ai
#    OPENCLAW_API_TOKEN=your-token-here
#    ELEVENLABS_API_KEY=your-elevenlabs-key
#    ELEVENLABS_VOICE_ID=your-voice-id

# 5. Run the development server
npm run dev

# Neko Agent is now live at http://localhost:3000

# 1. Create a new Node.js project
mkdir neko-discord && cd neko-discord
npm init -y
npm install discord.js

# 2. Create bot.js (see Discord Bot section below for full code)

# 3. Set environment variables
export DISCORD_TOKEN="your-discord-bot-token"
export NEKO_API="https://your-deployment.vercel.app"
# Or for local: export NEKO_API="http://localhost:3000"

# 4. Run the bot
node bot.js

// How Neko Agent calls OpenClaw (simplified)
const response = await fetch(OPENCLAW_API_URL + "/v1/chat/completions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer " + OPENCLAW_API_TOKEN,
  },
  body: JSON.stringify({
    model: "gpt-4o-mini",
    messages: [
      { role: "system", content: "You are Neko Agent..." },
      { role: "user", content: userMessage }
    ],
    temperature: 0.7,
    max_tokens: 2048,
  }),
});

const data = await response.json();
const reply = data.choices[0].message.content;

// discord-bot.js — Example using discord.js
const { Client, GatewayIntentBits } = require("discord.js");

const client = new Client({ 
  intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages, GatewayIntentBits.MessageContent] 
});

// Your Neko Agent instance URL
const NEKO_API = "https://your-deployment.vercel.app";

client.on("messageCreate", async (message) => {
  if (message.author.bot) return;
  if (!message.content.startsWith("!neko ")) return;
  
  const query = message.content.slice(6);
  
  try {
    const res = await fetch(NEKO_API + "/api/chat", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({
        messages: [{ role: "user", content: query }]
      }),
    });
    
    const data = await res.json();
    
    if (data.ok) {
      await message.reply(data.reply);
    } else {
      await message.reply("Agent error: " + (data.error?.message || "Unknown"));
    }
  } catch (err) {
    await message.reply("Connection error.");
  }
});

client.login(process.env.DISCORD_TOKEN);

# telegram_bot.py — Example using python-telegram-bot
import requests
from telegram import Update
from telegram.ext import Application, CommandHandler, MessageHandler, filters

NEKO_API = "https://your-deployment.vercel.app"

async def handle_message(update: Update, context):
    user_msg = update.message.text
    
    response = requests.post(
        f"{NEKO_API}/api/chat",
        json={"messages": [{"role": "user", "content": user_msg}]},
        headers={"Content-Type": "application/json"},
    )
    
    data = response.json()
    reply = data.get("reply", "Error processing request.")
    
    await update.message.reply_text(reply)

app = Application.builder().token("YOUR_TG_BOT_TOKEN").build()
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, handle_message))
app.run_polling()

# Quick CLI usage with curl
curl -X POST https://your-deployment.vercel.app/api/chat \
  -H "Content-Type: application/json" \
  -d '{"messages": [{"role": "user", "content": "Write a React hook for debouncing"}]}'