octop_assistant

Configure and manage Octop servers, agents, channels, and models via CLI commands.

Updated Aug 7, 2026
One-click install
npx skills add https://github.com/Protremix/EvolvixOS --skill octop-assistant-protremix
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: octop_assistant
Source: https://github.com/Protremix/EvolvixOS/tree/main/knowledge/experts/general-assistant/skills/octop-assistant
Command: npx skills add https://github.com/Protremix/EvolvixOS --skill octop-assistant-protremix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Configuring an Octop deployment involves many CLI subcommands that are agent-scoped, identity-sensitive, and split between the terminal and the web console, making it easy to run the wrong command against the wrong user or agent. ## Core Features & Use Cases - Identity-First Workflow: Resolves the current user and agent via the /status command before running any CLI, avoiding mistakes from assuming octop config show reflects the Dashboard or IM user. - Full Configuration Coverage: Provides command templates for providers and models, IM channels (Feishu, Discord, WeCom, QQ, Telegram), skills, cron jobs, agent lifecycle, users, backups, upgrades, and plugins. - Use Case: A user asks in Feishu "how do I switch the model to GPT-4o" — the assistant first requests /status output, then guides or executes octop models active --provider OpenAI --model gpt-4o with the correct agent context. ## Quick Start Ask the assistant to help you change the default model or add a Feishu channel to your Octop agent, and send /status first so it can identify your agent and user.

Frequently Asked Questions about octop_assistant

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I change the default LLM model in Octop?▼

Run octop provider list and octop models active to see current state, then set a new default with octop models active --provider <name> --model <id>. If no provider is configured, use the interactive octop models config wizard or provider create.

How do I connect a Feishu bot to an Octop agent?▼

Use octop --agent <id> channel create --kind feishu with a config containing app_id and app_secret, or run the interactive channel feishu-setup wizard. Verify the connection afterward with channel test <channel_id>.

Why does the Octop CLI report not logged in when I am logged into the Dashboard?▼

Dashboard login uses a browser JWT while the CLI uses a token stored by octop user login on the server terminal; they are independent. Run octop config show to check the CLI token, then log in on the server terminal or use the Dashboard settings pages instead.

Why do Octop channel and cron commands require an --agent flag?▼

Channels, skills, and cron jobs are isolated per agent, so the CLI must know which agent to target. Pass --agent <id> explicitly, or set a default with octop agent use <id> or the OCTOP_AGENT environment variable.

How do I back up and upgrade an Octop server?▼

Run octop backup create to archive the ~/.octop data directory, then octop update -y to upgrade. After upgrading, restart the octop run process or Docker container and confirm health with octop service status.